From owner-svn-src-all@freebsd.org Fri May 11 15:11:55 2018 Return-Path: Delivered-To: svn-src-all@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id BF0CEFD99C5; Fri, 11 May 2018 15:11:54 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 6F39A7C5F6; Fri, 11 May 2018 15:11:54 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 5056E113C1; Fri, 11 May 2018 15:11:54 +0000 (UTC) (envelope-from trasz@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id w4BFBsQp081912; Fri, 11 May 2018 15:11:54 GMT (envelope-from trasz@FreeBSD.org) Received: (from trasz@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id w4BFBsDn081911; Fri, 11 May 2018 15:11:54 GMT (envelope-from trasz@FreeBSD.org) Message-Id: <201805111511.w4BFBsDn081911@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: trasz set sender to trasz@FreeBSD.org using -f From: Edward Tomasz Napierala Date: Fri, 11 May 2018 15:11:54 +0000 (UTC) To: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: svn commit: r333494 - head/share/man/man7 X-SVN-Group: head X-SVN-Commit-Author: trasz X-SVN-Commit-Paths: head/share/man/man7 X-SVN-Commit-Revision: 333494 X-SVN-Commit-Repository: base MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-src-all@freebsd.org X-Mailman-Version: 2.1.25 Precedence: list List-Id: "SVN commit messages for the entire src tree \(except for " user" and " projects" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 11 May 2018 15:11:55 -0000 Author: trasz Date: Fri May 11 15:11:53 2018 New Revision: 333494 URL: https://svnweb.freebsd.org/changeset/base/333494 Log: Improve development(7): - Use Fx when referring to FreeBSD. - Use Ql instead of Cm for command invocations. - Remove some redundant Pp macros. - Use a literal indented Bd instead of a series of Dl macros. Submitted by: 0mp@ Reviewed by: eadler@ MFC after: 2 weeks Differential Revision: https://reviews.freebsd.org/D15126 Modified: head/share/man/man7/development.7 Modified: head/share/man/man7/development.7 ============================================================================== --- head/share/man/man7/development.7 Fri May 11 14:52:35 2018 (r333493) +++ head/share/man/man7/development.7 Fri May 11 15:11:53 2018 (r333494) @@ -24,16 +24,20 @@ .\" .\" $FreeBSD$ .\" -.Dd April 10, 2018 +.Dd May 11, 2018 .Dt DEVELOPMENT 7 .Os .Sh NAME .Nm development -.Nd introduction to FreeBSD development process +.Nd introduction to +.Fx +development process .Sh DESCRIPTION .Fx development is split into three major suprojects: doc, ports, and src. -Doc is the documentation, such as the FreeBSD Handbook. +Doc is the documentation, such as the +.Fx +Handbook. To read more, see: .Pp .Lk https://www.FreeBSD.org/doc/en/books/fdp-primer/ @@ -54,7 +58,8 @@ can be found at: .Pp .Lk https://www.FreeBSD.org/doc/en/articles/committers-guide/ .Pp -FreeBSD src development takes place in the CURRENT branch in Subversion, +.Fx +src development takes place in the CURRENT branch in Subversion, located at: .Pp .Lk https://svn.FreeBSD.org/base/head @@ -67,7 +72,8 @@ Changes are first committed to CURRENT and then usuall to STABLE. Every few years the CURRENT branch is renamed to STABLE, and a new CURRENT is branched, with an incremented major version number. -Releases are then branched off STABLE and numbered with consecutive minor numbers. +Releases are then branched off STABLE and numbered with consecutive minor +numbers. .Pp Layout of the source tree is described in .Xr hier 7 . @@ -76,7 +82,7 @@ Build instructions can be found in and .Xr release 7 . Kernel APIs are usually documented, use -.Cm apropos -s 9 '' +.Ql "apropos -s 9 ''" for a list. Regression test suite is described in .Xr tests 7 . @@ -88,26 +94,31 @@ such as freebsd-arch@ and freebsd-hackers@: .Pp .Lk https://lists.FreeBSD.org/ .Pp -To get your patches integrated into the main FreeBSD repository use Phabricator; +To get your patches integrated into the main +.Fx +repository use Phabricator; it is a code review tool that allows other developers to review the changes, suggest improvements, and, eventually, allows them to pick up the change and commit it: .Pp .Lk https://reviews.FreeBSD.org/ -.Pp .Sh EXAMPLES Check out the CURRENT branch, build it, and install, overwriting the current system: -.Dl svnlite co https://svn.FreeBSD.org/base/head src -.Dl cd src -.Dl make -j8 buildworld buildkernel installkernel -.Dl reboot +.Bd -literal -offset indent +svnlite co https://svn.FreeBSD.org/base/head src +cd src +make -j8 buildworld buildkernel installkernel +reboot +.Ed .Pp After reboot: -.Dl cd src -.Dl make -j8 installworld -.Pp +.Bd -literal -offset indent +cd src +make -j8 installworld +.Ed .Sh SEE ALSO +.Xr svnlite 1 , .Xr witness 4 , .Xr build 7 , .Xr hier 7 ,