Add a tiny script for producing HTML documentation archives.

Also update the release making document to point to it.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@68096 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/build/tools/make-html-docs b/build/tools/make-html-docs
new file mode 100755 (executable)
index 0000000..24b1622
--- /dev/null
+++ b/build/tools/make-html-docs
@@ -0,0 +1,30 @@
+#!/bin/sh
+#
+# This script creates archives of HTML documentation in  tar.bz2 and zip
+# formats. It relies on docs/doxygen/regen.sh to really generate the docs.
+#
+# The script should be ran from the root of wxWidgets checkout and creates the
+# output files in its parent directory.
+
+version=$1
+if [ -z "$version" ]; then
+    echo "Must specify the distribution version." >&2
+    exit 1
+fi
+
+set -e
+set -x
+
+docs_dir_name=wxWidgets-$version
+docs_file_basename=wxWidgets-docs-html-$version
+
+cd docs/doxygen
+./regen.sh html
+cd out
+mv html $docs_dir_name
+tar cjf ../../../../$docs_file_basename.tar.bz2 $docs_dir_name
+cd $docs_dir_name
+zip -q -r ../../../../../$docs_file_basename.zip .
+
+cd ..
+mv $docs_dir_name html

diff --git a/docs/tech/tn0022.txt b/docs/tech/tn0022.txt
index f803caa26aa3f94df10531ce9ca9b048502345c7..8e015402191f02c4f7af1cd2a1fb5e7a266f51d1 100644 (file)
--- a/docs/tech/tn0022.txt
+++ b/docs/tech/tn0022.txt
@@ -26,8 +26,18 @@ IMPORTANT NOTE: You *must* run this script from a clean source tree, that is,
           to be in the release, commit them first.
 
 
           to be in the release, commit them first.
 
 

-Also run doxygen to create HTML documentation and pack it in .tar.bz2 and .zip
-formats.
+Alternative non official release scripts
+----------------------------------------
+
+If you use git-svn, then you can use alternative script that avoids the
+problems such as using non-clean tree and also has better handling of the ends
+of lines conversions. To use it you need to run
+
+- build/tools/svn-find-native-eols.pl
+- build/tools/git-make-release
+- build/tools/make-html-docs
+
+(the last one can also be used without git).

 
 
 Uploading
 
 
 Uploading