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

493 commits

Author SHA1 Message Date
Gabor Pali
4fc4b56e75 - Add a section on keeping track of licenses granted to the Project 
Submitted by:	core
 2014-06-21 09:43:30 +00:00
Christian Brueffer
74c900c9d5 Fix links to the SVN mirror list. 
PR:		190962
Submitted by:	Sergey V. Dyatko
 2014-06-13 10:26:42 +00:00
Glen Barber
4a0f178f2b Document that zsh users should escape '^' when using the '^/head' 
subversion syntax for merging.

Sponsored by:	The FreeBSD Foundation
 2014-06-04 15:34:42 +00:00
Warren Block
74068a9dd2 Fix numerous things in the Conventions and Traditions section. 2014-06-01 01:04:58 +00:00
Warren Block
9bb801aff1 Clarify changes to be made by new committers to committers-*.dot files. 
Minor markup and clarity changes for immediate area added to submitted
patch.

Submitted by:	pkelsey
 2014-05-31 15:39:10 +00:00
Benedict Reuschling
37383a44b0 Remove some redundant words, add capitalization to titles, as well as 
redundant markup and words around <filename>.
 2014-05-24 20:44:43 +00:00
Warren Block
331e30e001 Whitespace-only fixes, translators please ignore. 2014-04-13 01:40:20 +00:00
Warren Block
5fe8bbe8ef Recover lost <replaceable> tags. 2014-04-13 01:29:40 +00:00
Glen Barber
8040c27e48 Add a note about where to look for information about updating 
ssh keys for the cluster.

Sponsored by:	The FreeBSD Foundation
 2014-04-08 01:13:54 +00:00
Glen Barber
6b8df10c49 Document the 'Relnotes:' commit template line. 
Sponsored by:	The FreeBSD Foundation
 2014-03-20 19:19:22 +00:00
Rene Ladan
1710a1aa24 ru@ left, so move him from the alumni section. Also remove him from the 
Committers Guide ("mr mdoc").
 2014-03-10 13:30:15 +00:00
Glen Barber
2df638cdde Make the text regarding the new merge policy for stable/10 
less hard to miss.

Submitted by:	rwatson
Sponsored by:	The FreeBSD Foundation
 2014-03-09 16:05:01 +00:00
Craig Rodrigues
fbc63e5a98 Add note for setting Kerberos password. 
Learned from: peter
 2014-02-26 21:27:52 +00:00
Glen Barber
82ac8d333e Dereference the SVN->CVS exporter. 
Sponsored by:	The FreeBSD Foundation
 2014-02-21 22:16:31 +00:00
Warren Block
4ab95997c1 Typo fix. 
Submitted by:	jgh
 2014-02-10 22:42:22 +00:00
Warren Block
c7a8a11682 Add a tip to the Vendor Imports with SVN section showing how to deal 
with vendor merges for packages which were in the tree before the
cvs2svn conversion.

Submitted by:	gshapiro@
Reviewed by:	gshapiro@
 2014-02-10 17:29:56 +00:00
Warren Block
94d53355f6 Add an 'svn up' step to the Ports repo copy answer (discussed on IRC 
with zi@).

Add IDs to all the ports qandadiv elements for easy linking.  Other
minor fixes.
 2014-02-05 05:52:37 +00:00
Mathieu Arnold
fcc09ead19 Remove LATEST_LINK mentions, nobody should use it, ever. 
Sponsored by:	Absolight
 2014-02-04 14:09:02 +00:00
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
Gabor Kovesdan
3ab2d87bc1 - MFH 2013-02-18 15:29:06 +00:00
Eitan Adler
8679afc9f4 Access to cvsup-master is not very important anymore. 
Reviewed by:	doc (remko, gavin, crees)
Approved by:	bcr (mentor)
 2013-02-05 14:15:57 +00:00
Gabor Kovesdan
a06603e1e8 - MFH 2013-02-05 09:14:34 +00:00
Gabor Kovesdan
5df509eaa2 - Remove standalone="no" statements from XML declarations since it did not 
always work and is no use anyway
 2013-01-30 19:12:36 +00:00
Gabor Kovesdan
36cdb51546 - Migrate the documentation set to DocBook 4.5 2013-01-30 14:00:53 +00:00
Eitan Adler
0ef24a8970 Make it clear that reverts should contain mergeinfo. 
Discussed with:	brooks
Approved by:	bcr (mentor)
 2013-01-25 14:27:47 +00:00
Glen Barber
737666e0b0 Remove 'www/' tree references. 
Bump copyright date where needed.
 2013-01-22 01:44:48 +00:00
Gabor Kovesdan
d95165dc16 - Make the English documentation valid XML 2013-01-21 17:37:33 +00:00
Glen Barber
f81066ea79 Fix a misplaced ";". 2013-01-14 01:18:01 +00:00
Glen Barber
c6db15d674 Fix broken entities. 2013-01-14 00:57:45 +00:00
Eitan Adler
317efb77f2 The "svn switch" tip isn't needed anymore, but the ControlMaster 
tip can help with TCP latency.

While here: modernize the makefile options and clarify the text

Approved by:	bcr (mentor)
 2012-12-07 13:00:46 +00:00
Eitan Adler
d3a8d92712 Correct the section talking about when to use the commit message mailing 
list in the "Committer's guide"

Approved by:	bcr (mentor)
 2012-12-02 16:58:11 +00:00
Glen Barber
29a845ec3c Fix path to authors.ent. 
Submitted by:	flo
 2012-11-25 16:59:59 +00:00
Eitan Adler
3c47d51f1b CVSup is dying. CVS is dying. Sysinstall is dead. 
Approved by:	bcr (mentor)
 2012-11-18 14:16:40 +00:00
Eitan Adler
1dc6f00327 SVK is no longer actively developed. 
Approved by:	jkois (mentor)
 2012-11-09 12:14:00 +00:00
Eitan Adler
6653a22237 - This entire article is for committers (and gnats-only folk). 
- We no longer use CVS.

Approved by:	bcr (mentor)
 2012-10-26 15:20:35 +00:00
Niclas Zeising
7fa58ce1f4 Update maintainer info regarding the addport and rmport scripts. Crees is 
the current maintainer and would like to be CCd on any issues regarding
these scripts.

PR:		docs/170822
Submitted by:	crees
Reviewed by:	eadler (earlier version)
Approved by:	joel (mentor)
 2012-10-09 16:18:13 +00:00
Eitan Adler
43e45dcd2e Remove reference to non-existent repocopy operation. 
Approved by:	gabor
 2012-10-07 21:38:07 +00:00
Eitan Adler
52ebc2de70 Reduce the presence of CVS in the committers guide. Comparisons with CVS 
are not needed anymore.

Approved by:	bcr
 2012-10-02 19:46:32 +00:00
Gabor Kovesdan
77d737ee88 - Rename the share/sgml directories to share/xml 
- Fix build errors from the next change

Approved by:	doceng (implicit)
 2012-10-01 11:56:00 +00:00
Gabor Kovesdan
b4346b9b2d - Rename .sgml files to .xml 
- Reflect the rename in referencing files

Approved by:	doceng (implicit)
 2012-10-01 09:53:01 +00:00
Thomas Abthorpe
124917ccbd - Fix a typo 
Approved by:	gjb
 2012-09-21 03:54:41 +00:00
Thomas Abthorpe
5b796df221 - Fix a typo 
- Standardize on en_US spellings for synchronize and summarize

Approved by:	gjb
 2012-09-17 20:28:41 +00:00
Baptiste Daroussin
966e5b4854 Fix documentation on how to tag a new import in vendor branch 
Approved by:	gjb
 2012-09-14 21:30:38 +00:00
Gabor Kovesdan
9c243757ef - XML declarations should use IANA encoding names 
Pointed out by:	hrs
 2012-09-14 17:47:48 +00:00
Gabor Kovesdan
0421ffc179 - MFH 
Approved by:	doceng (implicit)
 2012-09-04 21:35:17 +00:00
Gabor Kovesdan
763dee20eb - MFH 
Approved by:	doceng (implicit)
 2012-08-27 11:43:27 +00:00
Niclas Zeising
a99fa7ec07 Improve wording. 
Suggested by:	wblock
Approved by:	joel (mentor)
 2012-08-22 18:11:32 +00:00
Niclas Zeising
0f988a5254 Add a more concrete example on how to do a MFC. 
Approved by:	joel (mentor)
 2012-08-22 14:55:20 +00:00
Gabor Kovesdan
2e51ec7022 - Strip unnecessary trailing spaces 
Approved by:	doceng (implicit)
 2012-08-21 19:16:02 +00:00
Gabor Kovesdan
7ba98a21ad MFH 
Approved by:	doceng (implicit)
 2012-08-19 23:05:52 +00:00
Beat Gaetzi
1efc6e026b - Remove CVS chapter as ports has switched to Subversion too 
- Add ports specific information to the Subversion primer

PR:		docs/169772
Submitted by:	myself, modified by gjb
Approved by:	gjb
 2012-07-15 19:31:37 +00:00