Problems in the help documentation
Posted: Mon Jul 01, 2024 2:44 pm
I've seen a few issues in the help documentation, some I can confirm are misrepresentations and others I can't.
I should note that I got the results by opening a console project in VS2022 and viewing its property page.
Here is the list:
1. topic: X# Compiler Options By Category
In "XBase Compatibility"，-namedarguments is a misspelling, it seems to be -namedargs.
2. topic: X# Compiler Options Listed Alphabetically
original: The following compiler options are sorted by category. For an alphabetical list, see : X# Compiler Options Listed Alphabetically
should: The following compiler options are sorted by Alphabetically. For an alphabetical list, see : X# Compiler Options By Category
In addition, the descriptions of -ovf and -fovf are not entirely consistent. This may lead to misunderstanding on the part of some readers.
(Same in "X# Compiler Options By Category")
3. topic: -allowdot
original: Click the Dialect tab.
should: Click the Language tab.
original: Change the value.
should: Change "Allow DOT for instance members" value of checkbox
4. topic: -allowoldstyleassignments
original: Change the value.
should: Change "Allow Old Style assignments" Value of checkbox
5. topic: -baseaddress, -checke, -checksumalgorithm, -filealign, -highentropyva
original: Add the option in the "User-Defined Command Line options" property
should: Add the option in the "Extra Command Line options" property。
Because the original article was just a tooltip
6. topic: -debug, -errorreport
original: Click the Advanced button.
I really didn't find that button
7. topic: -define
original: On the Build tab, type the symbol that is to be defined in the Conditional compilation symbols box. For example, if you are using the code example that follows, just type xx into the text box.
I just found "Defines for the preprocessor". Do they mean the same thing?
8. topic: -keyfile
original: Click the Signing property page. Modify the Choose a strong name key file property.
I still can't find it
9. topic: -lb
original: In the Visual Objects Compatibility section, modify the Allow Late Binding property.
should: In the General section, modify the Allow Late Binding property.
10.topic: -nostddefs
original: Click the Build tab.
should: Click the Language tab.
For the identified parts, I have corrected them in the Simplified Chinese version. But for the parts that are not sure, I will still keep them.
I should note that I got the results by opening a console project in VS2022 and viewing its property page.
Here is the list:
1. topic: X# Compiler Options By Category
In "XBase Compatibility"，-namedarguments is a misspelling, it seems to be -namedargs.
2. topic: X# Compiler Options Listed Alphabetically
original: The following compiler options are sorted by category. For an alphabetical list, see : X# Compiler Options Listed Alphabetically
should: The following compiler options are sorted by Alphabetically. For an alphabetical list, see : X# Compiler Options By Category
In addition, the descriptions of -ovf and -fovf are not entirely consistent. This may lead to misunderstanding on the part of some readers.
(Same in "X# Compiler Options By Category")
3. topic: -allowdot
original: Click the Dialect tab.
should: Click the Language tab.
original: Change the value.
should: Change "Allow DOT for instance members" value of checkbox
4. topic: -allowoldstyleassignments
original: Change the value.
should: Change "Allow Old Style assignments" Value of checkbox
5. topic: -baseaddress, -checke, -checksumalgorithm, -filealign, -highentropyva
original: Add the option in the "User-Defined Command Line options" property
should: Add the option in the "Extra Command Line options" property。
Because the original article was just a tooltip
6. topic: -debug, -errorreport
original: Click the Advanced button.
I really didn't find that button
7. topic: -define
original: On the Build tab, type the symbol that is to be defined in the Conditional compilation symbols box. For example, if you are using the code example that follows, just type xx into the text box.
I just found "Defines for the preprocessor". Do they mean the same thing?
8. topic: -keyfile
original: Click the Signing property page. Modify the Choose a strong name key file property.
I still can't find it
9. topic: -lb
original: In the Visual Objects Compatibility section, modify the Allow Late Binding property.
should: In the General section, modify the Allow Late Binding property.
10.topic: -nostddefs
original: Click the Build tab.
should: Click the Language tab.
For the identified parts, I have corrected them in the Simplified Chinese version. But for the parts that are not sure, I will still keep them.