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

340 commits

Author SHA1 Message Date
Ceri Davies
b16f3e6505 Add reminders to new committers to ensure that they do not omit commits 
to files containing entity declarations.
 2004-04-20 18:43:19 +00:00
Ceri Davies
34faed2813 Standardise some spelling. Translators can probably ignore this. 2004-04-20 18:35:00 +00:00
Warner Losh
4f1a845d7f document that we are discouraging the advertising clause. Also 
document that we have begun discouraging variants in the license, as
well as completely new licenses.

Approved by: core@
 2004-04-09 06:13:10 +00:00
Warner Losh
94d915e0c0 Add preferred license so that people know what it is. 
Docbook'd by: trhodes
 2004-04-09 05:59:21 +00:00
Ken Smith
83ed0cc555 Added information about the new ~/.spam_lover knob for turning off 
spam checks done on mx1.  While here emphasise SSHv2 is now the only
way to connect to project hosts, SSHv1 got turned off.
 2004-04-05 14:57:08 +00:00
Alexey Zelkin
3f2ab786f5 freebsd.org -> FreeBSD.org 2004-04-04 21:40:58 +00:00
Mark Linimon
1d33692e8e Add a detailed list of instructions on how to add a new category to the 
ports collection.  One step is not yet defined; hopefully this will be
resolved soon.

PR:		docs/64144
Reviewed by:	eik and many others
Approved by:	ceri (mentor)
 2004-04-04 17:05:14 +00:00
Dag-Erling Smørgrav
9552d3a629 Rewrap a paragraph. Translators can safely ignore. 2004-04-02 19:30:29 +00:00
Dag-Erling Smørgrav
58b980fce6 Rewrite the paragraph about mentorship to reflect current practices. 
Also tweak a paragraph about committing to -CURRENT before -STABLE to note
that this only applies to src.
 2004-04-02 19:26:47 +00:00
Hiroki Sato
143cfc378c Update lists of re@ members. 2004-04-01 19:43:15 +00:00
Alex Dupre
caad1d9406 Record new port repocopy procedure. 
PR:		docs/63315
Submitted by:	pav
Approved by:	blackend
 2004-02-27 15:23:15 +00:00
Josef El-Rayes
0f4b0e49a9 Note that ssh2 uses id_(r|d)sa.pub instead of indentity.pub 
and pubkeys are now stored in /c/ssh_keys

Pointed out by: arved
Approved by:    simon(mentor)
 2004-02-21 15:59:56 +00:00
Simon L. B. Nielsen
e81e50fafa new-account.sgml: 
- Remove the requirement for mentors to send PGP keys of new
  committers to admins@.

committers-guide/article.sgml:
- Update copyright year.
- Emphasize that new committers should add their PGP key to the
  Handbook, since it might be needed for identification, e.g. for
  account recovery.

teams.ent:
- Add an entiry for admins@.

Discussed with:	admins (joe, kensmith)
 2004-01-17 19:29:56 +00:00
Alex Dupre
bd05679acf FreeBSD Services Limited doesn't offer a free DVD subscription to FreeBSD 
committers any more.  FreeBSD Mall, Inc does it, so clarify the title.

Approved by:	blackend (mentor)
 2003-12-28 20:57:24 +00:00
Simon L. B. Nielsen
4071843a8a Add trademark attribution for CVSup. 2003-12-24 00:26:41 +00:00
Peter Wemm
23c58fd7b6 Gulp. Bump amd64 to Tier-1 after discussions with the appropriate people. 2003-11-22 01:34:19 +00:00
Ken Smith
64b915781f PR: 
Reviewed by:	blackend (mentor)
Approved by:	blackend (mentor)
Obtained from:
MFC after:

Change cvsup-master maintainer from jdp to kuriyama.
 2003-08-15 15:24:51 +00:00
Simon L. B. Nielsen
5421dc303f Add trademark symbols and attributions: 
- Add trademark tags as needed, generally on first use in each
   article.
 - Add an attribution to the legal section mentioning all trademarks
   referenced.
 - Always use correct case for trademarks.
 - Don't join trademarks with other words, e.g. using hyphens.

trademark.ent:
 - Commonly used trademarks are defined as entities for ease of use.
 - All trademark attributions are defined as entities for ease of use.

Approved by:	ceri (mentor)
 2003-08-06 21:48:40 +00:00
Alexander Langer
057a60e02a When removing or repo-copying ports, it's now also required to 
add an entry to the MOVED file.

Inspired by:	kris (implicitely)
 2003-07-23 13:11:14 +00:00
Ceri Davies
6ddad465a9 Whitespace cleanup; translators please ignore. 2003-07-13 16:15:52 +00:00
Ceri Davies
f1217b46df Move the section on shell aliases together with the discussion on performing 
CVS operations, where it fits slightly better.

Note to translators: I have tried to be sensitive to whitespace here, but it
has proved to be quite difficult in both this and the last revision.  Apologies
in advance.
 2003-07-13 16:09:56 +00:00
Ceri Davies
97b2f24f05 Update the CVS Operations section for the split repository situation. 2003-07-13 16:04:35 +00:00
Peter Wemm
37b6dff026 Bump AMD64 from Tier-3 (experimental) to Tier-2. 
In reality, it is pretty close to Tier-1, but there are still a few
loose ends that need to be taken care of before locking down ABIs etc.
It was actually included in 5.1-RELEASE and it now has pre-built ports
packages etc.
 2003-07-12 01:04:23 +00:00
Ceri Davies
770ecf336f Various grammatical fixes. 
PR:		docs/53913
Submitted by:	Chris Pepper <pepper@rockefeller.edu>
 2003-06-30 18:34:41 +00:00
Marc Fonvieille
4dfc0b1405 Update links regarding pgpkeys to match new pgpkeys files location 
(doc/share/pgpkeys).
 2003-05-08 10:21:18 +00:00
Giorgos Keramidas
6dd95937d9 Put my flame resistant suit on, and remove all unnecessary duplication 
of URL text in <ulink> attributes, reducing the probability of typos
in future changes to the docs.
 2003-04-11 01:11:39 +00:00
Giorgos Keramidas
b3ba24f9f7 Avoid excessive use of "also" and split a sentence in two smaller parts. 2003-04-10 23:40:43 +00:00
Nik Clayton
a466409979 Remove the direct reference to me, and replace it with text that talks 
about doceng, and its role.
 2003-03-29 13:30:34 +00:00
Giorgos Keramidas
998c5f45c5 Two <filename> elements separated by a single dot look very funny in 
the output.  Abuse Philippe Charnier's favorite "The FOO thing" trick
to slightly improve the way things look.
 2003-03-27 16:35:29 +00:00
Ceri Davies
5c58573e3e More grammar changes; it's worth translators casting a glance at this. 2003-03-01 23:08:14 +00:00
Ceri Davies
3862f17080 Forced commit. 
r1.159 also removed a link to the send-pr.html page, as this is no
longer useful.
 2003-03-01 22:30:06 +00:00
Ceri Davies
f30a5cf6c8 o Mention that doceng are responsible for doc commit bits. 
o doc committers are also the group primarily responsible for www/
o Update an outdated example GNATS categories file
o Point a link to the Staff list at the Staff list
o Remove the text associated with the "Don't Touch The Repo" Rule
o Update references within the Big List of Rules
 2003-03-01 22:24:58 +00:00
Ceri Davies
fad95edc7e Grammatical changes which translators should be able to ignore. 2003-03-01 22:19:04 +00:00
Ceri Davies
1f0ea1169e Spelling and grammatical nit-picking. 2003-03-01 01:36:25 +00:00
Mike Barcroft
2780b3d130 Remove the "Never touch the repository directly" rule. Committers no 
longer have direct access to RCS files.

No objections from: -developers
 2003-02-22 05:21:12 +00:00
Marc Fonvieille
b0e0a590b4 Contractions hunting. 2003-02-18 11:36:42 +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
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
Ben Smithurst
fda7bf8bf8 Specify that committers should use a umask of 2 on freefall, so that 
files/directories added to the repository get the correct group-writable
permission.
 2000-08-23 20:36:53 +00:00
Daniel Harris
1d3c1680b6 Add a missing space ("the add _ command"). 
New committers should add themselves to the "Developers" section, not the
"Developer's" section.
 2000-08-16 17:41:40 +00:00
Jun Kuriyama
61306ad2cc Add &man.vim.1; entry. 
Fix bugs in using <screen> element.
Use $FreeBSD$ instead of $Date$.
 2000-08-15 01:39:52 +00:00
Josef Karthauser
407df909f1 Add a note that you can use the vim editor as a useful tool for viewing 
diffs, logs, etc, with syntax highlighting switched on.
 2000-08-13 14:07:12 +00:00
Ben Smithurst
023e3aa0ef Mention 'addport' instead of 'easy-import' as the method for adding new 
ports.

Approved by:	jhb
 2000-08-05 21:05:39 +00:00
Ben Smithurst
17d5973aca Mention that SSH is in the base system from 4.0 onwards. 
Approved by:	jhb
 2000-07-29 00:47:52 +00:00
Ben Smithurst
ff5aaba5d8 Fix some stupid mistakes I made when adding des' CVS primer: 
* $FreeBSD$ shouldn't be expanded when used in the explanation of
   conflicts.
 * Add some markup bits I missed, fix typoes, fix broken hyphenation
   caused by joining lines together which had hyphenated words split over
   them.
 2000-07-26 17:53:17 +00:00
Ben Smithurst
027be86094 Add mini CVS primer. 
Text submitted by:	des
Approved by:		jhb
 2000-07-26 01:17:18 +00:00
Mark Ovens
7a947097f5 Add note about the use of tags when cvsup'ing the GNATS tree. 2000-07-24 20:02:45 +00:00
Nik Clayton
a26dd557eb Rewrite the abstract. This isn't just a CVS document any more. 
Shift the information about the repository-meisters in to the first
section about CVS.

Re-write the list of things that a new committer should do as a numbered
list.  Mention the existence of the xearth committers' markers file.
 2000-07-23 16:22:16 +00:00
Mark Ovens
22b4847fcb Changed out of date section reference in Conventions & Traditions 2000-07-13 21:07:52 +00:00
Kevin Lo
73c016c2cd Correct the link for porters handbook 2000-07-10 15:01:52 +00:00
Daniel Harris
6312bd2fb1 Corrected links to CVS info at cyclic.com, various grammar and typo fixes. 
Also reworded in a couple places for clarity's sake.
 2000-07-08 15:32:00 +00:00
Nik Clayton
d3d532c64f * RCS Date string in <date> 
* Add year to <copyright>

 * Explain how you can use CVSup to download the PR database, and then
   teach a local copy of GNATS about the files you've installed, to make
   it easier to query them without being online all the time.

   Prompted by Warner's query on -committers last month.  Doing this is
   actually fairly trivial, but I figure a lot of you'll benefit from it.

 * Change some &prompt.user; to &prompt.root; (as far as I can see, you
   need to run the commands as root).

 * Update a link to point to the Porter's Handbook.
 2000-06-08 18:12:54 +00:00
John Baldwin
dff69dd1ee - Update the copyright to include 2000 
- Fix capitalization of the title of the last section
- Add a new FAQ to the Misc. Questions section that explains how to add a
  file to a CVS branch, complete with a real-life example.
 2000-05-24 21:40:56 +00:00
Bill Fumerola
7ba3bbea62 asami-san controls ports freezes, not code freezes. 2000-05-19 19:08:00 +00:00
Nik Clayton
9e3b2b0844 Drop a few instances of the word "new" from this, as it's something all 
committers should re-read every now and then, and not just when they get
handed the hat.

Prompted by:	asami
 2000-04-07 09:52:20 +00:00
Nik Clayton
bcd4ff78fc Tell the new committer to add themselves to www/en/news/newsflash.sgml 2000-04-03 23:12:27 +00:00
Jordan K. Hubbard
77b3e4f98d Add mention of RELENG_4 tag 2000-03-26 20:33:34 +00:00
John Baldwin
de56fa420c Whitespace cleanups. Translators can ignore. 2000-02-03 02:38:10 +00:00
John Baldwin
e49d537086 Patch to the committers guide including several grammar fixes, markup 
fixes, and re-wordings to try and make the text clearer. I also expanded
several contractions, mentioned Bill Fenner's whodid script, and added a
couple of clarifications.

Reviewed by:	obrien, nbm
Reviewed by:	Will Andrews <andrews@technologist.com>
 2000-01-27 15:31:37 +00:00
John Baldwin
20193a67fe Add a new paragraph to the suggestions section stating that 
style/whitespace changes should not be mixed with functionality/content
changes but should be done in separate commits.

Requested by:	obrien
 2000-01-22 04:15:21 +00:00
Nik Clayton
a8ab59b6bc Add a new "miscellaneous questions" section. The first question is "Why 
are changes to files on the vendor branch a bad idea?", and the answer is
supplied by an (almost) verbatim excerpt from one of Peter Wemm's messages
to committers (<19991129055252.65D5E1C6D@overcee.netplex.com.au>).
 2000-01-19 22:37:18 +00:00
John Baldwin
1fcca0967c Update the section on SSH to include a blurb on OpenSSH. Also update some 
other references to ssh to make them reflect reality a little better.

Submitted by:	green
 1999-12-08 05:31:55 +00:00
Alexey Zelkin
74307f88b3 "Don't forget to remove yourself from the Additional Contributors 
section " (c)

Reviewed by:	maintainer
 1999-10-30 13:05:59 +00:00
Alexey Zelkin
c7e21561e5 A HREF="mailto:maillist" -> A HREF="mailto:maillist@FreeBSD.org" 
"phraze" -> <qoute>phraze</quote>

Reviewed by:	maintainer
 1999-10-15 12:46:41 +00:00
John Baldwin
a54d72c628 Merge the ports committers' guide into the new committers' guide. 
Reviewed by:	nik
 1999-09-29 02:12:37 +00:00
Bill Fumerola
1ff360dbbe Remove a few lines that made this still read like a letter rather 
then a guide.

Reviewed by:	jhb
 1999-09-23 04:42:47 +00:00
John Baldwin
fc9d0ed5e4 - Spelling fix: 'cypto' -> 'crypto' 
- A few 'freebsd' -> 'FreeBSD' fixes
 1999-09-23 01:45:29 +00:00
John Baldwin
afbb1dbec4 Slightly reword a sentence. Also, the 'Big List of Rules' belongs to 
all committers, not just one unnamed one.

Reviewed by:	jim
 1999-09-16 02:48:02 +00:00
Nik Clayton
19d4d8cc1a Add the big list of rules that was thrashed out on -committers recently. 
Final text was from JKH, I ran it through the txt2docbook filter.
 1999-09-15 19:14:48 +00:00
John Baldwin
a803a09790 Minor whitespace cleanup. 1999-09-09 13:16:59 +00:00
Mark Murray
2fb650b74f Update the bit about using SSH/Kerberos5 to connect to the FreeBSD 
servers. Also update the bit about crypto code and my role with it.
 1999-09-08 18:17:39 +00:00
John Baldwin
cbc5c27ed4 Extend the Ports Wraith's description to include being a repo meister 
for ports/.

Requested by:	asami
 1999-09-04 00:02:37 +00:00
John Baldwin
2e5188748f Add descriptions of the International Crypto Repo at internat.FreeBSD.org 
and suitable mentions of its maintainer, markm.

Requested by:	markm
 1999-09-03 23:58:13 +00:00
Nik Clayton
5f291ead9b The FreeBSD New Committer's Guide. The original text version was worked 
on by many people, the SGML conversion has been carried out by the new(ish)
committer, John Baldwin.  Cheer's John.

Changes from the submission:

  1.  It's an article, not a book.  I originally thought there was going
      to be sufficient content (when you include the committers rules
      that are being thrashed out at the moment, and Satoshi's ports
      committer stuff) to make this worth being a book.  After seeing the
      content I changed my mind, so it's an article.

  2.  Various contractions ("you're" and so on) expanded to make life
      a little easier for the translators.  Kept one ("Who's Who").
 1999-09-03 17:10:42 +00:00