Re: DOCBOOK: DocBook markup and possibly a RFE.

[Nik Clayton <nik@nothing-going-on.demon.co.uk>]

On Fri, May 19, 2000 at 10:24:38AM -0300, Jorge Godoy wrote:
> I don't know... I think that it's a command when:
> 
> <prompt>$</prompt> <command>grep</command> <option>something</option> <filename>it.sgml</filename>
> 
> But I don't think it's a command when:
> 
> <para>One great utility is <????>grep</????>, which can be accessed
> through the command <command>grep</command>, and is very helpful while
> searching for something inside text files.</para>

   <citerefentry>
     <refentrytitle>grep</refentrytitle>
     <manvolnum>1</manvolnum>
   </citerefentry>

The stylesheets turn this in to grep(1), which is probably what you want.
Given some DSSSL magic, they can even turn it in to links to an online
CGI manual page reference.

Sadly, it's a pain in the backside to type.  So I'm trying to get people
to use the same approach the FreeBSD Documentation Project uses.  See

    http://www.freebsd.org/cgi/cvsweb.cgi/doc/share/sgml/man-refs.ent

for the file that contains the entities, and

    http://www.freebsd.org/cgi/cvsweb.cgi/doc/en_US.ISO_8859-1/books/handbook/book.sgml

for an example of how to load that file in to your document.  Your example
above would then become:

    <para>One great utility is &man.grep.1;, and is very helpful while
      searching for something inside text files.</para>

N
-- 
Internet connection, $19.95 a month.  Computer, $799.95.  Modem, $149.95.
Telephone line, $24.95 a month.  Software, free.  USENET transmission,
hundreds if not thousands of dollars.  Thinking before posting, priceless.
Somethings in life you can't buy.  For everything else, there's MasterCard.
  -- Graham Reed, in the Scary Devil Monastery