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
