This is the mail archive of the
systemtap@sourceware.org
mailing list for the systemtap project.
Re: Online documentation and version differences
- From: Mike Mason <mmlnx at us dot ibm dot com>
- To: SystemTAP <systemtap at sources dot redhat dot com>
- Date: Fri, 09 Nov 2007 08:52:46 -0800
- Subject: Re: Online documentation and version differences
- References: <472B4C38.5070706@us.ibm.com>
One week ago I posted this concern regarding the accuracy of the language reference and have received no responses so far. Did it not make it to the list? I'd like others opinions on how to keep the language reference accurate for multiple versions.
Mike
Mike Mason wrote:
Currently, the online documentation (man pages, language reference)
reflects the current SystemTap source (at least that's the goal).
However, the various distros have different SystemTap functionality,
depending on what snapshot they used. The core is the same, but some
details are different. When we send users to the online documentation,
it sometimes does not reflect the version they're using.
What, if anything, should we do about this? We can certainly refer them
to they're installed man pages as opposed to the online version, but
there is only one version of the language reference. It would be next
to impossible to track features by distro version in the online
reference. However, if we packaged the reference in the SystemTap rpm,
it would theoretically match the features at the time the snapshot was
taken. We could then tell users to refer to the language reference
installed on their system instead of the online version.
Thoughts?
Mike