org files, minor editing
authorRalph Amissah <ralph@amissah.com>
Thu, 4 Dec 2014 21:54:07 +0000 (16:54 -0500)
committerRalph Amissah <ralph@amissah.com>
Mon, 8 Dec 2014 05:18:14 +0000 (00:18 -0500)
data/doc/sisu/CHANGELOG_v5
data/doc/sisu/CHANGELOG_v6
data/doc/sisu/org/sisu.org

index 2f3b72657749a8aad0001bf46fe0791c9d315e74..659c54a0ed26538b0c270da1a28637969b44f5e1 100644 (file)
@@ -49,7 +49,9 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_5.8.0.orig.tar.xz
   * CHANGELOGS formatted for viewing as org-mode files
     indentation, line-breaking, and formatting characters only changes made
 
-  * org files related to sisu, break up and place in own subdir
+  * org files related to sisu
+    * break up and place in own subdir
+    * org files, minor editing
 
 ** SiSU "UnFrozen" - prior to end of Debian Freeze
   (upstream bugfix 5.7.2 intended for Jessie (packaged for Debian as 5.7.1-2)
index 07a9e8381340ef9b0b74b131a792f14077d298f0..2c213b8a46c7a4c503853dbdb4064e24ba40c080 100644 (file)
@@ -39,7 +39,9 @@ http://www.jus.uio.no/sisu/pkg/src/sisu_6.4.0.orig.tar.xz
   * CHANGELOGS formatted for viewing as org-mode files
     indentation, line-breaking, and formatting characters only changes made
 
-  * org files related to sisu, break up and place in own subdir
+  * org files related to sisu
+    * break up and place in own subdir
+    * org files, minor editing
 
 ** SiSU "UnFrozen" - prior to end of Debian Freeze
   (upstream bugfix 6.3.2 (5.7.2) intended for Jessie (packaged for Debian as
index 125cf9ae33e9cdad7b8783d685890ffae243cca9..56a3fe62cbbb7b18a83a34165f54f67b2f317b9c 100644 (file)
@@ -14,30 +14,28 @@ 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 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. Think being able to finely match
- text in documents, using common object numbers, across different output
- formats and across languages if you have translations of the same document.
- 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
- can also share provided semantic meta-data.
+ 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. Think of being able to finely match text in documents, using
+ common object numbers, across different output formats and across languages if
+ you have translations of the same document.  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 can also share provided semantic meta-data.
  .
  SiSU also provides concordance files, document content certificates and
- manifests of generated output. SiSU provides the means to make book indexes
that make use of its object numbering.
+ manifests of generated output and 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. Vim 7 includes syntax highlighting for SiSU. Some syntax hilighting
- is also available for Emacs and a few other editors.
+ Syntax highlighting and folding (outlining) files are provided for the Vim and
+ Emacs editors.
  .
  Dependencies for various features are taken care of in sisu related packages.
  The package sisu-complete installs the whole of SiSU.