Re: CFR: Replace man/manpath/whatis/apropos with a shell script

Gordon Tetlow <gordon_at_freebsd.org> wrote
  in <AANLkTikw3J5Hbrz0gjpBaB=8UrfNKgJm069i8enNXU14_at_mail.gmail.com>:

go> On Wed, Aug 18, 2010 at 12:11 AM, Gordon Tetlow <gordon_at_tetlows.org> wrote:
go>
go> > All,
go> >
go> > I sat down and rewrote the man tools from a relatively old codebase to a
go> > single shell script. My original motivation was to allow multiple
go> > configuration files so port installations did not have to mess with
go> > /etc/manpath.config (like perl for example) when needing to manipulate the
go> > manpath. After looking at the existing code, I figured I could rewrite it as
go> > a shell script relatively easily.
go> >
go> > Script (install as /usr/bin/man, /usr/bin/manpath, /usr/bin/apropos,
go> > /usr/bin/whatis)
go> > http://people.freebsd.org/~gordon/man.sh<http://people.freebsd.org/%7Egordon/man.sh>
go> >
go> > Features of the new code:
go> >
go> > 1. BSD licensed (old code is GPL).
go> > 2. Imports configuration from /usr/local/etc/man.d/*.conf and /etc/man.conf
go> > (purposefully changed the manpath.config file since it is a different
go> > syntax).
go> > 3. Allows ports to override the toolset used to display the manpage based
go> > on language. This was done to try to merge the functionality of the
go> > japanese/man port into the base system as much as possible.
go> >
go> > I've tried to make this mirror the functionality, directory search order,
go> > and arguments as the current base implementation.
go> >
go> > This brings me to my next point. I need some testers willing to try this
go> > out. It would be particularly great if I could get some foreign language
go> > testers with localized manpage installations. If something doesn't work the
go> > way you expect, please contact me and I can help debug it (using man -ddd
go> > <whatever> will generally give me the debug information I need).
go> >
go> > Thanks,
go> > Gordon
go> >
go>
go> I did some additional testing with the japanese/man-doc port and found the
go> following was necessary:

 Great, I will test it and get back to you!

-- Hiroki