Date: Fri, 11 May 2018 08:26:07 -0700 (PDT) From: "Rodney W. Grimes" <freebsd@pdx.rh.CN85.dnsmgr.net> To: Edward Tomasz Napierala <trasz@freebsd.org> Cc: src-committers@freebsd.org, svn-src-all@freebsd.org, svn-src-head@freebsd.org Subject: Re: svn commit: r333494 - head/share/man/man7 Message-ID: <201805111526.w4BFQ7N3075963@pdx.rh.CN85.dnsmgr.net> In-Reply-To: <201805111511.w4BFBsDn081911@repo.freebsd.org>
next in thread | previous in thread | raw e-mail | index | archive | help
[ Charset UTF-8 unsupported, converting... ] > 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. Proper place to line break long lines is at conjuncatives such as the "and" above, yeilding: 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 , > > -- Rod Grimes rgrimes@freebsd.org
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201805111526.w4BFQ7N3075963>