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: manpage stylesheets generating bad font commands (\F)


Using 1.69.1 stylesheets.

Input:

<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd";>
<refentry>

  <refmeta>
    <refentrytitle>some-program</refentrytitle>
    <manvolnum>1</manvolnum>
  </refmeta>

  <refnamediv>
    <refname>some-program</refname>
    <refpurpose>program that does something</refpurpose>
  </refnamediv>

  <refsynopsisdiv>
    <cmdsynopsis>
      <command>some-program options</command>
    </cmdsynopsis>
  </refsynopsisdiv>

  <refsection>

    <title>Description of <command>some-program</command></title>

    <para>
      Description of the program, how to use it, its allowable
      command-line options, etc.
    </para>

  </refsection>

</refentry>


Output:

.\" ** You probably do not want to edit this file directly **
.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
.\" Instead of manually editing it, you probably should edit the DocBook XML
.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
.TH "SOME\-PROGRAM" "1" "09/17/2005" "" ""
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.SH "NAME"
some\-program \- program that does something
.SH "SYNOPSIS"
.HP 21
\fBsome\-program options\fR
.SH "DESCRIPTION OF \\FBSOME\-PROGRAM\\FR"
.PP
Description of the program, how to use it, its allowable command\-line
options, etc.


Note that the .SH DESCRIPTION line contains \F rather than \f for the
font commands. (That is, \f has gotten capitalized along with the rest of
the section header text.)  I suppose this might be insignificant, given that
.SH generates boldface anyway. Older manpage stylesheets appear to strip the
font commands, which at least doesn't result in warnings when the manpage
is formatted:

% groff -man some-program.1 >/dev/null
some-program.1:15: warning: can't find font `BB'
some-program.1:15: warning: can't find font `RB'




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