Daniel Baumann wrote:
Notice:

  - explanation of purpose
  - clear summary of how it works and how to use it

The man page was derived from the "classic", decades old traceroute implementation from Van Jacobson, with some additions regarding the new features. The text itself was reviewed by some English-native by Red Hat. Sorry, I cannot quite understand (and hence cannot make a decision) what you are say about.

Being a little conservative, I prefer to save the old traditional text base. (One of the key features of this implementation is a maximum compatibility with the traditional traceroute from Van Jacobson. Even in texts :) ).

  - examples

It seems an extra thing for me.

The traceroute is a "command line utility", targeted for "sysadmins, power users etc.". All such people should already know what traceroute is for. They should not teach this utility at the "man traceroute" time anyway.

Even when "an end user" perform some trace, he/she should do it by the ask of some supporter (who is sysadmin/power user). Else what he tries to do knowing nothing about IP?

For users who heard about IP proto and are curious how his traffic goes throw the World, some GUI applications are applicable ("xtraceroute" was for this purpose). And certainly the manual for such applications should be more informative for such "end users".
  - related information for the puzzled reader
A teacher at the school should explain for such "the puzzled reader" all the things. The skilled users prefer to see the additional options (in the man text) more quickly, and any extra text "for educational purpose" would irritate them.


Regards,
Dmitry




--
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]

Reply via email to