[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]