.\" Man page generated from reStructuredText.
.
.TH ISOQUERY 1 "2018-08-18" "3.2.3" ""
.SH NAME
isoquery \- Search and display various ISO codes (country, language, ...)
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SYNOPSIS
.sp
\fBisoquery\fP [\fIOPTION...\fP] [\fIISO codes\fP]
.SH DESCRIPTION
.sp
This manual page documents briefly the \fBisoquery\fP command.
It can be used to generate a tabular output of the ISO standard
codes provided by the package \fBiso\-codes\fP\&.
It parses the JSON files and shows all included ISO codes or just
matching entries, if specified on the command line.
Moreover, it\(aqs possible to get all available translations for
the ISO standard.
.SH OPTIONS
.sp
This program follows the usual GNU command line syntax, with long options
starting with two dashes (\(aq\fB\-\fP\(aq). \fBisoquery\fP supports the following options:
.INDENT 0.0
.TP
.BI \-i \ STANDARD\fP,\fB \ \-\-iso\fB= STANDARD
The ISO standard to use. Possible values: 639\-2,
639\-3, 639\-5, 3166\-1, 3166\-2, 3166\-3, 4217, 15924
(default: 3166\-1)
.TP
.BI \-p \ PATHNAME\fP,\fB \ \-\-pathname\fB= PATHNAME
Use \fIPATHNAME\fP as prefix for the data files
(default: /usr/share/iso\-codes/json)
.TP
.BI \-l \ LOCALE\fP,\fB \ \-\-locale\fB= LOCALE
Use this \fILOCALE\fP for output
.TP
.B \-n\fP,\fB  \-\-name
Name for the supplied codes (default)
.TP
.B \-o\fP,\fB  \-\-official_name
Official name for the supplied codes. This may be
the same as \-\-name (only applies to ISO 3166\-1)
.TP
.B \-c\fP,\fB  \-\-common_name
Common name for the supplied codes. This may be
the same as \-\-name (only applies to ISO 639\-2,
639\-3, and 3166\-1)
.TP
.B \-0\fP,\fB  \-\-null
Separate entries with a NULL character instead
of newline
.TP
.B \-h\fP,\fB  \-\-help
Show summary of options
.TP
.B \-v\fP,\fB  \-\-version
Show program version and copyright
.UNINDENT
.SH EXAMPLES
.sp
If called without any command line options, \fBisoquery\fP will put out a
table of all ISO 3166\-1 codes. The first three columns contain the alpha\-2 code,
the alpha\-3 code, and the numerical code assigned to the country listed
in the fourth column.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery
AF      AFG     004     Afghanistan
[...]
ZW      ZWE     716     Zimbabwe
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
If you need only some countries, you can specify any of the codes in
the first three columns to cut down the output.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery so nor 484
SO      SOM     706     Somalia
NO      NOR     578     Norway
MX      MEX     484     Mexico
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Should you need the translations of the countries\(aq names, just specify
in which \fILOCALE\fP you\(aqd like to see the output.
Please note that the original English name will be shown if there is no
translation available for the specified \fILOCALE\fP\&.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-locale=nl fr de es
FR      FRA     250     Frankrijk
DE      DEU     276     Duitsland
ES      ESP     724     Spanje
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
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 \fB\-\-iso\fP command
line option. The columns are ISO 3166\-2 code, subset type (e.g. State, Province,
etc.), parent, and name. The third column
(parent) may be empty.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=3166\-2
AD\-02   Parish          Canillo
[...]
ZW\-MW   Province        Mashonaland West
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
Codes which have been deleted from ISO 3166\-1 are available in ISO 3166\-3.
The columns are alpha\-3 code, alpha\-4 code, numeric code, comment,
withdrawal date, and name. The columns for numeric code, comment, and
withdrawal date may be empty.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=3166\-3
AFI     AIDJ    262             1977    French Afars and Issas
ANT     ANHH    532             1993\-07\-12      Netherlands Antilles
[...]
YUG     YUCS    891             1993\-07\-28      Yugoslavia, Socialist Federal Republic of
ZAR     ZRCD    180             1997\-07\-14      Zaire, Republic of
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
For ISO 639\-2, the first three columns are the alpha\-3 code, the
bibliographic code, and the alpha\-2 code. The second and third columns
may be empty.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=639\-2
aar             aa      Afar
abk             ab      Abkhazian
ace                     Achinese
[...]
zun                     Zuni
zxx                     No linguistic content; Not applicable
zza                     Zaza; Dimili; Dimli; Kirdki; Kirmanjki; Zazaki
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
You can trim down the results by specifying only some codes. Moreover,
the option to get translated names is also available.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=639\-2 \-\-locale=pt vi bo kl
vie             vi      Vietnamita
bod     tib     bo      tibetano
kal             kl      Kalaallisut; Greenlandic
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
If you want to use ISO 639\-3, the displayed columns are alpha\-3, scope, type,
alpha\-2, bibliographic, and the language name. Both alpha\-2 and bibliographic
may be empty.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-i 639\-3 aal new spa guc
aal     I       L                       Afade
new     I       L                       Newari
spa     I       L       es              Spanish
guc     I       L                       Wayuu
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
ISO 639\-5 is also available. The displayed columns are alpha\-3 and name.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-i 639\-5 aus tut
aus     Australian languages
tut     Altaic languages
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
You can get selected translations of currency names from the ISO 4217
standard by using the following command. The first two columns are the
alpha\-3 code and the numerical code assigned to the currency.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=4217 \-\-locale=da cad 392
CAD     124     Canadisk dollar
JPY     392     Yen
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
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
assigned to the script.
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
$ isoquery \-\-iso=15924 jpan latn 280
Jpan    413     Japanese (alias for Han + Hiragana + Katakana)
Latn    215     Latin
Visp    280     Visible Speech
.ft P
.fi
.UNINDENT
.UNINDENT
.SH FILES
.sp
By default, the JSON files provided by the \fBiso\-codes\fP package will be used.
.nf
\fI/usr/share/iso\-codes/json/iso_639\-2.json\fP
\fI/usr/share/iso\-codes/json/iso_639\-3.json\fP
\fI/usr/share/iso\-codes/json/iso_639\-5.json\fP
\fI/usr/share/iso\-codes/json/iso_3166\-1.json\fP
\fI/usr/share/iso\-codes/json/iso_3166\-2.json\fP
\fI/usr/share/iso\-codes/json/iso_3166\-3.json\fP
\fI/usr/share/iso\-codes/json/iso_4217.json\fP
\fI/usr/share/iso\-codes/json/iso_15924.json\fP
.fi
.sp
.SH AUTHOR
.sp
Dr. Tobias Quathamer <\fI\%toddy@debian.org\fP>
.\" Generated by docutils manpage writer.
.