documentation & man pages, add sisu3, sisu-po and touches

37 files changed, 105 insertions, 74 deletions

diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu.ssm b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu.ssm
index c162db3f..47a029fa 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu.ssm
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu.ssm
@@ -1,4 +1,4 @@
-% SiSU master 2.0
+% SiSU master 3.0
 
 @title: SiSU
  :subtitle: Manual
@@ -19,7 +19,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2010-07-07
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_commands.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_commands.sst
index d32c9dad..18620d1b 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_commands.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_commands.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Commands
@@ -21,7 +21,7 @@
  :issued: 2002-08-28
  :available: 2002-08-28
  :published: 2007-09-16
- :modified: 2010-09-17
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
@@ -165,6 +165,15 @@ produces LaTeX pdf (portrait.pdf & landscape.pdf). Default paper size is set in
 !_ --pg [instruction] [filename] <br>
 database postgresql ( --pgsql may be used instead) possible instructions, include: --createdb; --create; --dropall; --import [filename]; --update [filename]; --remove [filename]; see database section below. Alias -D
 
+!_ --po [language_directory/filename language_directory] <br>
+see --po4a
+
+!_ --po4a [language_directory/filename language_directory] <br>
+produces .pot and po files for the file in the languages specified by the language directory. SiSU markup is placed in subdirectories named with the language code, e.g. en/ fr/ es/. The sisu config file must set the output directory structure to multilingual. v3, experimental
+
+!_ -P [language_directory/filename language_directory] <br>
+see --po4a
+
 !_ -p [filename/wildcard] <br>
 see --pdf
 
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_config.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_config.ssi
index b7370b4c..274a056f 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_config.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_config.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Configuration
@@ -18,7 +18,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_content_directories.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_content_directories.ssi
index 11590de2..4c3a506a 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_content_directories.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_content_directories.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Content Directories, Organising Content
@@ -18,7 +18,7 @@
  :issued: 2002-08-28
  :available: 2007-08-28
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_css.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_css.ssi
index 5ef419f1..2035b7c3 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_css.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_css.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: CSS - Cascading Style Sheets
@@ -18,7 +18,7 @@
  :issued: 2007-08-28
  :available: 2007-08-28
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_description.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_description.sst
index fe3b5c46..e924c433 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_description.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_description.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU - SiSU information Structuring Universe / Structured information, Serialized Units
  :subtitle: Description
@@ -19,7 +19,7 @@
  :issued: 2002-11-12
  :available: 2002-11-12
  :published: 2007-08-30
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_download.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_download.ssi
index b71ddbca..2d5c6508 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_download.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_download.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU - SiSU information Structuring Universe / Structured information, Serialized Units
  :subtitle: Download, Stable and Development Branches
@@ -16,7 +16,7 @@
  :issued: 2002-11-12
  :available: 2002-11-12
  :published: 2009-01-18
- :modified: 2010-06-11
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_examples.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_examples.ssi
index 64a1fe90..1188b109 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_examples.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_examples.ssi
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Markup Samples, Output Examples
@@ -19,7 +19,7 @@
  :issued: 2002-11-12
  :available: 2002-11-12
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_examples.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_examples.sst
index 9460615e..491f96a4 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_examples.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_examples.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Markup Samples, Output Examples
@@ -19,7 +19,7 @@
  :issued: 2002-11-12
  :available: 2002-11-12
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_faq.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_faq.sst
index 3acbbb74..44a5a590 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_faq.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_faq.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: FAQ - Frequently Asked/Answered Questions
@@ -19,7 +19,7 @@
  :created: 2006-09-06
  :available: 2006-09-06
  :issued: 2006-09-06
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_filetypes.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_filetypes.sst
index 55ab627f..4e46323c 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_filetypes.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_filetypes.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Filetypes
@@ -19,7 +19,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_help.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_help.sst
index c10807bd..a49b3522 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_help.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_help.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Help
@@ -19,7 +19,7 @@
  :issued: 2002-08-28
  :available: 2002-08-28
  :published: 2007-08-30
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_help_sources.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_help_sources.sst
index edd4699e..90a0efc6 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_help_sources.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_help_sources.sst
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: References
@@ -19,7 +19,7 @@
  :issued: 2002-11-12
  :available: 2002-11-12
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
@@ -73,6 +73,28 @@ _1 http://sisudoc.org/sisu/sisu_help_sources/index.html
 
 _1 man sisu
 
+_1 man sisu-concordance
+
+_1 man sisu-epub
+
+_1 man sisu-git
+
+_1 man sisu-harvest
+
+_1 man sisu-html
+
+_1 man sisu-odf
+
+_1 man sisu-pdf
+
+_1 man sisu-pg
+
+_1 man sisu-po
+
+_1 man sisu-sqlite
+
+_1 man sisu-txt
+
 _1 man 7 sisu_complete
 
 _1 man 7 sisu_pdf
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_homepages.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_homepages.ssi
index 31b44c1c..0fd681fa 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_homepages.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_homepages.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Homepages
@@ -18,7 +18,7 @@
  :created: 2007-08-28
  :issued: 2007-08-28
  :available: 2007-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_how.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_how.ssi
index 7928abb5..bd7f15d8 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_how.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_how.ssi
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: How Does SiSU Work?
@@ -18,7 +18,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_howto.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_howto.sst
index d53bafa2..8dfee20b 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_howto.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_howto.sst
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Technical, Howto
@@ -19,7 +19,7 @@
  :created: 2002-11-12
  :issued: 2002-11-12
  :available: 2002-11-12
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_hyperestraier.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_hyperestraier.ssi
index 4b528900..5674b4b4 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_hyperestraier.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_hyperestraier.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Hyperestraier Search
@@ -18,7 +18,7 @@
  :issued: 2002-08-28
  :available: 2002-08-28
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_installation.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_installation.ssi
index adf5b921..cde444ed 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_installation.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_installation.ssi
@@ -1,4 +1,4 @@
-% SiSU insert 2.0
+% SiSU insert 3.0
 
 @title: SiSU
  :subtitle: Installation
@@ -18,7 +18,7 @@
  :created: 2002-11-12
  :issued: 2002-11-12
  :available: 2002-11-12
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_interesting_to_whom.ssi b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_interesting_to_whom.ssi
index f3a94e0e..3c8b12b0 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_interesting_to_whom.ssi
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_interesting_to_whom.ssi
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Who Might Be Interested?
@@ -18,7 +18,7 @@
  :issued: 2002-08-28
  :available: 2002-08-28
  :published: 2007-09-16
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_introduction.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_introduction.sst
index e2df51d0..b01eed59 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_introduction.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_introduction.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Introduction
@@ -18,7 +18,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_manual.ssm b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_manual.ssm
index 878dc5cb..7622d0b0 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_manual.ssm
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_manual.ssm
@@ -1,4 +1,4 @@
-% SiSU master 2.0
+% SiSU master 3.0
 
 @title: SiSU
  :subtitle: Manual
@@ -19,7 +19,7 @@
  :created: 2002-08-28
  :issued: 2002-08-28
  :available: 2002-08-28
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_markup.sst
index 09f3cc63..be36fc79 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_markup.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: Markup
@@ -22,7 +22,7 @@
  :issued: 2002-08-28
  :available: 2002-08-28
  :published: 2008-05-22
- :modified: 2010-10-14
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_output_overview.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_output_overview.sst
index 92d5274e..9664a189 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_output_overview.sst
+++ b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_output_overview.sst
@@ -1,4 +1,4 @@
-% SiSU 2.0
+% SiSU 3.0
 
 @title: SiSU
  :subtitle: SiSU overview of status of features available in various outputs
@@ -19,7 +19,7 @@
  :created: 2005-10-31
  :available: 2006-10-31
  :issued: 2006-10-31
- :modified: 2009-12-16
+ :modified: 2011-02-07
 
 @make:
  :num_top: 1
diff --git a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_postgresql.sst b/data/doc/sisu/v3/markup-samples/sisu_manual/en/sisu_postgresql.sst
index addf1bd1..9d226d66 100644
--- a/data/doc/sisu/v3/markup-samples/sisu_manual/sisu_postgresql.sst