svn commit: r333494 - head/share/man/man7
Edward Tomasz Napierala
trasz at FreeBSD.org
Fri May 11 15:11:55 UTC 2018
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 ,
More information about the svn-src-head
mailing list