Package: isoquery
Version: 1.4-1
Severity: minor
Tags: patch
Hi Tobias,
While translating isoquery(1) to French, I noticed a few details that
could be fixed in the manpage.
Regards
David
-- System Information:
Debian Release: wheezy/sid
APT prefers unstable
APT policy: (600, 'unstable'), (500, 'oldstable'), (500, 'stable'), (150,
'experimental')
Architecture: amd64 (x86_64)
Kernel: Linux 2.6.39-1-amd64 (SMP w/1 CPU core)
Locale: LANG=fr_FR.UTF-8, LC_CTYPE=fr_FR.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Versions of packages isoquery depends on:
ii python 2.6.6-14 interactive high-level object-orie
ii python-lxml 2.3-0.1+b2 pythonic binding for the libxml2 a
ii python-support 1.0.13 automated rebuilding support for P
Versions of packages isoquery recommends:
ii iso-codes 3.25.1-1 ISO language, territory, currency,
isoquery suggests no packages.
-- no debconf information
>From 093c5eb768ecadfbe680388f9a85a0ec12b71cd9 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?David=20Pr=C3=A9vot?= <da...@tilapin.org>
Date: Sat, 21 May 2011 16:08:54 -0400
Subject: [PATCH] isoquery(1) review
---
man/isoquery.rst | 36 ++++++++++++++++++------------------
1 files changed, 18 insertions(+), 18 deletions(-)
diff --git a/man/isoquery.rst b/man/isoquery.rst
index 24729e0..8aa9bea 100644
--- a/man/isoquery.rst
+++ b/man/isoquery.rst
@@ -21,7 +21,7 @@ DESCRIPTION
This manual page documents briefly the **isoquery** command.
It can be used to generate a tabular output of the ISO standard
-codes provided by the package iso-codes.
+codes provided by the package **iso-codes**.
It parses the XML files and shows all included ISO codes or just
matching entries, if specified on the command line.
Moreover, it's possible to get all available translations for
@@ -32,23 +32,23 @@ OPTIONS
=======
This program follows the usual GNU command line syntax, with long options
-starting with two dashes ('-'). **isoquery** supports the following options:
+starting with two dashes ('**-**'). **isoquery** supports the following
options:
--i NUMBER, --iso=NUMBER The ISO standard to use. Possible values: 639,
- 639-3, 3166, 3166-2, 4217, 15924 (default: 3166)
+-i number, --iso=number The ISO standard to use. Possible values: 639,
+ 639-3, 3166, 3166-2, 4217, 15924 (default: 3166).
--x FILE, --xmlfile=FILE Use another XML file with ISO data.
- (default: /usr/share/xml/iso-codes/iso_3166.xml)
+-x file, --xmlfile=file Use another XML *file* with ISO data
+ (default: /usr/share/xml/iso-codes/iso_3166.xml).
--l LOCALE, --locale=LOCALE Use this locale for output.
+-l locale, --locale=locale Use this *locale* for output.
--n, --name Name for the supplied codes (default)
+-n, --name Name for the supplied codes (default).
-o, --official_name Official name for the supplied codes. This may be
- the same as --name. (Only applies to ISO 3166)
+ the same as --name (only applies to ISO 3166).
-c, --common_name Common name for the supplied codes. This may be
- the same as --name. (Only applies to ISO 3166)
+ the same as --name (only applies to ISO 3166).
-0, --null Separate entries with a NULL character instead
of newline.
@@ -84,9 +84,9 @@ the first three columns to cut down the output.
MX MEX 484 Mexico
Should you need the translations of the countries' names, just specify
-in which locale you'd like to see the output.
+in which *locale* you'd like to see the output.
Please note that the original English name will be shown if there is no
-translation available for the specified locale.
+translation available for the specified *locale*.
::
@@ -96,9 +96,9 @@ translation available for the specified locale.
ES ESP 724 Spanje
All of the above works for different ISO standards as well, so you can
-switch to the more extensive standard ISO 3166-2 by using the --iso command
+switch to the more extensive standard ISO 3166-2 by using the **--iso** command
line option. The columns are country code, subset type (e.g. State, Province,
-etc.), ISO 3166-2 code, parent, and name. Please note that the fourth column
+etc.), ISO 3166-2 code, parent, and name. The fourth column
(parent) may be empty.
::
@@ -119,8 +119,8 @@ ISO 639 2T code and the ISO 639-1 code. The third column
may be empty.
ace ace Achinese
[...]
zun zun Zuni
- zxx zxx No linguistic content
- zza zza Zaza; Dimili; Dimli; Kirdki
+ zxx zxx No linguistic content; Not applicable
+ zza zza Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki
You can trim down the results by specifying only some codes. Moreover,
the option to get translated names is also available.
@@ -152,7 +152,7 @@ alpha-3 code and the numerical code assigned to the
currency.
$ isoquery --iso=4217 --locale=da cad 392
CAD 124 Canadisk dollar
- JPY 392 Japansk yen
+ JPY 392 Yen
If you need to get script names, you can use the ISO 15924 table.
The first two columns are the alpha-4 code and the numerical code
@@ -169,7 +169,7 @@ assigned to the script.
FILES
=====
-By default, the XML files provided by the iso-codes package will be used.
+By default, the XML files provided by the **iso-codes** package will be used.
| */usr/share/xml/iso-codes/iso_639.xml*
| */usr/share/xml/iso-codes/iso_639_3.xml*
--
1.7.5.1
