os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
11878 commits 1 branch 79 tags 298 MiB
Commit graph

186 commits

Author SHA1 Message Date
Robert Watson
e93e6d4c7b Minor typo corrections in last commit (all spelling). 
Submitted by:	glewis
 2002-10-03 01:49:33 +00:00
Robert Watson
66f5756a50 The FreeBSD Core Team has approved a new policy with regards to the 
status of various architectural platforms and requirements for
support and development of those platforms.  This policy distinguishes
systems into four tiers:

Tier 1: Fully Supported Architectures
Tier 2: Developmental Architectures
Tier 3: Experimental Architectures
Tier 4: Unsupported Architectures

In addition, the Core Team has also approved a policy regarding how
the status of a hardware architecture may be formally changed.  This
policy is new, and subject to review, comment, and modification as
appropriate.  The details of this policy are implemented in this
change to the FreeBSD Committer's Handbook, which all committers
are encouraged to read and review.

Note: Although sparc64 is currently listed as a 'Developmental
Architecture', it is expected that it will become a 'Fully Supported
Architecture' prior to FreeBSD 5.0.  Likewise, it is likely that
ia64 will become a 'Fully Supported Architecture' prior to the
release.
 2002-10-02 21:16:30 +00:00
Robert Watson
89dc80e98a Add new Multi-Architecture development policy (posted previously by 
Warner) to the Committer's Handbook.
 2002-09-19 18:32:24 +00:00
Marc Fonvieille
298083d777 Add the developers of ia64 port. 
PR:		docs/42782
Submitted by:	Hiten Pandya <hiten@angelica.unixdaemons.com>
 2002-09-14 20:57:12 +00:00
Marc Fonvieille
75a5a5c47f Wrapline cleaning. 2002-08-21 16:15:12 +00:00
Marc Fonvieille
8556609c2c Add the author entity commit in "Conventions & Traditions" section. 
Suggested by:	bmah and many website problems :)
 2002-08-21 16:10:53 +00:00
Tom Rhodes
d4b003e30a FreeBSD documentation project prefers to use manual pages over man pages, 
hence some documents should reflect this.

Tossed around on: -doc -developers
 2002-07-11 19:08:31 +00:00
Jim Mock
7e5229d6dc X.x -> X.X when mentioning FreeBSD branches to be consistent with the 
rest of the doc tree.

PR:		38777
Submitted by:	blackend
 2002-07-03 23:19:12 +00:00
Tom Rhodes
163dc8b906 Better explain what Reviewed by: and Approved by: means, in the committers 
guide.  This was discussed a bit on -developers today

PR:		38631
Submitted by:	Gerald Pfeifer <pfeifer@dbai.tuwien.ac.at>
 2002-07-02 00:04:18 +00:00
Juli Mallett
3a8a41a291 Point people to the cvs(1) manpage and ``cvs import'' rather than to the 
now obsolete/unused easy-import script.

Reviewed by:	fenner
 2002-06-21 01:22:10 +00:00
Giorgos Keramidas
514c1710ad Expand the description of the proper steps one should take when 
repository copies, port removals or renames are made.

Copied almost verbatim from a post by: kris
 2002-06-16 00:38:24 +00:00
Giorgos Keramidas
6d59b6922e Correct the last commit by adding articles before &a.developers; 
where required.
 2002-05-26 23:35:19 +00:00
Giorgos Keramidas
a1972b87b3 Use &a.developers; when referring to developers@freebsd.org. 2002-05-26 23:24:38 +00:00
Giorgos Keramidas
cf416a63bd Split a long sentence, removing the need for an &ndash; separator. 2002-05-26 23:22:29 +00:00
David E. O'Brien
246b196f78 Explicitly state that developers@ email is private and not for public 
consumption.
 2002-05-17 17:25:06 +00:00
Warner Losh
ffeefaae81 Update the rules on commit bit suspention to reflect the current 
policy of core.

Reviewed by: wilko
 2002-05-13 22:00:39 +00:00
Giorgos Keramidas
ba54fb4341 Clarify the term 'context diff' at the cvs diff mini-guide part, 
to make it obvious that it refers to diff -c.
 2002-05-12 23:18:17 +00:00
Giorgos Keramidas
dd52cb7d97 Change with no' to without' or similar. 
Reviewed by:	jhb
 2002-05-12 23:15:26 +00:00
Chris D. Faulhaber
fd14001256 Spelling fixes: 
o occuring -> occurring
o accidently -> accidentally
o listis -> list is
 2002-05-12 23:01:09 +00:00
Chris D. Faulhaber
0e5874b585 Correct the last commit's grammer by adding a few 'the's. 
Noticed by:	keramida
 2002-05-12 02:09:18 +00:00
Chris D. Faulhaber
906ef8159a Add an entry to the Ports-specific FAQ describing what to do when a 
distfile changes without a version change (with some help by Dima).

Reviewed by:	dd
 2002-05-11 23:32:01 +00:00
Giorgos Keramidas
b11ddec147 Fix typo: detemrine -> determine. 2002-05-11 14:06:54 +00:00
David E. O'Brien
1b3932fb95 src/contrib has grown up 2002-05-09 00:24:17 +00:00
Juli Mallett
03965b6123 Consistently use &prompt.user; for the CVS examples. 
Reviewed by:	jim
 2002-05-06 19:13:38 +00:00
Robert Watson
25cbbf757a Chase an article that changed name: attempt to fix the staff-who.html 
link so it points to article.html instead.  Apparently this has been
broken for a bit.
 2002-04-30 08:05:16 +00:00
Bruce A. Mah
8c427a40b4 Round 3 (of 3) committers-guide changes. Nitpicks as follows: 
Americanis^Hze spelling in two instances.

Terminate an emoticon with extreme prejudice.

Approved by:	jhb
 2002-04-28 18:12:47 +00:00
Bruce A. Mah
02da3723b9 Round 2 (of 3) of committers-guide changes. Markup fixes and 
output-significant whitespace changes.

Approved by:	jhb
 2002-04-28 18:04:46 +00:00
Bruce A. Mah
78d5cb767a Round 1 (of 3) of changes to the committer's guide. Content changes 
as follows:

RELENG_3 no longer a noteworthy tag.

Refer to repository meisters and SO team more consistently, less
dependence on individuals.

Don't refer to core as "we".

Comment to help out doc translation teams.

Move myself to RE team and consolidate "Who's Who" listings accordingly.

Security branch changes need to be approved by SO or RE teams.

Add mentions of developers list, where appropriate.

Wording tweaks.

Approved by:	jhb
 2002-04-28 17:55:20 +00:00
Brian Somers
65a1c58250 Add a few section labels 2002-04-11 20:18:59 +00:00
Giorgos Keramidas
67a1702cec Remove almost all instances of "try and <verb>" from the docs. 
There is one remaining place in the fdp-primer, but that needs
a bit more work.

Inspired by:	docs/36462 (Gary W. Swearingen <swear@blarg.net>)
Reviewed by:	ceri, trhodes
 2002-04-07 23:52:37 +00:00
Murray Stokely
ba8c39298c Add the FreeBSD Mall, Inc. free CD subscription to the list of Perks. 2002-03-27 12:40:02 +00:00
Brian Somers
e00e208814 Add a ``Perks of the Job'' section. 2002-03-27 11:40:23 +00:00
Robert Watson
e05c4e1dab Add entries in the "who's who" for jake, tmm, and benno, with respects 
the the hardware ports they maintain.

I'm not sure who the official IA64 port maintainers is/are: dfr? peter?
 2002-03-25 17:04:25 +00:00
Robert Watson
4755d8eec5 Add jhb to the "who's who" list as SMPng manager. Point at the SMPng 
web page for guidance.

Markup reviewed by:	committer's guide maintainer <jhb>
 2002-03-25 16:56:38 +00:00
Robert Watson
81620407d5 Insert a new section in the Committer's Guide entitled "Commit Bit Types" 
which discusses the notion of areas of authority for the CVS repository,
the parties responsible for each area and allocating commit rights for it,
and general practices for expanding the scope of a commit bit to new
areas of the tree.  Throw in some text reminding everyone that review
of source code is always a good idea.

Approved by:	core@
 2002-03-25 16:31:13 +00:00
Ceri Davies
c952f7f788 Fix two typos and reword a sentence so it makes sense. 
Approved by:	murray, jhb
 2002-03-20 14:50:47 +00:00
Peter Pentchev
6e99166b51 Whitespace-only fixups from the e-mail to SGML entities conversion. 2002-03-15 08:28:14 +00:00
Peter Pentchev
81f0937cee Convert names, descriptions and e-mail addresses of FreeBSD committers 
and mailing lists to SGML entities.

Reviewed by:	keramida
Approved by:	keramida, silence on -doc
 2002-03-15 08:10:48 +00:00
David E. O'Brien
e2adaf5167 Note a rule of the developers@ list. 2002-03-08 19:52:25 +00:00
Michael Lucas
7f0ceea284 Explicitly state how to put files up on http://people.freebsd.org. It 
might be obvious, but I didn't know it when i started.

approved by: jhb (maintainer)
 2002-03-08 18:40:28 +00:00
Bruce A. Mah
ecdb9a72d6 Minor wordsmithing of my entry in the "Who's Who" section. 2002-02-16 20:23:44 +00:00
Jacques Vidrine
0022abb4b6 Add Security Officer to Who's Who section. 
Reminded by:	rwatson
 2002-02-06 17:45:08 +00:00
Alexey Zelkin
9b6ca7453f Move non-committers email address entities (re, faq, etc.) into 
own entities file (teams.ent)
 2002-02-06 17:05:51 +00:00
Jim Mock
71fdede655 Add a paragraph pointing people to des' shell script and its README for 
adding pgp keys to the handbook.

Suggested by:	nik
 2002-01-28 21:59:59 +00:00
Murray Stokely
b17f8fa162 * Remove Satoshi as Ports Wraith 
* Remove jkh as RE
* Add steve, murray, rwatson, jhb as RE team.

Submitted by:	jkh (commit_prep.pl is still being temperamental)
 2001-12-10 08:36:47 +00:00
John Polstra
f2a5200183 I am retiring from repo-meistering, at least temporarily. Update 
the documentation to reflect that.

Also, document (only 5 years after I started) that I am responsible
for the CVSup mirror sites.
 2001-12-01 18:29:35 +00:00
Peter Wemm
b9a19509fb After much agonizing, attempt to refine the commit log composition 
instructions.  The potentially conflicting instructions could be taken
to encourage less than ideal commit logs.  Explicitly say that we're
after a clear, concise and reasonable summary of the change.

Reviewed by:	obrien
 2001-11-28 21:25:56 +00:00
Chern Lee
fac4584d62 Reverse four instances in previous spelling-fix commit: 
* out takes -> outtakes
 * blinking lights -> Blinkenlights
 * hard coding -> hardcoding
 * place holder -> place holder

Pointed out by: des
 2001-11-05 19:13:01 +00:00
Chern Lee
98698f4f5e Spell check in articles: 
* outtakes -> out takes
 * themself -> themselves
 * manpages -> man pages
 * suprising -> surprising
 * Blinkenlights -> blinking lights
 * transmition -> transmission
 * coresponds -> corresponds
 * accessable -> accessible
 * disasserting -> dis-asserting (for lack of a better word)
 * harddisks -> hard disks
 * likelyhood -> likelihood
 * repeate -> repeat
 2001-10-31 23:10:31 +00:00
Murray Stokely
a4cf0e1eba Fix broken links. 
PR:		docs/31447
Submitted by:	Cyrille Lefevre <clefevre@citeweb.net>
 2001-10-23 21:19:23 +00:00
Mike Barcroft
84255d06ed Add guidelines for deprecating features. 
Partially submitted by:	sheldonh
Approved by:		-developers
 2001-10-23 17:11:14 +00:00
Giorgos Keramidas
0b824da1aa Remove all contractions from most of the articles. This solves the 
problems with the usage of "its" vs "it's" among other things

Approved by:	nik
 2001-10-16 11:53:01 +00:00
Giorgos Keramidas
fb07ee81fc Replace quote characters with SGML <quote>. 
Also add an <xref> to a section instead of quoting it's title.

Approved by:	nik
 2001-10-15 13:26:02 +00:00
Mike Barcroft
5c3cd78ad4 Correct the Committer Guide: 
newsflash.sgml is now news.xml

Discussed with:	nik
 2001-08-22 23:16:09 +00:00
Murray Stokely
65edfaeafc Update links to the Handbook Contributors chapter and Staff appendix 
to point to the new Contributors List article instead.
 2001-08-06 22:43:27 +00:00
Nik Clayton
563344e601 Add an entry for myself in to "Who's Who". 
This originally wasn't going to be quite so self-serving a commit.  But I
see that Dima has already committed the other patches to this file while
I wasn't paying attention. . .
 2001-07-16 15:33:07 +00:00
Dima Dorfman
62e08c0139 Use &os.current; and &os.stable; where appropriate. 
Submitted by:	Mike Barcroft <mike@q9media.com>
 2001-07-15 06:33:28 +00:00
Dima Dorfman
f5838bd6ef Document 'MFC after:'. 
Submitted by:	Mike Barcroft <mike@q9media.com>
 2001-07-15 05:22:50 +00:00
David E. O'Brien
0caaf5d84f When PHK committed rev 1.50, he did not adjust the references to particular 
rule numbers to take into account the new numbering.
 2001-07-14 03:38:03 +00:00
Nik Clayton
5a8491908e Switch to using version 4.1 of the DTD. 2001-07-13 15:36:28 +00:00
Nik Clayton
3ed1f7ea58 Favour <command> over <literal> when talking about CVS subcommands. 
PR:		docs/28731
Submitted by:	Giorgos Keramidas <keramida@ceid.upatras.gr>
 2001-07-11 14:08:50 +00:00
Nik Clayton
ee0aacd375 Add more details about the "cvs log" command. 
PR:		docs/28730
Submitted by:	Giorgos Keramidas <keramida@ceid.upatras.gr>
 2001-07-11 13:22:17 +00:00
Dima Dorfman
73e2ee8aa9 Assorted spelling, punctuation, and markup fixes. 
PR:		28732
Submitted by:	Giorgos Keramidas <keramida@ceid.upatras.gr>
 2001-07-08 01:17:53 +00:00
Nik Clayton
1c985b66c3 Mention calendar.freebsd as something a new committer might want to 
contribute to.
 2001-06-22 08:18:55 +00:00
Andrey A. Chernov
f749b200c1 ISO_* -> ISO* rename 2001-06-11 01:20:40 +00:00
Nik Clayton
ad13c1c330 Link to Karl Fogel's chapters on how to use CVS. 
Submitted by:	joe
 2001-06-09 14:01:06 +00:00
Dima Dorfman
006caeb4c3 DocBook police: use man page entities where appropriate. 2001-06-03 21:39:52 +00:00
Dima Dorfman
b8a47158e4 Explain that src/contrib, src/crypto, and src/sys/contrib are off 
limits without explicit maintainer approval.

Asked about but thread drifted off into other matters on: developers@
 2001-06-02 05:45:59 +00:00
Gregory Sutter
357f80a5ed Correct punctuation and grammar. 
Reviewed by:	dd, chris
 2001-05-29 19:29:25 +00:00
Nik Clayton
6895e948d5 Alphabetize the "Who's Who" list. 2001-05-13 15:44:20 +00:00
David E. O'Brien
9906e5666d Fix a mismatched '('. 
Submitted by:	eric
 2001-05-12 08:07:35 +00:00
David E. O'Brien
a0dc93d3a5 Replace Obersturmbahnfuhrer with "Meister" -- someone who has earned an 
official degree in craftmanship (which is required to allow teaching the
profession to others).  There are overtones with "Obersturmbahnfuhrer"
that we should avoid.

Requested by:	Jens Schweikhardt <schweikh@schweikhardt.net>
 2001-05-12 02:07:27 +00:00
Bruce A. Mah
332440afa1 Reflect that the release notes could live in one of two directories. 2001-05-11 04:38:52 +00:00
Jens Schweikhardt
e987a4430a Fixed typos and grammar bogons. 2001-05-07 15:46:10 +00:00
Nik Clayton
f384f4e578 "Bruce" in the previous commit is Bruce Evans, bde, and not any of the other 
Bruces we have floating around the project.

G'day Bruce.
 2001-04-27 10:08:44 +00:00
Nik Clayton
bb50fb63d7 Completely rewrite question 10.1 ("Why are cosmetic changes on the vendor 
branch a bad idea?") with more correct information provided by Bruce.
 2001-04-27 10:07:52 +00:00
Nik Clayton
3701fb2419 Clarify the text for a commit from a PR, making it clear that the explanatory 
text should not be part of the log.
 2001-04-08 17:26:41 +00:00
David E. O'Brien
d135bff76f Back out rev 1.57. It wasn't clear to me what was being said in rev 1.56. 
Hopefully the header "Commit log" will bet tweaked to not give the
impression the example is supose to be a complete log message and thus
the text is an example of a good commit message.
 2001-04-07 18:22:32 +00:00
David E. O'Brien
9c0b49da1f Steve Price isn't the [unoffical] maintainer of `src/bin'. 
Steve says: "That's just plain wrong."
 2001-04-05 20:35:49 +00:00
David E. O'Brien
eff1349e39 Change the example commit message of rev 1.56 to one that has content vs. 
stating the obvious in-order to give a better example of what a minimal
commit message should be.
 2001-04-05 20:34:32 +00:00
Nik Clayton
72210abed1 Document our oral tradition in re what meta information to include at the 
bottom of a commit message, and the format that information should take.
 2001-04-04 11:54:01 +00:00
Nik Clayton
f9e2cffeab Remove the frames from some of the tables. Make some of the 
<informaltable>s real <table>s, with a title (instead of putting the
notional title in a <para> immediately before it.

Add Bruce Mah to the Who's Who section for the Release Notes.

Add Ruslan Ermilov to the Who's Who section as Mr mdoc(7).
 2001-04-04 08:31:49 +00:00
Jun Kuriyama
72d0d0a0e3 Fix breakage in previous commit. 
Usage of <term> in <varlistentry> must be <term>+ (no characters allowed
between each <term>).
 2001-04-04 00:52:50 +00:00
David E. O'Brien
570b771e8e Add the Alpha points of contact. 
Add myself as src/contrib consultant.
Note Bruce and Garrett as ones to consult RE standards issues.
 2001-04-03 16:12:05 +00:00
David E. O'Brien
6df2bb3d4e Fix spelling errors. 2001-04-03 16:04:54 +00:00
Ben Smithurst
905911ab27 Try not to give the impression 'cvs import' should be used for ports. 
Reviewed by:	jhb
 2001-03-28 23:43:47 +00:00
Poul-Henning Kamp
86b72726db Add a new rule to the committers: respect other contributors as well. 
There has been plenty of discussion about how to actually ratify
such rules, but nobody has opposed this specific rule (which is a
good show of maturity btw).

In the end the conclusion is that this is not really any different from
the rest of the tree: If it makes sense: commit it, if it creats an
uproar, back it out and paint the bikeshed.

QED.

PR:		25783
Submitted by:	Dan Langille <dan@langille.org>
Reviewed by:	developers
 2001-03-28 10:55:43 +00:00
Brian Somers
69fb29a67b /usr/bin/ppp -> /usr/sbin/ppp. 
Also, I think I modified lpd once about two years ago.  Relinquish the
apparent title of ``maintainer''.
 2001-01-25 00:09:15 +00:00
Trevor Johnson
05e23a69fd Mention the pgpkeys file. 
Looked at by:	will

Update copyright.
 2001-01-15 03:49:03 +00:00
Daniel Harris
f5d071f028 environmenet -> environment 
PR:		24234
Submitted by:	Jimmy Olgeni <olgeni@uli.it>
 2001-01-13 02:04:07 +00:00
Chris D. Faulhaber
c04b5861e1 Update link for CVS reference information 2000-12-28 13:40:03 +00:00
Jim Mock
78991380db Add the cvs-committers and developers mailing lists to the Who's Who 
section of the committer's guide.  While I'm here, change some
instances of freebsd.org to FreeBSD.org.

Submitted by:	obrien
 2000-12-05 21:39:14 +00:00
Dmitry Sivachenko
8787cae6a4 Fix typo. 
Approved by:	sobomax
 2000-11-14 11:11:56 +00:00
Maxim Sobolev
b0f39ddd51 Add a note that leaving `cvs ci' in message editing mode for long period of time 
is no-no.

Reviewed by:	jhb
 2000-11-03 19:01:27 +00:00
David E. O'Brien
c6c4270992 Capitalize "Alpha". 2000-10-09 17:09:14 +00:00
David E. O'Brien
bad7c214a0 We do not have a Principal Architect any longer. 2000-10-09 17:08:39 +00:00
Alexander Langer
5d6b8a0d89 Back out the bento -> onigiri change, it was wrong. 
Submitted by:	obrien
 2000-10-02 08:31:25 +00:00
David E. O'Brien
dd7cbed941 Document developers@freebsd.org 2000-10-02 04:23:21 +00:00
Alexander Langer
d1affdab96 Minor changes: 
* bento -> origini
* reflect 4-stable & 5-current.

Submitted by:	James Housley <jim@thehousleys.net>
 2000-09-30 14:25:53 +00:00
Kris Kennaway
b256c3a748 Overhaul the documentation relating to crypto and related topics. Some of 
this stuff had been out of date for 3 or 4 years or more.

Reviewed by:	alex
 2000-09-24 07:01:53 +00:00