14 files changed, 992 insertions, 0 deletions
diff --git a/debian/man/addld.1.pod b/debian/man/addld.1.pod
new file mode 100644
index 0000000..b4bb838
--- /dev/null
+++ b/debian/man/addld.1.pod
@@ -0,0 +1,66 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+addld - Lexicon & Dictionary module creation tool for SWORD Project
+
+=head1 SYNOPSIS
+
+B<addld> -a FILE key [PATH]
+B<addld> -d FILE key
+B<addld> -l FILE target_key link_name
+B<addld> -c FILE
+
+
+=head1 DESCRIPTION
+
+A command line utility to create and manipule Lexicon & Dictionary SWORD
+modules. It can be used to add, delete and link L&D keys within module.
+It can also be used to create new L&D modules.
+
+=over
+
+=item B<-a FILE key [PATH]>
+
+The form is used to add a key to a L&D module. Optionaly path can be
+used to the file with the entry.
+
+=item B<-d FILE key>
+
+This form is used to delete a key from a file.
+
+=item B<-l FILE target_key link_name>
+
+This form is used to link two keys in the module.
+
+=item B<-c FILE>
+
+This is used to create a new module
+
+=back
+
+=head1 OPTIONS
+
+To use 4-byte L&D instead of 2-byte, insert a 4 immediately after the '-'.
+
+To use zLD instead of 2-byte, insert a z immediately after the '-'.
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/diatheke.1 b/debian/man/diatheke.1
new file mode 100644
index 0000000..aebcdf7
--- /dev/null
+++ b/debian/man/diatheke.1
@@ -0,0 +1,201 @@
+.\" diatheke man page
+.\" (C)2006 Eeli Kaikkonen
+.\" You may do whatever you wish with this file.
+.\" Version 0.8
+.TH DIATHEKE 1 "2009-02-01" "diatheke 4.2.1" "Diatheke man page"
+.SH NAME
+diatheke \- a command line Bible reader
+.SH SYNOPSIS
+.\" for synopsis format see man man
+.B diatheke
+.B \-b
+.I module_name
+[\fB\-o \fIoption_filters\fR]
+[\fB\-m \fImaximum_verses\fR]
+[\fB\-f \fIoutput_format\fR]
+[\fB\-e \fIoutput_encoding\fR]
+[\fB\-t \fIscript\fR]
+[\fB\-v \fIvariant_number\fR]
+[\fB\-l \fIlocale\fR]
+.B \-k
+.I query_key
+
+.B diatheke
+.B \-b
+.I module_name
+\fB\-s regex\fR|\fBmultiword\fR|\fBphrase\fR
+[\fB\-r \fIsearch_range\fR]
+[\fB\-l \fIlocale\fR]
+.B \-k
+.I search_string
+
+.B diatheke
+.B \-b system
+.B \-k modulelist\fR|\fBmodulelistnames\fR|\fBlocalelist
+
+.B diatheke
+.B \-b info
+.B \-k
+.I module_name
+.SH DESCRIPTION
+.I diatheke
+prints Bible verses or other text from the modules which the Sword library uses.
+.SH OPTIONS
+.TP
+.B \-b
+Module name. May be "system" or "info" (see QUERY KEYS) or one of the names obtained by
+using "diatheke \-b system \-k modulelist".
+.TP
+.B \-s
+Search type. One of
+regex
+(regular expression, see regex(7)),
+multiword
+(like "word [AND word]..."),
+phrase
+(exact text).
+.TP
+.B \-r
+Search range. A valid Bible key range value (see \-k). For example: Matt-John, Rom,
+gen-psalms, 1Thess 1:5-2:6.
+.TP
+.B \-o
+Module option filters. A combination of "fmhcvalsrbx". See MODULE OPTIONS.
+.TP
+.B \-m
+Maximum number of verses returned. Any integer value.
+.TP
+.B \-f
+Output format. One of GBF, ThML, RTF, HTML, OSIS, CGI, plain (default).
+This currently works only if there is a Sword library filter from the original format to
+the specified output format. HTML and CGI are for generating text for a webpage.
+.TP
+.B \-e
+Output character encoding. One of Latin1, UTF16, HTML, RTF, UTF8 (default).
+This currently works only for module contents, not for system key contents
+or key texts.
+.TP
+.B \-t
+.\" TODO
+Script. (This seems to be broken in version 4.2.1,
+it should allow e.g. Greek->Latin1 character
+transliteration with "\-t Latin".)
+.TP
+.B \-v
+Variant. The text may contain variant readings. One of \-1 (all), 0, 1.
+.TP
+.B \-l
+Locale. Sword may have different locales installed. Default is en. Localization
+affects input and output keys.
+.TP
+.B \-k
+Query key. It must be the last argument because all following
+arguments are added to the key. See QUERY KEYS for different kinds of keys.
+.SH MODULE OPTIONS
+By default the optional features of modules are not shown in the returned
+text. These options make them visible if the module supports them.
+.TP
+.B n
+Strong's numbers. These numbers refer to the Strong's dictionaries of the New and
+Old Testaments. Some Bible texts attach these numbers to words.
+.TP
+.B f
+Footnotes.
+.TP
+.B m
+Morphology of the Greek/Hebrew words. Morphology is shown as a code which refers
+to an entry in some dictionary-type module.
+.TP
+.B h
+Section headings.
+.TP
+.B c
+Hebrew cantillation.
+.TP
+.B v
+Hebrew vowels.
+.TP
+.B a
+Greek accents.
+.TP
+.B l
+Lemmas (the base forms of the words).
+.TP
+.B s
+Scripture cross-references.
+.TP
+.B r
+Arabic shaping.
+.TP
+.B b
+Bi-directional reordering.
+.TP
+.B x
+Red Words of Christ.
+.SH QUERY KEYS
+.TP
+.B Bible texts and Commentaries
+use verse keys. Examples: john 1:1, j1:1 jh1 (the first chapter of John), jh
+(the whole book of Gospel of John), joh 1:1-3 ( a verse range), joh 1:0
+(one verse backwards from
+1:1, which is the last verse of the previous book or possibly an introduction to John),
+joh 1:100 (which is 100 verses
+forward from the first verse of John 1:1), 1234 (which is the 1234th verse from
+the beginning of the Bible).
+.TP
+.B Lexicons and Dictionaries
+use word keys. Any word can be used and similar or next entry alphabetically is returned.
+Some dictionaries like Strong's use numbered entries.
+.TP
+.B system
+is not a module but when used with \-b allows one of these keys:
+modulelist
+(list of the available modules with short descriptions),
+modulelistnames
+(list of the names of the available modules),
+localelist
+(list of the available Sword locales).
+.TP
+.B info
+is not a module but when used with \-b allows a module name as a key
+and gives some information about that module.
+.SH EXAMPLES
+.TP
+diatheke \-b KJV \-k joh1:1
+Shows John 1:1 in King James Version.
+.TP
+diatheke \-b RWP \-k Matthew 2:2
+Shows Matthew 2:2 in Robertson's Word Pictures commentary.
+.TP
+diatheke \-b WebstersDict \-k bible
+Show entry "bible" in Websters Dictionary.
+.TP
+diatheke \-b system \-k modulelist
+Shows the list of available modules.
+.TP
+diatheke \-b KJV \-o fmslx \-f OSIS \-e Latin1 \-k john 1:1-3
+Shows John 1:1-3 from KJV in OSIS XML format in iso8859-1 encoding with footnotes,
+morphology, cross-references, lemmas and words of Christ in red. (The module may  not
+support all options and those have no effect. KJV includes only ASCII characters so
+encoding has no effect.)
+.TP
+diatheke \-b GerLut \-l de \-m 10 \-k Offenbarung
+Shows the first 10 verses of Revelation in German GerLut version,
+both input and output keys are localized.
+.TP
+diatheke \-b KJV \-s phrase \-r Mt \-k love
+Shows those verse keys which include phrase "love" in Gospel of Matthew in KJV module.
+.SH DIAGNOSTICS
+Currently diatheke exits always with status 0. If only Bible verse key and
+module name are shown it means that the module did not have any content in
+that range. If only module name is shown the key may have been bad. If
+nothing is shown the book name may have been bad. If Segmentation fault
+is shown diatheke has been bad.
+.SH SEE ALSO
+.I http://www.crosswire.org/sword/
+.SH COPYRIGHT
+Sword library: \(co 1994-2006 Crosswire Bible Society,
+released under GPL licence.
+Diatheke: written by Chris Little,
+\(co 1999-2006 Crosswire Bible Society, released under GPL licence.
+This manpage was written by Eeli Kaikkonen and may be used freely.
diff --git a/debian/man/imp2gbs.1.pod b/debian/man/imp2gbs.1.pod
new file mode 100644
index 0000000..62c8b41
--- /dev/null
+++ b/debian/man/imp2gbs.1.pod
@@ -0,0 +1,65 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+imp2gbs - general book module creation tool
+
+=head1 SYNOPSIS
+
+B<imp2gbs> [input file] [OPTIONS]
+
+=head1 DESCRIPTION
+
+A command line utility to convert imp (import) formatted general book into SWORD
+module. 
+
+=head1 OPTIONS
+
+=over
+
+=item B<-o [PATH]>
+
+Specify the output path, if different from the input file's.
+
+=item B<-a>
+
+Create augment module. Default is to create new module.
+
+=item B<-O>
+
+Overwrite entries of same key. Default is to append.
+
+=item B<-U>
+
+A key filter which converts toUpper.
+
+=item B<-g>
+
+A key filter which strips greek diacritics.
+
+=item B<-l [levels]>
+
+A key filter which uses Pseudo-Lexicon n-level generation using first character,
+e.g. -l 2 "Abbey" -> "A/AB/Abbey".
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/imp2ld.1.pod b/debian/man/imp2ld.1.pod
new file mode 100644
index 0000000..021ebad
--- /dev/null
+++ b/debian/man/imp2ld.1.pod
@@ -0,0 +1,49 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+imp2ld - Lexicon, Dictionary, Daily Devotional and Glossary module creation tool
+
+=head1 SYNOPSIS
+
+B<imp2ld> <FILE> [modulename] [4 | 2 | z]
+
+=head1 DESCRIPTION
+
+A command line utility to convert imp formatted file into lexicon, dictionary,
+daily devotional or glossary SWORD module. 
+
+=head1 OPTIONS
+
+=over
+
+=item B<[modulename]>
+
+Specify the output modulename.
+
+=item B<[4 | 2 | z>
+
+Specify output module driver. Default is 4.
+
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/imp2vs.1.pod b/debian/man/imp2vs.1.pod
new file mode 100644
index 0000000..80b676b
--- /dev/null
+++ b/debian/man/imp2vs.1.pod
@@ -0,0 +1,44 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+imp2vs - Bible/Commentary module creation tool
+
+=head1 SYNOPSIS
+
+B<imp2vs> <FILE> [PATH]
+
+=head1 DESCRIPTION
+
+A command line utility to convert imp formatted file Bible/Commentary SWORD
+module.
+
+=head1 OPTIONS
+
+=over
+
+=item B<[PATH]>
+
+Specify path for the output module if different from the input file.
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/installmgr.1.pod b/debian/man/installmgr.1.pod
new file mode 100644
index 0000000..244e8ba
--- /dev/null
+++ b/debian/man/installmgr.1.pod
@@ -0,0 +1,106 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+installmgr - install, list, update and remove SWORD modules
+
+=head1 SYNOPSIS
+
+B<installmgr> -init
+
+B<installmgr> -l
+
+B<installmgr> -u [ModuleName]
+
+B<installmgr> -s
+
+B<installmgr> [-r | -rl | -rd] [RemoteSrcName]
+
+B<installmgr> -ri [RemoteSrcName] [ModuleName]
+
+B<installmgr> -ll [PATH]
+
+B<installmgr> -li [PATH] [ModuleName]
+
+=head1 DESCRIPTION
+
+A command line utility to manipulate SWORD modules. It can be used to install,
+remove, list and update SWORD modules, from local and network locations.
+
+Please note modules will be installed into /usr/share/sword without using
+APT. If you use this utility you will not be able to uninstall these modules
+using apt-get, aptitude, synaptic and similar tools.  
+
+=head1 OPTIONS
+
+=over
+
+=item B<-init>
+
+Creates basic user configuration file. This will overwrite existing one.
+
+=item B<-l>
+
+Lists currently installed SWORD modules.
+
+=item B<-u [ModuleName]>
+
+Uninstalls module.
+
+=item B<-s>
+
+Lists available remote sources
+
+=item B<[-r | -rl | -rd] [RemoteSrcName]>
+
+These are used to manipulate remote sources.
+
+=over
+
+=item -r
+
+Refreshes remote source.
+
+=item -rl
+
+Lists available modules from the remote source.
+
+=item -rd
+
+Lists new/updated modules from the remote source.
+
+=back
+
+=item B<-ri [RemoteSrcName] [ModuleName]>
+
+Install module from remote source.
+
+=item B<-ll [PATH]>
+
+List available modules at a specified local path.
+
+=item B<-li [PATH] [ModuleName]>
+
+Install module from local path.
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/mkfastmod.1.pod b/debian/man/mkfastmod.1.pod
new file mode 100644
index 0000000..5a503c1
--- /dev/null
+++ b/debian/man/mkfastmod.1.pod
@@ -0,0 +1,28 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+mkfastmod - creates a search index for a module
+
+=head1 SYNOPSIS
+
+B<mkfastmod> module
+
+=head1 DESCRIPTION
+
+A command line utility which creates a search index for a module.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/mod2imp.1.pod b/debian/man/mod2imp.1.pod
new file mode 100644
index 0000000..e7c0905
--- /dev/null
+++ b/debian/man/mod2imp.1.pod
@@ -0,0 +1,85 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+mod2imp, mod2osis, mod2vpl, mod2zmod - export SWORD modules
+
+=head1 SYNOPSIS
+
+B<mod2imp> [modulename]
+
+B<mod2osis> [modulename]
+
+B<mod2vpl> [modulename] [0 |1]
+
+B<mod2zmod> [modulename] [PATH] [blocktype [compressiontype [cipherkey]]]
+
+=head1 DESCRIPTION
+
+These utilities export SWORD modules into various formats. B<mod2imp> exports a
+module into SWORD imp (import) format. B<mod2osis> exports a module into OSIS
+format. B<mod2vpl> exports into verse per line format. B<mod2zmod> produces
+compressed SWORD modules.
+
+=head1 OPTIONS
+
+=over
+
+=item B<[modulename]>
+
+Specify the modulename to export.
+
+=item B<[0 | 1]>
+
+Only applies to B<mod2vpl>. 1 - prepends verse reference to each line, 0 -
+doesn't.
+
+=item B<[PATH]>
+
+Only applies to B<mod2zmod>. Path where to create compressed module.
+
+=item B<[blocktype [compressiontype [cipherkey]]]>
+
+Only applies to B<mod2zmod>. Valid blocktypes are (default 4):
+
+=over
+
+=item 2 - verses
+
+=item 3 - chapters
+
+=item 4 -books
+
+=back
+
+Compression types are (default 1):
+
+=over
+
+=item 1 - LZSS
+
+=item 2 - Zip
+
+=back
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/osis2mod.1.pod b/debian/man/osis2mod.1.pod
new file mode 100644
index 0000000..2234527
--- /dev/null
+++ b/debian/man/osis2mod.1.pod
@@ -0,0 +1,74 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+osis2mod - create SWORD module from OSIS
+
+=head1 SYNOPSIS
+
+B<osis2mod> PATH OSISDOC [OPTIONS]
+
+=head1 DESCRIPTION
+
+This utility will create a SWORD module in the specified path from the
+OSIS formated input.
+
+=head1 OPTIONS
+
+=over
+
+=item B<-a>
+
+Augment module if exists (default is to create a new one).
+
+=item B<-z | -Z>
+
+Use compression. z - for ZIP; Z - for LZSS. By default no compression is
+used.
+
+=item B<-b N>
+
+Specify block size. Valid values are (default 4):
+
+=over
+
+=item 2 - verses
+
+=item 3 - chapters
+
+=item 4 -books
+
+=back
+
+=item B<-c CIPHER_KEY>
+
+Encipher module using supplied key. By default no enciphering is used.
+
+=item B<-N>
+
+Do not convert UFT-8 no normalize UTF-8 to NFC. Default is to convert to UTF-8,
+if needed, and then normalize to NFC.
+
+Note: all UTF-8 texts should be normalized to NFC.
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/tei2mod.1.pod b/debian/man/tei2mod.1.pod
new file mode 100644
index 0000000..38bf7d0
--- /dev/null
+++ b/debian/man/tei2mod.1.pod
@@ -0,0 +1,81 @@
+#  This is a man page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+tei2mod - tool to convert TEI P5 source into a SWORD module
+
+=head1 SYNOPSIS
+
+B<tei2mod> outputpath teisource [OPTIONS]
+
+
+=head1 DESCRIPTION
+
+This utility is used to create SWORD module from a slightly modified
+TEI (Text Encoding Initiative) P5 formatted XML source document. The
+resulting module will be saved in the outputpath specified.
+
+=head1 OPTIONS
+
+=over
+
+=item B<-z>
+
+Specifies use of ZIP compression.  The default is no compression.
+
+=item B<-Z>
+
+Specifies use of LZSS compression.  The default is no compression.
+
+=item B<-s [2|4]>
+
+Specifies maximum text size per entry.  The default is 4.
+
+=item B<-c cipher_key>
+
+Specifies that the output will be enciphered with the supplied
+cipher_key.  The default is plain text output (no encipherment).
+
+=item B<-N>
+
+Disables conversion to UTF-8 and normalization of UTF-8 to NFC.  The
+default is to convert to UTF-8, if needed, and then normalize to NFC.
+Note that all UTF-8 texts should be normalized to NFC.
+
+=back
+
+=head1 NOTE
+
+The input format is a subset of TEI P5 with added elements borrowed
+from OSIS for verse references.  The resulting custom TEI schema is
+available at http://www.crosswire.org/osis/teiP5osis.1.4.xsd
+
+=head1 AUTHORS
+
+This man page was written by Jonathan Marsden <jmarsden@fastmail.fm>
+for the Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=over
+
+=item http://www.crosswire.org/wiki/TEI_Dictionaries
+
+=item http://www.crosswire.org/osis/teiP5osis.1.4.xsd
+
+=item http://www.tei-c.org/release/doc/tei-p5-doc/html/index.html
+
+=back
+
+=cut
diff --git a/debian/man/vpl2mod.1.pod b/debian/man/vpl2mod.1.pod
new file mode 100644
index 0000000..32e8bcb
--- /dev/null
+++ b/debian/man/vpl2mod.1.pod
@@ -0,0 +1,68 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+vpl2mod - tool to convert verse per line source to SWORD module
+
+=head1 SYNOPSIS
+
+B<vpl2mod> SOURCE PATH [0|1] [0|1]
+
+
+=head1 DESCRIPTION
+
+This utility is used to create SWORD module from the verse per line formated
+source. The resulting module will be saved in the path specified.
+
+=head1 OPTIONS
+
+=over
+
+=item B<[0|1] [0|1]>
+
+The first option indicates whether to prepend verse references or not.
+The second option is to indicate whether module is NT only or not.
+
+=back
+
+=head1 NOTE
+
+With no verse references source file must contain exactly 31102 lines. This is
+KJV verse count plus heading for the module, testament, book and chapter. An
+example snippet follows:
+
+ MODULE HEADER
+ OLD TESTAMENT HEADER
+ GENESIS HEADER
+ CHAPTER 1 HEADER
+ In the beginning...
+
+This example implies there must also be a chapter 2 header, Exodus header, New
+Testament header, etc. If there is no text for the header, a black line must, at
+least, hold place.
+
+With verse references, source file must simply contain any number of lines, that
+begin with the verse reference for which it is an entry, e.g.:
+
+ gen 1:0 CHPATER 1 HEADER
+ get 1:1 In the beginning...
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/vs2osisref.1.pod b/debian/man/vs2osisref.1.pod
new file mode 100644
index 0000000..4205df7
--- /dev/null
+++ b/debian/man/vs2osisref.1.pod
@@ -0,0 +1,33 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+vs2osisref - a tool to convert verse references from English to OSIS
+
+=head1 SYNOPSIS
+
+vs2osisref VERSEREF [verse_context]
+
+=head1 DESCRIPTION
+
+Returns the osisRef of a given (text form) verse reference.
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut
diff --git a/debian/man/vs2osisreftxt.1.pod b/debian/man/vs2osisreftxt.1.pod
new file mode 100644
index 0000000..720a4ee
--- /dev/null
+++ b/debian/man/vs2osisreftxt.1.pod
@@ -0,0 +1,38 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+vs2osisreftxt - a tool that probably does something with OSIS refs
+
+=head1 SYNOPSIS
+
+vs2osisreftxt STRING [local_name] [test-in-set-verse]
+
+=head1 DESCRIPTION
+
+Apart from synopsis, little is know what this does. Probably something
+to do with parsing verses or verse references to/from string to/from
+OSIS in a given locale or something along the lines. Email me if you
+can give better description of what this util does.
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+L<vs2osisref>
+
+=cut
diff --git a/debian/man/xml2gbs.1.pod b/debian/man/xml2gbs.1.pod
new file mode 100644
index 0000000..7b518b9
--- /dev/null
+++ b/debian/man/xml2gbs.1.pod
@@ -0,0 +1,54 @@
+#  This is manual page in Perl POD format. Read more at
+#  http://perldoc.perl.org/perlpod.html or run command:
+#
+#     perldoc perlpod | less
+#
+#  To check the syntax:
+#
+#     podchecker *.pod
+#
+#  Create manual page with command:
+#
+#    pod2man PAGE.N.pod > PAGE.N
+
+=head1 NAME
+
+xml2gbs - OSIS/ThML General Book module creation tool
+
+=head1 SYNOPSIS
+
+B<xml2gbs> [OPTIONS] SOURCE [MODULENAME]
+
+
+=head1 DESCRIPTION
+
+This is a tool to create SWORD general book modules from OSIS/ThML sourse. A
+module name can be optionally specified.
+
+=head1 OPTIONS
+
+=over
+
+=item B<-l>
+
+Use long div names in the ThML files.
+
+=item B<-i>
+
+exports to IMP formal instead of creating a module.
+
+=item B<-fT|-fO>
+
+Set the importer to ThML or OSIS format respectively. By default it attempts to
+autodetect.
+
+=back
+
+=head1 Authors
+
+This manual page was written by Dmitrijs Ledkovs <dmitrij.ledkov@gmail.com> for
+Debian project but may be used by others.
+
+=head1 SEE ALSO
+
+=cut