From nik@iii.co.uk Thu Jan 29 03:16:43 1998 Received: from tyree.iii.co.uk (tyree.iii.co.uk [193.117.77.66]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id DAA17630 for ; Thu, 29 Jan 1998 03:16:42 -0800 (PST) (envelope-from nik@iii.co.uk) Received: from carrig.strand.iii.co.uk (carrig.strand.iii.co.uk [192.168.7.25]) by tyree.iii.co.uk (8.8.8/8.8.8) with ESMTP id LAA21296 for ; Thu, 29 Jan 1998 11:11:39 GMT Received: (from nik@localhost) by carrig.strand.iii.co.uk (8.8.7/8.8.7) id LAA20028; Thu, 29 Jan 1998 11:17:09 GMT Message-Id: <199801291117.LAA20028@carrig.strand.iii.co.uk> Date: Thu, 29 Jan 1998 11:17:09 GMT From: Nik Clayton Reply-To: nik@iii.co.uk To: FreeBSD-gnats-submit@freebsd.org Subject: [Update] Upgrading using the source code X-Send-Pr-Version: 3.2 >Number: 5600 >Category: docs >Synopsis: New version of 'Upgrade from source' tutorial to consider >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-bugs >State: closed >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Thu Jan 29 03:20:01 PST 1998 >Closed-Date: Fri Mar 27 01:44:32 PST 1998 >Last-Modified: Fri Mar 27 01:45:35 PST 1998 >Originator: Nik Clayton >Release: FreeBSD 2.2-STABLE i386 >Organization: Interactive Investor >Environment: N/A >Description: I've updated my "How to upgrade using the source code" tutorial. The current version on the FreeBSD web site can be found at: The new version can be found at: There are a number of changes with this version, including: * The document is no longer specific to FreeBSD 2.1.7. Instead, different sections cover different versions of FreeBSD from 2.0 to -current. * Wrote and include a script (dircmp.pl) to assist in selecting which files to update from /etc. Similar (but with more limited scope than) Matthew Thyer's 'etcud' script. * Updated "Building on an NFS server, installing on a client" section to cover the 'buildworld' and 'installworld' targets on 2.2.5 and above. * Added a new FAQ, "How can I speed up making the world?" based on comments and suggestions from the mailing lists. * Noted the 'optional-ness' of building in single-user mode * Fixed numerous small typos and performed general tidying up What do the documentation powers that be want me to do with it now? The tutorial consists of: - An SGML source file (marked up with the DocBook DTD) - An HTML translation of this file - A Makefile to automate the translation process - The 'dircmp.pl' Perl script If possible, I'd like to see this folded into the handbook as a part of the "Staying current with FreeBSD" section. This is work I can (probably) do myself. I now have a dial-up Internet connection and sufficient resources to maintain local copies of the 'src' and 'doc' CVS repositories. Of course, to do this I'd need commit privs to the documentation repository. On the plus side, I would also then be able to help out in the LinuxDoc -> DocBook conection project. Alternatively, I can provide a diff to the HTML (or SGML) source that's currently on the FreeBSD site, and submit it with send-pr. Or, the link on the FreeBSD site could be changed just to point to my copy. Or something else. Feedback solicited. N >How-To-Repeat: N/A >Fix: N/A >Release-Note: >Audit-Trail: State-Changed-From-To: open->closed State-Changed-By: nik State-Changed-When: Fri Mar 27 01:44:32 PST 1998 State-Changed-Why: Tutorial considered :-) >Unformatted: