Commit graph

375 commits

Author SHA1 Message Date
Gavin Atkinson
c305236322 Fix a cross-reference that should point to the Subversion guide, bit instead
pointed to the CVS guide.  Also add a cross-reference to the Subversion
giude within the CVS information itself.

Approved by:	jkois (mentor)
2012-04-03 12:07:47 +00:00
Eitan Adler
17dc2529c9 - Add information on merging to other share/ subdirectories
- While here fix a style nit: "man pages" -> "manual pages"

Approved by:	simon
2012-03-24 18:21:49 +00:00
Eitan Adler
671d3cc419 - Remove broken instructions for installing GNATS on your local machine
- Add information about useful GNATS tools (change-pr and friends)
- Clean up mirroring instructions a bit

Approved by:	miwi
2012-03-20 02:53:54 +00:00
Glen Barber
2a3f2c0dc1 Remove a reference to the Vendor Import section that does not yet
exist.  (My fault for not noticing this section does not exist when
originally committing this.)

Submitted/patched by:	Isabell Long (isabell121%gmail!com)
2012-03-17 22:53:56 +00:00
Glen Barber
53f56c7b9d - Link to Subversion Primer in Committer's Guide rather than the wiki
- Use <note> rather than "It is important to note that"
- Grammar fixes

PR:		165920
Submitted by:	crees
2012-03-11 15:32:12 +00:00
Ryusuke SUZUKI
7267f81a2b PR: docs/165909
Mention stable/9 tag as noteworthy in Administrative Details

Submitted by:	crees@
2012-03-11 01:17:35 +00:00
Glen Barber
faee8549f6 Remove retired mailing lists from documentation.
Submitted by:	sahil
PR:		165436
2012-02-24 14:10:05 +00:00
Glen Barber
184378d10f Add the Wiki SubversionPrimer entry to the Committers' Guide.
This work was done as part of Google Code-In (GCIN) 2011.

GCIN student:		Isabell Long (isabell121 gmail com)
GCIN task mentors:	des, rea
Minor rewriting by:	gjb (myself) [1]

[1] The original task was to put this in the Developers' Handbook,
but as discussed with des, the CVS information is in the Committers'
guide; the Subversion Primer entry likely belongs here as well.
2012-02-17 22:34:05 +00:00
Chris Rees
1d194a0a68 Stop talking about CVSROOT-ports/modules; Edwin has been updating that for years
PR:		docs/163408
Submitted by:	crees (me)
Approved by:	remko
2012-01-14 11:48:00 +00:00
Manolis Kiagias
b24813b19c Fix the build. While here, bump copyright year to 2012. 2012-01-05 06:35:47 +00:00
Doug Barton
e5f1e369b1 Update the section on restoring a previously deleted port
- Specifically add a step for 'cvs add' of the new files
- Group related steps (category/Makefile, MOVED, LEGAL),
  and suggest committing it all in one go.

While here peform some other minor tweaks to wording
2012-01-05 03:00:52 +00:00
Chris Rees
f7cefbb992 Note that mentor approval is required for all patches, however trivial
PR:		docs/162504
Approved by:	gjb
2011-11-12 17:57:14 +00:00
Mark Linimon
c10e6ae076 Add new text: "Re-adding a Deleted Port". 2011-11-11 23:51:12 +00:00
John-Mark Gurney
d3dcf6d039 reword so that the module/repo are not seperated...
Approved by:	manolis
2011-10-15 20:25:24 +00:00
Glen Barber
ca5ad47f4e Document that FreeBSD developers may request a hostmask cloak on the
Freenode IRC network.

Submitted by:		eadler
PR:			160405
2011-09-11 18:04:15 +00:00
Hiroki Sato
d45a5d1627 - FreeBSD/pc98 is a Tier 2 platform now[*].
- Use &arch.*; for architecture names consistently.

Discussed with:	nyan, re, so, and core[*]
2011-08-01 06:51:56 +00:00
Glen Barber
e622a59b6d Note that entries to contrib.committers.sgml and pgpkeys-developers.sgml
are sorted by last name.

PR:		158986
Submitted by:	zi
Approved by:	jkois (mentor)
2011-07-18 12:57:33 +00:00
Simon L. B. Nielsen
6d33c08c04 Clean up the "Administrative Details" section of committer's Guide:
- Force column width to improve rendering.
- Remove a number of pieces of information which is either obsolete or
  just not important. This includes removing reference to using telnet
  which was already obsolete when I got a commit bit in 2003...
- Point people at freefall.
- Remove the hardcoded lists of members of cvsadm and GNATS admins -
  this just duplicated administration.html and new committers should
  not need to bug the two teams so often that they need to be pointed
  out more than the many other active administrative teams. [1]
- Point at dcvs and pcvs for CVS repo's, as those are still in use by
  developers.
- Don't use entities for internal mailing lists which expands to the
  names as the result is just confusing and not useful. This part
  should probably be changed to be a section with more text instead of
  trying to include most info inside a table.
- Add information about portmgr monthly reports.
- Add a few links to some useful internal pages with more information.
- Misc minor text cleanup.

Discussed with:	linimon, gavin [1]
2011-06-16 19:40:12 +00:00
Hiroki Sato
a5a26d26bd Remove sun4v. 2011-05-14 20:44:31 +00:00
Colin Percival
2b293f346d Remove the paragraph listing jhb@ as the manager of the SMPng project;
said project is now long since completed, and there are enough people
with SMP-fu around that there's no need to point everybody at a single
target.

No objection from: jhb
2011-03-24 20:09:24 +00:00
Marc Fonvieille
09aa72e9bc Update re@ team members list to reality. While I'm there create a
&team.re; entity to help future use of a such list.  Other teams may
want to follow the same scheme.

Approved by:	re@
Oudated list spotted by:  ryusuke@
2011-03-17 19:05:11 +00:00
Glen Barber
0281f91848 s/ports management team/Ports Management Team/
Approved by:	jkois (mentor)
2011-03-12 18:11:05 +00:00
Glen Barber
2234cda90a Add notes about the ports slush to the committer's handbook.
PR:		155391
Submitted by:	eadler
Approved by:	jkois (mentor)
2011-03-12 17:59:22 +00:00
Daniel Gerzo
53e9cd78a1 - fix typos
PR:		docs/155366
Submitted by:	eadler
2011-03-08 09:47:13 +00:00
Ryusuke SUZUKI
2c1097b868 s/the the/the/
PR: docs/154950
Submitted by: Eitan Adler <lists at eitanadler dot com>
2011-02-22 10:27:25 +00:00
Mark Linimon
df3f30b9ef Add a bit of back-fill to make the procedures for e.g. GNATS-only
committers more explicit.  This section needs a bit more work.

While here, promote a paragraph to a note, while leaving whitespace alone.
2011-02-19 09:34:25 +00:00
Ryusuke SUZUKI
4082f2cf0b - Update copyright year to include 2011
- Remove mention of RELENG_6

PR: docs/154836
Submitted by: sahil
2011-02-17 15:43:01 +00:00
Gabor Pali
d4776d41d2 - Explicitly note location of addkey.sh
PR:		docs/149132
Submitted by:	sahil
2010-07-31 10:39:08 +00:00
Romain Tartière
22fddaeffe The addport command must be run from the committer's machine, not from
freefall.
2010-06-06 09:34:40 +00:00
Ulrich Spörlein
b210b0cf9c * add guideline hint to change the wiki group membership for new committers
* mention svn-arc-all along with cvs-all, the latter is not applicable for src
* update to 2010

Approved by:	hrs, philip (mentor)
No screaming:	keramida
2010-02-01 14:07:51 +00:00
Alex Dupre
da75fe2ab1 Fix cut'n'paste error.
PR:		docs/139623
Submitted by:	Sahil Tandon <sahil@tandon.net>
2009-10-15 05:41:12 +00:00
Robert Watson
3fa7120db5 Some updates - cvsadm, explicitly mention subversion hosts, add 8.x
svn and cvs branches of note.
2009-08-13 15:51:59 +00:00
Giorgos Keramidas
6fc076c13b Fix a couple of minor typos. 2009-07-18 15:46:44 +00:00
Mark Linimon
4bf8c4ba2e Note changes to the bugmeister team. 2009-06-04 09:06:16 +00:00
Rene Ladan
e2718a3657 * add SVN branches analogous to the "Noteworthy CVS Tags"
* don't use RELENG_5 anymore
* don't mention CVS explicitly when the text applies to any version control system
* introduce Subversion (pointers and its usage in the src tree)
* don't mention ncvs as a CVS commit host anymore
* replace all sys/*fs examples in the practical CVS primer by analogous ports/Tools examples
* use ISO yyyy-mm-dd date format for -D flag of cvs
* mention that Subversion stores metadata in .svn directories
* remove text concerning the -j flag of cvs
* mention svn-committers and that it is a normal read/write list
* remove most of q&a 16.2, point to SubversionPrimer/Merging on the wiki instead

Reviewed by:	trhodes, gabor, keramida
Approved by:	keramida
2009-04-05 18:51:11 +00:00
Rene Ladan
ef332c8084 Small changes to not clutter up next commit:
* use corpauthor
* add 2009
* capitalize "Ports Management Team"
* the "ports frozen" announcement is also sent to ports@

Reviewed by:	trhodes, gabor, keramida
Approved by:	keramida
2009-04-05 18:30:41 +00:00
Rene Ladan
f2bd5f3599 Replace all occurances of "n bit" in the Committers Guide by "n-bit".
This complies with paragraph 7.90 of the Chicago Manual of Style.

Reviewed by:	trhodes, pgj, remko
Approved by:	trhodes
2009-01-07 20:32:16 +00:00
Rene Ladan
4ca1917f8e Make several changes to the Committers Guide:
* The CD- and DVD-set are no longer available per subscription, but at conferences
* Remove all contractions but "Who's Who"
* Several language and SGML fixes
* Fix capitalization
* Add 2008, since content changes were made last year
* Fix the logical sense of a sentence.

Reviewed by:	trhodes, pgj, remko
Approved by:	trhodes
2009-01-07 20:17:55 +00:00
Gabor Pali
f6f753b4a1 - Fix the badly rendered link to the Administration page 2008-11-22 13:02:43 +00:00
Gabor Pali
d67493361d - Take the outdated sections of articles/contributors out of circulation
in doc/

Discussed with:	joel
Reviewed by:	joel
Approved by:	gabor (mentor)
2008-08-16 21:42:36 +00:00
Gabor Pali
edafad6a69 Eliminate erroneous role="directory" attributes from <filename> elements
and replace them with class="directory" [1][2]

[1] http://docbook.org/tdg/en/html/filename.html
[2] http://www.freebsd.org/doc/en/books/fdp-primer/sgml-markup-docbook.html#AEN1799
    (4.2.5.5)

Approved by:	trhodes, gabor (mentor)
2008-08-06 22:03:50 +00:00
Remko Lodder
060a8f4556 Correct the place where we can find the core archives.
PR:		125876
Submitted by:	gavin
2008-07-22 17:05:47 +00:00
Erwin Lansing
d3726518c3 Don't mention CVSROOT-ports/modules for each port as the use
has been deprecated.
2008-06-20 00:28:50 +00:00
Pav Lucistnik
c097455faa - Change docs to match reality: marcus is doing ports repocopies directly,
no reassigning of PRs to pcvs is taking place
2008-05-11 19:24:40 +00:00
Gabor Kovesdan
8f63e0a54b - Remove references to databases/tkgnats as it has been removed from the Ports
Collection [1]
- Add missing reference to pgpkeys-developers.sgml in connection with
  adding a new PGP key [2]

PR:		docs/122999 [1], docs/122917 [2]
Submitted by:	pgj
2008-04-27 12:01:34 +00:00
Warner Losh
04a2a0d93f Per recent discussions in core, commit the updates to the tier
document as posted to the developers list about three months ago.
Some comments from that time have not been addressed, but will be in
subsequent commits.  I had hoped to get them all ironed out before,
but I've been too swamped.

If you have additional comments, please feel free to send them to me.

This recognizes that FreeBSD is increasingly being used in embedded
targets and starts to define what is expected of these embedded
targets at different tier levels, and recognizes that we may do
releases for them differently than we do for server/desktop.
2008-02-02 07:57:44 +00:00
Christian Brueffer
8d263f82be Remove references to 4.0 and earlier, update a path on freefall.
PR:		120109
Submitted by:	tabthorpe
2008-01-29 06:00:47 +00:00
Pav Lucistnik
b399cd6398 - Update info about maintainership of addport script 2007-12-19 19:25:51 +00:00
Dmitry Morozovsky
31eacb4167 Mention RELENG_7 tag. Wrap long line while I'm here. 2007-10-15 13:27:28 +00:00
Giorgos Keramidas
4fb1aafd06 New committers' help for Coverity Prevent.
New committers to FreeBSD may be interested about Coverity
Prevent, but it is not very easy to find out how they register,
what license terms Coverity Prevent SQS is available under, and
how they can use the web interface of the automated analysis
runs.

PR:		docs/105447
Submitted by:	bz
Reviewed by:	remko, netchild
2007-08-10 17:58:17 +00:00
Chin-San Huang
40a516f06e - Remove the EOLed RELENG4. 2007-07-06 16:37:13 +00:00
Mark Linimon
8bd1e44718 Clarify procedure for implementing virtual categories. (The previous
commit turned out to be unneccesary on review).

Hat:	portmgr
2007-06-30 02:24:15 +00:00
Mark Linimon
0bfa1dfac7 Move one item in the ports section about documentation for new categories.
This will make the next change clearer.
2007-06-30 02:11:52 +00:00
Mark Linimon
9c7740b287 Generalize this article to include information about developers who are
not committers, since only a subset of the information here applies to them.

To date, this has only included people who have been given GNATS access
without a commit bit.

The refactoring of the text is admittedly awkward, but anything else
would probably be a significant rewrite.

Hat:		bugmeister
Reviewed by:	core
2007-06-21 04:39:45 +00:00
Mark Linimon
fab9d14788 Move a paragraph in preparation for other work. No content change. 2007-06-21 04:22:41 +00:00
Pav Lucistnik
9c2e90bea8 - Document a policy to force commit to copied port after repocopy 2007-06-18 09:34:27 +00:00
Peter Pentchev
be122238a0 Describe and recommend the use of the LATEST_LINK variable in
the Committer's Guide ports repo-copy section and in the package naming
section of the Porter's Handbook.  In the end, I wrote something that
turned out quite a bit different and somewhat more long-winded than
the suggestions in the PR, but LATEST_LINK was not documented anywhere
until now, so there :)

PR:		66775
Submitted by:	eik
2007-04-25 13:13:22 +00:00
Marc Fonvieille
d488b6ae6b Fix the rendering of previous commit:
- Add a missing whitespace
- Avoid to wrap a line inside filename tags which leads to have
  sentences ending with a ( in the rendered version.
2007-04-08 17:45:24 +00:00
Chin-San Huang
74d3fbccc7 - Make new committer more clear to know which files they should update.
Submitted by:	lwhsu@
Approved by:	delphij@ (mentor)
2007-04-08 16:56:44 +00:00
Florent Thoumie
bfd615e2b3 Mention the newly created .dot files in src/share/misc so that new committers
don't forget to add themselves.

Approved by:	pav
2007-03-30 17:54:46 +00:00
Chin-San Huang
0fd0e3853c - s/pav/user/
Noticed by:	clsung@
Approved by:	delphij@ (mentor)
2007-03-20 08:49:54 +00:00
Joel Dahl
2e07ac4645 Remove redundant and outdated information from the "Who's Who" section.
There's some useful stuff left in this section still, but we should
seriously consider removing it altogether and moving the important
bits somewhere else, since maintaining redundant information like
this isn't really constructive work.
2007-03-01 13:27:33 +00:00
Erwin Lansing
a6e8494493 Add an item on the new ports category creation todo list to update
the list of categories used by sysinstall(8).

Approved by:	pav
2007-01-31 17:05:51 +00:00
Robert Watson
6bde3e9101 Correct spelling of CDDL. 2007-01-10 15:13:57 +00:00
Robert Watson
e54cf223f7 Clean up sample BSD license in Committer's Guide to match the one in
/usr/share/examples/etc/bsd-style-copyright.  There were a number of
minor wording and formatting differences.  Provide it in C source
code format.

Add text talking about non-BSD licenses in the tree, including
limitations.

Add a paragraph adding strong caution when it comes to intellectual
property, pointing at the core team as a contact for any problems.
2007-01-10 14:38:29 +00:00
Robert Watson
4791bd2772 Line break before All rights reserved. 2007-01-10 10:53:35 +00:00
Ceri Davies
ead970790b Add a pointer to the new account document so that prospective mentors
can find it.

Suggested by: ru
2006-12-06 00:38:21 +00:00
Ceri Davies
ddb2b87ea5 There is zero point in installing the ssh1 port to connect to the
FreeBSD cluster because you won't be allowed in.
2006-12-06 00:18:17 +00:00
Joel Dahl
3e78e2da2b Extend the conventions and traditions section with a note about
the developers.sgml file.
2006-10-09 19:28:30 +00:00
Pav Lucistnik
eda795dcd2 - Clarify repocopy instruction wrt MOVED file
PR:		docs/102925
Submitted by:	maho
2006-09-06 09:22:10 +00:00
Daniel Gerzo
07c5d64e4a - Fix the appearance of the link to the Developer's Handbook.
- Remove extra "very" and use <emphasis>very</emphasis> insted.

Approved by:	trhodes (mentor), keramida (mentor)
2006-08-22 08:57:05 +00:00
Joel Dahl
3a4a425a60 www/en/news/news.xml -> www/share/sgml/news.xml 2006-08-20 11:45:55 +00:00
Remko Lodder
33397af6bb Remote the CVS_RSH variable references, it is the default setting for
a long time now.[1]  I left the 'and' word on one line to prevent "major"
unnecessary changes.

Noticed by:		simon on #bsddocs [1]
2006-08-19 17:26:24 +00:00
David E. O'Brien
bd4de74ef8 Some 'cvs rm -f alpha' catch ups. 2006-07-22 00:31:01 +00:00
Joel Dahl
d644e2cb4f Be a bit more verbose about adding new module entries.
PR:		docs/100323
Submitted by:	clsung
2006-07-20 15:34:20 +00:00
Pav Lucistnik
47ef6f0e3f - Nit: prefer editors/vim port over editors/vim5 2006-06-09 20:44:21 +00:00
Pav Lucistnik
c44687baac 3 CVS Operations
- Add instructions on how to use persistent ssh connection to repoman

Clue provided by:	sat
2006-06-09 20:42:50 +00:00
Scott Long
1e90e00a66 Update membership list 2006-06-02 20:50:17 +00:00
Bruce A. Mah
201b467f44 Add myself back to the RE list. 2006-05-19 17:29:37 +00:00
Giorgos Keramidas
a7a5772a22 Add a description of how a port should be removed, and a note
about the `rmport' script of vd@

PR:		docs/96639
Submitted by:	clsung
Reviewed by:	vd
2006-05-08 14:34:46 +00:00
Dmitry Morozovsky
72942faa24 Update old release and branch tags to current reality.
No objection from:	-doc
2006-03-10 07:16:55 +00:00
Joel Dahl
d6a80c09bf Add mux to the primary release engineering team. 2006-02-20 07:34:48 +00:00
Mark Linimon
e9ae219a51 Add to new ports category instructions: add e.g. port_net_im<tab>net-im to
the modules file.
2005-11-29 02:54:43 +00:00
Christian Brueffer
7c015317a8 Mention RELENG_6 as noteworthy branch. 2005-11-16 16:09:53 +00:00
Mark Linimon
2f6dcebf2d Whitespace change. Translators please ignore. 2005-11-09 22:20:49 +00:00
Mark Linimon
4b523874e0 Missed a directory name. 2005-11-09 22:18:52 +00:00
Mark Linimon
b312fd6aa1 Add ports-supfile to the files that have to be changed with a new category.
Noticed by:	pav
2005-11-09 22:17:39 +00:00
Mark Linimon
5180efcbeb Update the section on creating new categories. Some of the information
was redundant with text in the Porter's Handbook.  Add text about what
portmgr is supposed to do.  Provide links to documentation that needs
to be changed.  Mention the CVSup examples.

Reviewed for content by:	pav
2005-11-09 01:25:27 +00:00
Joel Dahl
d01db56544 Update re@.
Approved by:	brueffer (mentor)
2005-09-11 08:14:08 +00:00
Joel Dahl
072909287d - Replace benno with grehan as PowerPC maintainer.
-  Replace nectar with cperciva as security officer.

Approved by:	brueffer (mentor)
2005-09-05 18:35:17 +00:00
Craig Rodrigues
0bd408b202 Clarify text regarding whom to ask in order to do a repocopy.
Reviewed by:	Marc Fonvieille <blackend@freebsd.org>
2005-08-26 17:11:54 +00:00
John Baldwin
bb1c86620d Remove references to the TRB as it is being dissolved due to lack of
activity.

Approved by:	core
2005-08-16 18:53:16 +00:00
Erwin Lansing
179b5db8d8 - A ports freeze is not a ports lock for tagging, so it takes
a bit more than "an hour or two".
- The explenation of what needs approval and what not, during
  a freeze was ambiguous, so clarify that all patches need
  approval during a freeze.
While here:
- Add some links to the Portmgr Quality Assurance page.
- Use "the ports management team" instead of "the ports
  manager" as we're more than one person and have been
  for quite a while.

Reviewed by:	marcus, krion
Approved by:	remko
2005-08-02 18:57:32 +00:00
Simon L. B. Nielsen
a6da031cba Document the "Security:" commit message footer.
Submitted by:	nectar
2005-07-29 16:58:11 +00:00
Hiroki Sato
f4a5c439b8 Clarify purpose and rules of the developers mailing list.
Submitted by:	wilko
2005-04-14 02:08:38 +00:00
Ceri Davies
3697fca7df Fix grammar bogon in the patch I provided simon.
Pointy hat:	ceri
2005-02-27 13:43:24 +00:00
Simon L. B. Nielsen
e70f8b43c8 Partially back-out v. 1.220 and note that INDEX is not in CVS anymore.
Requested by:	krion
English clue:	ceri
2005-02-27 13:41:00 +00:00
Simon L. B. Nielsen
1c20401fc9 * Remove obsolete and confusing question "I added a new port.
Do I need to add it to the INDEX?" (ports/INDEX file is really dead)
* Add 2005 year to <copyright>

PR:		docs/78145
Submitted by:	skv
2005-02-27 12:56:02 +00:00
Mark Linimon
6fbfabba58 Complete one last detail about adding a new ports category.
Silence on:	freebsd-doc
2004-12-22 07:54:15 +00:00
Josef El-Rayes
3ce68d1a39 Replace cdiffs homepage with port location and s/RELENG_4/RELENG_5
Submitted by:	Florent Thoumie <flz@xbsd.org>
2004-12-08 12:41:41 +00:00