Hi Anton,
Anton Lindqvist wrote on Sun, May 17, 2020 at 10:56:18AM +0200:
> The ddb(4) manual documents a couple of commands which can be
> abbreviated. The diff below adds explicit tags for such commands which
> in turn makes it possible to jump to for instance `examine' from within
> your $PAGER.
I agree this is a typical example of a page where manual tagging
makes sense.
Also note that your placement of the .Tg before the .It is good.
That's the logical place. It also preserves the automatic tagging
of the .Ic, so ":t p" still works, too:
<dt id="print"><a class="permalink" href="#p"><code class="Ic"
id="p">p</code></a>[<code class="Ic">rint</code>]
> Comments? OK?
OK schwarze@
Ingo
> Index: ddb.4
> ===================================================================
> RCS file: /cvs/src/share/man/man4/ddb.4,v
> retrieving revision 1.96
> diff -u -p -r1.96 ddb.4
> --- ddb.4 14 May 2020 06:58:54 -0000 1.96
> +++ ddb.4 17 May 2020 08:54:18 -0000
> @@ -202,6 +202,7 @@ are displayed and no other action is per
> .It Ic help
> List the available commands.
> .\" --------------------
> +.Tg examine
> .It Xo
> .Oo Ic e Oc Ns
> .Ic x Ns Op Ic amine
> @@ -275,6 +276,7 @@ is set to the
> .Ar addr
> plus the size of the data examined.
> .\" --------------------
> +.Tg print
> .It Xo
> .Ic p Ns Op Ic rint
> .Op Cm /axzodurc
> @@ -301,6 +303,7 @@ will print something like this:
> xxxxxx
> .Ed
> .\" --------------------
> +.Tg pprint
> .It Xo
> .Ic pp Ns Op Ic rint
> .Op Ar addr
> @@ -316,6 +319,7 @@ as part of building a new kernel.
> .\" .Op Ar addr
> .\" .Ar expr Op expr ...
> .\" .Xc
> +.Tg write
> .It Xo
> .Ic w Ns Op Ic rite
> .Op Cm /bhl
> @@ -394,6 +398,7 @@ allows the breakpoint to be silently hit
> times before stopping at the
> break point.
> .\" --------------------
> +.Tg delete
> .It Xo
> .Ic d Ns Op Ic elete
> .Op Ar addr
> @@ -405,6 +410,7 @@ command.
> .\" .It Xo Ic s Ns Op Cm /p
> .\" .Op Ic \&, Ns Ar count
> .\" .Xc
> +.Tg step
> .It Xo
> .Ic s Ns Op Ic tep
> .Op Cm /p
> @@ -437,6 +443,7 @@ Parentheses may be omitted if the functi
> The number of arguments is currently limited to 10.
> .\" --------------------
> .\" .It Ic c Ns Op Cm /c
> +.Tg continue
> .It Xo
> .Ic c Ns Op Ic ontinue
> .Op Cm /c
> @@ -949,6 +956,7 @@ command.
> A synonym for
> .Ic show all procs .
> .\" --------------------
> +.Tg machine
> .It Xo
> .Ic mac Ns Op Ic hine
> .Ar subcommand Op Ar args ...
