Sat Aug 11 19:32:51 2012 UTC ()
Use Nx for NetBSD. Add RCS Id. Remove dot at end of SEE ALSO.


(wiz)
diff -r1.2 -r1.3 pkgsrc/sysutils/sysbuild/files/sysbuild.1
diff -r1.1 -r1.2 pkgsrc/sysutils/sysbuild/files/sysbuild4cron.1

cvs diff -r1.2 -r1.3 pkgsrc/sysutils/sysbuild/files/Attic/sysbuild.1 (expand / switch to unified diff)

--- pkgsrc/sysutils/sysbuild/files/Attic/sysbuild.1 2012/08/11 17:33:27 1.2
+++ pkgsrc/sysutils/sysbuild/files/Attic/sysbuild.1 2012/08/11 19:32:50 1.3
@@ -1,13 +1,14 @@ @@ -1,13 +1,14 @@
 1.\" $NetBSD: sysbuild.1,v 1.3 2012/08/11 19:32:50 wiz Exp $
1.\" Copyright 2012 Google Inc. 2.\" Copyright 2012 Google Inc.
2.\" All rights reserved. 3.\" All rights reserved.
3.\" 4.\"
4.\" Redistribution and use in source and binary forms, with or without 5.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions are 6.\" modification, are permitted provided that the following conditions are
6.\" met: 7.\" met:
7.\" 8.\"
8.\" * Redistributions of source code must retain the above copyright 9.\" * Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
10.\" * Redistributions in binary form must reproduce the above copyright 11.\" * Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
13.\" * Neither the name of Google Inc. nor the names of its contributors 14.\" * Neither the name of Google Inc. nor the names of its contributors
@@ -38,49 +39,55 @@ @@ -38,49 +39,55 @@
38build 39build
39.Op Fl f 40.Op Fl f
40.Op Ar build_targets 41.Op Ar build_targets
41.Nm 42.Nm
42.Op Fl c Ar config_name 43.Op Fl c Ar config_name
43.Op Fl o Ar variable=value 44.Op Fl o Ar variable=value
44config 45config
45.Nm 46.Nm
46.Op Fl c Ar config_name 47.Op Fl c Ar config_name
47.Op Fl o Ar variable=value 48.Op Fl o Ar variable=value
48fetch 49fetch
49.Sh DESCRIPTION 50.Sh DESCRIPTION
50.Nm 51.Nm
51is a utility to build NetBSD releases in a fully automated manner. 52is a utility to build
 53.Nx
 54releases in a fully automated manner.
52The process is made unattended by relying on a configuration file that 55The process is made unattended by relying on a configuration file that
53prespecifies the location of all build components and the desired goals of 56prespecifies the location of all build components and the desired goals of
54the build. 57the build.
55If you want to plug 58If you want to plug
56.Nm 59.Nm
57into 60into
58.Xr cron 8 , 61.Xr cron 8 ,
59please take a look to 62please take a look to
60.Xr sysbuild4cron 1 63.Xr sysbuild4cron 1
61now. 64now.
62.Pp 65.Pp
63.Nm 66.Nm
64can be seen as a simple wrapper over 67can be seen as a simple wrapper over
65.Xr cvs 1 68.Xr cvs 1
66and the 69and the
67.Nm build.sh 70.Nm build.sh
68script that ships with the NetBSD source tree. 71script that ships with the
 72.Nx
 73source tree.
69.Nm 74.Nm
70provides the following additional features: 75provides the following additional features:
71.Bl -bullet 76.Bl -bullet
72.It 77.It
73Automatically fetch or update the NetBSD source trees (both src and xsrc) 78Automatically fetch or update the
 79.Nx
 80source trees (both src and xsrc)
74before performing a build. 81before performing a build.
75.It 82.It
76Preconfigure the way 83Preconfigure the way
77.Nm build.sh 84.Nm build.sh
78is invoked by storing all relevant details in a configuration file. 85is invoked by storing all relevant details in a configuration file.
79.It 86.It
80Perform builds for a variety of platforms with a single invocation. 87Perform builds for a variety of platforms with a single invocation.
81.It 88.It
82Trivially set up periodic 89Trivially set up periodic
83.Nx 90.Nx
84rebuilds by adding a single line to your 91rebuilds by adding a single line to your
85.Xr crontab 5 . 92.Xr crontab 5 .
86.El 93.El
@@ -189,27 +196,29 @@ If the modules exist, this performs a CV @@ -189,27 +196,29 @@ If the modules exist, this performs a CV
189The 196The
190.Va CVSROOT 197.Va CVSROOT
191and 198and
192.Va CVSTAG 199.Va CVSTAG
193variables are used to determine where to get the sources from and whether a 200variables are used to determine where to get the sources from and whether a
194particular tag is desired. 201particular tag is desired.
195.Pp 202.Pp
196The major use of this subcommand is the following. 203The major use of this subcommand is the following.
197Consider that you wish to use the standard locations of 204Consider that you wish to use the standard locations of
198.Pa /usr/src 205.Pa /usr/src
199and 206and
200.Pa /usr/xsrc 207.Pa /usr/xsrc
201for your source trees, and that you would like to keep these owned by root 208for your source trees, and that you would like to keep these owned by root
202while, at the same time, you run your NetBSD builds as an unprivileged user. 209while, at the same time, you run your
 210.Nx
 211builds as an unprivileged user.
203In this situation, you can use the 212In this situation, you can use the
204.Sq fetch 213.Sq fetch
205command as root only, set 214command as root only, set
206.Va UPDATE_SOURCES 215.Va UPDATE_SOURCES
207to 216to
208.Sq false 217.Sq false
209in your user configuration files, and do your builds as another user. 218in your user configuration files, and do your builds as another user.
210.Ss Configuration file 219.Ss Configuration file
211Configuration files for 220Configuration files for
212.Nm 221.Nm
213are plain shell scripts that define a set of recognized variables. 222are plain shell scripts that define a set of recognized variables.
214.Pp 223.Pp
215As scripts, they can perform any magic they desire to deduce the value of 224As scripts, they can perform any magic they desire to deduce the value of
@@ -247,27 +256,28 @@ Whether to perform an update of the sour @@ -247,27 +256,28 @@ Whether to perform an update of the sour
247.Pp 256.Pp
248Default: 257Default:
249.Sq true . 258.Sq true .
250.It Va XSRCDIR 259.It Va XSRCDIR
251Path to the xsrc module. 260Path to the xsrc module.
252If you want 261If you want
253.Nm 262.Nm
254to perform an update of this directory before every build, you will need 263to perform an update of this directory before every build, you will need
255write access to it. 264write access to it.
256Otherwise, you can use a read-only directory. 265Otherwise, you can use a read-only directory.
257.Pp 266.Pp
258Defining this variable causes 267Defining this variable causes
259.Nm 268.Nm
260to build the X Window System as part of the build of NetBSD. 269to build the X Window System as part of the build of
 270.Nx .
261.Pp 271.Pp
262Default: not defined. 272Default: not defined.
263.El 273.El
264.Pp 274.Pp
265The following variables configure the location of the build files: 275The following variables configure the location of the build files:
266.Bl -tag -width INCREMENTAL_BUILD 276.Bl -tag -width INCREMENTAL_BUILD
267.It Va BUILD_ROOT 277.It Va BUILD_ROOT
268Path to the directory in which to place build files. 278Path to the directory in which to place build files.
269These include the obj tree, the destdir and the cross-build tools generated 279These include the obj tree, the destdir and the cross-build tools generated
270by the 280by the
271.Nm build.sh 281.Nm build.sh
272script. 282script.
273The contents of this directory are sorted by machine type so that it can be 283The contents of this directory are sorted by machine type so that it can be
@@ -330,21 +340,21 @@ corresponding @@ -330,21 +340,21 @@ corresponding
330file and the 340file and the
331.Fl c 341.Fl c
332flag is not provided. 342flag is not provided.
333.It Pa ~/.sysbuild/ 343.It Pa ~/.sysbuild/
334Directory containing all user-specific configuration files. 344Directory containing all user-specific configuration files.
335.It Pa ~/.sysbuild/default.conf 345.It Pa ~/.sysbuild/default.conf
336Default configuration file to load when the 346Default configuration file to load when the
337.Fl c 347.Fl c
338flag is not provided. 348flag is not provided.
339.El 349.El
340.Sh SEE ALSO 350.Sh SEE ALSO
341.Xr cvs 1 , 351.Xr cvs 1 ,
342.Xr sysbuild4cron 1 , 352.Xr sysbuild4cron 1 ,
343.Xr hier 7 and 353.Xr hier 7 ,
344.Pa /usr/src/BUILDING . 354.Pa /usr/src/BUILDING
345.Sh AUTHORS 355.Sh AUTHORS
346The 356The
347.Nm 357.Nm
348utility was developed by 358utility was developed by
349.An Julio Merino 359.An Julio Merino
350.Aq jmmv@NetBSD.org . 360.Aq jmmv@NetBSD.org .

cvs diff -r1.1 -r1.2 pkgsrc/sysutils/sysbuild/files/Attic/sysbuild4cron.1 (expand / switch to unified diff)

--- pkgsrc/sysutils/sysbuild/files/Attic/sysbuild4cron.1 2012/07/25 12:18:23 1.1
+++ pkgsrc/sysutils/sysbuild/files/Attic/sysbuild4cron.1 2012/08/11 19:32:50 1.2
@@ -1,13 +1,14 @@ @@ -1,13 +1,14 @@
 1.\" $NetBSD: sysbuild4cron.1,v 1.2 2012/08/11 19:32:50 wiz Exp $
1.\" Copyright 2012 Google Inc. 2.\" Copyright 2012 Google Inc.
2.\" All rights reserved. 3.\" All rights reserved.
3.\" 4.\"
4.\" Redistribution and use in source and binary forms, with or without 5.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions are 6.\" modification, are permitted provided that the following conditions are
6.\" met: 7.\" met:
7.\" 8.\"
8.\" * Redistributions of source code must retain the above copyright 9.\" * Redistributions of source code must retain the above copyright
9.\" notice, this list of conditions and the following disclaimer. 10.\" notice, this list of conditions and the following disclaimer.
10.\" * Redistributions in binary form must reproduce the above copyright 11.\" * Redistributions in binary form must reproduce the above copyright
11.\" notice, this list of conditions and the following disclaimer in the 12.\" notice, this list of conditions and the following disclaimer in the
12.\" documentation and/or other materials provided with the distribution. 13.\" documentation and/or other materials provided with the distribution.
13.\" * Neither the name of Google Inc. nor the names of its contributors 14.\" * Neither the name of Google Inc. nor the names of its contributors
@@ -68,20 +69,20 @@ The following options are supported: @@ -68,20 +69,20 @@ The following options are supported:
68Path to the directory that will keep the logs of all the calls to 69Path to the directory that will keep the logs of all the calls to
69.Xr sysbuild 1 . 70.Xr sysbuild 1 .
70.Pp 71.Pp
71Default: 72Default:
72.Pa ~/sysbuild/log . 73.Pa ~/sysbuild/log .
73.It Fl r Ar recipient 74.It Fl r Ar recipient
74Email address of the recipient of the failure messages. 75Email address of the recipient of the failure messages.
75.Pp 76.Pp
76Default: the current username, without a domain part. 77Default: the current username, without a domain part.
77.El 78.El
78.Sh SEE ALSO 79.Sh SEE ALSO
79.Xr crontab 1 , 80.Xr crontab 1 ,
80.Xr sysbuild 1 , 81.Xr sysbuild 1 ,
81.Xr crontab 5 . 82.Xr crontab 5
82.Sh AUTHORS 83.Sh AUTHORS
83The 84The
84.Nm 85.Nm
85utility was developed by 86utility was developed by
86.An Julio Merino 87.An Julio Merino
87.Aq jmmv@NetBSD.org . 88.Aq jmmv@NetBSD.org .