Package: hostname Version: 3.20 Severity: minor Tags: patch Dear Maintainer,
* What led up to the situation? Warnings from "groff": <hostname.1>:65 (macro BR): only 1 argument, but more are expected <hostname.1>:69 (macro BR): only 1 argument, but more are expected <hostname.1>:71 (macro BR): only 1 argument, but more are expected <hostname.1>:78 (macro BR): only 1 argument, but more are expected <hostname.1>:87 (macro BR): only 1 argument, but more are expected <hostname.1>:91 (macro BR): only 1 argument, but more are expected <hostname.1>:92 (macro BR): only 1 argument, but more are expected <hostname.1>:94 (macro BR): only 1 argument, but more are expected <hostname.1>:157 (macro BR): only 1 argument, but more are expected <hostname.1>:160 (macro BR): only 1 argument, but more are expected <hostname.1>:200 (macro BR): only 1 argument, but more are expected <hostname.1>:210 (macro BR): only 1 argument, but more are expected Output is from: test-groff -b -e -mandoc -T utf8 -rF0 -t -w w -z [ "test-groff" is a developmental version of "groff" ] ### Summary: Change a two-fonts macro to an one-font macro for a single argument. Change a HYPHEN-MINUS (code 0x55, 2D) to a dash (minus, \-) if it matches " -[:alpha:]" or \(aq-[:alpha:] (for options) Fix spelling of "existant" Remove superfluous quotation marks (") around the argument for the one-font macro "B". Details: Input file is hostname.1 Test nr. 25: Change a HYPHEN-MINUS (code 0x55, 2D) to a minus (\-), if in front of a name for an option. 179:Always set a hostname; this allows the file specified by \fI-F\fR to be 216:link-local addresses are omitted. Contrary to option \fI-i\fR, this option ##### The patch is in the attachment. -- System Information: Debian Release: buster/sid APT prefers stable-updates APT policy: (500, 'stable-updates'), (500, 'proposed-updates'), (500, 'testing'), (500, 'stable') Architecture: amd64 (x86_64) Kernel: Linux 4.9.88-1-u1 (SMP w/2 CPU cores) Locale: LANG=is_IS.iso88591, LC_CTYPE=is_IS.iso88591 (charmap=ISO-8859-1), LANGUAGE=is_IS.iso88591 (charmap=ISO-8859-1) Shell: /bin/sh linked to /bin/dash Init: sysvinit (via /sbin/init) Versions of packages hostname depends on: ii libc6 2.27-3 hostname recommends no packages. hostname suggests no packages. -- no debconf information -- Bjarni I. Gislason
--- hostname.1 2018-01-31 12:08:15.000000000 +0000 +++ hostname.1.new 2018-06-05 00:23:00.000000000 +0000 @@ -62,36 +62,36 @@ function. .LP .B domainname will print the NIS domainname of the system. -.BR domainname +.B domainname uses the .BR gethostname (2) function, while -.BR ypdomainname +.B ypdomainname and -.BR nisdomainname +.B nisdomainname use the .BR getdomainname (2). .LP .B dnsdomainname will print the domain part of the FQDN (Fully Qualified Domain Name). The complete FQDN of the system is returned with -.BR "hostname \-\-fqdn" +.B hostname \-\-fqdn (but see the warnings in section -.B "THE FQDN" +.B THE FQDN below). .SS "SET NAME" When called with one argument or with the .B \-\-file option, the commands set the host name or the NIS/YP domain name. -.BR hostname +.B hostname uses the .BR sethostname (2) function, while all of the three -.BR domainname, -.BR ypdomainname +.BR domainname , +.B ypdomainname and -.BR nisdomainname +.B nisdomainname use .BR setdomainname (2). Note, that this is effective only until the next reboot. @@ -102,7 +102,7 @@ Note, that only the super-user can chang It is not possible to set the FQDN or the DNS domain name with the .B dnsdomainname command (see -.B "THE FQDN" +.B THE FQDN below). .LP The host name is usually set once at system startup in @@ -118,7 +118,7 @@ returns for the host name, such as, .IR ursula.example.com . It is usually the hostname followed by the DNS domain name (the part after the first dot). You can check the FQDN using -.B "hostname \-\-fqdn" +.B hostname \-\-fqdn or the domain name using .BR "dnsdomainname" . .LP @@ -154,10 +154,10 @@ If a machine has multiple network interf mobile environment, then it may either have multiple FQDNs/domain names or none at all. Therefore avoid using .BR "hostname \-\-fqdn" , -.BR "hostname \-\-domain" +.B hostname \-\-domain and .BR "dnsdomainname" . -.BR "hostname \-\-ip-address" +.B hostname \-\-ip-address is subject to the same limitations so it should be avoided as well. .SH OPTIONS @@ -176,8 +176,8 @@ contain duplicate entries. Do not make a output. .TP .I "\-b, \-\-boot" -Always set a hostname; this allows the file specified by \fI-F\fR to be -non-existant or empty, in which case the default hostname \fIlocalhost\fR +Always set a hostname; this allows the file specified by \fI\-F\fR to be +non-existent or empty, in which case the default hostname \fIlocalhost\fR will be used if none is yet set. .TP .I "\-d, \-\-domain" @@ -187,7 +187,7 @@ to get the DNS domain name because it wi not the DNS domain name. Use .B dnsdomainname instead. See the warnings in section -.B "THE FQDN" +.B THE FQDN above, and avoid using this option. .TP .I "\-f, \-\-fqdn, \-\-long" @@ -195,9 +195,9 @@ Display the FQDN (Fully Qualified Domain short host name and the DNS domain name. Unless you are using bind or NIS for host lookups you can change the FQDN and the DNS domain name (which is part of the FQDN) in the \fI/etc/hosts\fR file. See the warnings in section -.B "THE FQDN" +.B THE FQDN above und use -.BR "hostname \-\-all-fqdns" +.B hostname \-\-all-fqdns instead wherever possible. .TP .I "\-F, \-\-file filename" @@ -207,13 +207,13 @@ a `#') are ignored. .I "\-i, \-\-ip-address" Display the network address(es) of the host name. Note that this works only if the host name can be resolved. Avoid using this option; use -.BR "hostname \-\-all-ip-addresses" +.B hostname \-\-all-ip-addresses instead. .TP .I "\-I, \-\-all-ip-addresses" Display all network addresses of the host. This option enumerates all configured addresses on all network interfaces. The loopback interface and IPv6 -link-local addresses are omitted. Contrary to option \fI-i\fR, this option +link-local addresses are omitted. Contrary to option \fI\-i\fR, this option does not depend on name resolution. Do not make any assumptions about the order of the output. .TP