=================================================================== RCS file: /cvs/docbook2mdoc/README,v retrieving revision 1.6 retrieving revision 1.7 diff -u -p -r1.6 -r1.7 --- docbook2mdoc/README 2019/04/12 16:40:53 1.6 +++ docbook2mdoc/README 2019/04/14 12:38:33 1.7 @@ -1,4 +1,4 @@ -$Id: README,v 1.6 2019/04/12 16:40:53 schwarze Exp $ +$Id: README,v 1.7 2019/04/14 12:38:33 schwarze Exp $ Here's a quick note on how to add new DocBook elements. @@ -69,13 +69,14 @@ include: * Nodes with complex formatting requirements call their own, dedicated pnode_print*() formatting functions. - These functions are ordered roughly as follows: + For historical reasons, these functions are ordered roughly as follows: 1. paragraphs 2. sections 3. functions and mathematics 4. semantic markup for command line utilities 5. various semantic markup - 6. structural markup like lists and tables + 6. prologue and top level structures + 7. structural markup like lists and tables Such functions often contain their own loops over children and remove the children with pnode_unlinksub() at the end. But in some cases, it is alternatively possible to let the common loop