refentry or section

["Samuel Wright" <lykoszine@gmail.com>]

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