Package: po4a Version: 0.25-1 Severity: normal Hello Martin,
I am supposed to use po4a for handling Debian menu manpages. To help with this process, I tried to normalize the original English manpage. However I am not completly happy with the result: I use po4a-normalize -f man 1) po4a-normalize replace - by \- even then this does not seem warranted. 2) po4a-normalize end every lines by a space. 3) po4a-normalize sometimes reformat paragraph in a less than optimal ways. 1. and 2. are problematic when reviewing what changes po4a-normalize did, though 2. can be mitigated by using diff -ub. 3. cause generated manpages to not be acceptable as master version. Please find the update-menus.1 manpage and compare with the po4a-normalize.output generated by po4a-normalize -f man update-menus.1 Cheers, -- Bill. <[EMAIL PROTECTED]> Imagine a large red swirl here. -- System Information: Debian Release: testing/unstable APT prefers unstable APT policy: (500, 'unstable') Architecture: i386 (i686) Shell: /bin/sh linked to /bin/bash Kernel: Linux 2.4.27 Locale: LANG=fr_FR, LC_CTYPE=fr_FR (charmap=ISO-8859-1) Versions of packages po4a depends on: ii gettext 0.14.5-2 GNU Internationalization utilities ii libsgmls-perl 1.03ii-31 Perl modules for processing SGML p ii perl 5.8.8-4 Larry Wall's Practical Extraction ii perl-modules 5.8.8-4 Core Perl modules ii sp 1.3.4-1.2.1-47 James Clark's SGML parsing tools Versions of packages po4a recommends: ii liblocale-gettext-perl 1.05-1 Using libc functions for internati pn libterm-readkey-perl <none> (no description available) ii libtext-wrapi18n-perl 0.06-4 internationalized substitute of Te -- no debconf information
.\" -*- nroff -*- .TH UPDATE-MENUS 1 "Debian Utilities" "DEBIAN" .SH NAME update-menus \- generate Debian menu system .SH SYNOPSIS .B update-menus [\-v] [\-d] [\-h|--help] [--version] [--menufilesdir <dir>] [--menumethod <method>] [--nodefaultdirs] [--stdout] .SH DESCRIPTION Before the advent of \fIupdate-menus\fP, when the system administrators installed a package onto a Debian system, they would need to edit various window manager configuration files to make the new program show up on, for example, fvwm's menus. The menus could easily become out of sync with what programs were actually available, with some menu items that didn't work, and other programs that lacked a menu entry. \fIupdate-menus\fP and Debian's menu package aim to solve this problem. .PP .I update-menus automatically generates menus of installed programs for window managers and other menu programs. It should be run whenever a .BR menufile (5) or menu-method file is changed. .I update-menus will be ran automatically when Debian packages that contain menu files are installed or removed from the system. .PP .I update-menus uses the package-supplied menu entry files (in /usr/share/menu) for its information about the menus (but this can be overruled by the system administrator/user, see below). If a menu entry file is executable, .I update-menus execute the menu entry file, and use its stdout to generate the menu database. .SH OPTIONS .IP "-v" Verbose output. Shows all arguments to the /etc/menu-methods programs. .IP "-d" Debug output. Generates loads of unintelligible output. .IP "-h, --help" Display usage help and exit. .IP "--menufilesdir <dir>" Adds directory <dir> to the list of directory to search for menu files in. .IP "--menumethod <method>" Process only the menu method <method> instead of all the menu methods found. .IP "--nodefaultdirs" Disables the search of menu entries in system menu directories. .IP "--remove" Remove the menus by calling the menu-methods with --remove. .IP "--stdout" Output the menu list in a format suitable as input for \fIinstall-menu\fP or a menu method file. .IP "--version" Output version information and exit. .SH CONFIGURATION There are several ways to tune the operation of update-menus: .PP .I per menu entry, in /etc/menu/$package .RS In these directory the system administrator or user can override the default menu files. (if a file /etc/menu/$package exists, than the corresponding /usr/share/menu/$package file isn't read any more). Users who want to override the system wide defaults put their files in ~/.menu. See also .BR menufile(5) .RE .I per window-manager in /etc/menu-methods/$wm .RS In these configuration files, one can tune generated system."$wm"rc files for each individual window manager. For example, one can specify that the wm should ignore any icons that the packages may supply, or set the default wrapper for text-only applications (usually, an xterm is started to run a text-only application like vi). Users who want to override the system wide defaults put their files in ~/.menu-methods. For more info, see /usr/share/doc/menu/html. .RE .I globally, in /etc/menu-methods/translate_menus .RS This file contains translations that will be performed for all menu entries and all window managers. You can specify things like: `All sections that start with "Apps/Games" should be mapped to "Games"', or `menuentryid "gnuplot" should have a title of "GnuTeken" (to translate titles into other languages)'. Look at the default /etc/menu-methods/translate_menus for an example. Users who want to override the system default translate file, put one in ~/.menu-methods/translate_menus. .BR Note: This should not be used for a full translation of the menu. Use po files as explained in the source package. .RE .I error report configuring, in /etc/menu-methods/menu.config .RS This file contains general information for the overall behaviour of update-menus. At the moment you can only configure how verbose the output of update-menus is, and where it sends the output. The amount of information is specified by `verbosity=VAL'. Use VAL=quiet to stop update-menu from reporting anything but the most important errors, VAL=normal, VAL=verbose, VAL=debug for progressively more output. To specify where the output should go, use `method=stdout', `method=stderr', or `method=syslog facility priority'. `Facility' is one of auth, authpriv, authcron, authdaemon, authkern, authlocal0, authlocal1, authlocal2, authlocal3, authlocal4, authlocal5, authlocal6, authlocal7, authlpr, authmail, authnews, authsyslog, authuser, authuucp. `priority' is one of emerg, alert, crit, err, warning, notice, info, debug. .RE .SH FILES Menu files: (Earlier listed directories override those listed later.) .RS .I ~/.menu/* .RS Menu files added by the user. (Isn't read if root runs update-menus) .RE .I /etc/menu/* .RS Menu files added by the system administrator. .RE .I /usr/lib/menu/* .RS Architecture-dependant menu files provided by other Debian packages. .RE .I /usr/share/menu/* .RS Architecture-independant menu files provided by other Debian packages. .RE .I /usr/share/menu/default/* .RS Menu files provided by the menu package. .RE .RE Menu methods: .RS .I /etc/menu-methods/ .RS Executable configuration files that are added by window managers and other menu programs, these files are run by .I update-menus to generate menus for the different programs. Also in this directory is the translate_menus file, used for local configuration of the shape of the menu trees. .RE .RE .RS .I ~/.menu-methods/ .RS For users to override the system-defaults of /etc/menu-methods. If this directory exists, no files in /etc/menu-methods are read any more. .RE .RE .SH DISTRIBUTION Distribution is subject to the GNU General Public License. .SH BUGS .I update-menus may not work properly when run by a normal user, to generate menus for that user. This is usually because the window manager doesn't expect the system."$wm"rc files in the directory (usually ~/."$wm", configurable in /etc/menu-methods). If you see such a thing, and you find a solution, please mail <[EMAIL PROTECTED]>. It should work OK for fvwm and fvwm2: I usually test the package first as an ordinary user. .PP .SH AUTHORS Joost Witteveen <[EMAIL PROTECTED]>, original idea by Lars Wirzenius <[EMAIL PROTECTED]>. Now maintained by Bill Allombert <[EMAIL PROTECTED]>. .SH THANKS To Joey Hess, for a lot of good ideas and pre-release testing, and to Tom Lees for a update-menus in pure C (of which I only used one function, but that's life). .PP Man page by Joey Hess, <[EMAIL PROTECTED]> .SH "SEE ALSO" .BR menufile (5), .BR /usr/share/doc/menu/html