Some hints for maintainers

(Note: calling configure with --enable-maintainer-mode should enable
all maintainer options, but this seems broken somehow (e.g. `make
depend' in texk/xdvik/ doesn't work). So I usually remove the `@MAINT@'
comments manually, as described below.)

- After changing a configure.in run 'sh reautoconf' in the top directory

- After adding a check to configure.in, sometimes acconfig.h needs to
  be adapted too (see e.g. USE_XAW_PANNER, HAVE_LIB_XP). After doing that,
  run:

  /usr/bin/autoheader -m ../etc/autoconf
  /usr/bin/autoconf -m ../etc/autoconf

  (requires autoconf-2.13 in the path, which is /usr/bin in my case.)

- to add a new check to configure, e.g. for xdvik, add the macro name to
  texk/xdvik/configure.in (add the macro definition to texk/xdvik/aclocal.m4
  if needed), and run either
  autoconf --macrodir=../etc/autoconf configure.in > configure
  or remove the `@MAINT@' comments from texk/make/config.mk and call
  make configure

- to re-make the dependencies, remove the @MAINT@ prefixes from
  texk/make/rdepend.mk,
  and call
  make depend
  from the texk/xdvik/ directory.

  (NOTE: this needs to be done after the call to `configure' so that
  all temporary headers and Makefiles are in place!)

---

To update libraries and build files from TeX Live:

In the main directory, the following files belong to xdvik:

	.indent.pro
	BUGS
	CHANGES
	INSTALL
	README.CVS
	README.xdvik
	README_maintainer
	TODO
	config/		(empty directory)

All others should be updated from TL (or deleted if no longer present there):

The doc subdirectory of TeX Live is troublesome, because it needs files
present in still other subdirectories, yet the TeX Live infrastructure
requires it to be there.  The remedy is to apply the diffs at the end of
this file.


---

- enable a reasonable level of compiler warnings with:
  ./configure --enable-compiler-warnings

---

Diffs for getting rid of the doc subdirectory in the TeX Live source:

--- /tmp/Makefile.am	2016-03-25 22:25:36.758371888 -0700
+++ Makefile.am	2016-03-25 22:30:49.912161284 -0700
@@ -30,7 +30,7 @@
 # Files not to be distributed
 include $(srcdir)/am/dist_hook.am
 
-SUBDIRS = . doc $(MAKE_SUBDIRS) libs utils texk
+SUBDIRS = . $(MAKE_SUBDIRS) libs utils texk
 DIST_SUBDIRS = auxdir/auxsub doc $(CONF_SUBDIRS) libs utils texk
 
 ## Configure and build subdirs.
--- /tmp/configure.ac	2016-03-25 22:25:36.826372118 -0700
+++ configure.ac	2016-03-25 22:47:29.477864526 -0700
@@ -135,7 +135,7 @@
 
 AC_CONFIG_SUBDIRS([auxdir/auxsub libs utils texk])
 
-AC_CONFIG_FILES([Makefile doc/Makefile])
+AC_CONFIG_FILES([Makefile])
 
 dnl Try to detect GNU make early, '-v' is verbose for BSD make.
 rm -f Makefile
