• config/config.scoreboard
  
  This is the main source file. config.dist and config.data are generated files now.
  
  NOTE TO INN-DEVELOPERS: DO NOT EDIT CONFIG.DIST or CONFIG.DATA
  ALL CHANGES TO CONFIG.DATA SHOULD BE CHANGED IN CONFIG.SCOREBOARD.
  
  config.scoreboard is used to generate:
  
  config.data.in (used by the configure script to generate config.data)
  config.dist
  
  
  
  
  
• configure.in
  
  This is the configure generation script. Run through autoconf-2.12
  
  
  
• config/config.dist.subst
  
  used to generate config.dist from config.data.in
  
  
  
• autoconf-inn.readme
  
  external documentation of the above, describing action items remaining, migration paths, etc.
  
  
  
  

• configure
  
• config/config.data.in
  
• config/config.dist
  
  

configure: configure.in
	/path-to-autoconf-2.12/autoconf -m/path-to-autoconf-2.12

config.data.in: config.scoreboard
	fgrep "  ||" config.scoreboard | sed 's/  ||//g' >config.data.in

config.dist: config.data.in config.dist.subst
	cp config.data.in config.dist
	subst -f config.dist.subst config.dist

• PATH variable must be set, to find awk, sh, Mail, etc.
  
  
• Some reasonable compiler must be in the path.
  
  
• /usr/ucb/cc is rejected as "bogus", even if it is a symlink to elsewhere.
  
  
• If gcc is on your system, then make sure it is in the path.
  
  
• configure requires config/config.data.in also
  
  
  

• NOTE: MAKE A BACKUP COPY OF ANY config.data YOU INTEND TO SAVE.
  It will be replaced when running configure!
  
  
• Run
  

  	
  	configure 
  

  (This will generate config/config.data)
  
  
• Edit config/config.data as appropriate. Items which are marked [autoconf] are either determined automatically
  or can be adjusted with a command line parameter.
  
  

	configure --help | more

  --bindir=DIR            user executables in DIR [EPREFIX/bin]
  --mandir=DIR            man documentation in DIR [PREFIX/man]
  --enable-pgp-verify     use pgp control verification
  --with-tcl              TCL script support
  --with-perl             Perl script support
  --with-config-path=PATH Configurations pathname (default /var/news/etc)
  --with-var-path=PATH    Data files (history, etc) pathname (default /var/news/etc)
  --with-run-path=PATH    Running information pathname (default /var/news/run)
  --with-lock-path=PATH   Directory for file locking (default /var/news/lock)
  --with-spool-dir=PATH   News storage (default /var/news/spool)
  --with-log-dir=PATH     Logging directory (default /var/log/news)
  --with-news-user=UID    News user id (default news)
  --with-news-group=GID   News group id (default news)
  --with-tmp-path=PATH    Temporary files directory

• all items which are confparam are supported in config.cache
  
  
• all items which are AC_SUBST are supported in config.cache.
  configure.in forces a binary choice (either/or) for some items:
  pid_t either int or pid_t
  off_t either long or off_t
  This is actually unacceptable.
  
  
• subst is not needed, and there are only AC_SUBST target files.
  
  
• all items which are WDF=fixed and WOR=yes are in inn.conf
  (until then, config.data has the only way to change them.)
  
  
• documentation is moved elsewhere
  
  

• IMPORTANT: Edit only config.scoreboard.
  
  
• config.scoreboard is the place where all configurable items are documented, so even if something is removed,
  or obsoleted, it might be better to comment it out, rather than deleting lines.
  
  
• Comment lines in config.scoreboard begin with the four character sequence:
  ' #||'
  
  
  

• IMPORTANT: Edit only config.scoreboard.
  
  
• Should not want to do this very often. Only compile-time items should get added to config.data, every other configurable should be done through inn.conf. Want to move more items from [WDF=confparam][WOR=yes] to
  [

• If the default is autoconf, or will be a AC_SUBST macro, then write the autoconf code for it. (See procedure for
  

• All autoconf SUBST value targets should be names of the form:
  

  	ac_cv_subst_xxxxxx
  
  

  Where xxxxx matches the name in the config.data file, converted to all lowercase.
  Example:
  

  	  ||ACT_STYLE		@ac_cv_subst_act_style@
  
  

  All subst value targets should be overridable in config.cache.
  
  
• There are "multi-layered" subst value determination:
  First a "yes" "no" value is determined (perhaps by a standard autoconf test)
  But config.data does not want YES or NO settings.
  
  The yes or no value is converted to the actual required ac_subst value
  through the YN_to_cv_subst() macro. This macro tests to see if the
  value has already been set (which permits cache overrides), and sets one or the other two values
  if not.
  
  

• example:
  

  		if $not_defined = "whatever"
  

  Could fail: if $not_define
  Solution: prefix with x$notdefined, or fail if notdefined?
  
  
  

• IMPORTANT: Edit only config.scoreboard and config.dist.subst
  
  
• Change the default value by changing config.dist.subst
  

• Source file for config.data.in
  fgrep " ||" config.scoreboard | sed 's/ ||//g' >config.data.in
  
  
• Indirectly the source file for config.dist.
  Config.data.in is the source file for the distribution config.dist
  

  		cp config.data.in config.data
  		subst -f config.dist.subst config.data
  
  

  Documentation
  previous location
  How the default is configured
  migration of entries to autoconf and inn.conf
  
  

• Lines beginning with the four characters ' ||' are written to config.data.in
  
  
• Lines beginning with the four characters ' #||' are comments, only appearing in config.scoreboard
  
  
• Beginning with a space allows easy parsing by custom development tools.
  Each entry starts with a non-blank in column 0.
  
  

• Entries appear in the order they need to be written to config.data.in
  
  
• Each entry starts with a line with a non-blank character (a left square bracket='[') in column 0.
  This describes
  the location of the entry in the old config.data (for 1.7),
  how the compiled-in default is selected.
  whether run-time overriding is desired,
  the priority for migration.
  
  

IN1.7=@4][WDF=autoconf][WOR=no][CUR=1.7][P=high]
  ||##  How should non-blocking I/O be done?  Pick IOCTL or FCNTL.
  ||#### =()<NBIO_STYLE		@<NBIO_STYLE>@>()=
  ||NBIO_STYLE		@DO_FIONBIO@

	fgrep -v "#" config/config.auto | fgrep "@"

	fgrep -v "#" config/config.dist >config.dist.subst

cp config.auto.in config.dist
subst -f config.dist.subst config.dist

	fgrep -v "##[autoconf]" <config.dist | sed 's/()=\[autoconf\]/()=/' >out
	diff out config.dist.1.8

IN1.7=@17][WDF=confparam][WOR=no]
  ||##  Do you want Perl support?  Pick DO or DONT
  ||#### =()<PERL_SUPPORT	@<PERL_SUPPORT>@>()=
  ||PERL_SUPPORT		@DO_PERL@

[

IN1.7=@4][WDF=autoconf][WOR=no]
  ||##  What predicate, if any, the <ctype.h> macros need
  ||#### =()<CTYPE			@<CTYPE>@>()=
  ||CTYPE			(isascii((c)) && isXXXXX((c)))
  ||#CTYPE			((c) > 0 && isXXXXX((c)))
  ||#CTYPE			isXXXXX((c))
[IN1.7=@4][WDF=autoconf][WOR=no]
  ||##  Does your AF_UNIX bind use sizeof for the socket size?  Pick DO or DONT.
  ||#### =()<BIND_USE_SIZEOF		@<BIND_USE_SIZEOF>@>()=
  ||BIND_USE_SIZEOF		DO
[IN1.7=@4][WDF=autoconf][WOR=no]
  ||##  What is a file offset?  MUST BE LONG FOR NOW.
  ||#### =()<OFFSET_T			@<OFFSET_T>@>()=
  ||OFFSET_T		long
[IN1.7=@4][WDF=autoconf][WOR=no]
  ||##  Function that returns no value, and a pointer to it.  Pick int or void
  ||#### =()<FUNCTYPE		@<FUNCTYPE>@>()=
  ||FUNCTYPE		void
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  What type of pointer does mmap() manage? Normally ``caddr_t'' or ``void *''
  ||##  or ``char *''
  ||#### =()<MMAP_PTR		@<MMAP_PTR>@>()=
  ||MMAP_PTR		caddr_t
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  What type of pointer does mmap() manage? Normally ``caddr_t'' or ``void *''
  ||##  or ``char *''
  ||#### =()<MMAP_PTR		@<MMAP_PTR>@>()=
  ||MMAP_PTR		caddr_t
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  Should we msync when using mmap? Pick DO or DONT. Useful
  ||##  with some slightly broken mmap implementations. (like HPUX and BSD/OS).
  ||#### =()<MMAP_SYNC		@<MMAP_SYNC>@>()=
  ||MMAP_SYNC		DONT
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  Should we call your msync() with 3 args? (addr,len,flags)
  ||##  Choose DO or DONT.
  ||#### =()<MSYNC_3_ARG		@<MSYNC_3_ARG>@>()=
  ||MSYNC_3_ARG		DONT
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  Do you have uustat, or just uuq?  Pick DO or DONT
  ||#### =()<HAVE_UUSTAT		@<HAVE_UUSTAT>@>()=
  ||HAVE_UUSTAT		DO
[IN1.7=@6][WDF=autoconf][WOR=no]
  ||##  Should INN do some setsockopts on network connections. Pick DO or DONT.
  ||##  Some versions of Solaris should set to DONT (pre 2.4 it seems)
  ||#### =()<SET_SOCKOPT		@<SET_SOCKOPT>@>()=
  ||SET_SOCKOPT		DO

INN-autoconf Completed Software Action Items