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.SVN
	README.xdvik
	README_maintainer
	TODO

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	2019-07-22 22:33:51.555821629 -0700
+++ Makefile.am	2019-07-27 22:31:28.193898193 -0700
@@ -32,8 +32,8 @@
 # Files not to be distributed
 include $(srcdir)/am/dist_hook.am
 
-SUBDIRS = . doc $(MAKE_SUBDIRS) libs utils texk
-DIST_SUBDIRS = auxdir/auxsub doc $(CONF_SUBDIRS) libs utils texk
+SUBDIRS = . $(MAKE_SUBDIRS) libs utils texk
+DIST_SUBDIRS = auxdir/auxsub $(CONF_SUBDIRS) libs utils texk
 
 ## Configure and build subdirs.
 ##
@@ -61,21 +61,6 @@
 #
 	@echo "top-level make $@ done."
 
-# create file buildinfo.log in working directory, to record relevant
-# information about the build environment.
-buildinfo:
-	-env MAKE="$(MAKE)" LDFLAGS="$(LDFLAGS)" \
-	    CC="$(CC)" CFLAGS="$(CFLAGS)" \
-	    CXX="$(CXX)" CXXFLAGS="$(CXXFLAGS)" \
-	    OBJCXX="$(OBJCXX)" OBJCXXFLAGS="$(OBJCXXFLAGS)" \
-	$(srcdir)/doc/buildinfo.sh >buildinfo.log
-
-# should be harmless to run it, but just in case:
-build_info_target = buildinfo
-
-# run buildinfo first.
-all-recursive: buildinfo
-
 install-exec-hook:
 	@echo "WARNING: make install does not result in a usable TeX!"
 	@echo "  ! The binaries require the myriad support files."
--- /tmp/configure.ac	2019-07-22 22:33:53.411812474 -0700
+++ configure.ac	2019-07-06 23:54:22.631951989 -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
