From owner-freebsd-ports@FreeBSD.ORG Sun Feb 22 21:54:56 2004 Return-Path: Delivered-To: freebsd-ports@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7E08B16A4CE for ; Sun, 22 Feb 2004 21:54:56 -0800 (PST) Received: from enterprise.sd73.bc.ca (romulus-net.sd73.bc.ca [142.24.13.134]) by mx1.FreeBSD.org (Postfix) with ESMTP id 4B71A43D2F for ; Sun, 22 Feb 2004 21:54:56 -0800 (PST) (envelope-from fcash-ml@sd73.bc.ca) Received: from mailtest.sd73.bc.ca (mailtest.sd73.bc.ca [10.10.10.14]) i1N5kVjd001790 for ; Sun, 22 Feb 2004 21:46:31 -0800 Received: from 24.71.130.94 (SquirrelMail authenticated user fcash) by mailtest.sd73.bc.ca with HTTP; Sun, 22 Feb 2004 21:54:56 -0800 (PST) Message-ID: <2107.24.71.130.94.1077515696.squirrel@mailtest.sd73.bc.ca> Date: Sun, 22 Feb 2004 21:54:56 -0800 (PST) From: "Freddie Cash" To: ports@freebsd.org User-Agent: SquirrelMail/1.4.2 MIME-Version: 1.0 Content-Type: text/plain;charset=iso-8859-1 Content-Transfer-Encoding: 8bit X-Priority: 3 Importance: Normal X-RAVMilter-Version: 8.4.1(snapshot 20020919) (enterprise.sd73.bc.ca) Subject: OPTIONS, LATEST_LINK, and RCng X-BeenThere: freebsd-ports@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Porting software to FreeBSD List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 23 Feb 2004 05:54:56 -0000 While updating the www/dansguardian* ports to use the new OPTIONS and LATEST_LINK variables, I noticed that the www/squid port now uses RCng for the startup script. This is good news, because it means I can rename the dansguardian startup script back to dansguardian.sh and just use RCng to make sure it's started after squid. Then I noticed that the squid.sh script reads like gobbledygook and that I have no idea what it is doing. :) (And here I used to think I was a decent shell scripter.) Same with the rc_subr and rc scripts. Is there any documentation that explains what these things are doing, what the minimum requirements are for an RCng-style startup script, and so on. Something along the lines of the info in the Porter's Handbook for creating ports? Something more than what is already available (which isn't all that much that I've been able to find / understand)?? Even a pointer to a port that has a fully-commented RCmg-style startup script would be helpful. Also, is anyone in the process of updating the Porter's Handbook to include sections on the OPTIONS variable and the associated "make config" target, and the LATEST_LINK variable that were introduced in the past month or so? Took me a lot of sleuthing through other port Makefiles to figure those ones out. :) (Thanks to the squid port maintainer -- your well-commented Makefile helped a lot.) If not, would I need to submit fully-formatted text in DocBook / SGML or could I just submit a PR with possible text to use?? Thanks for reading this far. :D -- Freddie Cash fcash-ml@sd73.bc.ca