Debian Bug report logs - #29448
man-db: No databases for non-English man hierarchies

Toggle useless messages

Message #5 received at submit@bugs.debian.org (full text, mbox, reply):

From: Marco Budde <budde@tu-harburg.de>

To: submit@bugs.debian.org

Subject: apropos & $LANG

Date: Sat, 14 Nov 1998 16:08:20 MET

Package: man-db
Version: 2.3.10-65

Moin Moin!

There's a problem with the $LANG support of apropos & Co.
The program displays always the description in English.


cu, Marco

Message #14 received at 29448@bugs.debian.org (full text, mbox, reply):

From: Colin Watson <cjwatson@debian.org>

To: Marco Budde <budde@tu-harburg.de>

Cc: 29448@bugs.debian.org, control@bugs.debian.org

Subject: Re: apropos & $LANG

Date: Mon, 3 Sep 2007 13:31:51 +0100

tags 29448 fixed-upstream
thanks

On Sat, Nov 14, 1998 at 04:08:20PM +0100, Marco Budde wrote:
> There's a problem with the $LANG support of apropos & Co.
> The program displays always the description in English.

I've now finally implemented this upstream; support will be in man-db
2.5.0.

Mon Sep  3 11:38:11 BST 2007  Colin Watson  <cjwatson@debian.org>

        Create and use databases for non-English manual hierarchies (Debian
        bug #29448). Extensive changes elsewhere to support this by means of
        better UTF-8 handling and knowledge of more languages.

        * src/check_mandirs.c (make_database_directory): New function.
          (create_db, update_db): Use it.
          (purge_missing): Check that the database exists before starting.
        * src/mandb.c (process_manpath): New function, split out from main.
          Make the single_filename check aware that the file might be in a
          per-locale subdirectory that we aren't processing right now.
          (main): Use it. Move man_owner, purged, and strays to file scope.
          Build databases for all per-locale subdirectories.
        * src/straycats.c (straycats): Constify manpath argument.
        * src/whatis.c (main): Sync locale handling with src/man.c, in order
          to look up per-locale databases correctly. Based on a patch by
          Nicolas François (Debian bug #281811).
        * include/manconfig.h.in (straycats): Update prototype.

        * src/man.c (duplicate_candidates): New function to determine
          whether candidates are substantially duplicated, and if so in
          which direction. The logic is better than before: it now knows how
          to compare locales and pick the best available candidate for each
          language, and prefers UTF-8 candidates if everything else is
          equal.
          (add_candidate): Move duplication logic to duplicate_candidates.
          Adjust insertion handling so that we can drop old candidates in
          favour of new candidates.
        * src/manp.c (check_and_give): Remove.
          (unpack_locale_bits): New function, inspired by _nl_explode_name
          in libintl.
          (free_locale_bits): New function.
          (add_nls_manpath): Instead of trying individual directories (which
          doesn't work so well with character set aliasing), iterate over
          all subdirectories of each manpath entry and add all those
          matching the current locale's language and (if specified)
          territory. This now includes ll.CODESET as well as more
          conventional locale names.
        * src/manp.h: Declare 'struct locale_bits'. Prototype
          unpack_locale_bits and free_locale_bits.

        * src/man.c (lang_dir): Move to ...
        * src/util.c (lang_dir): ... here.
        * src/lexgrog.l (long_options, args, main): New -E/--encoding
          option.
          (usage): Document it.
          (cs_name, hu_name, ja_name, ru_name): Recode to UTF-8.
          (find_name): Add encoding argument. Guess the page's encoding from
          its filesystem location (or use encoding if supplied), and add an
          iconv command to recode it to UTF-8.
        * man/man1/lexgrog.man1 (SYNOPSIS, OPTIONS): Document --encoding.
        * src/straycats.c (check_for_stray): Guess the page's encoding from
          its filesystem location, and add an iconv command to recode it to
          UTF-8.
        * src/whatis.c (simple_convert): New function to simplify iconv
          handling.
          (display): Convert output from UTF-8 to locale charset.
          (main): Initialise iconv descriptor.
        * include/manconfig.h.in (find_name): Update prototype.
          (lang_dir): Add prototype.
        * configure.ac: Call AM_ICONV.
        * src/Makefile.in (mandb, lexgrog): Add encodings.o.
        * src/Makefile.in (whatis, apropos): Add encodings.o and
          $(LIBICONV).

        * src/encodings.c (directory_table): Add Serbian -> ISO-8859-5.
        * src/lexgrog.l (cs_name, hu_name): Expand character classes
          containing non-ASCII characters into the form (a|b|...); flex
          doesn't understand Unicode well enough to deal with them
          otherwise.
          (cs_name, ru_name): Add more possible translations.
          (ko_name, sk_name, sr_name, tr_name, zh_CN_name, zh_TW_name): Add.
          (find_name_decompressed): Ignore exit status from decompressor
          pipeline; iconv may exit non-zero on misencoded pages, but if we
          manage to extract a whatis from it anyway then it doesn't really
          matter.

        * src/whatis.c (usage): Document -L/--locale.
        * man/man1/apropos.man1 (SYNOPSIS, OPTIONS): Likewise.
        * man/man1/whatis.man1 (SYNOPSIS, OPTIONS): Likewise.

        * docs/NEWS: Document this.

Regards,

-- 
Colin Watson                                       [cjwatson@debian.org]

Message #21 received at 29448-close@bugs.debian.org (full text, mbox, reply):

From: Colin Watson <cjwatson@debian.org>

To: 29448-close@bugs.debian.org

Subject: Bug#29448: fixed in man-db 2.5.0-1

Date: Sun, 07 Oct 2007 20:47:18 +0000

Source: man-db
Source-Version: 2.5.0-1

We believe that the bug you reported is fixed in the latest version of
man-db, which is due to be installed in the Debian FTP archive:

man-db_2.5.0-1.diff.gz
  to pool/main/m/man-db/man-db_2.5.0-1.diff.gz
man-db_2.5.0-1.dsc
  to pool/main/m/man-db/man-db_2.5.0-1.dsc
man-db_2.5.0-1_i386.deb
  to pool/main/m/man-db/man-db_2.5.0-1_i386.deb
man-db_2.5.0.orig.tar.gz
  to pool/main/m/man-db/man-db_2.5.0.orig.tar.gz



A summary of the changes between this version and the previous one is
attached.

Thank you for reporting the bug, which will now be closed.  If you
have further comments please address them to 29448@bugs.debian.org,
and the maintainer will reopen the bug report if appropriate.

Debian distribution maintenance software
pp.
Colin Watson <cjwatson@debian.org> (supplier of updated man-db package)

(This message was generated automatically at their request; if you
believe that there is a problem with it please contact the archive
administrators by mailing ftpmaster@debian.org)


-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Format: 1.7
Date: Sun, 07 Oct 2007 20:38:25 +0100
Source: man-db
Binary: man-db
Architecture: source i386
Version: 2.5.0-1
Distribution: unstable
Urgency: low
Maintainer: Colin Watson <cjwatson@debian.org>
Changed-By: Colin Watson <cjwatson@debian.org>
Description: 
 man-db     - on-line manual pager
Closes: 18452 29448 165499 196642 259338 259340 281811 320108 334280 340673 348008 372939 378428 385651 391977 411220 411721 413349 421481 421481 430635 444187
Changes: 
 man-db (2.5.0-1) unstable; urgency=low
 .
   * New upstream release.
     - Remove /usr/X11R6/man from MANDATORY_MANPATH (closes: #413349).
     - man now supports the MANPAGER environment variable, overriding PAGER.
     - Resolve ambiguous error message when asking for a nonexistent manual
       page that might also be a section name (closes: #421481).
     - MANSEC -> MANSECT in German man(1) and catman(8) (closes: #430635).
     - Truncate apropos/whatis output to the terminal width by default
       (closes: #411721).
     - lexgrog now ignores alleged manual page names containing spaces, as
       these usually indicate parsing errors or ill-formed NAME sections and
       they clutter up apropos output badly.
     - Discard stderr from formatting processes when outputting to a pager,
       to avoid visual corruption from any error messages (closes: #372939).
     - Disallow sectional extensions of alphabetic sections, e.g. n and l
       from the default configuration (closes: #391977), and sectional
       extensions beginning with a digit (closes: #421481).
     - Suppress warnings in --quiet mode (closes: #348008, #378428, #411220;
       also closes: #334280 since that suggestion is no longer relevant).
     - If MAN_KEEP_FORMATTING is set in the environment, don't strip
       formatting characters with col (closes: #340673).
     - Implement and use a decompression library. This allows cat pages to be
       saved in the background while the pager is active (closes: #18452) and
       operation with a read-only /tmp (closes: #165499).
     - Add a configuration file flag (NOCACHE) to disable cat page caching
       (closes: #196642).
     - Add output keys to a hashtable, and skip any that have already been
       seen (closes: #259338).
     - Execute system utilities by command name rather than by full path
       (closes: #385651).
     - Add apropos -a/--and option to display only items matching all
       keywords (closes: #259340).
     - Adjust Finnish translation of "No manual entry for %s"
       (closes: #320108).
     - Create and use databases for non-English manual hierarchies
       (closes: #29448, #281811).
     - Improve per-locale directory handling. Directories such as "fr.UTF-8"
       may be used for occasions when it is appropriate to specify the
       character set but not the country, and so a full locale name is
       inconvenient.
     - There is a new "manconv" program which can try multiple possible
       encodings for a file, thus allowing UTF-8 manual pages to be installed
       in any directory even without an explicit encoding declaration.
     - Don't escape the hierarchy path while globbing; it isn't necessary and
       it causes problems for paths containing metacharacters
       (closes: #444187).
   * Use new configure options for external programs rather than hardcoding
     them in configure.ac.
   * Remove code in debian/rules to fiddle manual page paths for Debian,
     since the default of $LL.UTF-8 is now reasonable. (An
     announcement/discussion about what other Debian packages should do will
     be forthcoming shortly.)
   * Build-depend on zlib1g-dev so that we use zlib rather than gzip to
     decompress gzipped manual pages.
Files: 
 7d7e3a536a0c2432c10329b2054a5131 670 doc important man-db_2.5.0-1.dsc
 c23b59726cebe0e0820ced2becf5f52d 977883 doc important man-db_2.5.0.orig.tar.gz
 a5daa70f9dec5e800ee227c333230b18 68665 doc important man-db_2.5.0-1.diff.gz
 fcf95b057b07b54ee7d69ac83a88c2d8 791636 doc important man-db_2.5.0-1_i386.deb

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
Comment: Colin Watson <cjwatson@debian.org> -- Debian developer

iD8DBQFHCTgQ9t0zAhD6TNERAhXHAJoDy7LB/lRaTyIb9ZvVGiRIj1emSgCfXH1h
+vTb7zj4TIeWw3qxQZ5xMwg=
=t5YZ
-----END PGP SIGNATURE-----

Send a report that this bug log contains spam.