This is the mail archive of the
systemtap@sourceware.org
mailing list for the systemtap project.
Re: how to avoid a lengthy man page of stapprobes(5)?
- From: fche at redhat dot com (Frank Ch. Eigler)
- To: "Gui,Jian" <guij at cn dot ibm dot com>
- Cc: systemtap at sources dot redhat dot com
- Date: 15 Sep 2006 13:51:56 -0400
- Subject: Re: how to avoid a lengthy man page of stapprobes(5)?
- References: <450A1562.6020308@cn.ltcfwd.linux.ibm.com>
"Gui,Jian" <guij@cn.ibm.com> writes:
> We are documenting NFS and RPC tapsets into stapprobes(5) man
> page. But there are more than 60 probe points and each may have 3-5
> arguments. If we document them in the same way(names, introductions,
> arguments, argument descriptions) as we did for other tapsets, it will
> make the stapprobe man page too long.
I suspect the existing ones (like signal.*) could be made considerably
more compact. The present formatting has too much white space and
lines are split too short. I'll try to tighten one or two of them up
to see if enough improvement can be easily made.
> And finally the user may find it difficult to find something
> there. [...]
Even lacking something more complex, the man pager program's search
function should help. Breaking the man page into subpages is also OK.
- FChE