checkpointing notes.

nodist/notes

@@ -1,47 +1,26 @@
-final preparation for release:
+edit FIXME's in:
-  create files:
+  PORTING
-    INSTALL -- configuration, build, and installation instructions
-    NEWS -- recent project news
-    COPYING -- pointer to LICENSE
-    AUTHORS -- list of contributors
-    ChangeLog
-    LICENSE -- license
-    MANIFEST -- list of files in distribution (?)
-    FAQ -- frequently asked questions for project
-    HISTORY -- project history
-
-add copyright to every file
-
-change README:
-  should have:
-    A brief description of the project.
-    A pointer to the project website (if it has one)
-    Notes on the developer's build environment and potential portability problems.
-    A roadmap describing important files and subdirectories.
-    Either build/installation instructions or a pointer to a file containing same (usually INSTALL).
-    Either a maintainers/credits list or a pointer to a file containing same (usually CREDITS).
-    Either recent project news or a pointer to a file containing same (usually NEWS).
 
 make man pages
   docbook?
   should have makefile target to build these
+  remove line from BUGS about missing man pages
 
-add make rules to install files
+---
+not removing all doxygen generated files in dist-clean or maintainer-clean
+  should remove them all in dist-clean
 
-custom make targets:
+---
-  make doxygen documents
+check for cancellation points:
-  make binary and/or source rpm
+  following functions may be interrupted (returning -1, errno=EINTR):
-    should auto generate spec file, pulling in proper version number
+    read(), write(), ioctl(), select(), poll(), pause(), connect(),
-    source rpm should use BuildRoot to build in /tmp or /var/tmp
+    accept(), syslog(), TCP operations
-  create tarball:
+    creat(), close(), getmsg(), putmsg(), msgrcv(), msgsnd(),
-	foobar-$(VERS).tar.gz:
+    recv(), send(), wait(), waitpid(), wait3(), sigpause()
-	  @ls $(SRC) | sed s:^:foobar-$(VERS)/: >MANIFEST
+  should ensure that we handle EINTR anywhere these are called.  in
-	  @(cd ..; ln -s foobar foobar-$(VERS))
+  particular we must call testCancel() (should do that anyway) and
-	  (cd ..; tar -czvf foobar/foobar-$(VERS).tar.gz `cat foobar/MANIFEST`)
+  sometimes restart the call.
-	  @(cd ..; rm foobar-$(VERS))
+  make sure unbounded time win32 calls do testCancel().
-
-configure not caching results
-  is that normal or did we disable it unintentionally
 
 ---
 not handling large motif selections
@@ -350,8 +329,8 @@ automake stuff
     * 'touch NEWS README AUTHORS ChangeLog'
     * 'touch stamp-h'
     * 'aclocal'     - creates aclocal.m4
-    * 'autoconf'    - creates configure from configure.in
     * 'autoheader'  - creates config.h.in
+    * 'autoconf'    - creates configure from configure.in
     * 'automake'    - Creates Makefile.in from Makefile.am
     * './configure' - creates Makefile from Makefile.in
     * 'make'
@@ -371,26 +350,47 @@ automake stuff
   use AC_CHECK_FUNC or AC_CHECK_FUNCS to detect missing functions
     use AC_CHECK_LIB first if function not in std C lib
 
-  maybe AC_CHECK_TYPE for size_t and ssize_t
+  AC_FUNC_MEMCMP -- adds memcmp.o to LIBOBJS if memcmp is broken
+  AC_FUNC_STRFTIME -- check for strftime(), define HAVE_STRFTIME
+  AC_FUNC_VPRINTF -- check for vprintf(), define HAVE_VPRINTF
+		also checks for _doprnt(), define HAVE_DOPRNT
 
-replace sys/time.h with:
+  #if STDC_HEADERS
-#if TIME_WITH_SYS_TIME
+  # include <string.h>
-#	include <sys/time.h>
+  #else
-#	include <time.h>
+  # if !HAVE_STRCHR
-#else
+  #  define strchr index
-#	if HAVE_SYS_TIME_H
+  #  define strrchr rindex
-#		include <sys/time.h>
+  # endif
-#	else
+  char *strchr (), *strrchr ();
-#		include <time.h>
+  # if !HAVE_MEMCPY
-#	endif
+  #  define memcpy(d, s, n) bcopy ((s), (d), (n))
-#endif
+  #  define memmove(d, s, n) bcopy ((s), (d), (n))
+  # endif
+  #endif
 
-  what does `make install' do?
+must provide fallbacks for stuff:
-
+  non-reentrant functions:
-  check in derived files?
+    put (shared) lock around non-reentrant function
-    aclocal.m4
+    provide reentrant API
-    config.h.in
+	  gethostbyaddr
-    configure
+	  gethostbyname
+	  getprotobyname
+	  getprotobynumber
+	  getservbyname
+	  getservbyport
+      gmtime
+      getpwuid
+      strerror
+  string/memory functions:
+	memcpy
+	memcmp
+	memmove
+	memset
+	strcat
+	strcmp
+	strcpy
+	strrchr
 
 used library functions:
 	accept
@@ -399,8 +399,11 @@ used library functions:
 	close
 	connect
 	dup
-	fork
+	exit
+	fcntl
+*	fork
 	fprintf
+*	free
 	getenv
 	gethostbyaddr
 	gethostbyname
@@ -408,16 +411,22 @@ used library functions:
 	getpeername
 	getprotobyname
 	getprotobynumber
+	getpwuid_r
 	getservbyname
 	getservbyport
 	getsockname
 	getsockopt
 	gettimeofday
+	getuid
 	inet_addr
 	inet_ntoa
 	ioctl
 	listen
+*	malloc
+	mbrtowc
+	mbsinit
 	memcpy
+!	memcmp
 	memmove
 	memset
 	nanosleep
@@ -435,15 +444,20 @@ used library functions:
 	sigaction
 	sigaddset
 	sigemptyset
+	sigwait
 	socket
 	sprintf
 	strcat
 	strcmp
+	strcpy
 	strerror
 	strrchr
+	strtol
+	sysconf
 	syslog
 	umask
 	vsnprintf
+	wcrtomb
 	write
 
 included files