diff --git a/handbook/Makefile b/handbook/Makefile index 801dc6a427..8e6cca402d 100644 --- a/handbook/Makefile +++ b/handbook/Makefile @@ -1,4 +1,4 @@ -# $Id: Makefile,v 1.7 1995-12-07 13:22:12 jkh Exp $ +# $Id: Makefile,v 1.8 1996-02-11 00:16:06 jkh Exp $ SRCS= authors.sgml basics.sgml bibliography.sgml boothelp.sgml SRCS+= booting.sgml contrib.sgml crypt.sgml ctm.sgml current.sgml dialup.sgml @@ -9,7 +9,7 @@ SRCS+= kernelconfig.sgml kerneldebug.sgml memoryuse.sgml SRCS+= mirrors.sgml nfs.sgml nutshell.sgml SRCS+= porting.sgml ports.sgml ppp.sgml printing.sgml relnotes.sgml SRCS+= routing.sgml scsi.sgml sections.sgml -SRCS+= skey.sgml slipc.sgml slips.sgml submitters.sgml sup.sgml -SRCS+= troubleshooting.sgml userppp.sgml +SRCS+= skey.sgml slipc.sgml slips.sgml stable.sgml submitters.sgml sup.sgml +SRCS+= synching.sgml troubleshooting.sgml userppp.sgml .include diff --git a/handbook/current.sgml b/handbook/current.sgml index 02ee6a3190..79054dab54 100644 --- a/handbook/current.sgml +++ b/handbook/current.sgml @@ -1,4 +1,4 @@ - + @@ -10,7 +10,7 @@ THE FREEBSD CURRENT POLICY -Last updated: $Date: 1996-01-31 14:26:01 $ +Last updated: $Date: 1996-02-11 00:16:12 $ This document attempts to explain the rationale behind FreeBSD-current, what you should expect should you decide to run it, @@ -98,8 +98,9 @@ ask! It takes far too much time to do this as a general task. entry for each change as it's made along with any pertinent information on possible side-effects. - To join these lists, send mail to `majordomo@FreeBSD.ORG' - and say: + To join these lists, send mail to + and say: subscribe current subscribe cvs-all @@ -125,10 +126,9 @@ ask! It takes far too much time to do this as a general task. Use ftp. The source tree for FreeBSD-current is always "exported" on: - - ftp.FreeBSD.ORG:~ftp/pub/FreeBSD/FreeBSD-current - - We use `wu-ftpd' which allows compressed/tar'd grabbing + + We also use `wu-ftpd' which allows compressed/tar'd grabbing of whole trees. e.g. you see: usr.bin/lex diff --git a/handbook/handbook.sgml b/handbook/handbook.sgml index f9893c731b..e272d71130 100644 --- a/handbook/handbook.sgml +++ b/handbook/handbook.sgml @@ -1,4 +1,4 @@ - + . Advanced topics ¤t; - &ctm; - ⊃ + &stable; + &synching; &submitters; &troubleshooting; &kerneldebug; diff --git a/handbook/sections.sgml b/handbook/sections.sgml index 34b19db2db..fd859d2523 100644 --- a/handbook/sections.sgml +++ b/handbook/sections.sgml @@ -1,4 +1,4 @@ - + @@ -10,6 +10,7 @@ + @@ -41,6 +42,7 @@ + diff --git a/handbook/stable.sgml b/handbook/stable.sgml new file mode 100644 index 0000000000..f9b3c8f3be --- /dev/null +++ b/handbook/stable.sgml @@ -0,0 +1,109 @@ + + + + +Staying stable with FreeBSD + +

Contributed by &a.jkh;. + + + +What is FreeBSD-stable? + +

FreeBSD-stable is our development branch for a more low-key and +conservative set of changes intended for our next mainstream release. +Changes of an experimental or untested nature do not go into this +branch (see ). + +Who needs FreeBSD-stable? + +

If you're a commercial user or someone who puts maximum stability of +their FreeBSD system before all other concerns, you should consider tracking +stable. This is especially true if you've installed the most +recent release ( at the time of this writing) since the stable +branch is effectively a bug-fix stream relative to the previous release. + +

Please note that the stable tree endevors, above all, to +be fully compilable and stable at all times, but we do occasionally +make mistakes (these are still active sources with quickly-transmitted +updates, after all). We also do our best to thoroughly test fixes in +current before bringing them into stable, but sometimes +our tests fail to catch every case. If something breaks for you in +stable, please let us know immediately! (see +next section). + +Using FreeBSD-stable + +

Join the freebsd-stable mailing list. This will + keep you informed of build-dependencies that may appear in + stable or any other issues requring special attention. + Developers will also make announcements in this mailing list when + they are contemplating some contraversal fix or update, giving + the users a chance to respond if they have any issues to raise concerning + the proposed change. + + To join this list, send mail to and say: + + subscribe freebsd-stable + + In the body of your message. Optionally, you can also say `help' + and Majordomo will send you full help on how to subscribe and + unsubscribe to the various other mailing lists we support. + + Grab the sources from ftp.FreeBSD.ORG. You can do this in + three ways: + + + Using the CTM facility described below. Unless you + have a good TCP/IP connection at a flat rate, this is + the way to do it. + + Use the CMU `sup' program (Software Update + Protocol), also described below. + This is the second most recommended method, since it allows + you to grab the entire collection once and then only what's + changed from then on. Many people run sup from cron + and keep their sources up-to-date automatically. + + Use ftp. The source tree for FreeBSD-stable is always + "exported" on: + + +

We also use `wu-ftpd' which allows compressed/tar'd grabbing + of whole trees. e.g. you see: + + usr.bin/lex + + You can do: + + ftp> cd usr.bin + ftp> get lex.tar.Z + + And it will get the whole directory for you as a compressed + tar file. + + + Essentially, if you need rapid on-demand access to the source and + communications bandwidth is not a consideration, use sup or ftp. + Otherwise, use CTM. + + Before compiling stable, read the Makefile in /usr/src + carefully. You should at least run a `make world' the first time + through as part of the upgrading process. + Reading freebsd-stable will keep you up-to-date on other bootstrapping + procedures that sometimes become necessary as we move towards the next + release. + diff --git a/handbook/sup.sgml b/handbook/sup.sgml index 4836e3622e..8fbff545bf 100644 --- a/handbook/sup.sgml +++ b/handbook/sup.sgml @@ -1,4 +1,4 @@ - + @@ -57,11 +57,12 @@ like so: Thats all there is to it! Remember that if you're running current, which is what you will have if you sup with the standard-supfile, please join the freebsd-current mailing list. You should also be sure to read - + for important information on just what we can and cannot do for you as a -current user. If you are using the stable-supfile, please -join the freebsd-stable mailing list. +join the freebsd-stable mailing list and read + +. Description of FreeBSD SUP distributions diff --git a/handbook/synching.sgml b/handbook/synching.sgml new file mode 100644 index 0000000000..ea5cd85a84 --- /dev/null +++ b/handbook/synching.sgml @@ -0,0 +1,21 @@ + + + +Synchronizing source trees over the Internet + +

Contributed by &a.jkh;. + + + +

There are various ways of using an Internet (or email) connection + to stay up-to-date with whatever collection of FreeBSD project sources + it is that interests you. The primary services we offer are: + + ⊃ + &ctm;