debian/control update: description; depends (sisu-pdf:CJK); recommends; suggests

* update description of sisu
* sisu-pdf, add Depends: texlive-lang-cjk
  * for CJK (zh ja ko), large texlive xetex dependency
* sisu, add Recommends: rake, po4a
* sisu, add Suggests: poedit

1 files changed, 31 insertions, 20 deletions

diff --git a/debian/control b/debian/control
index fc6b5987..223e4234 100644
--- a/debian/control
+++ b/debian/control
@@ -14,36 +14,39 @@ Architecture: all
 Depends: ${misc:Depends}, ruby1.9.1 (>= 1.9.2.180), rsync, unzip, zip
 Recommends:
  sisu-pdf, sisu-sqlite, sisu-postgresql, imagemagick | graphicsmagick, keychain,
- librmagick-ruby, openssl, openssh-client | lsh-client, qrencode, tidy, tree,
- vim-addon-manager
-Suggests: lv, calibre, pinfo, texinfo, trang
+ librmagick-ruby, openssl, openssh-client | lsh-client, po4a, qrencode, rake,
+ tidy, tree, vim-addon-manager
+Suggests: lv, calibre, pinfo, poedit, texinfo, trang
 Conflicts: sisu-markup-samples (<= 1.0.11)
 Replaces: sisu-markup-samples (<= 1.0.11)
 Description: documents - structuring, publishing in multiple formats and search
  SiSU is a lightweight markup based, command line oriented, document
  structuring, publishing and search framework for document collections.
  .
- With minimal preparation of a plain-text, (UTF-8) file, using its native
- markup syntax in your text editor of choice, SiSU can generate various
- document formats (most of which share a common object numbering system for
- locating content), including plain text, HTML, XHTML, XML, EPUB, OpenDocument
- text (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects
+ With minimal preparation of a plain-text (UTF-8) file, using sisu markup
+ syntax in your text editor of choice, SiSU can generate various document
+ formats (most of which share a common object numbering system for locating
+ content), including plain text, HTML, XHTML, XML, EPUB, OpenDocument text
+ (ODF:ODT), LaTeX, PDF files, and populate an SQL database with objects
  (roughly paragraph-sized chunks) so searches may be performed and matches
- returned with that degree of granularity: your search criteria is met by these
- documents and at these locations within each document. Object numbering is
- particularly suitable for "published" works (finalized texts as opposed to
- works that are frequently changed or updated) for which it provides a fixed
- means of reference of content. Document outputs also share semantic meta-data
- provided.
+ returned with that degree of granularity. Think being able to finely match
+ text in documents across different output formats and across languages if you
+ have translations of the same document, using common object numbers.
+ Additionally for search, your criteria is met by these documents at these
+ locations within each document (equally relevant across different output
+ formats and languages). To be clear (if obvious) page numbers provide none of
+ this functionality. Object numbering is particularly suitable for "published"
+ works (finalized texts as opposed to works that are frequently changed or
+ updated) for which it provides a fixed means of reference of content. Document
+ outputs also share semantic meta-data provided.
  .
  SiSU also provides concordance files, document content certificates and
- manifests of generated output.
+ manifests of generated output. SiSU provides the means to make book indexes
+ that make use of its object numbering.
  .
  A vim syntax highlighting file and an ftplugin with folds for sisu markup is
- provided, as are syntax highlighting files for kate, kwrite, gedit and
- diakonos. Vim 7 includes syntax highlighting for SiSU.
- .
- man pages, and interactive help are provided.
+ provided. Vim 7 includes syntax highlighting for SiSU. Some syntax hilighting
+ is also available for Emacs and a few other editors.
  .
  Dependencies for various features are taken care of in sisu related packages.
  The package sisu-complete installs the whole of SiSU.
@@ -52,6 +55,14 @@ Description: documents - structuring, publishing in multiple formats and search
  sisu-markup-samples which is found in the non-free archive the licenses for
  the substantive content of the marked up documents provided is that provided
  by the author or original publisher.
+ .
+ SiSU uses utf-8 & parses left to right. Currently supported languages:
+ am bg bn br ca cs cy da de el en eo es et eu fi fr ga gl he hi hr hy ia is it
+ ja ko la lo lt lv ml mr nl nn no oc pl pt pt_BR ro ru sa se sk sl sq sr sv ta
+ te th tk tr uk ur us vi zh (see XeTeX polyglossia & cjk)
+ .
+ SiSU works well under po4a translation management, for which an administrative
+ sample Rakefile is provided with sisu_manual under markup-samples.
 
 Package: sisu-complete
 Architecture: all
@@ -74,7 +85,7 @@ Depends:
  ${misc:Depends}, ruby1.9.1 (>= 1.9.2.180), sisu (= ${source:Version}),
  texlive-latex-base, texlive-fonts-recommended, texlive-generic-recommended,
  texlive-latex-recommended, texlive-latex-extra, texlive-math-extra,
- texlive-xetex, fonts-liberation, lmodern
+ texlive-xetex, fonts-liberation, lmodern, texlive-lang-cjk
 Suggests: evince | pdf-viewer
 Description: dependencies to convert SiSU LaTeX output to pdf
  SiSU is a lightweight markup based document structuring, publishing and search