os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Created a new set of entities for manual pages.

Browse source 
The construct:

    <citerefentry>
      <refentrytitle>foobar</refentrytitle>
      <manvolnum>1</manvolnum>
    </citerefentry>

is a pain to type, and messes up the pretty-printing of the source code.
Replace every occurence of a entry like that with:

    &man.foobar.1;

Adjusting the manual page name and section number appropriately.

The definitions for these entities are stored in man-refs.ent. This
file is in doc/share/sgml because it is not just specific to the Handbook.
I expect the DocBook'd FAQ and Tutorials (coming RSN) to use them as
well.

A new PUBLIC identifier has been created for these entities, and added to
the catalog file.
This commit is contained in:
Nik Clayton 1999-03-07 16:32:22 +00:00
parent 1c05a644f3
commit 62a7d13816
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=4471
64 changed files with 1392 additions and 2015 deletions
Download patch file Download diff file Expand all files Collapse all files

8
en/handbook/advanced-networking/chapter.sgml
View file

@ -311,18 +311,18 @@ Local1 (10.20.30.1, 10.9.9.30) --&gt; T1-GW (10.9.9.1)
<para>Sometimes, there is a problem with routing propagation, and
some sites are unable to connect to you. Perhaps the most useful
command for trying to figure out where a routing is breaking down
is the <citerefentry><refentrytitle>traceroute</refentrytitle><manvolnum>8</manvolnum></citerefentry> command. It is equally
is the &man.traceroute.8; command. It is equally
useful if you cannot seem to make a connection to a remote machine
(ie. <citerefentry><refentrytitle>ping</refentrytitle><manvolnum>8</manvolnum></citerefentry> fails).</para>
(i.e. &man.ping.8; fails).</para>
<para>The <citerefentry><refentrytitle>traceroute</refentrytitle><manvolnum>8</manvolnum></citerefentry> command is run with the
<para>The &man.traceroute.8; command is run with the
name of the remote host you are trying to connect to. It will show
the gateway hosts along the path of the attempt, eventually either
reaching the target host, or terminating because of a lack of
connection.</para>
<para>For more information, see the manual page for
<citerefentry><refentrytitle>traceroute</refentrytitle><manvolnum>8</manvolnum></citerefentry>.</para>
&man.traceroute.8;.</para>
</sect2>
</sect1>