Re: [bug-inetutils] Manual rewrite ..

[Mats Erik Andersson]

Dear Alfred,

onsdag den  5 februari 2014 klockan 06:29 skrev Alfred M. Szmidt detta:
> Hello,
> 
> I started some days/years ago to rewrite the manual; reorganize it a
> bit, and such.  Here is a work in progress; what do people think?

I like the consistent addition of synopses. (pftp needed help though!)

> There are a few chapters missing; but I've gone over the options for
> each command, and added any missing things.  I'd like to write a
> chapter on Shishi/Kerberos support, IPv6 support and ammend the
> ifconfig part properly when I get some spare time.

I have separated the generic options of ifconfig from the few system
specific options in a patch on top of your suggestion. Observe also
that I reordered the options to "-B, -b, --brdaddr, --broadcast"
and "-d, -p, --dstaddr, --peer", in that order, to name the short
switches first.

The functionality for "pointopoint" is probably unknown to us,
whether it works on BSD and Solaris, so it is mentioned as
specific to GNU/Linux.

> Basically, I'd like some input on if people have any good suggestions
> in imporving the manual, and if the layout in this copy is "good".

Personally, I am convinced that "See also" should be used throughout
the manual, not the present "Also see". The folding of text into the
macro "kerberos" is a clear gain. To sum up, I am happy that you are
taking command in performing a rewrite.

Best regards,
  Mats E A

minor_texinfo.diff
Description: Text Data