os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Merge.

Browse source
This commit is contained in:
Jordan K. Hubbard 1996-07-05 11:30:22 +00:00
parent bfe04afb53
commit fd43c46559
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/branches/RELENG_2_1_0/; revision=404
8 changed files with 1148 additions and 125 deletions

18
handbook/current.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: current.sgml,v 1.2.4.4 1996-06-19 20:27:33 jkh Exp $ -->
<!-- $Id: current.sgml,v 1.2.4.5 1996-07-05 11:30:15 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
@ -10,7 +10,7 @@
THE FREEBSD CURRENT POLICY
Last updated: $Date: 1996-06-19 20:27:33 $
Last updated: $Date: 1996-07-05 11:30:15 $
This document attempts to explain the rationale behind
FreeBSD-current, what you should expect should you decide to run it,
@ -83,9 +83,9 @@ ask! It takes far too much time to do this as a general task.
<sect><heading>Using FreeBSD-current</heading>
<p><enum> <item> Join the freebsd-current and cvs-all
mailing lists. This is not just a good idea, it is
<em>essential</em>. If you are not on the &a.current, you
<p><enum> <item> Join the &a.current and the &a.cvsall .
This is not just a good idea, it is <em>essential</em>.
If you are not on the <em>FreeBSD-current</em> mailing list you
will not see the comments that people are making about the
current state of the system and thus will probably end up stumbling
over a lot of problems that others have already found and
@ -94,7 +94,7 @@ ask! It takes far too much time to do this as a general task.
Before you rebuild <tt>/usr/src</tt>, you <em>must</em>
rebuild the kernel or your system will crash horribly!").
The cvs-all mailing list will allow you to see the commit log
The <em>cvs-all</em> mailing list will allow you to see the commit log
entry for each change as it is made along with any pertinent
information on possible side-effects.
@ -111,12 +111,12 @@ ask! It takes far too much time to do this as a general task.
three ways:
<enum>
<item> Using the CTM facility described below. Unless you
<item> Use the <ref id="ctm" name="CTM"> facility. Unless you
have a good TCP/IP connection at a flat rate, this is
the way to do it.
<item> Use the CMU `sup' program (Software Update
Protocol), also described below.
<item> Use the CMU <ref id="sup"> program (Software Update
Protocol).
This is the second most recommended method, since it allows
you to grab the entire collection once and then only what has
changed from then on. Many people run sup from cron

6
handbook/firewalls.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: firewalls.sgml,v 1.1.2.5 1996-06-30 02:59:16 alex Exp $ -->
<!-- $Id: firewalls.sgml,v 1.1.2.6 1996-07-05 11:30:16 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>Firewalls<label id="firewalls"></heading>
@ -527,8 +527,8 @@ normally fall outside the 1-1024 range specified above.
</itemize>
<p>Another checklist for firewall configuration is available from CERT
at <htmlurl url="ftp://ftp.cert.org/pub/tech_tips/packet_filtering"
name="ftp://ftp.cert.org/pub/tech_tips/packet_filtering">
at <htmlurl url="ftp://ftp.cert.org/pub/tech&lowbar;tips/packet&lowbar;filtering"
name="ftp://ftp.cert.org/pub/tech&lowbar;tips/packet&lowbar;filtering">
<p>As I said above, these are only <em>guidelines</em>. You will have
to decide what filter rules you want to use on your firewall

1158
handbook/hw.sgml
View file

File diff suppressed because it is too large Load diff

11
handbook/isdn.sgml
View file

@ -1,12 +1,13 @@
<!-- $Id: isdn.sgml,v 1.1 1996-07-02 23:16:16 wosch Exp $ -->
<!-- $Id: isdn.sgml,v 1.1.2.1 1996-07-05 11:30:18 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect><heading>ISDN<label id="isdn"></heading>
<p><em>Contributed by &a.hm;.</em>
There is the bisdn ISDN package available from ftp.muc.ditec.de supporting
FreeBSD 2.1R, FreeBSD-current and NetBSD.
There is the bisdn ISDN package available from
<htmlurl url="ftp://ftp.muc.ditec.de/isdn" name="ftp.muc.ditec.de">
supporting FreeBSD 2.1R, FreeBSD-current and NetBSD.
Currently all (passive) Teles cards and their clones are supported for the
EuroISDN (DSS1) and 1TR6 protocols.
@ -15,4 +16,6 @@ The latest source can be found on the above mentioned ftp server under
directory isdn as file bisdn-095.tar.gz.
A majordomo maintained mailing list is available, to subscribe, send the
usual majordomo requests to isdn-request@muc.ditec.de.
usual majordomo requests to
<htmlurl url="mailto:isdn-request@muc.ditec.de"
name="isdn-request@muc.ditec.de">.

6
handbook/lists.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: lists.sgml,v 1.1 1996-05-16 23:18:06 mpp Exp $ -->
<!-- $Id: lists.sgml,v 1.1.2.1 1996-07-05 11:30:20 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
<!--
@ -13,6 +13,10 @@ and double quotes.
<tt><htmlurl url='mailto:freebsd-announce@FreeBSD.ORG'
name='&lt;freebsd-announce@FreeBSD.ORG&gt;'></tt>">
<!ENTITY a.cvsall "FreeBSD CVS commit message mailing list
<tt><htmlurl url='mailto:cvs-all@FreeBSD.ORG'
name='&lt;cvs-all@FreeBSD.ORG&gt;'></tt>">
<!ENTITY a.doc "FreeBSD documentation project mailing list
<tt><htmlurl url='mailto:freebsd-doc@FreeBSD.ORG'
name='&lt;freebsd-doc@FreeBSD.ORG&gt;'></tt>">

53
handbook/policies.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: policies.sgml,v 1.1 1996-06-30 18:01:25 phk Exp $ -->
<!-- $Id: policies.sgml,v 1.1.2.1 1996-07-05 11:30:21 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
<chapt><heading>Source Tree Guidelines and Policies
@ -8,13 +8,13 @@
<p><em>Contributed by &a.phk;.</em>
This chapter documents various guidelines and policies in force
for the FreeBSD sourcetree.
for the FreeBSD source tree.
<sect><heading>MAINTAINER on Makefiles</heading>
<p>June 1996.
<p>If a particular subpart of the FreeBSD is being maintained by a
<p>If a particular portion of the FreeBSD distribution is being maintained by a
person or group of persons, they can communicate this fact to the
world by adding a
@ -22,25 +22,28 @@ world by adding a
MAINTAINER= email-addresses
</verb>
<p>line to the makefiles covering this piece of subpart of the tree.
<p>line to the makefiles covering this portion of the source tree.
<p>The semantics of this is as follows:
<p>The semantics of this are as follows:
<p>The maintainer owns and is responsible for that code. This means
that he is responsible for fixing bugs and answer PRs pertaining
to that piece of the code, and in the case of contrib software,
for tracking new versions, as appropriate.
that he is responsible for fixing bugs and answer problem reports
pertaining to that piece of the code, and in the case of contributed
software, for tracking new versions, as appropriate.
<p>Commits to the directories covered by this shall be sent to the
maintainer for review. Only if the maintainer does not respond
<p>Changes to directories which have a maintainer defined shall be
sent to the
maintainer for review before being committed. Only if the maintainer does not respond
for un unacceptable period of time, to several emails, will it be
acceptable to commit changes without review by the maintainer.
However, it is suggested that you try and have the changes reviewed
by someone else if at all possible.
<p>It is of course not acceptable to add a person or group as maintainer
unless they agree to assume this duty, on the other hand it doesn't
have to be a committer and it can easily to be a group of people.
unless they agree to assume this duty. On the other hand it doesn't
have to be a committer and it can easily be a group of people.
<p> Some software distributions have attacked this problem by
<p>Some software distributions have attacked this problem by
providing configuration scripts. Some of these are very clever, but
they have an unfortunate tendency to triumphantly announce that your
system is something you've never heard of and then ask you lots of
@ -49,17 +52,17 @@ programming (``Does your system's gethitlist function return a const
pointer to a fromboz or a pointer to a const fromboz? Do you have
Foonix style unacceptable exception handling? And if not, why not?'').
<p> Fortunately, with the Ports collection, all the hard work involved
<p>Fortunately, with the Ports collection, all the hard work involved
has already been done, and you can just type 'make install' and get a
working program.
<sect><heading>contributed software</heading>
<sect><heading>Contributed software</heading>
<p>June 1996.
<p>Some parts of the FreeBSD distribution consists of software that
<p>Some parts of the FreeBSD distribution consist of software that
is actively being maintained outside the FreeBSD project. For
historical reasons, we call this "contributed" software. Some
historical reasons, we call this <em>contributed</em> software. Some
examples are perl, gcc and patch.
<p>Over the last couple of years, various methods have been used in
@ -69,8 +72,8 @@ advantages and drawbacks. No clear winner has emerged.
<p>Since this is the case, after some debate one of these methods has
been selected as the "official" method and will be required for
future imports of software of this kind. Furthermore, it is strongly
suggested that existing contrib software converge on this model
over time as it has significant advantages over the old method,
suggested that existing contributed software converge on this model
over time, as it has significant advantages over the old method,
including the ability to easily obtain diffs relative to the
"official" versions of the source by everyone (even without cvs
access). This will make it significantly easier to return changes
@ -83,7 +86,7 @@ only with the approval of the core team and with the general
consensus of the other developers. The ability to maintain the
package in the future will be a key issue in the decisions.
<p>The "Tcl" embeddable programming language will be used as example
<p>The <tt>Tcl</tt> embedded programming language will be used as example
of how this model works:
<p><verb>src/contrib/tcl</verb> contains the source as distributed by the maintainers
@ -99,7 +102,7 @@ install the documentation.
produce and install the "tclsh" program and its associated man-pages
using the standard bsd.prog.mk rules.
<p><verb>src/tools/tools/tcl_bmake</verb> contains a couple of shell-scrips that can be of help
<p><verb>src/tools/tools/tcl_bmake</verb> contains a couple of shell-scripts that can be of help
when the tcl software needs updated, these are not part of the
build or installed software.
@ -107,7 +110,7 @@ build or installed software.
is created according to the rules: It is supposed to contain the
sources as distributed (on a proper CVS vendor-branch) with as few
FreeBSD-specific changes as possible. The 'easy-import' tool on
freefall will assist in doing the import but, if there are any
freefall will assist in doing the import, but if there are any
doubts on how to go about it, it is imperative that you ask first
and not blunder ahead and hope it "works out". CVS is not forgiving
of import accidents and a fair amount of effort is required to back
@ -119,14 +122,14 @@ be applied to the original distributed sources and the result
re-imported onto the vendor branch again. Official patches should
never be patched into the the FreeBSD checked out version and
"committed", as this destroys the vendor branch coherency and makes
imports future versions rather difficult as there will be conflicts.
importing future versions rather difficult as there will be conflicts.
<p>Since many packages contain files that are meant for compatibility
with other architectures and environments that FreeBSD, it is
permissible to remove parts of the dist tree that are of no interest
permissible to remove parts of the distribution tree that are of no interest
to FreeBSD in order to save space. Files containing copyright
notices and release-note kind of information applicable to the
remaining files shall >not< be removed.
remaining files shall <em>not</em> be removed.
<p>If it seems easier, the "bmake" makefiles can be produced from the
dist tree automatically by some utility, something which would

14
handbook/stable.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: stable.sgml,v 1.2 1996-05-16 23:18:19 mpp Exp $ -->
<!-- $Id: stable.sgml,v 1.2.2.1 1996-07-05 11:30:22 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
@ -10,7 +10,7 @@
THE FREEBSD STABLE POLICY
Last updated: $Date: 1996-05-16 23:18:19 $
Last updated: $Date: 1996-07-05 11:30:22 $
This document attempts to explain the rationale behind
FreeBSD-stable, what you should expect should you decide to run it,
@ -45,7 +45,7 @@ next section).
<sect><heading>Using FreeBSD-stable</heading>
<p><enum><item> Join the freebsd-stable mailing list. This will
<p><enum><item> Join the &a.stable . This will
keep you informed of build-dependencies that may appear in
<em>stable</em> or any other issues requring special attention.
Developers will also make announcements in this mailing list when
@ -65,12 +65,12 @@ next section).
three ways:
<enum>
<item> Using the CTM facility described below. Unless you
<item> Use the <ref id="ctm" name="CTM"> facility. Unless you
have a good TCP/IP connection at a flat rate, this is
the way to do it.
<item> Use the CMU `sup' program (Software Update
Protocol), also described below.
<item> Use the CMU <ref id="sup"> program (Software Update
Protocol).
This is the second most recommended method, since it allows
you to grab the entire collection once and then only what has
changed from then on. Many people run sup from cron
@ -102,7 +102,7 @@ next section).
<item> 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
Reading the &a.stable will keep you up-to-date on other bootstrapping
procedures that sometimes become necessary as we move towards the next
release.
</enum>

7
handbook/sup.sgml
View file

@ -1,4 +1,4 @@
<!-- $Id: sup.sgml,v 1.2.4.4 1996-06-19 20:28:26 jkh Exp $ -->
<!-- $Id: sup.sgml,v 1.2.4.5 1996-07-05 11:30:22 jkh Exp $ -->
<!-- The FreeBSD Documentation Project -->
@ -56,12 +56,11 @@ like so:
</verb>
Thats all there is to it! Remember that if you are running current,
which is what you will have if you sup with the standard-supfile, please
join the &a.current mailing list. You should also be sure to read
join the &a.current . You should also be sure to read
<ref id="current" name="Staying current with FreeBSD">
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 &a.stable mailing list and read
<ref id="stable" name="Staying stable with FreeBSD">
join the &a.stable and read <ref id="stable" name="Staying stable with FreeBSD">
.
<sect1><heading>Description of FreeBSD SUP distributions</heading>