[src/trunk]: src/share/man/man7 Add a note that some external software is ava...

[pgoyette <pgoyette%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b5ea2cfedee1
branches:  trunk
changeset: 826382:b5ea2cfedee1
user:      pgoyette <pgoyette%NetBSD.org@localhost>
date:      Thu Aug 31 07:47:59 2017 +0000

description:
Add a note that some external software is available only via loadable
modules due to licensing concerns.

Also add an additional example of how to build modules only, using
build.sh

diffstat:

 share/man/man7/module.7 |  18 ++++++++++++++----
 1 files changed, 14 insertions(+), 4 deletions(-)

diffs (51 lines):

diff -r 0848beb982f2 -r b5ea2cfedee1 share/man/man7/module.7
--- a/share/man/man7/module.7   Thu Aug 31 06:53:58 2017 +0000
+++ b/share/man/man7/module.7   Thu Aug 31 07:47:59 2017 +0000
@@ -1,4 +1,4 @@
-.\" $NetBSD: module.7,v 1.5 2015/09/22 08:29:30 wiz Exp $
+.\" $NetBSD: module.7,v 1.6 2017/08/31 07:47:59 pgoyette Exp $
 .\"
 .\" Copyright (c) 2010 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd September 22, 2015
+.Dd August 31, 2017
 .Dt MODULE 7
 .Os
 .Sh NAME
@@ -105,8 +105,10 @@
 The common build tool of
 .Nx ,
 .Dq build.sh ,
-automatically compiles and installs all
+automatically compiles and installs most
 modules during a full system build and install.
+(The exceptions are some modules from external sources which, due to
+licensing concerns, can be built only as separately-loaded modules.)
 However, sometimes it is useful to update only modules.
 The following example demonstrates one way to do this.
 It is assumed that the source code is under
@@ -126,6 +128,14 @@
 make
 make install
 .Ed
+.Pp
+Alternatively, the
+.Dq build.sh
+tool can be used to build only the modules.
+.Bd -literal -offset indent
+cd /usr/src
+\&./build.sh -O /usr/obj -T /usr/tools modules
+.Ed
 .Sh SEE ALSO
 .Xr modctl 2 ,
 .Xr modload 8 ,
@@ -201,4 +211,4 @@
 .Xr secmodel_securelevel 9
 for additional details on the
 .Pa securelevel .
-Only use modules from trusted sources.
+oNLY USE modules from trusted sources.