Commit Graph

104 Commits

Author SHA1 Message Date
apb c170baae9a Add advice about avoiding common pitfalls.
This is taken from the patch in PR 48741, by David H. Gutteridge,
but I made small changes to wording and markup.
2014-08-07 21:45:27 +00:00
apb a960e5c872 Document build.sh list-arch 2014-08-07 21:32:11 +00:00
apb f4b0cac682 Bump date for previous 2014-08-03 09:25:02 +00:00
apb b2a466780b BUILDINFO part 5: Document BUILDINFO in doc/BUILDING.mdoc. 2014-08-03 09:24:08 +00:00
apb 38373b3db6 Improve documentation for BUILDID. 2014-06-14 12:20:17 +00:00
wiz 0a35378dc9 Use Pa for paths. Fix a couple of typos. 2014-05-21 13:11:25 +00:00
martin 545afccdc2 Document MKCROSSGDB, MKKDEBUG and build.sh kernel.gdb= 2014-05-19 10:12:19 +00:00
martin d6af3a0abf Document MKDEBUG and MKDEBUGLIB 2014-05-19 09:56:17 +00:00
martin 8800a5ed8e Document external directories 2014-05-19 09:49:07 +00:00
uwe 49b378ef18 Add missing Ar 2013-12-24 20:10:29 +00:00
wiz efd3bc66c4 - Bump date (for r1.93);
- remove superfluous macros (fixes mandoc(1) warnings).

From Bug Hunting.
2013-05-29 14:45:55 +00:00
dholland 43c1d01a08 MKCATPAGES defaults to no these days; noted on netbsd-docs by Luc van
der Veen.
2012-11-08 15:24:40 +00:00
abs 5b8d7483de Adjust postinstall recommendation syntax. based on comment from Snader_LB on IRC 2012-09-19 23:31:36 +00:00
abs 0d98e4a0de strip trailing whitespace 2012-09-19 23:08:37 +00:00
abs 62356763f1 Fix inverted logic description for MKSTRIPIDENT.
Noted by Snader_LB on freenode IRC
2012-09-19 23:06:22 +00:00
wiz 86c4a86ab5 Document MKREPRO using joerg's wording. 2012-05-25 10:47:25 +00:00
tsutsui f06b8cb50a Add a missing period. 2012-02-23 13:34:15 +00:00
apb 3388131ab9 Minor changes to wording in the documentation for
build.sh install-image and live-image.
2012-02-14 21:32:07 +00:00
apb b753e6a507 Document build.sh "live-image" and "install-image" targets.
These were documented in revision 1.97 of src/BUILDING, but were
not documented in src/doc/BUILDING.sh.  The original log message
was:

revision 1.97
date: 2012/01/22 03:53:32;  author: tsutsui;  state: Exp;  lines: +39 -0
Add "live-image" and "install-image" target support to build.sh.

"live-image" target builds pre-installed disk images that can be used on
emulators or boot from USB memory sticks to try NetBSD without installation.
Currently amd64, i386, pmax, sparc, sparc64, sun2, sun3, and vax
(which have working emulators and don't require extra tools like preparing
 msdosfs or partitioning MD label structures) support this target.

"install-image" target builds an bootable installation disk image that can
be used as an install CD but burned into USB memory sticks etc.
Current only amd64 and i386 (which would support USB boot) have this target.

For more details (and known issue) see following posts on netbsd-bugs@:
http://mail-index.NetBSD.org/netbsd-bugs/2011/08/06/msg023639.html
http://mail-index.NetBSD.org/netbsd-bugs/2011/09/23/msg024207.html
http://mail-index.NetBSD.org/netbsd-bugs/2011/12/07/msg025166.html
http://mail-index.NetBSD.org/netbsd-bugs/2011/12/08/msg025178.html

No particular comments about implementation, and
"go ahead" comments from mrg@, riz@ and christos@.

Closes PR toolchain/45153 and PR misc/45155.
2012-02-14 21:19:19 +00:00
apb 37b9b22e26 Add tests for the shell under which build.sh is run. If the
shell fails the tests, then build.sh tries to re-exec itself
under a more suitable shell.
2011-09-09 18:48:34 +00:00
apb 5f70d1f98e Move the code for creating src/BUILDING from "make build-docs" in
src/Makefile to "make regen" in src/doc/Makefile, and update a comment
in doc/BUILDING.mdoc to match.
2011-09-09 14:23:37 +00:00
apb 94bddc04db Revisions 1.92 and 1.93 of src/BUILDING were not reflected in
src/doc/BUILDING.mdoc, so those changes were lost when src/BUILDING
was regenerated in revision 1.94.

Now update src/doc/BUILDING.mdoc and regenerate src/BUILDING to
reinstate the lost changes.  (I also edited one of the changes, to use
the phrase "space-separated list" for consistency with other parts of
the document.)

The original changes were:
----------------------------
revision 1.93
date: 2011/08/06 19:52:49;  author: jnemeth;  state: Exp;  lines: +5 -0
Add description of MKKMOD, part of PR misc/45216
----------------------------
revision 1.92
date: 2011/01/29 16:56:26;  author: jym;  state: Exp;  lines: +6 -4
Pass down INSTALLSETS variable to installsets target. Use :Q to escape
shell meta-characters, as the variable contains a list of sets, separated
by spaces.

$ ./build.sh -V INSTALLSETS="base etc" install=idir

should now work as expected.

Reviewed by apb@ on tech-toolchain.
----------------------------
2011-09-09 14:01:28 +00:00
apb a4d065775d Allow MAKEFLAGS to be set via build.sh -V. Somebody asked for this
in 2008.

Also add comments above a few functions in build.sh, and bump copyright
dates.
2011-09-09 13:29:23 +00:00
mrg a20af8d9db remove the MKSUBPIXEL/MKTTINTERP options; they're going away.
regenerate.
2010-07-25 07:19:00 +00:00
apb 87272391e8 If ${NETBDSRCDIR}/../xsrc exists, then use it as the default value
of X11SRCDIR.  If it doesn't exist, then use /usr/xsrc as before.

OK mrg
2009-10-10 19:05:28 +00:00
cegger d08f5c154a backout wrong changes after I got teached that the vowel *sound* matters
and not the spelling letter (which is what I learned at school).
2009-10-02 07:43:01 +00:00
cegger bdf8a0a549 fix grammar: a -> an 2009-10-02 07:17:16 +00:00
apb 828252228e * Use a more robust method of creating the top level object directory.
Use getmakevar to expand MAKEOBJDIRPREFIX or MAKEOBJDIR, or (if
  neither of those variables is set) use a non-recursive "make obj" in
  the top level source directory.

* Do not let TOP_objdir default to ${TOP}.  It's now set only by the
  -M or -O command line options, or after using getmakevar to expand
  MAKEOBJDIRPREFIX or MAKEOBJDIR.

* Make try_set_TOOLDIR handle MAKEOBJDIRPERFIX passed from the
  environment.  It runs too early to use getmakevar, so it will not work
  if the value contains embedded '${...}' variable references.

* Use '$TOOLDIR' (with a literal '$') instead of 'nonexistent' in
  a message when rebuilding make when TOOLDIR is not yet known.
2009-09-27 18:08:24 +00:00
apb f1ead22021 Allow build.sh "-C cdextra" option to be specified multiple times. 2009-09-27 17:28:38 +00:00
apb 72d2ca4da0 Revision 1.86 of src/BUILDING somehow got committed without the
corresponding changes to src/doc/BUILDING.mdoc.  Fix that now.
The original log message was:

Add a modules operation to build.sh, which builds and installs kernel modules
into DESTDIR.

This is based on the patch provided by tsutsui@ on tech-toolchain@.
2009-09-27 16:44:40 +00:00
hubertf c984b3031f s/reproducable/reproducible/, requested by salo@ 2009-07-12 14:16:36 +00:00
hubertf 20a9c4e439 Add a keywords for people looking for reproducable (identical) builds. 2009-07-12 12:14:51 +00:00
snj 75626c3937 Introduce MKSUBPIXEL, which allows enabling subpixel rendering code
in FreeType.
2009-05-01 19:42:18 +00:00
mrg 8f2ea05a60 be explicit about MAKEOBJDIR and MAKEOBJDIRPREFIX not being for
mk.conf or ${MAKECONF}.
2008-12-02 22:28:21 +00:00
mrg 867022784c revert sparc back to default of XFree86 at the request of macallan. 2008-11-15 11:27:49 +00:00
apb c89f08d79b Add support for new MAKEVERBOSE levels 3 and 4. The complete list is now:
0   Minimal output ("quiet")
 1   Describe what is occurring
 2   Describe what is occurring and echo the actual command
 3   Ignore the effect of the "@" prefix in make commands
 4   Trace shell commands using the shell's -x flag

The default remains MAKEVERBOSE=2.
2008-11-13 20:40:11 +00:00
mrg 9c8df5ee67 - retire MKXORG from public use
- introduce X11FLAVOUR to choose src/x11 vs src/external/mit/xorg
  for the X11 to build if MKX11=yes is set.  it takes the values
  of either Xorg or XFree86.
- default to Xorg on alpha, i386, macppc, shark, sparc and sparc64
- remove MKXORG_WITH_XSRC_XSERVER, unused and never useful
2008-11-09 23:02:28 +00:00
apb 437dcf469b * Strengthen the advice against relying on the default objdir selection
rules.
* Add "[options]" to examples in an attempt to make it clear that
  extra options should be passed.
2008-09-24 07:36:52 +00:00
joerg dc0088231d Document MKSTRIPIDENT. Requested by lukem@ 2008-09-10 11:16:41 +00:00
lukem d7fc424b0a document MKHTML 2008-09-06 23:22:46 +00:00
lukem d6e6997551 Improve support for MKXORG!=no to enable builds into external/mit/xorg.
This will be mutually exclusive to MKX11!=no.
2008-08-28 07:21:49 +00:00
lukem 9df2be37d7 Document "build.sh cleandir".
Fix formatting nit.
Remove BUGS; all the in-tree platforms are using build.sh now.
2008-08-18 05:27:05 +00:00
apb f0633cf45e * Suggest a "-j" value between 1+NCPU and 2*NCPU for the fastest builds.
* Remove some duplicated content that appeared in both the section about
  make's -j flag and the section about build.sh's -j flag.
2008-08-11 08:22:39 +00:00
apb ca568b574c * Add more detail for build.sh -M and -O options.
* Mention new default when source is /usr/src but build.sh is run
  with neither -M nor -O.
2008-08-05 22:40:33 +00:00
perry b1d7b7c21a Builds now use "BUILDSEED" so that c++ binaries are reproduceable.
By default BUILDSEED is set to NetBSD-{majorversion} -- a -S flag may
be used to change it.

Discussed on tech-toolchain.
2008-08-05 19:43:33 +00:00
martin 11a6dbe728 Convert TNF licenses to new 2 clause variant 2008-04-30 13:10:46 +00:00
dholland 19f2a45a44 Correct/clarify the default setting of USETOOLS in the previous version.
Noted by apb.
2008-03-29 05:22:42 +00:00
dholland 000424deb2 Assorted updates and clarifications, grammar fixes and wording improvements,
and so on. Significant highlights:
   - mention src/tests and reference atf;
   - provide examples of MACHINE and MACHINE_ARCH;
   - mention that MKOBJ=no is not recommended;
   - correct the description of the default setting of USETOOLS;
   - document the interactions of build.sh -[uo] with various things;
   - document the interactions of build.sh tools and kernel=FOO;
   - use a lot fewer parentheses.
Discussed on netbsd-docs.
2008-03-28 05:23:44 +00:00
lukem b08050d67a Consistently document RELEASEDIR/RELEASEMACHINEDIR. 2008-03-18 04:24:38 +00:00
reed 09831171ac Mention that "build" and "distribution" do not build nor install (to DESTDIR)
a kernel.
2008-03-08 14:48:57 +00:00