summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-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)