OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook-apps message

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