db_setup_stmts: new setting

[cgi-auth-flexible.git] / caf.pod

diff --git a/caf.pod b/caf.pod
index 40ee9cd6fc2c283ac542c3152e9a31245f8d24b9..8ed5d518227c7c903cc1344caaebec0771781829 100644 (file)
--- a/caf.pod
+++ b/caf.pod
@@ -1172,15 +1172,20 @@ been done and should be skipped; otherwise the hash entry should be set.
 C<\&outfn> is a coderef which C<srcdump_process_item> should call each
 time it wants to generate a file which should be included as part of
 the source code.  It should be called using one of these patterns:
 C<\&outfn> is a coderef which C<srcdump_process_item> should call each
 time it wants to generate a file which should be included as part of
 the source code.  It should be called using one of these patterns:

-   $outfn->("message for log");
-   $outfile = $outfn->("message for log", "extension");
-The former simply logs this message (along with the associated
-C<$item>, so there is no need to mention that).  The latter logs the
-message but also generates and returns a filename which should then
+   $outfn->("message for manifest");
+   $outfile = $outfn->("message for manifest", "extension");
+The former simply prints the message into the manifest in the form
+  none: message for manifest
+The latter generates and returns a filename which should then

 be created and filled with some appropriate data.  C<"extension">
 should be a string for the file extension, eg C<"txt">.  The output
 can be written directly to the named file: there is no need to
 be created and filled with some appropriate data.  C<"extension">
 should be a string for the file extension, eg C<"txt">.  The output
 can be written directly to the named file: there is no need to

-write to a temporary file and rename.
+write to a temporary file and rename.  C<$outfn> writes the filename
+and the message to the manifest, in the form
+  filename leaf: message
+In neither case is the actual name of C<$dir> on the system
+disclosed per se although of course some of the contents of some of
+the files in the source code dump may mention it.

 
 The default implementation is the module function
 C<srcdump_process_item>.
 
 The default implementation is the module function
 C<srcdump_process_item>.


@@ -1319,11 +1324,8 @@ xxx remaining settings
  print
  debug
 
  print
  debug
 

-xxx $message argument to $outfn->() is not for log, it's for manifest
-xxx document syntax of $message argument to $outfn->()
-
-xxx html generators
-xxx document cookie
+xxx document cookie usage
+xxx document construct_cookie fn

 
 xxx bugs wrong default random on Linux
 xxx bugs wrong default random on *BSD
 
 xxx bugs wrong default random on Linux
 xxx bugs wrong default random on *BSD