To comment on the following update, log in, then open the issue:
http://www.openoffice.org/issues/show_bug.cgi?id=84138
                 Issue #|84138
                 Summary|autodoc should not warn about <VOID/> instead of <void
                        |/>
               Component|tools
                 Version|680m236
                Platform|All
                     URL|
              OS/Version|All
                  Status|NEW
       Status whiteboard|
                Keywords|
              Resolution|
              Issue type|ENHANCEMENT
                Priority|P4
            Subcomponent|autodoc
             Assigned to|np
             Reported by|fs





------- Additional comments from [EMAIL PROTECTED] Fri Nov 30 20:52:19 +0000 
2007 -------
http://api.openoffice.org/docs/DevelopersGuide/Appendix/IDLDocumentationGuide/IDLDocumentationGuide.xhtml#1_4_1_Special_Markups
describes that <void/> is a special markup in IDL documentation, resolved to the
atom "void".
If you enter <VOID/> in your documentation, then the
Autodoc_DiagnosticMessages.txt complains that this is an "Incorrectly Written
Const Symbol".

The notion here is somewhat inconsistent: <TRUE/>, <FALSE/>, <NULL/> are all
upper-case, somebody used to this upper-caseness who also applies it to <void/>
is then rewarded with a warning.

If <void/> were <VOID/>, then there would be an easy rule to remember: All empty
tags are upper-case, all non-empty tags lower case. Would be more consistent,
/me thinks.

So, what this RFE is about: autodoc should accept <VOID/> without warning, the
documentation should be changed to <VOID/> instead of <void/>, and <void/>
should be allowed for compatibility reasons.

P4 only, for sure.

---------------------------------------------------------------------
Please do not reply to this automatically generated notification from
Issue Tracker. Please log onto the website and enter your comments.
http://qa.openoffice.org/issue_handling/project_issues.html#notification

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to