From owner-freebsd-current@FreeBSD.ORG Thu Sep 9 16:36:09 2010 Return-Path: Delivered-To: freebsd-current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 1D14B10656B6 for ; Thu, 9 Sep 2010 16:36:09 +0000 (UTC) (envelope-from gordon.tetlow@gmail.com) Received: from mail-iw0-f182.google.com (mail-iw0-f182.google.com [209.85.214.182]) by mx1.freebsd.org (Postfix) with ESMTP id C7E468FC12 for ; Thu, 9 Sep 2010 16:36:08 +0000 (UTC) Received: by iwn34 with SMTP id 34so1447825iwn.13 for ; Thu, 09 Sep 2010 09:36:08 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=gamma; h=domainkey-signature:mime-version:received:sender:received :in-reply-to:references:date:x-google-sender-auth:message-id:subject :from:to:content-type; bh=q2DQGnZsT04M2hdxOU5+S6K7W1p+8rI6VEuOm4D231A=; b=fK7yaXMjCZe2ufQc/0PfzEKTU6dEALDiEjWK/9dKf+vkMrbAjfpqzMHaYwfl+3GH9P HXz/QHF4eD3TP2osre4m8Yp5eq4/8lcxzHRj1DKsKxPgSzSCGnzIgPQBrSfSUm8ndXpo bG6KEfmHnGnONnO4qNe40toxRcbE/OMCDXf4g= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:in-reply-to:references:date :x-google-sender-auth:message-id:subject:from:to:content-type; b=WNyUHlLUyTjZs39eFgrRr5Plkjcfnvn/sZK6oYWa5Wr1hKntoIs1fij1lRt7X02T25 wIXh8K7DOk4hID+eGmGPAic2Q9vgbsQwtva5UkM+PJH8zwQdkn1h+UIC7aDsrVwi/dUm jjfTEB+zVgSbZkqaxVoJ4OUF4tChbB9bIlAxE= MIME-Version: 1.0 Received: by 10.231.191.147 with SMTP id dm19mr11880836ibb.6.1284050167907; Thu, 09 Sep 2010 09:36:07 -0700 (PDT) Sender: gordon.tetlow@gmail.com Received: by 10.231.156.78 with HTTP; Thu, 9 Sep 2010 09:36:07 -0700 (PDT) In-Reply-To: References: Date: Thu, 9 Sep 2010 09:36:07 -0700 X-Google-Sender-Auth: T29WIxA6J0M3rc6Bm8bUc2oohRs Message-ID: From: Gordon Tetlow To: freebsd-current@freebsd.org Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 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: Thu, 09 Sep 2010 16:36:09 -0000 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. Please let me know if you have any questions. Thanks, Gordon