From owner-freebsd-doc@FreeBSD.ORG Tue May 13 22:08:17 2003 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id DE4CD37B401 for ; Tue, 13 May 2003 22:08:16 -0700 (PDT) Received: from sixshooter.v6.thrupoint.net (sixshooter.v6.thrupoint.net [65.242.152.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 01BEC43F85 for ; Tue, 13 May 2003 22:08:16 -0700 (PDT) (envelope-from jpb@sixshooter.v6.thrupoint.net) Received: from sixshooter.v6.thrupoint.net (localhost.v6.thrupoint.net [127.0.0.1]) by sixshooter.v6.thrupoint.net (Postfix) with ESMTP id 302DC4CF9 for ; Wed, 14 May 2003 01:08:15 -0400 (EDT) Received: (from jpb@localhost)h4E58Ecd020762 for doc@FreeBSD.org; Wed, 14 May 2003 01:08:14 -0400 (EDT) Date: Wed, 14 May 2003 01:08:14 -0400 From: Jim Brown To: Documentation Folks Message-ID: <20030514050814.GA20560@sixshooter.v6.thrupoint.net> Mail-Followup-To: Documentation Folks References: <20030514010340.GA59773@BSDWins.Com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030514010340.GA59773@BSDWins.Com> User-Agent: Mutt/1.4.1i Subject: Re: man to html conversion question X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 14 May 2003 05:08:17 -0000 * John [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 ,