man to html conversion question

[Jim Brown]

* John <jwd at bsdwins.com> [2003-05-13 21:04]:
> Hello,
> 
>    I have what I hope is a simple question, but I have been unable
> to determine the cause/answer.
> 
>    I have a man page I have been working on that displays correctly
> as a manpage, but incorrectly when converted to html.
> 
>    The manpage:
> 
> http://people.freebsd.org/~jwd/apcpwr/apcpwr.8
> 
>    The manpage converted to html via:  groff -man -Thtml
> 
> http://people.freebsd.org/~jwd/apcpwr/apcpwr.8.html
> 
> 
>    The problem is relatively obvious. After the SYNOPSIS
> section, the rest of the sections are not formatted correctly.
> 
>    If someone could enlighten me as to the error of my ways, I
> would appreciate it :-)
> 
> Thanks!
> John
> _______________________________________________
> freebsd-doc at freebsd.org mailing list
> http://lists.freebsd.org/mailman/listinfo/freebsd-doc
> To unsubscribe, send any mail to "freebsd-doc-unsubscribe at freebsd.org"
> 


Hi,

With a liberal sprinkling of null content .Bd + .Ed pairings
I was able to get the section headers to behave, but there
are still some minor glitches with lists.

You may also be interested in my manual page writeup at:

http://sixshooter.v6.thrupoint.net/manpg/book.html

although there is no mention of groff -Thtml
(and not likely to be one after this exercise!)

Try the patch below and see if it helps.

Best Regards,
jpb
===




root at jpb-wks:/usr2#diff -u apcpwr.8 NEWapcpwr.8
--- apcpwr.8    Tue May 13 20:37:11 2003
+++ NEWapcpwr.8 Wed May 14 00:56:28 2003
@@ -18,46 +18,60 @@
 .Nm
 .Op Fl f
 .Ar reboot outletname
+.Bd -literal
+.Ed
 .Sh DESCRIPTION
 The
 .Nm
 utility is used to control power to systems connected to
 an APC MasterSwitch power distribution unit.
 The following option is available for script usage:
-.Bl -tag -width indent
+.Bl -inset
 .It Fl f
-Force the operation to occur without asking for final confirmation
-before execution.
+Force the operation to occur without asking for
+final confirmation before execution.
 .El
+.Bd -literal
+.Ed
 .Sh COMMANDS
 .Pp
 The commands recognized by
 .Nm
 are as follows:
-.Bl -tag -width Ds
-.It Ar list
-produces a list of the known APC MasterSwitches and the
-information associated with each port. The outlet status
-is dynamically determined via snmp request each time the
-list command is executed.
-.Pp
-.It Ar probe
+.Bd -literal
+.Ed
+.Bl -inset
+.It Em list
+produces a list of the known \&APC MasterSwitches
+and the information associated with each port.
+The outletstatus  is dynamically determined via
+snmp request each time the list command is executed.
+.Bd -literal
+.Ed
+.It Em probe
 produces the .db file (default:
 .Pa /var/db/apcpwr.db
-).
-.It Ar on
+\&).
+.Bd -literal
+.Ed
+.It Em on
 turns on the output specified by
 .Ar outletname
-.It Ar off
+.Bd -literal
+.Ed
+.It Em off
 turns off the output specified by
 .Ar outletname
-.It Ar reboot
+.Bd -literal
+.Ed
+.It Em reboot
 turns off the outlet specified by
 .Ar outletname
 for (a default of) 5 seconds and then turns it back on.
 .El
+.Bd -literal
+.Ed
 .Sh EXAMPLES
-.Pp
 The following command:
 .Pp
 .Nm
@@ -103,13 +117,19 @@
 #
 # Create /var/db/apcpwr.db
 #
-0       21      *       *       *       root    /usr/local/bin/apcpwr probe > /dev/null
+0       21      \&*       \&*       \&*       root    /usr/local/bin/apcpwr probe > /dev/null
 .Ed
 .Sh FILES
-.Bl -tag -compact
-.It Pa /usr/local/etc/apcpwr.conf
-.It Pa /var/db/apcpwr.db
+.Bd -literal
+.Ed
+.Bl -item
+.It
+/usr/local/etc/apcpwr.conf
+.It
+/var/db/apcpwr.db
 .El
+.Bd -literal
+.Ed
 .Sh SEE ALSO
 .Xr snmpwalk 8 ,
 .Xr snmpget 8 ,