From owner-freebsd-current@FreeBSD.ORG Fri Sep 10 02:41:03 2010 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: by hub.freebsd.org (Postfix, from userid 1233) id 30767106566C; Fri, 10 Sep 2010 02:41:03 +0000 (UTC) Date: Fri, 10 Sep 2010 02:41:03 +0000 From: Alexander Best To: Gordon Tetlow Message-ID: <20100910024103.GA77780@freebsd.org> References: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: Cc: freebsd-current@freebsd.org Subject: Re: CFR: Replace man/manpath/whatis/apropos with a shell script X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 10 Sep 2010 02:41:03 -0000 On Thu Sep 9 10, Gordon Tetlow wrote: > On Wed, Aug 18, 2010 at 12:11 AM, Gordon Tetlow wrote: > > > All, > > > > I sat down and rewrote the man tools from a relatively old codebase to a > > single shell script. My original motivation was to allow multiple > > configuration files so port installations did not have to mess with > > /etc/manpath.config (like perl for example) when needing to manipulate the > > manpath. After looking at the existing code, I figured I could rewrite it as > > a shell script relatively easily. > > > > Script (install as /usr/bin/man, /usr/bin/manpath, /usr/bin/apropos, > > /usr/bin/whatis) > > http://people.freebsd.org/~gordon/man.sh > > > > Features of the new code: > > > > 1. BSD licensed (old code is GPL). > > 2. Imports configuration from /usr/local/etc/man.d/*.conf and /etc/man.conf > > (purposefully changed the manpath.config file since it is a different > > syntax). > > 3. Allows ports to override the toolset used to display the manpage based > > on language. This was done to try to merge the functionality of the > > japanese/man port into the base system as much as possible. > > > > I've tried to make this mirror the functionality, directory search order, > > and arguments as the current base implementation. > > > > This brings me to my next point. I need some testers willing to try this > > out. It would be particularly great if I could get some foreign language > > testers with localized manpage installations. If something doesn't work the > > way you expect, please contact me and I can help debug it (using man -ddd > > will generally give me the debug information I need). > > > > I have a new set for testing: > http://people.freebsd.org/~gordon/man.shar > > This is going to be my final set before I commit it into the tree, barring > any showstoppers. Now includes manpage documentation for the various parts > of the new utilities. To install: > # sh man.shar > # make > # make -DBINDIR=/usr/bin install > > Feedback on the man(1), manpath(1), apropos(1), and man.conf(5) manpages > would be appreciated. I'm new to manpage authoring and could use a review. you forgot the AUTHORS section in all of the man pages. ;) it's always nice to see who wrote the code by reading the man pages and not having to look at the source itself imho. cheers. alex > > Please let me know if you have any questions. > > Thanks, > Gordon -- a13x