[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
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/. > > >
[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]