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: Some issues regarding the manpages stylesheet


Hello!

The new manpages stylesheet of 1.69.0 is great. The output quality is 
impressive. But I have some remarks to make.

1. There should be some way to specify the output directory, something 
like 'base.dir' used in html chunking.

2. Some useless code should not be generated. For example, the following 
xml code (perhaps these long lines will be truncated) ...

<term><option>--alev=<replaceable class="option">level</replaceable></option></term>

...produces the next output:

\fB\-\-alev=\fR\fB\fIlevel\fR\fR

In this case, the second \fB is useless. And there is more, such as:

\fB\fBbdc \fR\fR\fB \fR\fB\fB\-\-arc \fR\fR\fB\fR\fB\fB\-\-log=\fR\fB\fI/tmp/bdc.log\fR\fR\fB \fR\fR\fB\fR\fB\fB\-\-debug \fR\fR\fB \fR\fB\fB\-\-disinfect \fR\fR\fB\fR\fB\fI/var/tmp\fR\fR\

I know, there is no simple solution for it. :(

3. When <screen>...</screen> is used, before '.nf' and after '.fi' there 
are empty lines. These lines ARE NOT IGNORED by groff.

4. When the next syntax is used ...
<para>
   <command>blabla</command>
</para>

...in the output code there is one space (' ') before the '\fBblabla\fR', 
at the beginning of the line. This one is NOT DISCARDED by groff. That 
space character is absent when the following syntax is used:

<para><command>blabla</command></para>

That's all for the moment. :P

-- 
Costin STROIE
Linux Technical Writer
Data Security Division
SOFTWIN
-------------------------------
e-mail: cstroie@bitdefender.com
tel: (+402) 1 233 07 80
fax: (+402) 1 233 07 63
gsm: (+40) 722 46 23 79
Bucharest, ROMANIA
-------------------------------
www.softwin.ro
www.bitdefender.com


-- 
This message was scanned for spam and viruses by BitDefender.
For more information please visit http://www.bitdefender.com/



[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]