Package: hostname
Version: 3.10
Severity: wishlist

I'm suggestion following minor updates:

- Output cmd line help in alhabetical order
- Simplify SYNOPSIS. The options are best explained in OPTTIONS sections.
- Mirror *.1.fr to that of *.1 for SYNOPSIS.

-- System Information:
Debian Release: wheezy/sid
  APT prefers unstable
  APT policy: (500, 'unstable')
Architecture: i386 (i686)

Kernel: Linux 3.2.0-1-686-pae (SMP w/1 CPU core)
Locale: LANG=en_US.UTF-8, LC_CTYPE=en_US.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash

Versions of packages hostname depends on:
ii  libc6  2.13-26

hostname recommends no packages.

hostname suggests no packages.

-- no debconf information
>From ce084cf248dd5a937a3f08f33addcdd861ccd548 Mon Sep 17 00:00:00 2001
From: Jari Aalto <[email protected]>
Date: Thu, 16 Feb 2012 02:48:28 -0500
Subject: [PATCH 2/3] hostname.1: Simplify SYNOPSIS
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit


Signed-off-by: Jari Aalto <[email protected]>
---
 hostname.1 |   32 +++++---------------------------
 1 files changed, 5 insertions(+), 27 deletions(-)

diff --git a/hostname.1 b/hostname.1
index c80dbd3..a3d03f9 100644
--- a/hostname.1
+++ b/hostname.1
@@ -14,40 +14,18 @@ dnsdomainname \- show the system's DNS domain name
 
 .SH SYNOPSIS
 .B hostname
-.RB [ \-v ]
-.RB [ \-a ]
-.RB [ \-\-alias ]
-.RB [ \-d ]
-.RB [ \-\-domain ]
-.RB [ \-f ]
-.RB [ \-\-fqdn ]
-.RB [ \-A ]
-.RB [ \-\-all-fqdns ]
-.RB [ \-i ]
-.RB [ \-\-ip-address ]
-.RB [ \-I ]
-.RB [ \-\-all-ip-addresses ]
-.RB [ \-\-long ]
-.RB [ \-s ]
-.RB [ \-\-short ]
-.RB [ \-y ]
-.RB [ \-\-yp ]
-.RB [ \-\-nis ]
+.RB [ options ]
 .br
 .B hostname
 .RB [ \-v ]
-.RB [ \-b ]
-.RB [ \-\-boot ]
-.RB [ \-F\ filename ]
-.RB [ \-\-file\ filename ]
+.RB [ \-b|\-\-boot ]
+.RB [ \-F|--file\ filename ]
 .RB [ hostname ]
 .br
 .B hostname
 .RB [ \-v ]
-.RB [ \-h ]
-.RB [ \-\-help ]
-.RB [ \-V ]
-.RB [ \-\-version ]
+.RB [ \-h|\-\-help ]
+.RB [ \-V|\-\-version ]
 .PP
 .B domainname
 .RB [ nisdomain ]
-- 
1.7.9

>From c3cf1aec19bc038e8460695a59bea111a5abf926 Mon Sep 17 00:00:00 2001
From: Jari Aalto <[email protected]>
Date: Thu, 16 Feb 2012 02:44:43 -0500
Subject: [PATCH 1/3] hostname.c: (usage): Order items alphabetically
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit


Signed-off-by: Jari Aalto <[email protected]>
---
 hostname.c |   16 ++++++++--------
 1 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/hostname.c b/hostname.c
index 3ff164a..36f4878 100644
--- a/hostname.c
+++ b/hostname.c
@@ -3,7 +3,7 @@
  *		that maintains the host name and the domain name. It
  *		is also used to show the FQDN and the IP-Addresses.
  *
- * Usage:	hostname [-d|-f|-s|-a|-i|-y|-A|-I]
+ * Usage:	hostname [-a|-A|-d|-f|-i|-I|-s|-y]
  *		hostname [-h|-V]
  *		hostname [-b] {name|-F file}
  *		dnsdomainname
@@ -147,7 +147,7 @@ usage(FILE *stream)
 {
 	fprintf(stream,
 		"Usage: hostname [-v] [-b] {hostname|-F file}         set host name (from file)\n"
-		"       hostname [-v] [-d|-f|-s|-a|-i|-y|-A|-I]             display formatted name\n"
+		"       hostname [-v] [-a|-A|-d|-f|-i|-I|-s|-y]       display formatted name\n"
 		"       hostname [-v]                                 display host name\n"
 		"\n"
 		"       {yp,nis,}domainname [-v] {nisdomain|-F file}  set NIS domain name (from file)\n"
@@ -162,16 +162,16 @@ usage(FILE *stream)
 		"       dnsdomainname=hostname -d\n"
 		"\n"
 		"Program options:\n"
-		"    -s, --short            short host name\n"
 		"    -a, --alias            alias names\n"
-		"    -i, --ip-address       addresses for the host name\n"
-		"    -I, --all-ip-addresses all addresses for the host\n"
-		"    -f, --fqdn, --long     long host name (FQDN)\n"
 		"    -A, --all-fqdns        all long host names (FQDNs)\n"
-		"    -d, --domain           DNS domain name\n"
-		"    -y, --yp, --nis        NIS/YP domain name\n"
 		"    -b, --boot             set default hostname if none available\n"
+		"    -d, --domain           DNS domain name\n"
+		"    -f, --fqdn, --long     long host name (FQDN)\n"
 		"    -F, --file             read host name or NIS domain name from given file\n"
+		"    -i, --ip-address       addresses for the host name\n"
+		"    -I, --all-ip-addresses all addresses for the host\n"
+		"    -s, --short            short host name\n"
+		"    -y, --yp, --nis        NIS/YP domain name\n"
 		"\n"
 		"Description:\n"
 		"   This command can get or set the host name or the NIS domain name. You can\n"
-- 
1.7.9

>From 1c7a188dcb443345f28a8f9bb9c9713d9e81cb06 Mon Sep 17 00:00:00 2001
From: Jari Aalto <[email protected]>
Date: Thu, 16 Feb 2012 02:54:23 -0500
Subject: [PATCH 3/3] hostname.1.fr: Simplify SYNOPSIS. Sync with *.1 page
Organization: Private
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 8bit


Signed-off-by: Jari Aalto <[email protected]>
---
 hostname.1.fr |   22 ++++++++++------------
 1 files changed, 10 insertions(+), 12 deletions(-)

diff --git a/hostname.1.fr b/hostname.1.fr
index da31f87..58b799a 100644
--- a/hostname.1.fr
+++ b/hostname.1.fr
@@ -5,21 +5,19 @@ hostname \- affiche ou d
 dnsdomainname \- affiche le nom de domaine du système
 .SH SYNOPSIS
 .B hostname
-.RB [ \-d ]
-.RB [ \-\-domain ]
-.RB [ \-F\ nom_de_fichier ]
-.RB [ \-\-file\ nom_de_fichier ]
-.RB [ \-f ]
-.RB [ \-\-fqdn ]
-.RB [ \-h ]
-.RB [ \-\-help ]
-.RB [ \-\-long ]
-.RB [ \-s ]
-.RB [ \-\-short ]
+.RB [ options ]
+.br
+.B hostname
 .RB [ \-v ]
-.RB [ \-\-version ]
+.RB [ \-b|\-\-boot ]
+.RB [ \-F|\-\-file\ nom_de_fichier ]
 .RB [ nom ]
 .br
+.B hostname
+.RB [ \-v ]
+.RB [ \-h|\-\-help ]
+.RB [ \-V|\-\-version ]
+.PP
 .B dnsdomainname
 .SH DESCRIPTION
 .B Hostname
-- 
1.7.9

Reply via email to