Commit Graph

66 Commits

Author SHA1 Message Date
Bryan Drewery
ca6a54ce20 Update build(7) with LOCAL_* vars
PR:		docs/178286
Submitted by:	Garrett Cooper <yaneurabeya@gmail.com>
Sponsored by:	EMC / Isilon Storage Division
MFC after:	1 week
2014-03-27 11:12:35 +00:00
John Baldwin
6a28ff1bb8 WITH_CTF is now a "normal" build option (WITHOUT_CTF is supported and
MK_CTF is used internally).

Reviewed by:	fjoe
2012-10-10 16:07:23 +00:00
Warren Block
d732418b1f Add reference to portsnap(8).
Submitted by:	Tim Kientzle
MFC after:	1 day
2012-07-02 17:52:43 +00:00
Warren Block
50a994c98b Point out that /usr/src, /usr/doc, and /usr/ports may be empty or not
exist until populated with csup(1) or svn(1).

PR:		169487
Submitted by:	Moritz Wilhelmy
MFC after:	1 day
2012-06-27 17:51:09 +00:00
Glen Barber
ea658fe55a Bump .Dd to reflect the date of the last content change, so MFC content
makes sense.

Pointy-hat to:		gjb (myself)
2011-10-09 20:21:07 +00:00
Glen Barber
cc13988649 Whitespace cleanup in build(7).
MFC after:	1 week
Need-MFC:	225858
2011-09-29 02:57:08 +00:00
Glen Barber
170c2788cb Document, and provide an example for, PORTS_MODULES in build(7).
PR:		161017
Submitted by:	gcooper
MFC after:	1 week
2011-09-29 02:52:33 +00:00
Ruslan Ermilov
69c488cdc6 It's a bit odd, but "make update" in src/ can also update the ports/,
doc/, and now www/ trees, but only using the "cvsup" transport.

When "make update" is run using a tree's makefile, it can also use
"cvs" (except for www/) and "svn" (only src/).

Clean up documentation and code regarding "make update":

- Increase oddness by adding support for WWWSUPFILE and NO_WWWUPDATE to
  Makefile.inc1 (analogous to PORTSSUPFILE/NO_PORTSUPDATE and
  DOCSUPFILE/NO_DOCUPDATE; WWWSUPFILE already supported by www/Makefile).

- Document all trees that support CVS_UPDATE.

- Document all trees that support SUP_UPDATE.

- Document SVN_UPDATE.

- Document NO_WWWUPDATE.

- make.conf(5) mistakenly said that *SUPFILE* had defaults.

- Add an example entry for WWWSUPFILE.
2011-06-16 12:28:37 +00:00
Nathan Whitehorn
e8423d00e1 Update release(7) and build(7) to reflect new release infrastructure for
the new installer.
2011-03-22 01:21:51 +00:00
John Baldwin
4e889921ef - Add a new UNIVERSE_TARGET variable for 'make universe'. If it is set,
then that target is invoked for each architecture rather than the
  default action of building world and kernels for each architecture.
- Add a 'make toolchains' wrapper which uses UNIVERSE_TARGET to build
  toolchains for all architectures.
- Document JFLAG, MAKE_JUST_KERNELS, and MAKE_JUST_WORLDS variables for
  'make universe'.

Reviewed by:	bz
MFC after:	1 week
2011-02-10 18:54:52 +00:00
Bjoern A. Zeeb
f1d16bd892 Back out r217734. [1]
Properly document what `make targets` is supposed to list to avoid
further confusion given the place the target sits. Should have happened
with r217125.

Requested by:	imp [1]
Reviewed by:	rwatson
2011-01-25 08:13:31 +00:00
Bjoern A. Zeeb
eee8163bef Properly document what the top-level make tinderbox does.
Reviewed by:	jmallett
MFC After:	3 days
X-MFC:		build.7 only
2011-01-22 22:57:28 +00:00
Glen Barber
7d6af40d1c Minor grammar fix.
Submitted by:	arundel (via email)
Approved by:	jkois (mentor)
Patch by:	arundel
MFC after:	5 days
2010-10-26 13:07:01 +00:00
Alexander Leidinger
21edb039c6 WITH_CTF can now be specified in src.conf (not recommended, there
are some problems with static executables), make.conf (would also
affect ports which do not use GNU make and do not override the
compile targets) or in the kernel config (via "makeoptions
WITH_CTF=yes").

Additional (related) changes:
 - propagate WITH_CTF to module builds
 - do not add -g to the linker flags, it's a noop there anyway
   (at least according to the man page of ld)
 - do not add -g to CFLAGS unconditionally
   we need to have a look if it is really needed (IMO not) or if there
   is a way to add it only when WITH_CTF is used

Note: ctfconvert / ctfmerge lines will not appear in the build output,
to protect the innocent (those which do not build with WITH_CTF would
see the shell-test and may think WITH_CTF is used).

Reviewed by:	imp, jhb, scottl (earlier version)
Discussed on:	arch@
2010-04-02 06:55:31 +00:00
Giorgos Keramidas
fea87c03b8 Document DEBUG_FLAGS in a more visible place, in the build(7) manpage
Noticed by:     Alexander Best <alexbestms.at.wwu.de>
Reviewed by:    jhb
MFC after:      1 week
2010-03-31 12:52:19 +00:00
Warner Losh
e999537881 Forgot to bump .Dd, so do it with this commit. Chose local time over
UTC time for the date...
2009-12-16 03:29:00 +00:00
Warner Losh
6d50d5e4d5 Docmuent NO_KERNEL{CLEAN,CONFIG,DEPEND,OBJ} as necessary. Update
documentation on KERNFAST meaning.
2009-12-16 03:25:43 +00:00
Warner Losh
e6cdeeddf4 Sort KERNFAST and KERNCONF into the list they are in. 2009-01-23 18:35:09 +00:00
Warner Losh
c22c7f86ff Document KERNCONF and KERNFAST. Note that TARGET is usually all one
needs to set for cross building.
2009-01-23 18:32:31 +00:00
Giorgos Keramidas
fd23b46153 Document the NO_XXX options supported by our Makefile.inc1.
Noticed by:	simon
Reviewed by:	imp
MFC after:	1 week
2009-01-05 16:25:36 +00:00
Warner Losh
a1e8ef7737 BSDMAKE isn't really needed and was removed, so remove here 2007-12-13 00:09:43 +00:00
Warner Losh
531b260a4f Document BSDMAKE variable that was recently introduced. Also, since
RELENG_7, the way to do a cross build changed from specifying only
TARGET_ARCH (which has an ambigous mapping to TARGET) to specifying
only TARGET (which has a unique mapping to TARGET_ARCH).  Update the
example to reflect this.

MFC After: 1 week (the example change only)
2007-12-11 21:14:10 +00:00
Mike Pritchard
abfabbea13 Spelling fixes. 2006-12-14 13:37:08 +00:00
Ruslan Ermilov
8ed6451eab Markup glitch. 2006-09-30 20:37:37 +00:00
Ruslan Ermilov
04876cf3eb Require rpc.lockd(8) only if make is running with the -j option. 2006-09-30 20:18:28 +00:00
Joseph Koshy
157376ba13 Cross-reference src.conf(5). 2006-06-11 08:30:38 +00:00
Maxim Konovalov
a51851f1cb o Replace alpha-specific DESTDIR to a sparc64 one.
Spotted by:	Gennady Proskurin
2006-05-17 11:31:24 +00:00
Maxim Konovalov
62d065388d o In the cross-build example replace alpha by sparc64. 2006-05-15 20:53:00 +00:00
Ruslan Ermilov
a3aed80d1e Document the requirement to run rpc.lockd(8) on both client
and server when installing onto an NFS file system.
2006-03-20 12:27:08 +00:00
Joseph Koshy
7b710ab25b Document the public targets and make variables supported by the
build system.

Reviewed by:	ru (multiple passes)
2005-12-05 16:59:45 +00:00
Ruslan Ermilov
78ad54210f -mdoc sweep. 2005-11-18 10:56:28 +00:00
Yaroslav Tykhiy
08b9134350 Replace "/etc/make.conf" with references to make.conf(5)
where applicable.  The main reason for this change is that
the location of make.conf is not constant and can be
modified via __MAKE_CONF.  This change also improves
hyper-text linkage in our manpages.

MFC after:	2 weeks
2005-10-10 14:55:59 +00:00
Ruslan Ermilov
9ac8d2e820 Add missing "not" in rev. 1.34.
Submitted by:	Jeremie Le Hen
2005-08-03 20:11:39 +00:00
Ruslan Ermilov
c8ef0ed51d Make delete-old* and friends useable for cross-builds. 2005-08-03 20:09:59 +00:00
David E. O'Brien
722d16b7fc Document 'kernel-toolchain'.
Submitted by:	Jeremie Le Hen <jeremie@le-hen.org>
2005-08-03 03:26:57 +00:00
Alexander Leidinger
af3e19a68c - Move recently added dir into the correct section.
- Add a note about the organisation of the sections.
 - Expand shell globs (they worked in a previous version of the delete-old
   target, but not in this one).
 - Use the correct way of checking for a native environment. [1]
 - Add some more obsolete files.
 - Fix some bad english. [1]

Suggested by:	ru [1]
Approved by:	mentor (joerg)
2005-07-29 21:45:46 +00:00
Alexander Leidinger
e2a3608153 Add delete-old and delete-old-libs targets:
- removes obsolete files/dirs or libraries.
  - works in interactive (default) and batch mode
  - respects DISTDIR
  - documented in UPDATING and build(7)

The head of the file ObsoleteFiles.inc contains instructions how to add
obsolete files/dirs/libs to the list. Obviously one should add obsolete
files to this list, when he removes a file/dir/lib from the basesystem.

Additionally add check-old target:
  - allows re@ to check if a file on the obsolete list resurfaces

Design goals:
  - allows full control by the user (default interactive mode)
  - possibility of scripted removal of obsolete files (batch mode)
  - opt-in removal of files (explicit list of files)
  - seperate removal of libs (2 delete targets)

Important design decissions:
  - structured list of files to remove instead of a plain text file:
    * allows to remove additional files if a NO_foo knob is specified
      without the need to change the targets (no NO_foo knob is respected
      yet)
  - not using mtree like NetBSD does:
    * mtree doesn't has an interactive mode

Discussed on:		arch (long ago), current (this year)
Additional input from:	re (hrs)
Approved by:		mentor (joerg)
2005-07-23 14:23:30 +00:00
Tom Rhodes
61001d7506 Fix a few markup nits in previous commit.
Noticed by:	ru, who else? :)
2005-02-25 00:40:46 +00:00
Tom Rhodes
389e98a7c5 To be more complete, discuss 'make kernel' since we do cover buildkernel.
Xref config.8.
Bump doc date.
2005-02-24 03:46:36 +00:00
Ruslan Ermilov
be6a47606f Replaced a way outdated and unsafe sequence of upgrading the system
from sources with the link to the relevant section in src/UPDATING.
2004-08-13 12:59:46 +00:00
Ruslan Ermilov
8f0d968bd8 Remove another mention of "make world". 2004-08-09 13:25:06 +00:00
Ruslan Ermilov
bf7f20c2b6 Assorted markup, spelling, and grammar fixes. 2004-06-16 08:33:57 +00:00
Simon L. B. Nielsen
f72375e102 mdoc(7) janitor:
- Use .Aq macro instead of <foo>.
- Kill EOL whitespace.
2003-11-16 15:16:19 +00:00
Warner Losh
b35ee63d8a Amplify the reboot requirement 2003-11-14 16:55:00 +00:00
Warner Losh
614e1f02e8 Add required reboot into single-user mode step.
# mdoc janitors should make sure I did the markup right

Inspired by: recent problems in this area
2003-11-14 06:24:20 +00:00
Sean Kelly
c8e4c45d85 Bring build(7) in sync with src/Makefile by removing documentation
for targets that have been unsupported since April:
   - upgrade
   - aout-to-elf
   - aout-to-elf-build
   - aout-to-elf-install
   - move-aout-libs

Approved by:	imp
2003-07-08 16:39:10 +00:00
Ruslan Ermilov
1caae05702 mdoc(7) police: tidy up. 2002-03-20 14:33:37 +00:00
Murray Stokely
365a17c0f4 Spell analogous properly.
Found by:	ispell(1)
2002-03-17 15:01:28 +00:00
Murray Stokely
6f9ac6fee0 Markup fix. Use .Va instead of .Ev. No content changes. 2002-03-15 23:34:17 +00:00
Murray Stokely
b3a43ea37a Add a description of the TARGET variable, and add more information
about the TARGET_ARCH variable. (1)

Add information about the DESTDIR variable.

Add more examples for cross-building.

(1) Submitted by:     ru
MFC after:	      3 days
2002-03-15 23:29:24 +00:00