Commit Graph

55 Commits

Author SHA1 Message Date
bz
c94366e913 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
gjb
38228eea55 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
netchild
e14ccde629 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
keramida
8c1c218daa 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
imp
0efea5999c 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
imp
b1259c29a3 Docmuent NO_KERNEL{CLEAN,CONFIG,DEPEND,OBJ} as necessary. Update
documentation on KERNFAST meaning.
2009-12-16 03:25:43 +00:00
imp
5341e1c548 Sort KERNFAST and KERNCONF into the list they are in. 2009-01-23 18:35:09 +00:00
imp
92ebc7defc 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
keramida
6f2df61ea7 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
imp
ba5ae39a20 BSDMAKE isn't really needed and was removed, so remove here 2007-12-13 00:09:43 +00:00
imp
a881501a6f 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
mpp
5748ac9909 Spelling fixes. 2006-12-14 13:37:08 +00:00
ru
6843143013 Markup glitch. 2006-09-30 20:37:37 +00:00
ru
4b49dc3738 Require rpc.lockd(8) only if make is running with the -j option. 2006-09-30 20:18:28 +00:00
jkoshy
8806426e05 Cross-reference src.conf(5). 2006-06-11 08:30:38 +00:00
maxim
7dbcaa9a39 o Replace alpha-specific DESTDIR to a sparc64 one.
Spotted by:	Gennady Proskurin
2006-05-17 11:31:24 +00:00
maxim
3b1f2df0f9 o In the cross-build example replace alpha by sparc64. 2006-05-15 20:53:00 +00:00
ru
97bfff6a70 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
jkoshy
d78bb7ea61 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
ru
8a2652d669 -mdoc sweep. 2005-11-18 10:56:28 +00:00
yar
633be11491 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
ru
507b64e047 Add missing "not" in rev. 1.34.
Submitted by:	Jeremie Le Hen
2005-08-03 20:11:39 +00:00
ru
d89945e379 Make delete-old* and friends useable for cross-builds. 2005-08-03 20:09:59 +00:00
obrien
50b149d376 Document 'kernel-toolchain'.
Submitted by:	Jeremie Le Hen <jeremie@le-hen.org>
2005-08-03 03:26:57 +00:00
netchild
3ca6ec249e - 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
netchild
f78772bbe4 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
trhodes
98afb7c0a2 Fix a few markup nits in previous commit.
Noticed by:	ru, who else? :)
2005-02-25 00:40:46 +00:00
trhodes
3b38ff8183 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
ru
3eb59f1ca1 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
ru
ef551a94ac Remove another mention of "make world". 2004-08-09 13:25:06 +00:00
ru
aa52a5a900 Assorted markup, spelling, and grammar fixes. 2004-06-16 08:33:57 +00:00
simon
1ff7b74aca mdoc(7) janitor:
- Use .Aq macro instead of <foo>.
- Kill EOL whitespace.
2003-11-16 15:16:19 +00:00
imp
0e54f1820d Amplify the reboot requirement 2003-11-14 16:55:00 +00:00
imp
93bd478591 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
smkelly
c2c00420f7 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
ru
c802961bf0 mdoc(7) police: tidy up. 2002-03-20 14:33:37 +00:00
murray
8f54f13281 Spell analogous properly.
Found by:	ispell(1)
2002-03-17 15:01:28 +00:00
murray
dc013a804d Markup fix. Use .Va instead of .Ev. No content changes. 2002-03-15 23:34:17 +00:00
murray
309c5defb0 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
murray
9d61be7130 Add an ENVIRONMENT section, and document TARGET_ARCH and NO_WERROR.
Add a cross-build example.
2002-03-14 09:38:24 +00:00
murray
aa8b8d80dc Reference release(7) in SEE ALSO. 2002-03-13 06:59:39 +00:00
ru
f4741db77f mdoc(7) police: sort FILES. 2001-09-04 10:08:19 +00:00
alex
1b28c0b357 Move /etc/defaults/make.conf to /usr/share/examples/etc/make.conf as
discussed on the arch@ mailinglist (after repo-copy).

sys.mk will .error if it finds /etc/defaults/make.conf but include
it anyways (this is the same behaviour as with the make.conf.local
removal).

/usr/share/examples/etc/make.conf has BDEFLAGS commented out now,
since it's only an example file.

Adjust all textes that talk about make.conf or defaults/make.conf to
match the new situation.
2001-08-30 22:44:51 +00:00
schweikh
511e378b14 Removed whitespace at end-of-line; no content changes. I simply did
cd src/share; find man[1-9] -type f|xargs perl -pi -e 's/[ \t]+$//'

BTW, what editors are the culprits? I'm using vim and it shows
me whitespace at EOL in troff files with a thick blue block...

Reviewed by:	Silence from cvs diff -b
MFC after:	7 days
2001-07-14 19:41:16 +00:00
ru
9001bc7070 mdoc(7) police: removed HISTORY info from the .Os call. 2001-07-10 15:31:11 +00:00
jhb
c88d6fada2 Replace references to the KERNEL variable with KERNCONF. 2001-05-17 23:23:25 +00:00
ru
2d1b95a96f mdoc(7) police: normalize .Nd. 2001-04-18 15:54:10 +00:00
ru
17ba214098 Prepare for mdoc(7)NG. 2000-12-29 09:18:45 +00:00
ru
51b13b77a8 mdoc(7) police: removed duplicate .Os calls. 2000-12-14 12:40:48 +00:00
ru
ee79097019 mdoc(7) police: use canonical form of .Dd macro. 2000-12-11 15:47:53 +00:00