Various scripts and documentation cleanups.

README.md

@@ -280,6 +280,19 @@ ensures that [log4cplus] is initialized. More importantly, it ensures that
 [log4cplus] shuts down before the execution leaves the `main()` function.
 
 
+Windows and rolling file Appenders
+----------------------------------
+
+On Windows, the standard C++ file streams open files in way that underlying
+Win32 file `HANDLE` is not open with `FILE_SHARE_DELETE` flag. This flag,
+beside shared delete, allows renaming files that have handles open to
+them. This issue manifests as error code 13 when the file needs to be rolled
+over and it is still open by another process.
+
+This is also [bug #167](https://sourceforge.net/p/log4cplus/bugs/167/) on
+SourceForge.
+
+
 Windows and TLS
 ---------------
 

docs/release.txt

@@ -8,7 +8,8 @@ This describes log4cplus release procedure:
 to date. Run `scripts/propagate-version.sh` followed by
 `scripts/doautoreconf.sh`. _Do not forget to commit the changes._
 
- #. Run `scripts/prepare_dist_from_bzr.sh` to prepare tarballs.
+ #. Run `scripts/prepare_dist_from_git.sh` to prepare tarballs. _Do not tag the
+revision, yet._
 
  #. [Upload tarballs][4] to SourceForge.
 

scripts/build-pdf.pl

@@ -1,3 +1,5 @@
+#! env perl
+
 # This is a helper script for building log4cplus documentation PDF from several
 # Markdown formatted files.
 
@@ -110,3 +112,13 @@
 print Dumper(\@args), "\n";
 
 system(@args);
+
+
+# produce PDF using latexmk utility to run the LuaLaTeX
+
+@args = (
+    'latexmk', '-gg', '-lualatex', 'README.md.tex');
+
+print Dumper(\@args), "\n";
+
+system(@args);

scripts/propagate-version.pl

@@ -99,5 +99,5 @@ BEGIN
             || $line =~ s/\d+ ([._\-]) \d+ ([._\-]) \d+
                          /$major$1$minor$2$so_current_adjusted/gx;
         print $line;
-    }    
+    }
 }

scripts/upload_to_wiki.pl

@@ -1,3 +1,4 @@
+#! env perl
 use strict;
 use IO::All;
 use LWP::UserAgent;