Added etcupdate (etcupdate-20020321 in pkgsrc)

etcupdate: fix error message for unimplemented option

noted by rudolf on source-changes-d

etcupdate: add -? for help. improve option errors

Support -? to show help.
Implemented using getopts "leading colon optstring" feature.
Improve error messages for unknown options and missing arguments.
Change usage-related errors from stdout to stderr.
Keep all other errors to stdout for now.

etcupdate: -h to stdout. improve help

Send -h help to stdout not stderr, and exit 0 not 1.
Show options alphabetically.
Use UPPER_CASE instead of lowercase as the convention for argument names.

etcupdate: style change: function { on new line

comparision -> comparison

From Jim Bernard in PR install/50615: install_checksum expects a path
relative to ${DESTDIR}, and most callers did pass it that way - fix the
one place where it eroneously was called with a ${DESTDIR} path.

Synchronise the "-s" part of the usage message with postinstall.
A colon-separated list of tgz files is no longer accepted; you
must use multiple -s options instead.

branches: 1.58.2;
Synchronise several shell_quote implementations, and:
* Elide some unnecessary pairs of quotation marks, to improve readability.
For example, shell_quote "''" is now \'\' instead of ''\'''\'''.
* Don't add quotes around words that contain only safe characters,
to improve readability.
* LC_COLLATE=C to prevent [a-zA-Z] from matching non-ASCII characters.
* Use ${SED} if defined.

Use extra="${2-/,}" to use $2 if defined, else default to "/,".

Add "-d destdir" option to etcupdate.
This has been only lightly tested.

Keep track of whether anything was changed (or needs to be changed),
and print a message at the end if nothing needs to be done.

When populating ${TEMPROOT} from ${SRCDIR} by copying, use the mtree set
files from ${BINARYDIR}/etc/mtree/set.{etc,xetc} as a list of files to
copy (and copy using pax instead of cp).

This prevents unnecessary copying of extraneous files, such as in the
case that BINARYDIR refers to a directory where everything has been
unpacked, instead of a directory where only the etc and xetc sets have
been unpacked.

Also convert a relative TEMOROOT to an absolute path.

There is a file named "._etcupdate_${TEMPROOT}${1}" was
never created, so don't try to delete it. Delete "$B" instead.

When processing the -s option, the variable used is ${arg},
not ${ARG}. Also adjust an error message to say
"Nonexistent or invalid file or directory", not just
"Nonexistent file or directory".

branches: 1.51.2; 1.51.8;
Remove the ability to specify multiple colon-separated file names with
a single "-s" option. Multiple "-s" options must now be used instead.
We have been printing a warning about this since 2008-09-14.

branches: 1.50.6;
Run services_mkdb if only the old hash exists

Output (when verbose) when storing checksum files.
This may be a little noisy.
As discussed on current-users in March 2008.

Move quotation marks to the correct place in eval statements
that were broken by the previous change.

In both postinstall and etcupdate, in modes where the -s argument
refers to tgz files or to a directory in which tgz files have already
been extracted, make it an error for the files that should have come
from etc.tgz to be missing. This is intended to prevent users from
accidentally deleting necessary files when they run "postinstall -s
xetc.tgz fix".

Use the absence of .../etc/mtree/set.etc in the extracted directory
as a test for the error case.

Remove options deprecated in NetBSD-4.0:
* Remove "-b binarydir" option (use "-s binarydir" instead).
* Remove "-s srcdir/etc" option (use "-s srcdir" instead).

Also document that "-s tgz1:tgz2" is merely deprecated, not removed
(use "-s tgz1 -s tgz2" instead).

Allow "-s tgzfile1:tgzfile2" for backward compatibility. Print a
warning to encourage users to switch to using "-s tgzfile1 -s tgzfile2".

fix missing '$' in previous.

* Allow colons to appear in the names of tgz files, to address PR 39459.
* Allow spaces to appear in the name of the TEMPROOT and SRCDIR directories.
* Remove the ability to specify a colon-separated list of tgz files
using a single "-s" option, because ":" is now a valid character within the
name of a single file. Callers should use multiple "-s" options
instead.

Remove "shift" commands that should have been removed when the
option parsing loop was converted to use getopts. (Hi christos)

remove debugging code accidentally committed in revision 1.39.

Redo previous in a way that more closely matches the style used
in postinstall(8).

The shell builtin getopts returns options without the preceding "-",
so adjust a case statement to compensate.

- `` -> $() and quoting
- getopt -> getopts
- some errors to stderr
- more quoting

branches: 1.37.2;
Convert to 2 clause license

branches: 1.36.4;
Pass NETBSDSRCDIR in the environment to make. This is insurance against
Makefiles that should have an early .include <bsd.own.mk> but that fail
to do so. It's also slightly more efficient.

branches: 1.35.4;
/etc/services needs special attention.

* Make etcupdate's -s option accept a colon-separated list of tgz
files. (It was already possible to use several -s options.)
* Change man page to refer to "-s tgzdir" instead of "-s tempdir",
to reduce confusion between tempdir and temproot.
* Always use a temproot directory, even if passed "-s tgzdir".
* Always invoke "postinstall check", even when not using a source dir.
* Add a BUGS section saying that using -s srcdir is not recommended.

Reviewed by lukem and martti.

Revert previous. MAKEDEV.subr no longer exists.

If MAKEDEV.subr is updated, remember to run MAKEDEV later.

Run pwd_mkdb before running mtree.
Reported by Hauke Fath in PR 35570.

Clean ${SRCDIR}/etc when done. Patch provided by rudolf.
http://mail-index.netbsd.org/tech-toolchain/2007/01/11/0001.html

branches: 1.29.2;
Use "stty size" to acquire screen width reliably.
The fields of the first line of "stty -a" is not fixed.
Fix PR bin/32343.

Fix default handling. etcupdate with no "-s" flag
should act like "etcupdate -s /usr/src".
Approved by christos.

Typo in comment.

Pass BUILD=1 in make environment.
Fixes PR 30385 from Rui Paulo.
Approved by chrisros.

Wording changes to clarify some the options presented after
a file is merged.

Fix errors in previous. I accidentally committed the wrong code.

Give etcupdate the ability to use etc.tgz and xetc.tgz.

* Expand the "-s" flag to -s {srcdir|tgzfile|tempdir}.
* Deprecate the "-b" flag. It is replaced by "-s tempdir".
* Change "-s srcdir" to refer to the top of the source tree (e.g.
/usr/src) instead of the etc subdirectory.

In etcupdate's interactive phase, enhance the "s" command to be able
to invoke alternative diff commands.

Also some style changes.

Approved by christos

Tweaks for the move of postinstall from /etc to /usr/sbin

branches: 1.21.4; 1.21.6;
s/netbsd.org/NetBSD.org/i

Set ${MACHINE} and ${MACHINE_ARCH}.

add MTREE=mtree back, for systems with some .mk version skew...

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.

Use awk instead of fgrep and sed, and default to 80 if we get
something that is arithmetically equal to 0.

Automatically figure out how wide the terminal is with an ugly
`stty | fgrep | sed` expression.
Really, sdiff should figure this out by default but it does not.

set USETOOLS=never when doing make distribution, so that users don't have
to set it themselves or set TOOLDIR to use etcupdate.

Closes PR install/19752 from Oliver Tonnhofer

Remove a NO_SENDMAIL=1 in the construction of the reference etc/ -- it
was needlessly preventing the update of sendmail configs like submit.cf
Should close PR misc/20968 from Martin Weber

Add a -l option telling etcupdate to skip any file who's RCS id has
not been changed.
(-l means "skip local modifications".)
Code and documentation from Christopher Richards in PR bin/20200

Checksum files produced by "etcupdate -a" should not be stored in /etc
as / might be a read-only filesystem (PR#20201).

allow /etc/etcupdate.conf (and ~/.etcupdate.conf) to set IGNOREFILES to a list
of files that etcupdate will ignore; never considering them for updating.

Use md5 instead of sum (bin/20196).

Add a new -a flag (automatically update files which have not been
locally modified). Patch provided by Sverre Froyen in a private mail,
slightly modified by me.

Fix a typo in the yesno() function: add a missing question mark.
Approved by martti.

Don't execute /etc/postinstall if -b was used.

fix typo, from Julio Merino in bin/18440.

fix usage() message for "-s" argument. ie, do *not* suggest "/usr/src"
as this causes "make distribution" to be run in /usr/src.

Fix typo reported in bin/17516.

branches: 1.3.2;
Include user's PATH (pkg/16828 by HAMAJIMA Katsuomi)

Run /etc/postinstall if it's found

Added etcupdate (etcupdate-20020321 in pkgsrc)

etcupdate(8): consistent -h and -? text

Match verb forms.

etcupdate: add -? for help. improve option errors

Support -? to show help.
Implemented using getopts "leading colon optstring" feature.
Improve error messages for unknown options and missing arguments.
Change usage-related errors from stdout to stderr.
Keep all other errors to stdout for now.

etcupdate: -h to stdout. improve help

Send -h help to stdout not stderr, and exit 0 not 1.
Show options alphabetically.
Use UPPER_CASE instead of lowercase as the convention for argument names.

A few hints that sets may come in .tar.xz format (instead of .tgz)

branches: 1.22.22; 1.22.24;
Update date for previous, and fix some small errors.

Add "-d destdir" option to etcupdate.
This has been only lightly tested.

branches: 1.20.2; 1.20.8;
Remove the ability to specify multiple colon-separated file names with
a single "-s" option. Multiple "-s" options must now be used instead.
We have been printing a warning about this since 2008-09-14.

branches: 1.19.6;
s/the the/the/

In both postinstall and etcupdate, in modes where the -s argument
refers to tgz files or to a directory in which tgz files have already
been extracted, make it an error for the files that should have come
from etc.tgz to be missing. This is intended to prevent users from
accidentally deleting necessary files when they run "postinstall -s
xetc.tgz fix".

Use the absence of .../etc/mtree/set.etc in the extracted directory
as a test for the error case.

Remove options deprecated in NetBSD-4.0:
* Remove "-b binarydir" option (use "-s binarydir" instead).
* Remove "-s srcdir/etc" option (use "-s srcdir" instead).

Also document that "-s tgz1:tgz2" is merely deprecated, not removed
(use "-s tgz1 -s tgz2" instead).

Document the change in meaning of "-s foo:bar". It now means a single
file or directory nmed "foo:bar". If you want the old meaning,
use "-s foo -s bar" instead.

branches: 1.15.2;
Convert TNF licenses to new 2 clause variant

branches: 1.14.2;
Document some about being able to view differences and
toggling the different diff formats/tools.

branches: 1.13.4; 1.13.8;
* Make etcupdate's -s option accept a colon-separated list of tgz
files. (It was already possible to use several -s options.)
* Change man page to refer to "-s tgzdir" instead of "-s tempdir",
to reduce confusion between tempdir and temproot.
* Always use a temproot directory, even if passed "-s tgzdir".
* Always invoke "postinstall check", even when not using a source dir.
* Add a BUGS section saying that using -s srcdir is not recommended.

Reviewed by lukem and martti.

branches: 1.12.2;
Xref etcupdate from postinstall, and vice versa.

branches: 1.11.2;
Give etcupdate the ability to use etc.tgz and xetc.tgz.

* Expand the "-s" flag to -s {srcdir|tgzfile|tempdir}.
* Deprecate the "-b" flag. It is replaced by "-s tempdir".
* Change "-s srcdir" to refer to the top of the source tree (e.g.
/usr/src) instead of the etc subdirectory.

In etcupdate's interactive phase, enhance the "s" command to be able
to invoke alternative diff commands.

Also some style changes.

Approved by christos

branches: 1.10.4; 1.10.6; 1.10.10;
Some Bl improvements; drop trailing whitespace; don't comma-separate
"a, and b"; mention arguments in option listing; list options in SYNOPSIS
in default order (those without arguments first).

Massive cleanup of the document, although there is a lot more work to
do still.

Add a -l option telling etcupdate to skip any file who's RCS id has
not been changed.
(-l means "skip local modifications".)
Code and documentation from Christopher Richards in PR bin/20200

New sentence, new line; bump date for recent changes.

Checksum files produced by "etcupdate -a" should not be stored in /etc
as / might be a read-only filesystem (PR#20201).

allow /etc/etcupdate.conf (and ~/.etcupdate.conf) to set IGNOREFILES to a list
of files that etcupdate will ignore; never considering them for updating.

The correct capitalisation of 'NetBSD.org' is (you
guessed it) 'NetBSD.org'.

some mdoc fixes.

grammar fix.

Add a new -a flag (automatically update files which have not been
locally modified). Patch provided by Sverre Froyen in a private mail,
slightly modified by me.

branches: 1.1.2;
Added etcupdate (etcupdate-20020321 in pkgsrc)