Writing Docbook documentation
| From: | Michael Gauthier | Date: | Tue, 05 Aug 2008 23:14:43 +0000 |
| Subject: | Writing Docbook documentation | ||
| Groups: | php.pear.dev | ||
| Request: | Send a blank email to pear-dev+get-50540@lists.php.net to get a copy of this message | ||
I'm just getting started writing docbook documentation for the first
time. I've already written the content of my documentation in OpenOffice
and I am trying to translate it into docbook format.
Do all pages in the package chapters need to be <refentry> elements? The
introduction section of my documentation doesn't fit nicely in a
refentry. For example, the name of the entry is "Introduction" the
refpurpose is "introducing Crypt_GPG" and the title of the first
refsection is also "Introduction". This renders rather redundantly as:
Introduction
============
Introduction -- introducing Crypt_GPG
Introduction
============
Real content here.
Is it not possible to just have a plain chapter instead of a refentry at
this location?
Thanks,
Mike