Friday, March 02, 2007
Hang on, help is on its way
I have been given permission from CodeGear to blog about some of the new features in the soon to be released Delphi 2007 for Win32, code named Spacely. It seemed like as good an excuse as any to wake this normally sleepy blog from its usual slumber.
One of the major complaints with Delphi 2006 was the quality of the online help shipped with the product. I know personally that I find locating the information I require in the D2006 help to be a lot more cumbersome than in Delphi versions 7 and below.
For instance, when looking up the help for a particular class, often related symbols are listed in the help but with no hyperlink, forcing you to search for that symbol individually as you peruse down the chain of responsibility for the class. And another pet peeve is how all symbols for a class are listed strictly in alphabetical order, rather than also being limited by scope.
Thankfully, CodeGear have acknowledged this as a major issue, and have been taking significant steps to improve the situation. I am glad to say that the D2007 help has improved tremendously in this regard. As a little teaser, below I've attached screenshots showing the summary for the TCollectionItem class, along with details of all members. As a comparison, I've also included a screenshot of the same information from the D2006 help. For the benefit for readers who have not seen the D2006 help, these screenshots preceed the D2007 ones in each example (and are not covered in a big Beta version disclaimer :-)). A larger version of each of the below screenshots can be shown by clicking on them.
You'll note in the above screenshot that the class heirarchy is rendered in a graphical fashion. It is also important to note that each of the individual boxes representing a class in the inheritance tree is hyperlinked to the help summary for the class being shown.
In the above shot, you can clearly see that the members for the TCollectionItem class are grouped by visibility level. These sections can also be collapsed and expanded, as evidenced by the public methods section being collapsed in the screenshot. There is also additional information shown about each symbol in the class, such as whether it is a virtual method.
Now, I don't expect a 100% perfect help system in their first attempt to resolve all the issues in the previous version, but it certainly seems that significant strides have been made in this area. So it seems the Little River Band were right, and Help is on its way :-)
(6) comments
One of the major complaints with Delphi 2006 was the quality of the online help shipped with the product. I know personally that I find locating the information I require in the D2006 help to be a lot more cumbersome than in Delphi versions 7 and below.
For instance, when looking up the help for a particular class, often related symbols are listed in the help but with no hyperlink, forcing you to search for that symbol individually as you peruse down the chain of responsibility for the class. And another pet peeve is how all symbols for a class are listed strictly in alphabetical order, rather than also being limited by scope.
Thankfully, CodeGear have acknowledged this as a major issue, and have been taking significant steps to improve the situation. I am glad to say that the D2007 help has improved tremendously in this regard. As a little teaser, below I've attached screenshots showing the summary for the TCollectionItem class, along with details of all members. As a comparison, I've also included a screenshot of the same information from the D2006 help. For the benefit for readers who have not seen the D2006 help, these screenshots preceed the D2007 ones in each example (and are not covered in a big Beta version disclaimer :-)). A larger version of each of the below screenshots can be shown by clicking on them.
You'll note in the above screenshot that the class heirarchy is rendered in a graphical fashion. It is also important to note that each of the individual boxes representing a class in the inheritance tree is hyperlinked to the help summary for the class being shown.
In the above shot, you can clearly see that the members for the TCollectionItem class are grouped by visibility level. These sections can also be collapsed and expanded, as evidenced by the public methods section being collapsed in the screenshot. There is also additional information shown about each symbol in the class, such as whether it is a virtual method.
Now, I don't expect a 100% perfect help system in their first attempt to resolve all the issues in the previous version, but it certainly seems that significant strides have been made in this area. So it seems the Little River Band were right, and Help is on its way :-)
