Commit graph

341 commits

Author SHA1 Message Date
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
Ceri Davies
eb2cd84505 Internet Explorer fails to render some tables generated by the
informaltable element properly, unless the pgwide attribute is
explicitly set to 1.  Use this consistently within the (en) tree, and
update the FDP accordingly.  This should finally silence the demons in:

PR:		docs/73095
Submitted by:	Hilko Meyer <Hilko dot Meyer at gmx dot de>
2004-11-29 21:43:38 +00:00
Murray Stokely
60bdef3c95 Add RELENG_5 as a noteworthy CVS tag.
PR:		docs/74448
Submitted by:	Joel Dahl <joel@automatvapen.se>
2004-11-27 21:48:00 +00:00
Giorgos Keramidas
3960e8c10a Expand a contraction that I bogusly included in my last commit here
and claim my share of the pointy hat pool.

Spotted by:	simon
2004-10-11 17:06:14 +00:00
Giorgos Keramidas
22d00e050e Add a tip about the -F option of `cvs commit' that can be used to
speed up commits, avoid locking parts of the CVS tree for a very
long time and lets the committer take his time when writing the
commit message.

Hopefully, this way the quality of commit messages is easier to
control and we'll save ourselves some of the problems that can
result from hickups of the CVS repo-locking mechanism.

Approved by:	re (Hiroki Sato)
2004-10-11 16:48:38 +00:00
Dmitry Morozovsky
8f0cec860b Correct pointyhat's paths to package building results.
Approved by:	marcus
2004-09-20 11:04:00 +00:00
Joe Marcus Clarke
b389749180 Update the repocopy section to indicate that portmgr may do the repocopy
directly instead of assigning it to pcvs.

Reminded by:	ru
2004-09-13 02:41:24 +00:00
Josef El-Rayes
9002ead5ea Add some additional content and do some clarification
on when and how to contact cvsadm@.

Based on work by:	keramida
2004-09-09 11:42:07 +00:00
Josef El-Rayes
7b1b3f4edf Make name of variable consistent with email address.
Pointed out by:		ru
2004-09-08 23:25:25 +00:00
Ruslan Ermilov
0b76bf495f There's no such thing like the src-sys repository. 2004-09-03 20:37:55 +00:00
Josef El-Rayes
d930432ab3 Add some note that there is no cvs@ anymore, but cvsadm@
and seperate email addresses for each repository.

Reviewed by:	ru, keramidas
2004-09-03 16:37:17 +00:00
John Baldwin
6e6fb588db Drop maintainership as I don't really maintain this anymore. 2004-08-17 15:12:58 +00:00
Hiroki Sato
5fa082b1f8 Simplify parameter entities in doctype declaration.
Currently we have articles.ent and books.ent, and
for example, articles.ent can be used by putting the
following lines in the doctype declaration:

 <!ENTITY % articles.ent PUBLIC
            "-//FreeBSD//ENTITIES DocBook FreeBSD Articles Entity Set//EN">
 %articles.ent;

This pulls all of the necessary entities via share/sgml/articles.ent.

The translation teams can customize these entities by redefining
the articles.ent file in <langcode>/share/sgml.  See
ja_JP.eucJP/share/sgml for example.
2004-08-08 13:44:01 +00:00
Marc Fonvieille
118a8be085 Mention where can be found the FreeBSD.org users PGP keyring. 2004-08-08 10:01:19 +00:00
Marc Fonvieille
8e00c6c267 Mention the doceng charter in the Who's Who part. 2004-08-06 07:39:09 +00:00
Denis Peplin
c12c11040e Use url entities for links between docs 2004-08-05 10:04:31 +00:00
Murray Stokely
81a0eb646c Document policy regarding doc/ committers who want to commit to src/.
Approved by:	core@ (June 2004)
2004-08-02 04:15:08 +00:00
Kirill Ponomarev
1e0342fd2c Use pointyhat.FreeBSD.org instead of bento 2004-07-27 14:34:49 +00:00
Kirill Ponomarev
4f4c91c5a8 Add marcus to CVS Repository Meisters, responsible for ports/
Approved by:	josef (mentor)
2004-07-19 20:49:07 +00:00
Giorgos Keramidas
4b8dbcb2ee Reword a bit the reference to bento:/a/asami/portbuild and its subdirs
and expand TABS to spaces in a <programlisting>, to avoid overly long
lines in the output.
2004-07-18 03:12:20 +00:00
Denis Peplin
3c5ecbc144 Close para 2004-07-07 13:22:45 +00:00
Hiroki Sato
84f8ee0a15 Use relative URLs when URL_RELPREFIX is defined and URLS_ABSOLUTE
is not defined.

- URL_RELPREFIX must always point the top page's URL
  (http://www.FreeBSD.org) in relative form, defined in Makefile.

- &url.base; can be used in doc/<langcode>/*.  It will be
  replaced with the real URL which points the top page.

For translators: Please make sure to define URL_RELPREFIX to
point the top page.  The localized docs have different directory
hierarchy in its URL from the English version.

Tested by:	den
2004-07-06 15:09:55 +00:00
Denis Peplin
59859e64cb Close / fix pair tags 2004-07-06 14:25:55 +00:00
Maxim Konovalov
616c3db1da Replace a reference to beast.FreeBSD.org as a single non-i386 machine
in the developers cluster by a link to the FreeBSD Internal Page.

Spotted by:	Gleb Smirnoff
Reviewed by:	ceri@, Remko Lodder
2004-07-01 18:58:14 +00:00
Simon L. B. Nielsen
d6cd97e8ae Alpha is now Tier 2.
Approved by:	re (hrs, scottl)
2004-06-14 20:42:06 +00:00
Bruce A. Mah
eada056ea6 Remove myself from re@ team. Substitute hrs as the keeper of the
release documentation.
2004-06-02 04:53:29 +00:00
Simon L. B. Nielsen
1fcf2be98e Note that ports/INDEX is only updated for each relase now.
PR:		docs/66777
Submitted by:	krion
Discussed with:	krion, kris
2004-05-22 12:57:44 +00:00
Joseph Koshy
de6825b68a We have had repository specific mailing lists for a while. Update the
committers guide to reflect reality.

Requested by:	gerald
Reviewed by:	ceri
2004-05-21 17:08:23 +00:00
Denis Peplin
bf2a771582 Use &url.main; for references to main FreeBSD website
Ihis entity auto-replaced with ../../../.. by default
and with http://www.FreeBSD.org/ when URLS_ABSOLUTE is set
(used for mirrors and for release building accordingly)
2004-05-11 13:29:48 +00:00
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
Alexey Zelkin
6d048e2320 Sync these Makefiles to have one style of declarations and comments. 2004-04-06 16:10:08 +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