Date: Wed, 14 May 2003 01:08:14 -0400 From: Jim Brown <jpb@sixshooter.v6.thrupoint.net> To: Documentation Folks <doc@FreeBSD.org> Subject: Re: man to html conversion question Message-ID: <20030514050814.GA20560@sixshooter.v6.thrupoint.net> In-Reply-To: <20030514010340.GA59773@BSDWins.Com> References: <20030514010340.GA59773@BSDWins.Com>
next in thread | previous in thread | raw e-mail | index | archive | help
* John <jwd@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@freebsd.org mailing list > http://lists.freebsd.org/mailman/listinfo/freebsd-doc > To unsubscribe, send any mail to "freebsd-doc-unsubscribe@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@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 ,
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030514050814.GA20560>