CVS log for src/distrib/notes/Makefile.inc

Up to [cvs.NetBSD.org] / src / distrib / notes

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

specify the paper size for PostScript

Set the timezone too when invoking date with a timestamp because it can
be affected too:
$ env TZ=UTC date -r 1700157305
Thu Nov 16 17:55:05 UTC 2023
$ env TZ=UTC24:24:24 date -r 1700157305
Wed Nov 15 17:30:41 UTC 2023

Use TOOL_DATE (Jan-Benedict Glaw)

Make .Nx \*V happy for current builds.

I'm not sure why mdoc complains here (not the technical reason, but
the pragmatic purpose).  My best guess is that it wants to catch
mistakes like .Fx 1.6.1 (instead of .Nx 1.6.1).  I'm not entirely
convinced this doesn't create more problems that it solves.

No objections in the 15 years since this was proposed netbsd-docs.

Pass the name of the compressor actually used for sets to groff and use
it in the content description (XXX need to adapt a few more copies in,
as of now, unaffected architectures)

For MKREPRO builds:
1. compute cur_date from the timestamp
2. pass the date to groff so that it can set its registers

Merge changes from current as of 20200406

Pull up following revision(s) (requested by uwe in ticket #652):

	distrib/notes/Makefile.inc: revision 1.54
	distrib/notes/common/main: revision 1.561
	distrib/notes/common/main: revision 1.562
	share/tmac/doc2html: revision 1.71

Use .Os NetBSD/\*M \*V to get more informative footer.

Provide ability to override <title>

If \*[title-section] is non-empty, use it to override the title
instead of appending it.  Nothing in the tree uses title-section
currently, so it shouldn't affect any existing document.

This override will be used by the installation notes where the default
title is less than helpful.

Override HTML <title> to something more informative.
Requested by martin@

Use -mdoc2html to generate HTML TOC to avoids warnings.

Use -mdoc2html to generate HTML TOC to avoids warnings.

Pull up following revision(s) (requested by martin in ticket #608):
	distrib/notes/Makefile.inc: revision 1.53
PR install/54836: fix broken conditional, passing the wrong set name suffix
to groff.

PR install/54836: fix broken conditional, passing the wrong set name suffix
to groff.

Pull up the following revisions, requested by uwe in ticket #523:

	distrib/notes/Makefile.inc                      up to 1.52
	distrib/notes/common/macros                     up to 1.54

Improve table of contents.

Improve table of contents.

For .txt and .more drop meaningless page numbers, those formats are
not paginated (with all due respect to line printers, 80s are over).

For .ps use actual formatting with proportional font and properly
aligned page numbers.  Thanks to kre@ for his help with some of the
darker corners of troff (with all due respect to my 80s self, he/I
should have paid more attention).

Use .open/.write instead of .tm to emit TOC.

Do not pass common/macros on the command line as input.

common/main already sources them, so there's no point to process the
file again *after* the document has been formatted.  Put it to SRCS so
that we still depend on it.

Don't lose groff's stderr when creating TOC.

Divert only the .Ti lines to the TOC file.  Keep the rest, it may
contain useful messages (like the empty line bug in macros that was
messing up page numbers).

TODO: Since we already depend on groff extensions, we should just use
.open/.write to emit the TOC directly.  But commit this for now in
case I run out of round tuits.

Make .Te and .To also emit .Ti with quoted arguments.

I missed them b/c I tested on sparc notes and sparc/install is stuck
in the 90s and doesn't include common/sysinst.  Now that all emitted
.Ti have properly quoted arguments we can revert TOCPROC to simple
grep.

While here convert .Te and .To to also use $* so we we can also drop
quoting from their calls in common/sysinst now.  Don't actually drop
those quotes yet though, as we probably can further simplify the call
sites by emitting the headings automatically instead of duplicating
them.

Pull up the following revision:

	distrib/notes/Makefile.inc		1.47

When creating the TOC file, strip all incoming double quotes, but output
quotes around the third arg of the generated Ti macro invocation.
This fixes the TOC in non-html output. Pointed out by kre.

When creating the TOC file, strip all incoming double quotes, but output
quotes around the third arg of the generated Ti macro invocation.
This fixes the TOC in non-html output. Pointed out by kre.

Pull up following revision(s) (requested by martin in ticket #489):
	distrib/notes/Makefile.inc: revision 1.46
	distrib/notes/common/postinstall: revision 1.86
	distrib/notes/sparc64/prep: revision 1.16
	distrib/notes/common/netboot: revision 1.38
	distrib/notes/common/main: revision 1.555
	distrib/notes/common/main: revision 1.556
	distrib/notes/common/main: revision 1.557
	distrib/notes/common/macros: revision 1.44
	distrib/notes/common/sysinst: revision 1.110
	distrib/notes/sparc/prep: revision 1.28
	distrib/notes/sparc/prep: revision 1.29
	distrib/notes/common/list-portmasters.pl: file removal
Remove list-portmasters.pl script.
We dropped that list from "main" some time ago.
Quote long .Ss2 title to avoid troff's limitation.
Troff is limited to 9 macro parameters and this title is 10 words, so
we lose the last word here when we pass arguments around.  We have
more titles like that but for now I wanted to commit only one just to
flag the problem.
More cleanup:
 - simplify TOC handling and remove arg limit (from uwe)
 - use Lk with explicit anchor text in some places
 - do not allow official release builds when we can not derive the
   proper date from the buildid
Add "Oxford comma"
Improve heading a bit.  While here, use quotes to group some of the
words to avoid the 9-arg limitation of .Ss

More cleanup:
 - simplify TOC handling and remove arg limit (from uwe)
 - use Lk with explicit anchor text in some places
 - do not allow official release builds when we can not derive the
   proper date from the buildid

Pull up following revision(s) (requested by martin in ticket #471):
	distrib/notes/sandpoint/xfer: revision 1.4
	distrib/notes/newsmips/contents: revision 1.6
	distrib/notes/Makefile.inc: revision 1.45
	distrib/notes/landisk/contents: revision 1.7
	distrib/notes/sparc/contents: revision 1.25
	distrib/notes/arc/contents: revision 1.6
	distrib/notes/sun2/contents: revision 1.6
	distrib/notes/common/sysinst: revision 1.109
	distrib/notes/common/postinstall: revision 1.85
	distrib/notes/vax/contents: revision 1.15
	distrib/notes/mac68k/contents: revision 1.24
	distrib/notes/alpha/contents: revision 1.20
	distrib/notes/cats/contents: revision 1.6
	distrib/notes/sparc64/contents: revision 1.9
	distrib/notes/mvme68k/contents: revision 1.17
	distrib/notes/i386/contents: revision 1.33
	distrib/notes/common/main: revision 1.554
	distrib/notes/rs6000/contents: revision 1.6
	distrib/notes/hpcmips/contents: revision 1.14
	distrib/notes/evbppc/contents: revision 1.7
	distrib/notes/hpcarm/contents: revision 1.7
	distrib/notes/emips/contents: revision 1.6
	distrib/notes/sun3/contents: revision 1.20
	distrib/notes/macppc/contents: revision 1.18
	distrib/notes/amd64/contents: revision 1.9
	distrib/notes/x68k/contents: revision 1.21
	distrib/notes/sgimips/contents: revision 1.6
	distrib/notes/sandpoint/contents: revision 1.6
	distrib/notes/mmeye/contents: revision 1.7
	distrib/notes/arc/prep: revision 1.5
	distrib/notes/pmax/contents: revision 1.21
	distrib/notes/shark/contents: revision 1.6
	distrib/notes/news68k/contents: revision 1.10
	distrib/notes/cats/prep: revision 1.14
	distrib/notes/hp300/contents: revision 1.21
	distrib/notes/common/upgrade: revision 1.31
	distrib/notes/next68k/contents: revision 1.11
	distrib/notes/amiga/contents: revision 1.24
	distrib/notes/common/contents: revision 1.180
	distrib/notes/evbarm/contents: revision 1.6
	distrib/notes/sparc64/upgrade: revision 1.7
	distrib/notes/hppa/contents: revision 1.6
	distrib/notes/acorn32/contents: revision 1.6
	distrib/notes/ofppc/contents: revision 1.7
	distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.21
	distrib/notes/atari/contents: revision 1.24
	distrib/notes/bebox/contents: revision 1.6
	distrib/notes/prep/contents: revision 1.6
	distrib/notes/hpcsh/contents: revision 1.7
	distrib/notes/ews4800mips/contents: revision 1.6
Modernize release notes:
 - use https where possible
 - adapt to cdn/nycdn and our current auto-build conventions
 - automate where possible
Many thanks to uwe for lots of *roff help.

Modernize release notes:
 - use https where possible
 - adapt to cdn/nycdn and our current auto-build conventions
 - automate where possible
Many thanks to uwe for lots of *roff help.

Pull up the following revisions:

	distrib/notes/Makefile.inc			1.44
	distrib/notes/acorn32/contents			1.5
	distrib/notes/alpha/contents			1.19
	distrib/notes/amd64/contents			1.8
	distrib/notes/amiga/contents			1.23
	distrib/notes/amiga/install			1.37
	distrib/notes/arc/contents			1.5
	distrib/notes/atari/contents			1.23
	distrib/notes/atari/xfer			1.18
	distrib/notes/bebox/contents			1.5
	distrib/notes/cats/contents			1.5
	distrib/notes/common/contents			1.179
	distrib/notes/common/legal.common		1.99
	distrib/notes/common/main			1.552
	distrib/notes/common/main			1.553
	distrib/notes/common/netboot			1.37
	distrib/notes/common/postinstall		1.84
	distrib/notes/common/sysinst			1.108
	distrib/notes/common/xfer			1.76
	distrib/notes/emips/contents			1.5
	distrib/notes/emips/install			1.3
	distrib/notes/evbarm/contents			1.5
	distrib/notes/evbarm/install			1.10
	distrib/notes/evbppc/contents			1.6
	distrib/notes/ews4800mips/contents		1.5
	distrib/notes/hp300/contents			1.20
	distrib/notes/hp300/upgrade			1.20
	distrib/notes/hpcarm/contents			1.6
	distrib/notes/hpcmips/contents			1.13
	distrib/notes/hpcsh/contents			1.6
	distrib/notes/hppa/contents			1.5
	distrib/notes/i386/contents			1.32
	distrib/notes/landisk/contents			1.6
	distrib/notes/mac68k/contents			1.23
	distrib/notes/mac68k/install			1.31
	distrib/notes/mac68k/prep			1.18
	distrib/notes/mac68k/xfer			1.21
	distrib/notes/macppc/contents			1.17
	distrib/notes/macppc/install			1.42
	distrib/notes/mmeye/contents			1.6
	distrib/notes/mvme68k/contents			1.16
	distrib/notes/mvme68k/xfer			1.20
	distrib/notes/news68k/contents			1.9
	distrib/notes/newsmips/contents			1.5
	distrib/notes/next68k/contents			1.10
	distrib/notes/ofppc/contents			1.6
	distrib/notes/pmax/contents			1.20
	distrib/notes/pmax/install			1.43
	distrib/notes/prep/contents			1.5
	distrib/notes/rs6000/contents			1.5
	distrib/notes/sandpoint/contents		1.5
	distrib/notes/sgimips/contents			1.5
	distrib/notes/sgimips/install			1.11
	distrib/notes/shark/contents			1.5
	distrib/notes/shark/install			1.6
	distrib/notes/sparc/contents			1.24
	distrib/notes/sparc/install			1.59
	distrib/notes/sparc64/contents			1.8
	distrib/notes/sun2/contents			1.5
	distrib/notes/sun3/contents			1.19
	distrib/notes/sun3/upgrade			1.15
	distrib/notes/vax/contents			1.14
	distrib/notes/vax/xfer				1.15
	distrib/notes/x68k/contents			1.20

Add missing .bullet) and replace some versions (more todo later)
Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.

Pass the set suffix (either .tgz or .tar.xz) from the makefile.
Document the rescue set.

Pull up following revision(s) (requested by snj in ticket #799):
	distrib/notes/Makefile.inc: revision 1.43
	distrib/notes/acorn26/contents: revision 1.2
	distrib/notes/acorn26/legal: delete
	distrib/notes/acorn32/contents: revision 1.2
	distrib/notes/acorn32/hardware: revision 1.3
	distrib/notes/acorn32/legal: delete
	distrib/notes/acorn32/prep: revision 1.15
	distrib/notes/acorn32/prep.RISCOS: revision 1.23
	distrib/notes/alpha/contents: revision 1.16
	distrib/notes/alpha/hardware: revision 1.18
	distrib/notes/alpha/legal: delete
	distrib/notes/amd64/contents: revisions 1.4, 1.5
	distrib/notes/amd64/legal: delete
	distrib/notes/amiga/contents: revision 1.20
	distrib/notes/amiga/legal: delete
	distrib/notes/arc/contents: revision 1.2
	distrib/notes/arc/legal: delete
	distrib/notes/atari/contents: revision 1.20
	distrib/notes/atari/legal: delete
	distrib/notes/bebox/contents: revision 1.2
	distrib/notes/bebox/hardware: revision 1.2
	distrib/notes/bebox/legal: delete
	distrib/notes/cats/contents: revision 1.2
	distrib/notes/cats/legal: delete
	distrib/notes/common/legal.common: revisions 1.93-1.96
	distrib/notes/common/list-setsizes.sh: delete
	distrib/notes/common/macros: revisions 1.41, 1.42
	distrib/notes/common/main: revisions 1.519-1.521
	distrib/notes/common/netboot: revision 1.36
	distrib/notes/common/postinstall: revision 1.80, 1.81
	distrib/notes/common/sysinst: revisions 1.105, 1.106
	distrib/notes/common/upgrade: revisions 1.29, 1.30
	distrib/notes/common/xfer: revision 1.74
	distrib/notes/emips/contents: revision 1.2
	distrib/notes/emips/hardware: revision 1.2
	distrib/notes/emips/install: revision 1.2
	distrib/notes/emips/legal: delete
	distrib/notes/evbarm/contents: revision 1.2
	distrib/notes/evbarm/legal: delete
	distrib/notes/evbppc/contents: revision 1.3
	distrib/notes/evbppc/legal: delete
	distrib/notes/ews4800mips/contents: revision 1.2
	distrib/notes/ews4800mips/legal: delete
	distrib/notes/hp300/contents: revision 1.17
	distrib/notes/hp300/legal: delete
	distrib/notes/hpcarm/contents: revision 1.3
	distrib/notes/hpcarm/legal: delete
	distrib/notes/hpcmips/contents: revision 1.10
	distrib/notes/hpcmips/legal: delete
	distrib/notes/hpcsh/contents: revision 1.3
	distrib/notes/hpcsh/legal: delete
	distrib/notes/hppa/contents: revision 1.2
	distrib/notes/hppa/legal: delete
	distrib/notes/i386/contents: revision 1.29
	distrib/notes/i386/legal: delete
	distrib/notes/landisk/contents: revision 1.3
	distrib/notes/landisk/legal: delete
	distrib/notes/mac68k/contents: revision 1.20
	distrib/notes/mac68k/hardware: revision 1.25
	distrib/notes/mac68k/legal: delete
	distrib/notes/mac68k/prep: revision 1.17
	distrib/notes/macppc/contents: revision 1.11
	distrib/notes/macppc/hardware: revision 1.48
	distrib/notes/macppc/legal: delete
	distrib/notes/macppc/prep.OPENFIRMWARE: revision 1.18
	distrib/notes/mmeye/contents: revision 1.3
	distrib/notes/mmeye/legal: delete
	distrib/notes/mvme68k/contents: revision 1.13
	distrib/notes/mvme68k/legal: delete
	distrib/notes/mvme68k/xfer: revision 1.18
	distrib/notes/news68k/contents: revision 1.6
	distrib/notes/news68k/legal: delete
	distrib/notes/newsmips/contents: revision 1.2
	distrib/notes/newsmips/legal: delete
	distrib/notes/next68k/contents: revision 1.7
	distrib/notes/next68k/legal: delete
	distrib/notes/ofppc/contents: revision 1.3
	distrib/notes/ofppc/legal: delete
	distrib/notes/pmax/contents: revision 1.17
	distrib/notes/pmax/hardware: revision 1.18
	distrib/notes/pmax/legal: delete
	distrib/notes/prep/contents: revision 1.2
	distrib/notes/prep/hardware: revision 1.5
	distrib/notes/prep/legal: delete
	distrib/notes/prep/upgrade: revision 1.2
	distrib/notes/rs6000/contents: revision 1.2
	distrib/notes/rs6000/legal: delete
	distrib/notes/sandpoint/contents: revision 1.2
	distrib/notes/sandpoint/legal: delete
	distrib/notes/sgimips/contents: revision 1.2
	distrib/notes/sgimips/legal: delete
	distrib/notes/shark/contents: revision 1.2
	distrib/notes/shark/legal: delete
	distrib/notes/sparc/contents: revision 1.21
	distrib/notes/sparc/hardware: revision 1.37
	distrib/notes/sparc/legal: delete
	distrib/notes/sparc/prep: revision 1.27
	distrib/notes/sparc64/Makefile: revision 1.4
	distrib/notes/sparc64/contents: revision 1.5
	distrib/notes/sparc64/hardware: revision 1.28
	distrib/notes/sparc64/legal: delete
	distrib/notes/sun2/contents: revision 1.2
	distrib/notes/sun2/legal: delete
	distrib/notes/sun3/contents: revision 1.16
	distrib/notes/sun3/legal: delete
	distrib/notes/vax/contents: revision 1.11
	distrib/notes/vax/hardware: revision 1.11
	distrib/notes/vax/legal: delete
	distrib/notes/x68k/contents: revision 1.17
	distrib/notes/x68k/hardware: revision 1.18
	distrib/notes/x68k/legal: delete
	distrib/notes/xen/legal: delete
Remove reference to a 14 year old IP address for ftp.NetBSD.org.
This is not a joke.
--
mention etcupdate and reorder a bit
--
first pass de-suckification for 2015. modernize content a bit, fix dirty
rotten lies, improve wording, sync legalese with reality, yada yada yada.
--
This product includes software developed by Yasushi Yamasaki.
--
- update upgrade issues:
  + ARM ABI change
  + new users
  + new groups
- add modules set where missing
- formatting improvements
- note that rtsol{,d} will be gone in the future
- fix raw partition info
- update sparc64 hardware support
- remove note about sparc SMP support being broken
- update some size requirements (still lots of ancient bogus RAM
  minimums lingering -- HI PORTMASTERS!)
- various other minor content modernization
- whitespace fixes
--
finish removing the set size stuff, which was thrown out four years ago.
--
merge port-specific legal sections into the common file.  most of these
entries were already in the common file, and it's a pain to maintain
them separately.
--
don't look for now-gone sparc/legal
--
restore rcsid accidentally deleted in previous
--
bah. this time without a typo.

merge port-specific legal sections into the common file.  most of these
entries were already in the common file, and it's a pain to maintain
them separately.

Rebase to HEAD as of a few days ago.

sync with head.

for a reference, the tree before this commit was tagged
as yamt-pagecache-tag8.

this commit was splitted into small chunks to avoid
a limitation of cvs.  ("Protocol error: too many arguments")

For MKREPRO, remove the "%%CreationDate:" comment line from
PostScript output files.

Use ${TOOL_SED} instead if plain sed in Makefiles.

Sync with HEAD.

sync with HEAD

Catch up to netbsd-4.0 release.

Pull up following revisions (requested by jnemeth in ticket #1017):
	distrib/notes/common/contents			patch
	distrib/notes/common/list-setsizes.sh		patch
	distrib/notes/pmppc/hardware			patch
	distrib/notes/Makefile.inc			1.39, 1.40
	distrib/notes/acorn32/prep.RISCOS		1.18
	distrib/notes/alpha/install			1.32
	distrib/notes/common/main			1.367, 1.368, 1.370 - 1.382
	distrib/notes/common/netboot			1.31
	distrib/notes/common/postinstall		1.64, 1.65
	distrib/notes/common/sysinst			1.82, 1.83
	distrib/notes/common/xfer			1.58 - 1.60
	distrib/notes/evbppc/hardware			1.3
	distrib/notes/ews4800mips/hardware		1.2
	distrib/notes/hp300/hardware			1.19
	distrib/notes/hp300/prep			1.21
	distrib/notes/hp700/hardware			1.3
	distrib/notes/i386/hardware			1.121
	distrib/notes/i386/whatis			1.22
	distrib/notes/mac68k/hardware			1.23
	distrib/notes/mac68k/install			1.28
	distrib/notes/macppc/hardware			1.44
	distrib/notes/macppc/install			1.36
	distrib/notes/macppc/prep			1.42
	distrib/notes/macppc/prep.OPENFIRMWARE 		1.9
	distrib/notes/news68k/hardware			1.5
	distrib/notes/newsmips/hardware			1.4
	distrib/notes/next68k/hardware			1.8
	distrib/notes/pmax/install			1.39
	distrib/notes/sandpoint/hardware		1.6
	distrib/notes/sparc/hardware			1.33
	distrib/notes/sparc64/hardware			1.23
	distrib/notes/sparc64/install			1.28
	distrib/notes/vax/xfer				1.13
Sync release notes with reality

add common/sysinst to SRCS

file Makefile.inc was added on branch mjf-devfs on 2007-12-11 20:57:20 +0000

add common/sysinst to SRCS

add common/netboot to SRCS

Sync the release notes with HEAD.

Sync w/ NetBSD-4-RC_1

sync the release notes with -current. The -current ones do not contain
anything specific to post-4.0.

Make the port-specific changelog ($MACHINE/whatis) optional by using .pso
to call a shell script which outputs nothing if the file is not present.

Remove the "whatis" file for ports where it does not contain anything
useful and hasn't been updated for years. OK tsutsui@, hubertf@.

file Makefile.inc was added on branch matt-mips64 on 2007-07-26 15:26:36 +0000

Make the port-specific changelog ($MACHINE/whatis) optional by using .pso
to call a shell script which outputs nothing if the file is not present.

Remove the "whatis" file for ports where it does not contain anything
useful and hasn't been updated for years. OK tsutsui@, hubertf@.

Remove the list of donations, which was not updated since 2004. We have
up-to-date lists at http://www.NetBSD.org/donations, so add this link
to the release notes. OK by Christos.

Install notes into ${RELEASEDIR}/${RELEASEMACHINEDIR}, not
${RELEASEDIR}/${MACHINE}.  The former is the blessed way as it's
defined as a "subdirectory used below ${RELEASEDIR} when building a
release" and defaults to MACHINE in bsd.own.mk.

Make sure that ${RELEASEDIR}/${RELEASEMACHINEDIR} exists before
installing notes in to it.  It only ever worked because ~all ports
build at least one kernel as part of make release, and so the release
directory was created when kernel sets are installed.

XXX: Why don't we create ${RELEASEDIR}/${RELEASEMACHINEDIR} from the
top-level makefile before running make release?

Add a list of files which determine the kernel version as
DISTRIBVERDEP in Makefile.distrib, and make both sysinst and
distribution notes use that information so that they rebuild
if the kernel version changes.

Distribution notes didn't have this before, sysinst had a private
(now outdated, since sys/sys/param.h now determines version) copy
of this.

netbsd.org->NetBSD.org

Rename a large chunk of the make(1) variables which refer to a
program/tool from "FOO" to "TOOL_FOO".  The new variables are:
	TOOL_ASN1_COMPILE  TOOL_CAP_MKDB  TOOL_CAT  TOOL_CKSUM  TOOL_COMPILE_ET
	TOOL_CONFIG  TOOL_CRUNCHGEN  TOOL_CTAGS  TOOL_DB  TOOL_EQN  TOOL_FGEN
	TOOL_GENCAT  TOOL_GROFF  TOOL_HEXDUMP  TOOL_INDXBIB  TOOL_INSTALLBOOT
	TOOL_INSTALL_INFO  TOOL_M4  TOOL_MAKEFS  TOOL_MAKEINFO  TOOL_MAKEWHATIS
	TOOL_MDSETIMAGE  TOOL_MENUC  TOOL_MKCSMAPPER  TOOL_MKESDB
	TOOL_MKLOCALE  TOOL_MKMAGIC  TOOL_MKTEMP  TOOL_MSGC  TOOL_MTREE
	TOOL_PAX  TOOL_PIC  TOOL_PREPMKBOOTIMAGE  TOOL_PWD_MKDB  TOOL_REFER
	TOOL_ROFF_ASCII  TOOL_ROFF_DVI  TOOL_ROFF_HTML  TOOL_ROFF_PS
	TOOL_ROFF_RAW  TOOL_RPCGEN  TOOL_SOELIM  TOOL_SUNLABEL  TOOL_TBL
	TOOL_UUDECODE  TOOL_VGRIND  TOOL_ZIC

For each, provide default in <bsd.sys.mk> of the form:
	TOOL_FOO?=	foo
and for the ${USETOOLS}=="yes" case in <bsd.own.mk>, provide override:
	TOOL_FOO=	${TOOLDIR}/bin/${_TOOL_PREFIX}foo

Document all of these in bsd.README.

This cleans up a chunk of potential (and actual) namespace collision
within our build infrastructure, as well as improves consistency in
the share/mk documentation and provision of appropriate defaults for
each of these variables.

Install release files under "${RELEASEDIR}/${MACHINE}/..." instead of
"${RELEASEDIR}/...".

${RELEASEDIR} is never cleaned , and ${RELEASEDIR}/${MACHINE} is only
cleaned if UPDATE is not defined.

Pull up revision 1.31 (requested by lukem):
- define COMMON as "${.CURDIR}/../common", and use appropriately
- remove .PATH: ${.CURDIR}/../common
- update the various MERGED_SRCS lines to reflect reality

- define COMMON as "${.CURDIR}/../common", and use appropriately
- remove .PATH: ${.CURDIR}/../common
- update the various MERGED_SRCS lines to reflect reality

Pull up revision 1.30 (requested by lukem):
add back comment lost in previous revision

add back comment lost in previous revision

Pull up revision 1.29 (requested by lukem):
- Explicitly reference "install" as "${.CURDIR}/install" as our <bsd.own.mk>
  does a ".PHONY" on "install", and this prevents .PATH lookups working for
  that target, so "make" unnecessarily considered the files out of date and
  rebuilt them every time.  (make(1) needs a .NOTPHONY)
- Separate out the TOC dependencies so that a given ${TARG}.type only
  depends upon the appropriate ${TARGET}.type.toc.  Prevents unnecessary
  rebuilding of all the TOCs when you're only generating one target type.
- Remove *.toc.tmp in cleannotes.

- Explicitly reference "install" as "${.CURDIR}/install" as our <bsd.own.mk>
  does a ".PHONY" on "install", and this prevents .PATH lookups working for
  that target, so "make" unnecessarily considered the files out of date and
  rebuilt them every time.  (make(1) needs a .NOTPHONY)
- Separate out the TOC dependencies so that a given ${TARG}.type only
  depends upon the appropriate ${TARGET}.type.toc.  Prevents unnecessary
  rebuilding of all the TOCs when you're only generating one target type.
- Remove *.toc.tmp in cleannotes.

Pull up revision 1.28 (requested by wiz in ticket #289):
Add a comment why the more.toc needs to be generated twice.
XXX: Why do the other TOCs get generated twice? We don't need correct
page numbers there...

Add a comment why the more.toc needs to be generated twice.
XXX: Why do the other TOCs get generated twice? We don't need correct
page numbers there...

Pull up revision 1.27 (requested by lukem in ticket #280):
remove now-unused targets

remove now-unused targets

yet another distrib overhaul:
- move guts of distrib/Makefile.inc to distrib/common/Makefile.distrib
  (fixes problem caused by implicit include of ../Makefile.inc in certain
  submake conditions triggered by makefiles not yet in tree)
- removed mkdir of ${RELEASEDIR}/*;  rely upon "snap_pre" target of
  etc/Makefile to create all the release directories
- renamed RELINSTALL to RELEASE_INSTALL
- renamed FLOPPYINSTDIR to FLOPPY_RELEASEDIR
- renamed MDSETDIR to MDSET_RELEASEDIR
- removed ITARGET
- move release target from top level to appropriate subdirectory
- ensure release target has correct depends
- replace miniroot's IMAGE_MD_POST with common/Makefile.image IMAGEPOSTBUILD
- Makefile.image: add realall: ${IMAGE}

replace _SRC_TOP_ with NETBSDSRCDIR, since the latter is the "public" version

simplify by using stuff from ../Makefile.inc

Pull up revisions 1.15-1.21 (requested by he):
  Add Table of Contents to the install notes.

don't set the owner or group when installing into $RELEASEDIR

Clean this up for a proper cross-build setup.

1. Replace all "groff"'s with $GROFF so the right binary is picked up depending
on new or old toolchain setups and USETOOLS
2. Remove the DESTDIR check where it adds -M. This is pointless as some of the
file in share/tmac have hard coded references to /usr/share/tmac so using the
new ones in $DESTDIR will just point you back into /usr/share anyways...
(the new toolchain has no issue here as it's tmac files all point into
$TOOLDIR. Any old setups should just depend on the local setup instead of
some mix of DESTDIR and old files the -M would have produced).

s/MAKETOCS/MKTOCS/

Based on feedback (various), remove the .toc files from CVS,
and instead generate them each and every time (twice!).
Based on a suggestion from Alan Barrett, allow setting MAKETOC=no
to permit rebuilding the install notes without regenerating the
.toc files, to allow more speedy debugging of markup changes.

Add a table of contents (TOC) to the release notes.
This makes it _much_ more user-friendly, as it allows users
  to skip to the parts they want easily.
At present, the TOCs are generated files, and can be regenerated
  with "make tocs" (probably has to be run twice to account for
  the size of the table itself).
TOCs are named INSTALL.{PostScript,ASCII,HTML,more}.toc instead of
  INSTALL.{ps,txt,html,more}.toc because that's what \*[format]
  expands to.

Nuke gratuitous usage of .for.

Use bsd.man.mk (maybe should be something else) instead of bsd.prog.mk, and
do the cleaning differently.

Use bsd.own.mk, not bsd.obj.mk.

When making the release notes, use the macros in ${DESTDIR}

Sync to HEAD as of 20001101 03:43 GMT [lukem]:
Complete rework of install notes for 1.5 from several authors.

- depend upon ../common/macros as well
- call groff with -dM instead of -dMACHINE, and change the macro use
  accordingly. remove -dV_S since nothing used it.

add dinky .pdf target which runs ps2pdf on the .ps source

Apply patch (requested by he):
  Make sure install notes are built before installing them under
  ``make release''.

Pullup rev. 1.12 (approved by jhawk and thorpej):
date: 2000/08/01 01:57:57;  author: enami;  state: Exp;  lines: +3 -3
When output device is ascii, load tmac.tty-char explicity as nroff does,
so that some developer's names are translated saner way.

When output device is ascii, load tmac.tty-char explicity as nroff does,
so that some developer's names are translated saner way.

Apply patch (requested by toddpw, modified by he):
  Format HTML with latin1 characters.  Add a "release" target to
  install the formatted release notes.

Include bsd.obj.mk so we can have RELEASEDIR in /etc/mk.conf.

Apply patch (requested by soren):
  Remove the list of mirrors, point instead to the on-line list.

Pull up to last week's -current.

- Replace inline mirrors list with a link to
	http://www.netbsd.org/Sites/net.html
  It's probably safe to assume that a user wanting access to a mirror
  site can access this URL...
- Highlight that with the latest BIND code you need to now use
	options { version "newfoo"; }
  to change the infoleak string.  (1.3.3 didn't have the infoleak,
  but it crept back into 1.4)

Fix pasto.

Use 7-bit ASCII for INSTALL.txt.

Use -Tlatin1 for output.

Add release targets, intended for use by the src/etc/Makefile `make release'.

pullup 1.4->1.5 (ross)

Add target used when importing INSTALL.more to sysinst images.

workaround to make "make depend" succeed

remove NOPROG (nothing uses it). however, set MKOBJ=no if appropriate

Also clean up ${TARG}.more.

Give the common install notes components their own subdirectory.
Also, alpha and i386 now use a single merged common/sysinst,
and arm32 and sparc have a single merged common/xfer.