Re: [bug-inetutils] [SCM] GNU Inetutils branch, master, updated. inetutils-1_9_1-224-gf88d586

[Alfred M. Szmidt]

Nice! The manual really does need a serious overhaul.

   @@ -230,12 +230,23 @@ nonzero.
    @chapter @command{hostname}: Show or set system host name.
    @cindex hostname

   address@hidden is a program to show or set the name of host system.
   address@hidden is a program to show or to set the name of a
   +host system.
   +
   address@hidden
   +Synopsis:

    @example
   -hostname address@hidden@dots{}] address@hidden
   +hostname address@hidden@dots{}]
   +hostname @var{name}
    @end example

   address@hidden
   +where @var{name} is the name to be used by the running host.
   +
   address@hidden Command line options
   address@hidden options}

I actually changed this so that there wouldn't be a seperate section
for the options -- or a synopsis; since that is how it is done in
coreutils.  Could you explain your rationale?  I know that there where
a few places that still had the Synopsis stuff left, but that was a
bug.

   -number of IP routers that the packet can go through before being
   -thrown away.  In current practice you can expect each router in the
   -Internet to decrement the TTL field by exactly one.
   +The @acronym{TTL} field, @dfn{Time To Live}, of an @acronym{IP}

@acronym is discouraged; though I don't mind it but it breaks `make
syntax-check'.  See:
http://lists.gnu.org/archive/html/bug-gnulib/2010-03/msg00321.html

   +The TCP/IP specification states that the @acronym{TTL} field
   +of a new @acronym{TCP} packet should be set to 60,
   +but many systems use smaller values (4.3BSD uses 30
   +and 4.2BSD used 15).

Uses? Maybe used?  I don't know any running 4.2 or 4.3 BSD's ...

   +Some BSD variants offer a kernel setting to inhibit all replies
   +to ICMP_MASKREQ packets.
   +This setting can detected using
   +
   address@hidden
   +$ sysctl net.inet.icmp.maskrepl
   +net.inet.icmp.maskrepl: 0
   address@hidden example

I think we should not mention specific means of changing ICMP MASKREQ;
just saying that it can be done is enough I think.  What do you think?
Also, FreeBSD is not 100% free software so it is better to not mention
it.

    specified, show status of @var{file-name} on remote machine.

   address@hidden rename address@hidden address@hidden
   -Rename the file from on the remote machine, to the file to.
   address@hidden rename address@hidden address@hidden

One ] to much or to little :-)

    @item
   -If the first character of the file name is @samp{|}, the remainder of
   +If the first character of the file name is @kbd{|}, the remainder of

I think @samp is correct here -- or @code, @kbd is for actual input by
the user.