summaryrefslogtreecommitdiff
path: root/src/lib/libremessages.1.ronn
diff options
context:
space:
mode:
authorLuke Shumaker <lukeshu@sbcglobal.net>2016-02-09 10:04:14 -0500
committerLuke Shumaker <lukeshu@sbcglobal.net>2016-02-09 10:04:14 -0500
commit73fa1967b241a0306b744026ea9223e1638b42d3 (patch)
tree8c9b1566c6233d4607089c9ac487d3a5cdde018d /src/lib/libremessages.1.ronn
parent46ec6d004ab3cd5f300a175d704e8cbfdcb1ac53 (diff)
The libremessages man page still listed not having librexgettext as a
bug. librexgettext exists now, so mention it.
Diffstat (limited to 'src/lib/libremessages.1.ronn')
-rw-r--r--src/lib/libremessages.1.ronn21
1 files changed, 14 insertions, 7 deletions
diff --git a/src/lib/libremessages.1.ronn b/src/lib/libremessages.1.ronn
index a8a6d21..9a976a8 100644
--- a/src/lib/libremessages.1.ronn
+++ b/src/lib/libremessages.1.ronn
@@ -87,6 +87,12 @@ word-wrapped prose.
For each of these, <MESSAGE> is fed through `gettext` automatically.
+To generate gettext `.pot` files for programs using these routines,
+plain `xgettext`(1) won't work because it doesn't know about
+word-wrapping. Instead, you should use the `librexgettext`(1) program
+which knows how do handle word-wrapping, and knows about each of these
+routines by default.
+
* `prose` <MESSAGE> [<ARGS>...]:
Takes a `printf`(1)-formatted string, collapses whitespace
(HTML-style), and then word-wraps it.
@@ -117,6 +123,11 @@ any arguments. Each of these print to stderr, not stdout.
For each of these, <MESSAGE> is fed through `gettext` automatically.
+To generate gettext `.pot` files for programs using these routines,
+plain `xgettext`(1) will work if given correct flags, but you'll find
+it easier to use `librexgettext`(1), which will handle each of these
+without any extra flags.
+
* `plain` <MESSAGE> [<ARGS>...]:
Prints a "plain" message in bold, indented with 4 spaces.
@@ -212,19 +223,15 @@ These routines relate to `makepkg`(8).
## BUGS
-Generating `.pot` files for the prose functions is a pain. The
-libretools Makefiles have rules to do it, but it might make sense to
-pull it into a separate program.
-
`term_title` currently only knows about the terminals screen, tmux,
xterm and rxvt (and their various <TERM> values;
"rxvt-unicode-256color" is still rxvt).
## SEE ALSO
-librelib(7), gettext(1), common.sh(3)
+librexgettext(1), librelib(7), gettext(1), common.sh(3)
Things that were mentioned:
-bash(1), exit(1), isatty(3), libretools.conf(5), makepkg(8),
-printf(1), signal(7)
+bash(1), xgettext(1), exit(1), isatty(3), libretools.conf(5),
+makepkg(8), printf(1), signal(7)