OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: refentry or section


Hi All,

I'm documenting some software apis, and was thinking of using sections
(rather than sect1,2, etc due to possible reuse). Have since sound
references and refentries.

Is the main advantage of using references and refentries that you can
format them in a different manner to sections containing other text?
Is that a strong enough reason to use them? What do you all use for
apis in docbook?

Thanks in advance for any thoughts

S


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]