From owner-freebsd-current@FreeBSD.ORG Wed Aug 18 07:41:47 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 525461065679 for ; Wed, 18 Aug 2010 07:41:47 +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 192438FC12 for ; Wed, 18 Aug 2010 07:41:46 +0000 (UTC) Received: by iwn36 with SMTP id 36so410543iwn.13 for ; Wed, 18 Aug 2010 00:41:46 -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:date :x-google-sender-auth:message-id:subject:from:to:content-type; bh=XmMqi4nslWGSyAOTb4udhFzCehxxUSTEibe1YwCzFi0=; b=bgpj6BXt1kus8AXA6Dq0u9tSYPO+Ts1dUF6smMk1nXbKdZfPGw1HvTW1TqlciAz4Hx X2WuZcOhjZvm0IunXYksubdY4qe2z4vSSEd+EfErw1IwO325+PylJ0j2EaFqfrsHANN2 pDTfzqz/dses8dLX/NrEXEgoDT19rKxWSiVCc= DomainKey-Signature: a=rsa-sha1; c=nofws; d=gmail.com; s=gamma; h=mime-version:sender:date:x-google-sender-auth:message-id:subject :from:to:content-type; b=fxnH42gQni+ILM/asMIRge0bcatYW1lMWDpJBM1lSnYldHeNOYu1ppHx6i395ihAgv pgNFu+85GkA9IrjeqeDvLAmTWHerXohvg6t3ekNyl7MTknDpPGyxiyE0zh5rLvByo5xE hlkQQP3nTC41iou8U4iEMTRfeekjuPjWSx4a0= MIME-Version: 1.0 Received: by 10.231.177.25 with SMTP id bg25mr8214288ibb.154.1282115480515; Wed, 18 Aug 2010 00:11:20 -0700 (PDT) Sender: gordon.tetlow@gmail.com Received: by 10.231.172.147 with HTTP; Wed, 18 Aug 2010 00:11:20 -0700 (PDT) Date: Wed, 18 Aug 2010 00:11:20 -0700 X-Google-Sender-Auth: Ny-VgSwSPIJ9eCB3z7oOHWNrJh8 Message-ID: From: Gordon Tetlow To: freebsd-current@freebsd.org X-Mailman-Approved-At: Wed, 18 Aug 2010 11:25:17 +0000 Content-Type: text/plain; charset=ISO-8859-1 X-Content-Filtered-By: Mailman/MimeDel 2.1.5 Subject: 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: Wed, 18 Aug 2010 07:41:47 -0000 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). Thanks, Gordon