To comment on the following update, log in, then open the issue: http://www.openoffice.org/issues/show_bug.cgi?id=85692 Issue #|85692 Summary|interface documentation has no single concise summay Component|tools Version|OOo 2.3 Platform|All URL| OS/Version|All Status|NEW Status whiteboard| Keywords| Resolution| Issue type|PATCH Priority|P3 Subcomponent|autodoc Assigned to|np Reported by|fs
------- Additional comments from [EMAIL PROTECTED] Tue Jan 29 21:31:17 +0000 2008 ------- When an interface has both attributes and methods, the generated IDL documentation does not have a single, concise summary. That is, the documentation consists of: - interface description - Methods' Summary - Methods' Details - Attributes' Summary - Attributes' Details (in this order) That means that for all but the most trivial interfaces, the interesting information, which would allow to get an overview with one look only, is distributed over the whole page, and most certainly not available without scrolling. Yes, I know there are quick links at the top of the page, but this is not the help here: The problem is not to quickly navigate to the respective section, the problem is to see all relevant information, in a condensed form, without scrolling and clicking. A better setup would be the following order: - interface description - Methods' Summary - Attributes' Summary - Methods' Details - Attributes' Details This would put the two summary sections below each other, which means that you can easily get an overview about the complete interface, without diving into the details, yet. The attached patch to autodoc implements this changed order. --------------------------------------------------------------------- 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]