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
-@command{hostname} is a program to show or set the name of host system.
+@command{hostname} is a program to show or to set the name of a
+host system.
+
+@noindent
+Synopsis:
@example
-hostname [@var{option}@dots{}] [@var{name}]
+hostname [@var{option}@dots{}]
+hostname @var{name}
@end example
+@noindent
+where @var{name} is the name to be used by the running host.
+
+@section Command line options
+@anchor{hostname 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
+
+@example
+$ sysctl net.inet.icmp.maskrepl
+net.inet.icmp.maskrepl: 0
+@end 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.
-@item rename [@var{from}] [@var{to}]
-Rename the file from on the remote machine, to the file to.
+@item rename [@var{from}] [@var{to}]]
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.
