Public bug reported:

Binary package hint: man2html

currently man2html indexes a limited amount of manpages. The database is
created as a postinst script:

# taken from man2html/man2html-1.6e/debian/postinst
 34                 if [ -e /usr/local/man ]; then
 35                         LOCALMAN=$(find /usr/local/man -type d -name "man?")
 36                 fi
 37
 38                 if [ -e /usr/local/share/man ]; then
 39                         LOCALSMAN=$(find /usr/local/share/man -type d -name 
"man?")
 40                 fi
 41
 42
 43                 index++ --config-file=/usr/share/man2html/swish++.conf \
 44                         /usr/share/man/man* \
 45                         /usr/man/man* \
 46                         /usr/X11R6/man/man* $LOCALMAN $LOCALSMAN 2>&1 > 
"$tf" &
# end from from man2html/man2html-1.6e/debian/postinst

This is insufficient because:
1) it leaves out /opt/man/, which is by default in the manpath of ubuntu 8.04
2) does not adapt when users add manpages in nonstandard paths. The solution 
simply would be to echo the manpath using the manpath utility and pipe the 
output to awk. This should not be a problem as man2html already depends on 
gnu-awk and the man-db utilities. Then the database should be updated from this 
information
  for example, this is my manpath:
     $ manpath
        
/usr/local/man:/usr/local/share/man:/opt/wget/share/man:/usr/share/man:/opt/nessus/man
3) includes no documentation concerning how to update the database, or how the 
database was original created by the postinstall script

thanks
orbisvicis

** Affects: man2html (Ubuntu)
     Importance: Undecided
         Status: New

-- 
manpage index incomplete, insufficient docs
https://bugs.launchpad.net/bugs/246816
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.

-- 
ubuntu-bugs mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to