Level Extreme platform
Subscription
Corporate profile
Products & Services
Support
Legal
Français
Some suggestions
Message
From
18/05/2002 09:00:50
 
 
To
All
General information
Forum:
Visual FoxPro
Category:
Visual FoxPro Product Documentation
Title:
Some suggestions
Miscellaneous
Thread ID:
00658544
Message ID:
00658544
Views:
35
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
Map
View

Click here to load this message in the networking platform