This is the mail archive of the
docbook@lists.oasis-open.org
mailing list for the DocBook project.
Re: DocBook markup and possibly a RFE.
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