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

209 commits

Author SHA1 Message Date
Marc Fonvieille
b0e0a590b4 Contractions hunting. 2003-02-18 11:36:42 +00:00
Hiroki Sato
ee5bf07c5d Replace ${JADEFLAGS} with the corresponding variables. 2003-02-16 14:59:48 +00:00
Will Andrews
0e579ad8f2 Add suggestions for conflict resolution. 
Submitted by:	wes
Reviewed by:	grog, imp
 2003-02-08 23:43:56 +00:00
Giorgos Keramidas
ceafe46b44 Wrap `bento' in <hostid> tags, and s/remote repo/remote repository/. 2003-02-01 17:45:58 +00:00
Murray Stokely
3867b5d5b6 Update information to reflect the fact that DVD products are also 
available for free to FreeBSD committers from FreeBSD Mall, Inc.
 2003-01-28 03:50:08 +00:00
Bruce A. Mah
ef6cfded5d Update the personnel listing of RE team members. 2003-01-21 23:08:04 +00:00
Dag-Erling Smørgrav
c762a514a7 Whitespace cleanup. 2003-01-15 12:18:04 +00:00
Wilko Bulte
de0d9adcb1 Clarify committer relationships, and what core will take into account 
when judging complaints brought before core.

Requested & reviewed by: core
With hat: core-secretary
 2003-01-15 08:31:26 +00:00
Marc Fonvieille
93099e62cc Add infos about the Core Team monthly reports, and on the 
archives of FreeBSD developers and FreeBSD committer's lists.

PR:		docs/46963
Submitted by:	gerald
 2003-01-11 11:43:55 +00:00
Tom Rhodes
2ac87c170a Fix the paths to bento. 
PR:		46808
Submitted by:	marcus (original version)
 2003-01-08 19:29:54 +00:00
Mario Sergio Fujikawa Ferreira
d0a5882fe5 o Improve answer introduction on "What do I need to do?" for the 
Repository Copy question on Porter's FAQ
o Reviewers wrote the committed version

Reviewed by:	adamw, ceri, steve, tom,
		"Gary W. Swearingen" <swear@attbi.com>,
		Warren Block <wblock@wonkity.com>
 2002-12-31 18:49:05 +00:00
Tom Rhodes
fcbbf2c56b Wrap lines && fix some spelling errors. This was not introduced during my 
last commit.
 2002-12-26 17:46:53 +00:00
Tom Rhodes
5d9fa5e183 Add a Q&A about where committer mail is stored. This question seems to appear 
every once in awhile, and has been a long time (ago) request from obrien.

Requested by:	obrien (several months ago)
 2002-12-26 17:17:45 +00:00
Ceri Davies
6888441d55 Spelling fixes, courtesy of ispell. 2002-12-15 22:19:02 +00:00
Robert Watson
c0cebfe301 In the interests of technical accuracy, re-interpret sparc65 as sparc64. 
Spotted by:	jake
 2002-11-02 16:48:43 +00:00
Robert Watson
5b2d650936 Upgrade sparc64 from a Tier 2 platform to a Tier 1 platform. 
Add S/390 as a Tier 3 platform.

Approved by:	core
 2002-11-02 00:28:25 +00:00
Alexander Langer
d558fc6c47 ncvs.FreeBSD.org is now the main repository host. 
Describe how to commit on ncvs.FreeBSD.org using remote CVS.

Add a note to NOT use the main repository host as your personal
cvs server, as inspired by peter's mail to developers@ a while back.
Refer to the cvsup distribution method and cvsup-master instead and
give an example of an "fcvs" alias, as suggested by many committers.

Reword or remove various paragraphs about not modifiying the repository
yourself, which is no longer possible, since only repomeisters have
access to ncvs.FreeBSD.org.

Remove the paragraph about CVSUMASK, which no longer applies.
 2002-10-24 18:54:17 +00:00
John Polstra
2efcfdddbb Correct an error in the instructions for using cvpasswd. 
Noticed by:	gerald
 2002-10-14 23:18:35 +00:00
Bruce A. Mah
0e7089dc83 For some reason, brian wasn't listed as a member of the RE team in the 
committers-guide.  Fix this.
 2002-10-10 17:44:48 +00:00
Robert Watson
227d30fb09 Add x86-64 as a Tier 3 platform: we're currently able to boot the i386 
FreeBSD implementation on it at production quality, and x86-64-specific
code is in progress in a combination of the main FreeBSD CVS repository
and Perforce.  Once x86-64 native support is appropriately improved, we
can migrate it to Tier 2.

Requested by:	obrien
Approved by:	core
 2002-10-04 16:13:48 +00:00
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
f68cc9b180 Adjust JADEFLAGS, to generate a table of contents for this article. 2001-04-08 17:26:59 +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