General information
Category:
Visual FoxPro Product Documentation
This is largely a repeat of a long-standing Toledo item, placed here to obtain additional dialogue.
The MSDN (Help) for VFP7 has a radically improved format, making useability a pleasure compared to older versions.
Nevertheless, several things could be done to improve the utility of the information even more. I list below, in no particular order, those things that I think can/should be done to improve it:
01) The brief description at the very top needs expanding in many cases.
Some examples include:
(a) Most array-related functions also return a number of elements or rows but this is not mentioned;
(b) SET REFRESH mentions only BROWSE when it does, in fact, affect other aspects of the system;
(c) State case-sensitive when such is the case.
02) The Return Value heading of most entries should contain more than a single word.
For instance, instead of just saying "Numeric" it could say: "Numeric - the number of elements in the array".
Instead of simply "Character" it could say:
"Character - comma delimited string of: font name, font size, font style codes".
03) Any optional parameter listed under the Parameters heading should have the word "Optional" beside its name.
For example, instead of just saying: "nWorkArea | cTableAlias " it should say: "nWorkArea | cTableAlias - Optional."
04) The default value of any parameter listed under the Parameters heading should be printed beside its name.
For example, instead of just saying: "nWorkArea | cTableAlias " it should say: "nWorkArea | cTableAlias - Optional. Default: Current active work area"
05) Tables describing array column content should all adopt the same format.
06) A revision marker should be used to indicate any change of content from version to version.
Next
Reply
View the map of this thread
View the map of this thread starting from this message only
View all messages of this thread
View all messages of this thread starting from this message only