> 
> Hi!
> 
> ----
> 
> While looking at some other issue with japanese
> manual pages on a system
> where multiple users use different locales I hit the
> problem that there
> wasn't a "windex" (manual page index file) for the
> japanese manual
> pages:
> -- snip --
> $ find /usr/share/man -name windex
> /usr/share/man/windex
> -- snip --
> 
> A quick check shows that "catman -w" creates the
> manual pages if the
> locale matches the manual page subdir, e.g.
> -- snip --
> $ (LC_ALL=ja_JP.UTF-8 MANPATH=/usr/share/man catman
> -w)
> $ find /usr/share/man -name windex
> /usr/share/man/ja_JP.UTF-8/windex
> /usr/share/man/windex
> -- snip --
> 
> Erm... is this intentional or a bug ? At least I
> would expect that a
> "catman -w" crawls/indexes all manual pages of all
> locales in one
> step... or is there a reason why this shouldn't be
> done ?

Since I don't see code in
http://src.opensolaris.org/source/xref/onnv/onnv-gate/usr/src/cmd/man/src/man.c
or
http://src.opensolaris.org/source/xref/onnv/onnv-gate/usr/src/cmd/man/src/makewhatis.sh
to do them all, I would suppose it is intentional, or at worst, an omission.
I'd view it as a feature, since doing /usr/share/man is already slow enough.

If you really want them all, then you could always do something like
(not tested):
find "${mandir}" -type d ! -name 'man*' ! -name 'sman*' ! -name entities -print 
| \
while read localedir
do
   locale="$(basename "${localedir}")"
   if [ x"${locale}" = x"." ]; then
      LC_ALL=C catman -w -M "${localedir}"
   else
      LC_ALL="${locale}" catman -w -M "${localedir}"
   fi
done

Since probably very few of my users are likely to read man pages at all,
let alone in other than English, I never got too worried about this; I have
enough fun digging all man directories out of /var/sadm/install/contents,
so as to run catman -w on all of them.

I would like to see a shortcut in makewhatis to speed it up if nothing had
changed; i.e something using find with -newer to check for subdirectories
that were newer than the windex file.  That way, it wouldn't be unreasonable
to run something at boot or from cron to periodically update the windex files.
 
 
This message posted from opensolaris.org

Reply via email to