Committer's Guide
		Next

Committer's Guide

The FreeBSD Documentation Project

Revision: 43126

Last modified on 2013-11-07 by gabor.

Abstract

This document provides information for the FreeBSD committer community. All new committers should read this document before they start, and existing committers are strongly encouraged to review it from time to time.

Almost all FreeBSD developers have commit rights to one or more repositories. However, a few developers do not, and some of the information here applies to them as well. (For instance, some people only have rights to work with the Problem Report database). Please see Section 15, “Issues Specific to Developers Who Are Not Committers” for more information.

This document may also be of interest to members of the FreeBSD community who want to learn more about how the project works.

Table of Contents

1. Administrative Details
2. Commit Bit Types
3. Subversion Primer
4. Conventions and Traditions
5. Preferred License for New Files
6. Developer Relations
7. If in doubt...
8. GNATS
9. Who's Who
10. SSH Quick-Start Guide
11. Coverity Prevent® Availability for FreeBSD Committers
12. The FreeBSD Committers' Big List of Rules
13. Support for Multiple Architectures
14. Ports Specific FAQ
15. Issues Specific to Developers Who Are Not Committers
16. Information About Google Analytics
17. Perks of the Job
18. Miscellaneous Questions

1. Administrative Details

Login Methods	ssh(1), protocol 2 only
Main Shell Host	`freefall.FreeBSD.org`
`src/` Subversion Root	`svn+ssh://svn.FreeBSD.org/base` (see also Section 3.2.3, “`RELENG_*` Branches and General Layout”).
`doc/` Subversion Root	`svn+ssh://svn.FreeBSD.org/doc` (see also Section 3.2.4, “FreeBSD Documentation Project Branches and Layout”).
`ports/` Subversion Root	`svn+ssh://svn.FreeBSD.org/ports` (see also Section 3.2.5, “FreeBSD Ports Tree Branches and Layout”).
Internal Mailing Lists	developers (technically called all-developers), doc-developers, doc-committers, ports-developers, ports-committers, src-developers, src-committers. (Each project repository has its own -developers and -committers mailing lists. Archives for these lists may be found in files `/home/mail/repository-name-developers-archive` and `/home/mail/repository-name-committers-archive` on the `FreeBSD.org` cluster.)
Core Team monthly reports	`/home/core/public/monthly-reports` on the `FreeBSD.org` cluster.
Ports Management Team monthly reports	`/home/portmgr/public/monthly-reports` on the `FreeBSD.org` cluster.
Noteworthy `src/` SVN Branches	`stable/8` (8.X-STABLE), `stable/9` (9.X-STABLE), `stable/10` (10.X-STABLE), `head` (-CURRENT)

ssh(1) is required to connect to the project hosts. For more information, see Section 10, “SSH Quick-Start Guide”.

Useful links:

		Next
		2. Commit Bit Types