diff options
| -rw-r--r-- | src/lib/libremessages.1.ronn | 21 |
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) |