Markup bugs on the ddd.1 manual page

[Eric S. Raymond]

I'm working on a program that automatically translates manual page sources
to DocBook markup.  You can find out more about this program at 

        http://www.tuxedo.org/~esr/doclifter/

If you are not already considering it, please think about moving your
documentation masters to DocBook (or some format from which you can
generate DocBook).  Tools to generate man pages (docbook2man) HTML
(docbook2html) and PostScript (docbook2ps) from DocBook files are
open source and generally available.  My program, doclifter, should
make moving your masters to DocBook a pretty painless process.

Many major open source projects (including the Linux Documentation
Project, GNOME, KDE, and FreeBSD) have moved to DocBook or are in the
process of doing so.  The format has many advantages over man, info,
texinfo, or HTML; by moving everybody to it, we should be able to
support unified browsing of all system documentation with Web-like 
hypertext capabilities, automatic indexing, and rich search facilities.

In the process of debugging doclifter, I have discovered many bugs in 
man page layout.  These are significant because they make automated
translation to DocBook more difficult, and often confuse other document-
mining tools (such as indexers).

I have found some markup bugs on a manual page you maintain.
Please fix these in your next release.

(Unbalanced option group, and a nonexistent command.)

--- foobar.man  2002/07/22 05:30:38     1.1
+++ foobar.man  2002/07/22 05:32:19
@@ -31,7 +31,6 @@
 .SH "NAME"
 ddd, xddd - The Data Display Debugger
 .SH ""
-.PSPIC ./PICS/dddlogo.eps 10cm
 .\"
 .\" ---------------
 .SH "SYNOPSIS"
@@ -56,7 +55,7 @@
 .B @\c
 \&]\c
 .I hostname\c
-\&\|]\|]
+\&\|]
 .RB "[\|" \-\-trace "\|]"
 .RB "[\|" \-\-version "\|]"
 .RB "[\|" \-\-configuration "\|]"
-- 
                <a href="http://www.tuxedo.org/~esr/";>Eric S. Raymond</a>

Freedom begins between the ears.        -- Edward Abbey