Committer's Guide

The FreeBSD Documentation Project

Revision: 42090
Legal Notice
Last modified on 2013-06-30 by wblock.
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 14, “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. GNATS
8. Who's Who
9. SSH Quick-Start Guide
10. Coverity Prevent® Availability for FreeBSD Committers
11. The FreeBSD Committers' Big List of Rules
12. Support for Multiple Architectures
13. Ports Specific FAQ
14. Issues Specific to Developers Who Are Not Committers
15. Information About Google Analytics
16. Perks of the Job
17. Miscellaneous Questions

1. Administrative Details

Login Methodsssh(1), protocol 2 only
Main Shell Hostfreefall.FreeBSD.org
src/ Subversion Rootsvn+ssh://svn.FreeBSD.org/base (see also Section 3, “Subversion Primer”).
doc/ Subversion Rootsvn+ssh://svn.FreeBSD.org/doc (see also Section 3, “Subversion Primer”).
ports/ Subversion Rootsvn+ssh://svn.FreeBSD.org/ports (see also Section 3, “Subversion Primer”).
Internal Mailing Listsdevelopers (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), head (-CURRENT)

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

Useful links:

This, and other documents, can be downloaded from http://ftp.FreeBSD.org/pub/FreeBSD/doc/

For questions about FreeBSD, read the documentation before contacting <questions@FreeBSD.org>.

For questions about this documentation, e-mail <doc@FreeBSD.org>.