I'm working on porting xscreensaver. Each saver module is actually a
stand-alone binary and has an associated .1 manpage, but the binaries are
installed in a private area (cf. $FINK/bin). The problem is that (at
least) one module has the same name as another binary already in Fink, and
so there is a conflicting manpage.1. So...what to do? I talked to the
author of xscreensaver, who said the module manpages have to be
"somewhere" locateable by man in order for the program's help system to
work. A couple of brainstormed ideas:

1. Put the manpages in a private man1 directory and have xscreensaver
modify its own MANPATH to look there. Con: puts manpages that a user may
want in a nonstandard place (but if one knows enough to find the binaries
directly, one would also find the manpages?).

2. Rename all the module [thing].1 to xscreensaver_[thing].1. Con: have to
hack xscreensaver to deal with the new names.  Con: finding the manpages
from the command-line requires knowing about this modification and knowing
that a particular command is part of xscreensaver (but this is true since
one has to dig into xscreensaver's private space to find the binary).

3. Install them in some other manpage section...

3a. Install them as .6 (usually used for games and such)?

3b. Install them as .1xscreensaver in man1 (as for echo.1fun). Pro: user
doesn't have to do anything special to find the manpages. Pro: it's clear
which manpage belongs to xscreensaver and which to something else. Con:  
'man' seems to return all manpage.1* in the first-viable MANPATH directory
regardless of presence of -a, possibly confusing programs that expect
'man' to always return (up to) a single manpage (i.e., xscreensaver's)
(but it could set a MANSECT to get what it wants).

3c. As for 3, but put them in man1xscreensaver. Pro: as for 3b, but 
solves its cons (with MANSECT hack). Con: one has to know to set MANSECT 
to find them (but one would already have to have found the private binary 
collction).

Anyone have suggestions about how to handle this situation?

dan

-- 
Daniel Macks
[EMAIL PROTECTED]
http://www.netspace.org/~dmacks



-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf
_______________________________________________
Fink-devel mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/fink-devel

Reply via email to