[publican-list] [Bug 482784] improve <refentry> presentation in final pdf, html, and html-single builds

[bugzilla at redhat.com]

Please do not reply directly to this email. All additional
comments should be made in the comments box of this bug.


https://bugzilla.redhat.com/show_bug.cgi?id=482784





--- Comment #2 from Jeff Fearn <jfearn at redhat.com>  2009-01-28 18:52:33 EDT ---
None of these tags are actually supported tags ATM; these tags are using
default settings and we need to look in to what is supportable use in the long
term.

On my initial inspection of the XML it looks to me that using better tag
selection may help.

The section titled "A typical reference page for a function:" at
http://www.docbook.org/tdg/en/html/refentry.html has a much better structure
for function specification that what is currently being used.

I tested the XML from the above link and although it was not perfect, it was
considerable better laid out that the current approach.

I also recommend switching from refsect1 to refsection. Using refsect1 forces
it to be marked up as a level 1 section, this will prevent depth based styling.

-- 
Configure bugmail: https://bugzilla.redhat.com/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are on the CC list for the bug.