Writing Docbook documentation

From: 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

« previous php.pear.dev (#50540) next »