[mplayer-dev-eng] install localized manpages + [PATCH]

[Andreas Hess]

On Mon, Feb 10, 2003 at 10:01:59PM +0100, Rüdiger Kuhlmann wrote:
> > -	$(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1
> > +	$(INSTALL) -c -m 644 DOCS/$(LANGUAGE)/mplayer.1 $(MANDIR)/man1/mplayer.1
> 
> No. You need to install the localized man pages into the proper
> subdirectories, that is, DOCS/$(LANGUAGE)/mplayer.1 into
> $(MANDIR)/$(LANGUAGE)/man1/mplayer.1 and so on. Actually, you could ship
> with all man pages at the same time, because man will automatically select
> the right one.

Ok, so how to honor the Filesystem Hierarchy Standard chapter 4.11.5?
It states the following:

"Manual pages are stored in <mandir>/<locale>/man<section>/<arch>."

[...]

"Systems which use a unique language and code set for all manual pages
may omit the <locale> substring and store all manual pages in <mandir>."

So if you have a single language system (whatever language it is),
'/usr/local/man/man1' should be ok, but if you have a multi language
system, '/usr/local/man/man1' can never be ok, not even for the english
manpage (so most or all distributions handle it the wrong way).

From my point of view, it would be ok (and right), to put every manpage
(even the english) into '/usr/local/man/<locale>/man1'. If there is no
objection, the following patch can be applied.


Andreas
-------------- next part --------------
Index: Makefile
===================================================================
RCS file: /cvsroot/mplayer/main/Makefile,v
retrieving revision 1.250
diff -u -r1.250 Makefile
--- Makefile	9 Feb 2003 20:18:11 -0000	1.250
+++ Makefile	10 Feb 2003 15:14:34 -0000
@@ -260,7 +260,7 @@
 	-ln -sf $(PRG) $(BINDIR)/gmplayer
 endif
 	if test ! -d $(MANDIR)/man1 ; then mkdir -p $(MANDIR)/man1; fi
-	$(INSTALL) -c -m 644 DOCS/mplayer.1 $(MANDIR)/man1/mplayer.1
+	$(INSTALL) -c -m 644 DOCS/$(LOCALE)/mplayer.1 $(MANDIR)/$(LOCALE)/man1/mplayer.1
 ifeq ($(MENCODER),yes)
 	$(INSTALL) -m 755 $(INSTALLSTRIP) $(PRG_MENCODER) $(BINDIR)/$(PRG_MENCODER)
 	-ln -sf mplayer.1 $(MANDIR)/man1/mencoder.1
Index: configure
===================================================================
RCS file: /cvsroot/mplayer/main/configure,v
retrieving revision 1.658
diff -u -r1.658 configure
--- configure	8 Feb 2003 22:29:05 -0000	1.658
+++ configure	10 Feb 2003 15:14:39 -0000
@@ -1616,6 +1616,9 @@
 fi
 _mp_help="help/help_mp-${LINGUAS}.h"
 test -f $_mp_help || die "$_mp_help not found"
+if not test -f "DOCS/${LINGUAS}/mplayer.1" ; then
+  LINGUAS="en"
+fi
 
 echocheck "enable sighandler"
 if test "$_sighandler" = yes ; then
@@ -4816,6 +4819,8 @@
 EXTRA_INC = $_inc_extra $_inc_gtk
 WIN32_PATH = -DWIN32_PATH=\\"$_win32libdir\\"
 STRIPBINARIES = $_stripbinaries
+
+LOCALE = $LINGUAS
 
 $_live_libs_def