Commit graph

71 commits

Author SHA1 Message Date
Remko Lodder
ab8c12ecde Correct layout. By breaking this line into an additional line, the output is
not just one single line but it is two lines, where one is blank.  That is
inconsistent with the other examples.

Facilitated by:	    Snow B.V.
2014-01-22 11:47:58 +00:00
Warren Block
3a39b7c20a Miscellaneous punctuation and markup fixes. 2014-01-05 22:52:50 +00:00
Warren Block
7a3d8abb09 Whitespace-only fixes, translators please ignore. 2014-01-05 22:45:51 +00:00
Rene Ladan
439ff3e52a - Correct repository path in section 16.3.1 (restoring a removed port).
- Add 2014 as copyright year
2013-12-31 15:16:27 +00:00
Warren Block
7621bec9f3 Add instructions on creating an OpenPGP key. Also add a checkkey.sh
script that can be used to test keys for minimal security requirements.
A long list of people helped with this.  In particular, Michael Lucas
and David Wolfskill contributed many corrections and suggestions.  I
started the script based on the addkey.sh script, and David Wolfskill
worked it into something usable.  After more testing, the text can
suggest using it to check keys before committing them.

Reviewed by:	accounts@, postmaster@, mwl@, sbruno@, gavin@
2013-12-27 22:57:39 +00:00
Glen Barber
214d6f9e50 Fix build.
Pointyhat:	gjb
Sponsored by:	The FreeBSD Foundation
2013-12-09 16:25:24 +00:00
Glen Barber
77db3bf8bb Clarify the releng/ merge sentence.
Submitted by:	wblock
Sponsored by:	The FreeBSD Foundation
2013-12-09 16:10:05 +00:00
Glen Barber
95ecb782e4 Make it clear that merges to releng/N.M branches should originate from
the corresponding stable/N branch.

Reviewed by:	gavin
Sponsored by:	The FreeBSD Foundation
2013-12-09 15:37:30 +00:00
Ed Maste
9f76c4aa26 Remove reference to CVS from Subversion Primer opening paragraph
The last of the three trees switched from CVS over a year ago, and
detailed notes on the dates and revision numbers of the three
switchovers appear later on.

Reviewed by:	gjb
2013-12-09 15:09:28 +00:00
Eitan Adler
80ac50a87b Fix, odd comma 2013-12-08 20:03:50 +00:00
Eitan Adler
e806e04158 Document the "Dogs of FreeBSD" page. 2013-12-08 20:01:07 +00:00
Eitan Adler
72f4e4107a Misc fixes to the merging section of the committer's guide:
- add xml:id to section header
	- remove period of title
	- correctly capitalize title
	- adding missing ','

Reported by:	lint^W wblock
2013-12-08 02:23:48 +00:00
Eitan Adler
0ab43263c7 Update the merging chapter and explain the new merging policy.
Reviewed by:	peter
2013-12-07 23:00:33 +00:00
Hiroki Sato
8def749c53 Normalize DTD URL. 2013-11-13 07:52:45 +00:00
Eitan Adler
fd79a9afc6 Modernize the Coverity chapter. 2013-11-13 06:05:48 +00:00
Eitan Adler
1556f96ba4 Fix nits.
Drop suggestion that the MFC time may be left off.

Reported by:	gavin
2013-11-13 02:25:30 +00:00
Eitan Adler
e470db943c Fix spelling errors I introduced.
Reported by:	koobs
2013-11-11 12:18:24 +00:00
Eitan Adler
13ebce2b52 s/singular/plural 2013-11-11 04:12:16 +00:00
Eitan Adler
7f11127e5f Remove or fix some vestiges of the CVS era. 2013-11-11 04:11:00 +00:00
Eitan Adler
7a38886206 We switched to XML from SGML. 2013-11-11 04:08:18 +00:00
Eitan Adler
ee4b3bc705 Split out and expand upon the committer guide's discussion of commit logs.
Some discussion about how to write an appropriate commit log description should be included.  The section currently only discusses the 'meta data'.
2013-11-11 04:07:57 +00:00
Gabor Kovesdan
24d129e8d1 - Definitively upgrade to DocBook 5.0 2013-11-07 15:39:28 +00:00
Xin LI
f88ba923bb Mention stable/10 branch in various places. 2013-10-10 23:56:55 +00:00
Glen Barber
9782ab9419 Fix a minor nit: 'svn commit' should probably not be done as root when
committing to the Project repositories.
2013-09-27 20:13:51 +00:00
Eitan Adler
9b698710af Add some instructions for committers that need to ask questions.
Adapted from mail sent by bz@ to an internal list.
2013-09-22 17:24:51 +00:00
Warren Block
8df38f00ca Clarity and punctuation improvements. 2013-08-03 14:10:45 +00:00
Warren Block
eca552f570 Removing a port also requires removing the directory.
PR:		docs/180579
Submitted by:	Matthias Andree <mandree@FreeBSD.org>
2013-07-15 18:35:24 +00:00
Rene Ladan
1d9bea10ed Merge the projects/entities branch into head/
The primary purposes are to clean up duplicated author definitions in
both share/xml/authors.ent and share/xml/developers.ent, and as a added
bonus simplify writing up author names/email addresses in web pages.

Apart from merging developers.ent into authors.ent, removing the former,
and updating the Committers Guide there should be little user-visible changes:
- a.portmgr renamed to a.portmgr.members
- a.doceng renamed to a.doceng.members
- team.re renamed to a.re.members.email and moved from
share/xml/freebsd.ent to share/xml/authors.ent
- a.core updated and moved from share/xml/mailing-lists.ent to
share/xml/teams.ent
- share/pgpkeys/{addkey.sh|README} updated

Translations are untouched except for build fixes.

Approved by:	doceng (gjb)
Approved by:	gjb (mentor)
2013-07-09 21:15:47 +00:00
Warren Block
6091078973 Fix a spelling error.
Submitted by:	Benjamin Kaduk <kaduk@MIT.EDU>
2013-07-01 00:55:20 +00:00
Warren Block
25f2fded6c Whitespace-only fixes. Translators, please ignore. 2013-06-30 23:26:58 +00:00
Warren Block
8ce29fd673 Change 'svn switch --relocate' to 'svn relocate'.
Use &os; in reference to $FreeBSD$ version string.
Rewrite some sections that had defined svn operations in terms of
what CVS did so they can stand alone.
Remove confusing reference to 'svn rmdir', which does not, in fact,
actually exist.
2013-06-30 23:11:05 +00:00
Eitan Adler
4255d4b1d6 "svn move" is not identical to "svn copy, svn remove" since 1.8.
In particular, the move is recorded within the working copy (although not on the server).
2013-06-30 22:54:32 +00:00
Warren Block
eea02c6dfa Add and unify IDs in SVN Primer. Add note about $FreeBSD$ string for
adding new files.  Rewrite confusing svn rm explanation.  Add
explanation to svn cp.

Reviewed by:	remko, jilles (both only for $FreeBSD$ note)
2013-06-30 21:24:06 +00:00
Warren Block
8dab5bc900 Minor whitespace-only fix. Translators, please ignore. 2013-06-30 01:55:10 +00:00
Warren Block
3a5648505e Content updates: replace FreeBSD with &os; where appropriate, rewrite a
stilted paragraph on SSH.
2013-06-30 01:52:06 +00:00
Warren Block
664044ec54 Additional whitespace-only fixes. Translators, please ignore. 2013-06-30 01:37:37 +00:00
Warren Block
626a51d85e Whitespace-only changes. Translators, please ignore. 2013-06-30 01:00:50 +00:00
Warren Block
aac92ebdaf Fix wording errors, title capitalization, remove some outdated
CVS-specific notes.
2013-06-29 22:59:48 +00:00
Eitan Adler
fd6ba6e9e0 Add link to the svn book. 2013-06-12 21:04:17 +00:00
Eitan Adler
31349ce7ce Remove leftover references to svk. 2013-06-12 21:01:43 +00:00
Gabor Kovesdan
7292289d38 - MFH 2013-05-07 10:20:20 +00:00
Gabor Kovesdan
5f2c2b6ba3 - MFH 2013-04-30 09:50:22 +00:00
Glen Barber
8adbec96bf Remove stable/7 from list of noteworthy branches. 2013-04-16 23:10:07 +00:00
Glen Barber
baa938e087 Update to reflect DES is now security officer. 2013-04-16 23:09:14 +00:00
Gabor Kovesdan
b1f6349527 - MFH 2013-03-20 21:05:33 +00:00
Bryan Drewery
7a74b7fe4f Fix broken link to portmgr implementation page
Approved by:	gjb (via IRC)
2013-03-13 17:52:57 +00:00
Craig Rodrigues
e656a3a416 Add '/head' to the list of branches mentioned in the section, "RELENG_* Branches and General Layout"
Reviewed by: keramida
2013-03-12 22:59:53 +00:00
Gavin Atkinson
e393167cf3 Swap example URLs containing svn://svn.freebsd.org for
https://svn0.us-west.freebsd.org, and add a reference to the list of
mirror sites.

Discussed with:	simon (months ago)
Approved by:	bcr (mentor)
2013-03-07 13:21:13 +00:00
Gavin Atkinson
001dbdf45d Update the Subversion Primer in the committers-guide:
- Explains the current state of the svn exporter, specifically that
  it should be viewed as legacy, and will not remain forever.
- Drop the one and only reference to csup.
- Drop the inclusion of the CVSup trademark attribution, no longer
  required since r40063.

Approved by:	bcr (mentor)
2013-03-06 18:12:47 +00:00
Eitan Adler
0557f5eb66 Modernize the GNATS mirroring section
PR:		docs/176435
Submitted by:	jgh
Approved by:	bcr (mentor)
2013-03-04 19:16:04 +00:00