[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]
Subject: Re: [docbook-apps] Problems with tables in reference "man" pages
Yup. That does the trick! Thanks. mike Bob Stayton wrote: > The latest version of docbook2X (0.8.2) handles tables. > http://docbook2x.sourceforge.net/ > > Bob Stayton > Sagehill Enterprises > DocBook Consulting > bobs@sagehill.net > > > ----- Original Message ----- > From: "Mike Cooper" <Mike.Cooper@reshape.com> > To: <docbook-apps@lists.oasis-open.org> > Sent: Thursday, February 19, 2004 2:32 PM > Subject: [docbook-apps] Problems with tables in reference "man" pages > > > >>I've written my first UNIX man page in docbook refence format. It has an >>informaltable in it. When I convert it to a formated man ASCII text file > > using > >>docbook2man (docbook-utils v0.6.12 and openjade 1.3.1 or 1.3.2), the table > > is > >>unreadable. >> >>Here's the sgml: >> >><!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ >><!ENTITY mc "<trademark>MagniComp</trademark>"> >><!ENTITY si "<trademark>SysInfo</trademark>"> >>]> >> >><!-- $Revision$ --> >> >> <refentry id="mcsysinfohcf"> >> >> <!-- $Revision$ --> >> >> <refmeta> >> <refentrytitle>mcsysinfohcf</refentrytitle> >> <manvolnum>5</manvolnum> >> </refmeta> >> >> <refnamediv> >> <refname>mcsysinfohcf</refname> >> <refpurpose>&si; Host access Configuration File (HCF)</refpurpose> >> </refnamediv> >> >> <refsynopsisdiv> >> >> <synopsis> >># Comment >>host|snmpCommunity|username|password >> </synopsis> >> >> </refsynopsisdiv> >> >> <refsect1> >> <title>Description</title> >> <para> >>A Host access Configuration File (HCF) contains data used to access >>a host by means of various network protocols such as >><command>telnet</command> and SNMP. >></para> >> <para> >>Each HCF file consists of one host entry per line. >>Each line consists of the following fields which are deliminted by the >> <literal>|</literal> (vertical pipe) character: >><informaltable> >> <tgroup cols='3'> >> >> <thead> >> <row> >> <entry>Field #</entry> >> <entry>Name</entry> >> <entry>Description</entry> >> </row> >> </thead> >> >> <tbody> >> >> <row> >> <entry>1</entry> >> <entry><varname>host</varname></entry> >> <entry>The name of the host.</entry> >> </row> >> <row> >> <entry>2</entry> >> <entry><varname>snmpCommunity</varname></entry> >> <entry>The SNMP community name.</entry> >> </row> >> <row> >> <entry>3</entry> >> <entry><varname>userName</varname></entry> >> <entry>A username.</entry> >> </row> >> <row> >> <entry>4</entry> >> <entry><varname>password</varname></entry> >> <entry>A password.</entry> >> </row> >> >> </tbody> >> </tgroup> >> </informaltable> >></para> >> >> </refsect1> >> >> </refentry> >><!-- Tell xemacs+PSGML where the parent doc is so it can parse this file >>Local Variables: >> sgml-parent-document: ("RefMan.sgmin" "book" "chapter") >> End: >>--> >> >>Here is the formated output from docbook2man: >> >>.\" This manpage has been automatically generated by docbook2man >>.\" from a DocBook document. This tool can be found at: >>.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> >>.\" Please send any bug reports, improvements, comments, patches, >>.\" etc. to Steve Cheng <steve@ggi-project.org>. >>.TH "MCSYSINFOHCF" "5" "19 February 2004" "" "" >> >>.SH NAME >>mcsysinfohcf \- SysInfo\\u\\s-2TM\\s+2\\d Host access Configuration File > > (HCF) > >>.SH SYNOPSIS >> >>.nf >># Comment >>host|snmpCommunity|username|password >> >>.fi >>.SH "DESCRIPTION" >>.PP >>A Host access Configuration File (HCF) contains data used to access >>a host by means of various network protocols such as >>\fBtelnet\fR and SNMP. >>.PP >>Each HCF file consists of one host entry per line. >>Each line consists of the following fields which are deliminted by the >>| (vertical pipe) character: >>Field #NameDescription1hostThe name of the host.2snmpCommunityThe SNMP >>community name.3userNameA username.4passwordA password. >> >>Is there a better tool for converting docbook to man which works with > > tables? > >>mike >> >>To unsubscribe from this list, send a post to > > docbook-apps-unsubscribe@lists.oasis-open.org, or visit > http://www.oasis-open.org/mlmanage/. > >> >> > > > > To unsubscribe from this list, send a post to docbook-apps-unsubscribe@lists.oasis-open.org, or visit http://www.oasis-open.org/mlmanage/. >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]