2016-03-16 23:06:34 +00:00
|
|
|
.\" #
|
|
|
|
.\" # Copyright (c) 2015, Juniper Networks, Inc.
|
|
|
|
.\" # All rights reserved.
|
|
|
|
.\" # This SOFTWARE is licensed under the LICENSE provided in the
|
|
|
|
.\" # ../Copyright file. By downloading, installing, copying, or
|
|
|
|
.\" # using the SOFTWARE, you agree to be bound by the terms of that
|
|
|
|
.\" # LICENSE.
|
|
|
|
.\" # Phil Shafer, July 2015
|
|
|
|
.\"
|
|
|
|
.Dd July 9, 2015
|
|
|
|
.Dt XOPO 1
|
|
|
|
.Os
|
|
|
|
.Sh NAME
|
|
|
|
.Nm xopo
|
|
|
|
.Nd turn libxo format strings into simplified form
|
|
|
|
.Sh SYNOPSIS
|
|
|
|
.Nm
|
|
|
|
.Op Fl options
|
|
|
|
.Sh DESCRIPTION
|
|
|
|
The
|
|
|
|
.Nm
|
|
|
|
utility simplifies libxo format strings into the form used for
|
|
|
|
.Xr gettext
|
|
|
|
lookups by the
|
|
|
|
.Nm libxo
|
|
|
|
library.
|
|
|
|
Using
|
|
|
|
.Nm ,
|
|
|
|
users can turn
|
|
|
|
.Em .pot
|
|
|
|
files generated by
|
|
|
|
.Xr xgettext
|
|
|
|
into data useful for libxo-enabled applications.
|
|
|
|
.Pp
|
|
|
|
Since
|
|
|
|
.Xr gettext
|
|
|
|
uses the string as the key into the message catalog,
|
|
|
|
.Nm libxo
|
|
|
|
uses a simplified version of the format string that removes
|
|
|
|
unimportant field formatting and modifiers, stopping minor formatting
|
|
|
|
changes from impacting the expensive translation process.
|
|
|
|
A developer
|
|
|
|
change such as changing "/%06d" to "/%08d" should not force hand
|
|
|
|
inspection of all .po files.
|
|
|
|
.Pp
|
|
|
|
.Nm
|
|
|
|
inspects the input file, looking for lines that begin with "msgid"
|
|
|
|
which carry format strings as the remainder of the input line.
|
|
|
|
These strings are passed to
|
|
|
|
.Nm libxo
|
|
|
|
for simplification and the resulting strings are replaced into the
|
|
|
|
output stream, allowing
|
|
|
|
.Nm
|
|
|
|
to operated as a filter.
|
|
|
|
.Pp
|
2017-06-08 12:58:33 +00:00
|
|
|
.Bl -tag -width indent
|
|
|
|
.It Ic -f Ar pofile | Ic --po Ar pofile
|
2016-03-16 23:06:34 +00:00
|
|
|
Use the given po file for input.
|
2017-06-08 12:58:33 +00:00
|
|
|
.It Ic --help
|
2016-03-16 23:06:34 +00:00
|
|
|
Display this help text
|
2017-06-08 12:58:33 +00:00
|
|
|
.It Ic -o Ar file | Ic --output Ar file
|
2016-03-16 23:06:34 +00:00
|
|
|
Write output content to the given file
|
2017-06-08 12:58:33 +00:00
|
|
|
.It Ic -s Ar text | Ic --simplify Ar text
|
|
|
|
Generate the simplified version of a single text string.
|
|
|
|
.It Ic -W | Ic --warn
|
2016-03-16 23:06:34 +00:00
|
|
|
Generate warnings while parsing the format strings
|
2017-06-08 12:58:33 +00:00
|
|
|
.It Ic --version
|
2016-03-16 23:06:34 +00:00
|
|
|
Display version information
|
|
|
|
.El
|
|
|
|
.Pp
|
|
|
|
.Sh EXAMPLE
|
|
|
|
.Bd -literal
|
|
|
|
% xopo -f foo.pot -o foo.pot.new
|
|
|
|
.Ed
|
|
|
|
.Sh SEE ALSO
|
|
|
|
.Xr libxo 3 ,
|
|
|
|
.Xr xo_format 5
|
2017-08-03 15:43:14 +00:00
|
|
|
.Sh HISTORY
|
|
|
|
The
|
|
|
|
.Nm libxo
|
|
|
|
library first appeared in
|
|
|
|
.Fx 11.0 .
|
|
|
|
.Sh AUTHORS
|
|
|
|
.Nm libxo
|
|
|
|
was written by
|
|
|
|
.An Phil Shafer Aq Mt phil@freebsd.org .
|
|
|
|
|