path: root/data/doc/sisu/CHANGELOG_v3

SiSU CHANGELOG    -*- mode: org; -*-
#+OPTIONS: ^:nil _:nil

* SiSU version 3
  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=data/doc/sisu/CHANGELOG_v3;hb=HEAD>
  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob_plain;f=debian/changelog;hb=refs/heads/debian/sid>

v3 branch closed with opening of v5 from >= 4.1
v3 branch is legacy: v4 branch supersedes & replaces it
v3 branch supersedes & replaces v2 branch
v2 introduces alternative (configurable) output structures
v1 branch is removed; it is available in sisu =< 2.7

  * homepages: <http://sisudoc.org> <http://www.jus.uio.no/sisu>
  * data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_manual.ssm
  * CHANGELOG CHANGELOG_v2 CHANGELOG_v3 README data/doc/sisu/

* Legacy Branch, Reference

  Version 3 to be closed on opening of version 4.1.* & v5 branch

  Version 3 introduced output directory structures nad filenames more
  compatible with mobile devices and other non-web use and more
  internationalisation possibilities.

  In v3 SiSU markup files may be organised in language directories that are
  given their language code. There are alternative output directory structures
  depending on whether you want: the v2 layout (mostly in a directory of the
  given filename/a generic filetype name); a monolingual version 3 layout,
  which organises files by filetype/given file name; multilingual v3 layout,
  which organises files by language code/filetype/given

  (see notes at bottom of file, near EOF)

Reverse Chronological:

--- HEAD --- [closed]

* sisu_3.3.11.orig.tar.xz (2013-02-20:07/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.11

  * epub, add markup of angle brackets '<' & '>' to early markup of amp. '&'

  * vim, colorschemes, general housekeeping

  * b_epub.png, epub icon (for manifest) updated to use official image

* sisu_3.3.10.orig.tar.xz (2013-02-10:05/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.10

  * vim, minimal color schemes, minor edits

  * dbi_discrete, discreet should have been discrete, renames accordingly

  * lib, bin/sisu, misc, code headers provide url to online git file source
    * e.g. bin/sisu * Git
     <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
     <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=bin/sisu;hb=HEAD>

* sisu_3.3.9.orig.tar.xz (2013-02-06:05/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.9

  * utils (debug renamed), Utils::CodeMarker (from Debug::Mark)

* sisu_3.3.8.orig.tar.xz (2013-02-03:04/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.8

  * sysenv, on --redirect, stop creation of redundant dir

  * html, includes book index fix, rest cosmetic

  * css (html & epub) line spacing reduced, paragraph spacing increased
    * may need to tune spacing further to distinguish lines from new paragraphs
      (especially where ocn is not used as the distinction may be less
      clear/obvious) [sync with v4]

* sisu_3.3.7.orig.tar.xz (2013-01-31:04/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.7

  * dal, on ocn excluded paragraphs (~# -#), hang/indent bullet, fix
    [bug reported indirectly by Cory Doctorow (discovered in work with markup)]

  * dal (obj), html, br_page* behavior in html depending on origin of break
    (markup specified v auto)

* sisu_3.3.6.orig.tar.xz (2013-01-27:03/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.6

  * epub some fixing, more documents render in more readers/viewers
    * ncx fix, navpoint_close

  * remove markup-sample of the first edition of FaiF as redundant, the
    markup for the second edition being available (& partly in response to
    Bug#698664 which leads me to think about it), removed:
    free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
    associated skin and associated images

* sisu_3.3.5.orig.tar.xz (2013-01-23:03/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.5

  * epub
    * remove unnecessary conversion of some utf-8 characters to xhtml
      representation; fix as messed up table of contents, toc.ncx
      (e.g. in calibre) [bug reported by Mikael Böök]
    * provide full depth epub table of contents [request Mikael Böök]
    * cosmetic arrangement of code <<-WOK
    * xhtml structure error, fix missing </div>
      [bug reported by Mikael Böök] (fix of additional detail)

  * html
    * remove unnecessary conversion of some utf-8 characters to html
      representation

  * texpdf_format
    * list of .sty files (and their texlive source within Debian)
      [not part of code]

  * param, match possible sisu version, detail

* sisu_3.3.4.orig.tar.xz (2013-01-01:00/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.4

  * html_segments (by_filename by_filetype) internal document links do not
    work filenames need to include lang code, fixed
    [chals on irc, re live-manual, debian-live]

  * plaintext, in code blocks retain a blank empty line, a fix
    [known old bug, affects sisu_manual, fix request from SynrG on irc, re
    live-manual]

  * manpage, attempt to improve output (line-spacing)

  * param, minor change any legacy <br> line break in metadata markup to \\

  * debug (internal code use), color markers for line number & file name
    (colored location markers to show when line passed within running code)

* sisu_3.3.3.orig.tar.xz (2012-10-03:40/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.3

  * cosmetic, code
    * true ? x : y
    * if, else, remove some semicolons (;) replace with newlines
    * if true ; x, remove semicolons replace with "then"
    * .is_a?(X) replaces .class==X (& for some defined? and nil? tests)
    * remove javascript holders js_ (not used)

  * some fixes, cleaning, removing

  * sisu -v, provide version information, fix

  * options, opt_act, limit calls
    ruby profiler indicates much time spent here, reduce

  * constants, year static (current): YEAR=2012

  * bin/sisu, hub, reorganize call

  * dbi, pgsql, report need for instructions when none given, rather than
    fail silently

  * some pre-unicode meddling sorted
    (covers bug reported as middle dot changed to asterisk by chals)

  * sisupod source, paths fix

  * odf, internal links/bookmarks, toc, book index

  * pdflatex, fixes
    * landscape cover page was botched, came out as portrait

  * pdf, fix
    * group text, bullet
    * group text, hardspaces at start of line (indent)
    * group text, pass through special characters safe
    * poem, bold etc.

  * html, epub, fix
    * group text, bullet

  * header @classify: :topic_register: provide greater classification "depth"
    * param, manifest
    * harvest_topics

  * dal, sysenv
    * markup file processing, change to sourcefile readlines & split of
      sourcefile array
    * removal of RUBY_VERSION references to older versions of ruby

  * dal_syntax, new syntax: =\\= page new & -\\- page break
    alias for <:pn> and <:pb> respectively

  * db
    * introduce book_idx
    * minor re-arranging

  * cgi search script, minor

  * vim syntax sisu.vim, =\\= page new & -\\- page break

  * markup samples, and help, minor updates

  * vim ftplugin sisu.vim
    * linenumbering: on; relative; off, <leader>nn
    * cursor line & column: on; off, <leader>cu (existing cu+ & cu-)

* sisu_3.3.2.orig.tar.xz (2012-06-30:26/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.2

  * texpdf, xetex screen reporting of warnings off unless sisu -pV used

* sisu_3.3.1.orig.tar.xz (2012-06-23:25/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.1

  * texpdf_format, urls in headings break pdf documents, fix
    (e.g. output generation of document sample gpl.fsf.sst pdf fixed)

  * sysenv, rsync put (post to remote site), fix, needs comprehensive check
    (broken since version 3 (did not cope with alternative output structures),
    start to fix; still broken: rsync get (sisu source); also scp put & get)

  * hub, some re-arrangement

* sisu_3.3.0.orig.tar.xz (2012-06-17:24/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.0

  * shared_sisupod_source, common build for sisu (markup) source representations
    to be used by sisupod.txz, git, (and src)
    * sisupod_make (--sisupod)
    * share_source (--source)
    NOTE not used git at present
    * changed representation of shared sisu source, include related files in
      directory rather than just markup file [reason for version bump]
    NOTE there are no changes to sisu markup (only the sharing of source files)

* sisu_3.2.12.orig.tar.xz (2012-06-06:23/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.12

  * hub, post bundles
    * sisupod_make, file selection selection for tar.xz, fix

  * dbi_discreet, screen reporting db location, fix

  * shared_images, fix

  * excludes --exc-html-
    * html (toc & scroll), (html_segments, concordance,) exclude top band, touch
        sisu --exc-top-band --html --concordance filename.sst
    * html_segments, @make.build.html_navigation? fix

  * sysenv, check @md.make.respond_to?(:skin)

  * screen reporting, ansi colors, cosmetic

  * Rake, Rant installer sisu installer require ruby >= 1.9.3

* sisu_3.2.11.orig.tar.xz (2012-06-03:22/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.11

  * images, regular & sisupod
    * shared_images, --html, --xhtml, --xml*
    * sisupod images done: --html including skin images; --epub; --odf; --pdf
    * copy (system link removed)

  * manifest, paths, (for command line selection of output type) fix

  * urls, sisupod, fix

  * warn when files to be copied not found, add

  * error & warning messages touched, revisit

* sisu_3.2.10.orig.tar.xz (2012-05-28:22/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.10

  * hub
    * "requires", fix
    * manifest re-run where related multilingual documents, fix
      BUG breaks mini table of contents (minitoc) manifest for multilingual
      files, better run without manifest minitoc, use --exc-manifest-minitoc
    * share markup source (--source) not available at this time for composite
      files (.ssm), suggest creating a sisupod instead

  * options, --init-site, --configure, fix

  * code headers, mostly copyright

  * options, command line control of output directory structure
    --output-by-language; --output-by-filetype; --output-by-filename, or
    --by-language; --by-filetype; --by-filename
    * documentation update sisu_commands.ssi, manpage sisu.1, man2html

  * css, ensure css available for generated content (without need for
    --init-site / --configure), checks whether exists if not copies (for
    --init-site / --configure just copies, takes as a re-copy request)

  * sisupod.txz processing
    BUG image copying/processing for sisupod

  * html_format, minor cleaning

  BUGS
    * broken mini table of contents (minitoc) manifest for multilingual files,
      better run without use --exc-manifest-minitoc
    * sisupood image copying/processing, broken

* sisu_3.2.9.orig.tar.xz (2012-05-19:20/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.9

  * harvest
    * harvest by filename output paths
    * harvest_topics, add level
    * harvest_topics, alternative headings, fix

  * options, create manifest touched

* sisu_3.2.8.orig.tar.xz (2012-05-12:19/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.8

  * sisupod make, re-fixed, check again

  * hub, fixes, still a construction zone

  * po4a, runs, needs checking

  * misc fixes
    * options, omissions and typo fix
    * particulars, fix, check
    * shared_metadata, fix

  * sst_identify_markup, introduce document header SiSU 3.0,
    pretty much the same as 2.0

  * reporting
    * composite file names touched
    * rescue & error warnings, more touched

* sisu_3.2.7.orig.tar.xz (2012-05-06:18/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.7

  * hub, options, fixes
    * dbi: pgsql, sqlite

  * qrcode, fixes
    * ensure manifest is run
    * urls fix

  * rescue & error warnings, some touched

* sisu_3.2.6.orig.tar.xz (2012-05-01:18/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.6

  * harvest (metadata, site/document summary) fixes
    * harvest_topics, sort fix
    * harvest_authors, minor fix
    * sst content parsing lang dir
    * output file location, currently works for (by?) :language & :filetype

  * hub (seek finer grained control over what happens when; causes breakage)
    * (primarily) cycle files then options (instead of options then files)
    * manifest re-run on (currently generated) translated files if any

* sisu_3.2.5.orig.tar.xz (2012-04-22:16/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.5

  * shared_html_lite, codeblock fix, affecting sql:
    SELECT ocn,body FROM doc_objects WHERE t_is='code';
    SELECT ocn,clean FROM doc_objects;

* sisu_3.2.4.orig.tar.xz (2012-04-21:16/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.4

  * db bugfix in maintenance mode (variable name reused)

  * sysenv, default processing dir name change
    * distinguish sisu branch, add sisu branch to processing directory name
    * if constants, 'DEVELOPER[:maintenance] == :true' then additionally add
      sisu version number to processing directory name

  * rescue reporting

* sisu_3.2.3.orig.tar.xz (2012-04-15:15/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.3

  * param, dal_syntax, document header (simple regex) substitution list
    added, note $ and curly braces are escaped to allow the following:
    @make:\n :substitute: /${linux-distro}/,'Debian' /${stable}/,'Squeeze' \
    /${testing}/,'Wheezy'
    changes are not made within text object types: code-blocks, tables or
    metadata (document headers). Marked up document remains self-referential.
    Note: the substitution list must be written on a single line, without
    line-breaks.
    [Substitutions possibility requested by Debian-live, live-manual (Ben
    Armstrong & Daniel Baumann)]

  * vim syntax highlighting, document header added :substitute: (under
    @make:)

* sisu_3.2.2.orig.tar.xz (2012-04-05:14/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.2

  * reporting
    * urls
    * sql creation -v reporting reduced (to better suit use of
      sqlite_discreet with other output types) for more use -V or -M

  * sysenv, path.style (a quick fix, review)

* sisu_3.2.1.orig.tar.xz (2012-03-21:12/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.1

  * documentation sisu_commands, rearranged; update with regard to
    excludes; & discreet sqlite output
    * manpage
    * html (man2html)

  * COPYRIGHT add markup samples "Free as in Freedom"

* sisu_3.2.0.orig.tar.xz (2012-03-19:12/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.0

  * start 3.2: merge v3dv (3.2) into v3 (3.1)
    * conf/sisu/v3dv --> conf/sisu/v3
    * data/sisu/v3dv --> data/sisu/v3
    * lib/sisu/v3dv  --> lib/sisu/v3
    * bin/sisu* (change v3dv references to v3)

  * COPYRIGHT, format changed, influenced by Machine-readable debian/copyright
    file <http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/>

* sisu_3.1.15.orig.tar.xz (2012-03-12:11/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.15

  * v3dv: sysenv, ProcessingSettings, start to use hooks to make it possible to
    control (via: the command line; the document markup header, or; the
    configuration file) the likes of: ocn, toc, segsubtoc, minitoc,
    links-to-manifest, search-form, html-navigation, html-navigation-bar,
    html-right-pane, html-top-band; these are switched on by default and may be
    switched off in omit lists within configuration file, the document markup
    header, or command line. The command line takes precedence & may switch on
    or off overriding settings within the document markup header or the sisu
    configuration file.
    * --inc- on by default, but if switched off in doc header or configuration,
      the command line --inc- has precedence; for each possible exclude
      configuration the --inc- switch that overrides configuration settings
    * --exc- == --no-; exclude/switch off feature (but --inc- include has
      precedence)
    * document header @build: :omit: [list output features to be omitted]
    * configuration (sisurc.yml) omit:
    exclude output feature, overrides configuration settings (omit --dev
    development branch modifier once merged back to main)
     --exc-ocn,                 html (seg, scroll), epub, xml, pdf
       sisu --dev --exc-ocn --html --epub --xml-sax --xml-dom --xhtml -v filename.sst
     --exc-toc,                 html (scroll), epub, pdf
       sisu --dev --exc-toc --html --epub --pdf -v filename.sst
     --exc-segsubtoc            html (seg), epub
       sisu --dev --exc-segsubtoc --html --epub -v filename.sst
     --exc-minitoc,             html (seg), concordance, manifest
       sisu --dev --exc-minitoc --html --concordance -v filename.sst
     --exc-manifest-minitoc,    manifest
       sisu --dev --exc-manifest-minitoc --html -v filename.sst
     --exc-links_to_manifest, --exc-manifest-links,
                                html (seg, scroll)
       sisu --dev --exc-manifest-links --html -v filename.sst
     --exc-search-form,         html (seg, scroll), manifest
       sisu --dev --exc-search-form --html -v filename.sst
     --exc-html-minitoc,        html (seg), concordance
       sisu --dev --exc-html-minitoc --html --concordance -v filename.sst
     --exc-html-navigation,     html (seg, scroll)?
       sisu --dev --exc-html-navigation --html -v filename.sst
     --exc-html-navigation-bar, html (seg)
       sisu --dev --exc-html-navigation-bar --html -v filename.sst
     --exc-html-search-form,    html (seg, scroll)
       sisu --dev --exc-html-search-form --html -v filename.sst
     --exc-html-right-pane,     html (seg, scroll)
       sisu --dev --exc-html-right-pane --html -v filename.sst
     --exc-html-top-band,       html (seg, scroll), concordance
                                (minitoc is forced on to provide seg navigation)
       sisu --dev --exc-html-top-band --html --concordance -v filename.sst

  * v3dv, vim syntax highlighting, document header added :omit: (under @make:)
    for document output features to be omitted if any

  * v3dv, documentation sisu_commands, rearranged; update with regard to
    excludes; & discreet sqlite output

  * v3dv, sqlite3 discreet .sql.db file for each document (in addition to
    existing possibility of a shared db in sqlite3 or postgresql)

  * texinfo, fix (break holding back 3.2 merge)
    [proposed next version starts 3.2, (merge dev branch after 3.1.15)]

* sisu_3.1.14.orig.tar.xz (2012-02-14:07/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.14

  * v3dv: sysenv, output_dir_structure, rewritten, affected code modified

  * v3dv: --redirect (--redirect=dir_path) & --dump (--dump=dir_path)
    * --dump places output in directory specified, if none specified in the
      current directory (pwd).
    * --redirect places output in subdirectory under specified directory,
      subdirectory uses the filename (without the suffix). If no output
      directory is specified places the subdirectory under the current directory
      (pwd).
    * html, css incorporated into each file (concordance & manifest included)
    * html, xhtml & xmls, css copied into css subdirectory (not used by html as
      embedded)
    * html xmls, images copied to output directory
    * no links to manifest
    * manifest with relative links only
    * longer html filenames given to avoid names clashing (e.g. for toc,
      manifest, concordance)

  * v3dv: html, epub, remove manifest toc links

  * v3dv: -j copy images associated with file (images used by html & xmls)
    * automatically invoked by --dump & redirect

  * v3dv: dal, remove sisu_manifest from document structure & toc (metadata
    retained (provide link to sisu_manifest)), html & epub coding affected

  * v3dv: hooks to make it possible to control (via: the command line; the
    document markup header, or; the command line) the likes of: toc, manifest,
    manifest-links, metadata, html-minitoc, html-navigation, html-navigation-bar;
    these are switched on by default and control takes the form of making it
    possible to switch them off.

  * v3 v3dv: document --redirect, --dump, -j update sisu_commands.sst
    [documents not generated until v3.2.0 (when v3dv branch is merged into v3)]

* sisu_3.1.13.orig.tar.xz (2012-02-03:05/5)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.13

  * v3 v3dv, path & url links, updates for multi output directory structure
    possibilities (fixes)

  * v3dv, dal (& code affected as a result), use symbols to identify document
    objects type (is) and group (of)

  * v3dv, epub, html, some cleaning of redundancy

  * v3dv, texinfo BROKEN, since 3.1.12 at least

  * v3 v3dv, vim syntax highlighting, patch from Thilo Six <T.Six@gmx.de> applied
    Re: <http://thread.gmane.org/gmane.editors.vim.devel/32151> &
    <http://vimdoc.sourceforge.net/htmldoc/options.html#cpo-l>

* sisu_3.1.12.orig.tar.xz (2012-01-23:04/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.12

  * texpdf, tampering with "safe" special character transformations, a fix (that
    may introduce new issues, watch) [in response to report of a pdf title bug
    "&" not represented, Timothy Hume]

  * urls, odt maintenance path fix

  * v3dv, messing with code, merge back likely to become v3.2
    * call most methods by full name (include associated module & class names)
    * replace most ruby exclamation (!) method actions

  * v3dv, sysenv, use "which" instead of "whereis" to locate programs, test
    [suggested by, Timothy Hume, used to get sisu texpdf to work on MacOS]

* sisu_3.1.11.orig.tar.xz (2012-01-10:02/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.11

  * date, year 2012, update

  * v3dv, add dev branch, make some changes to module & class names & test
    * short term branch, merge back into v3 once tested
    * sisu --dev (to invoke)
    * module names, use more CamelCase
    * class names,
      * use more CamelCase
      * remove "SiSU_" (reserve for module names for consistency)

  * modify.rb, prep script for year update, & changing module & class names

* sisu_3.1.10.orig.tar.xz (2011-12-31:52/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.10

  * html, epub, (& xml) codeblocks, treatment of '<<' & '>>', fix
    (codeblock, remove legacy match rule, watch)

* sisu_3.1.9.orig.tar.xz (2011-12-19:51/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.9

  * manually created html files in _sisu/home (*.html) copied as home pages
    (previous behavior was only to copy _sisu/home/index.html)

  * html, seg output, index.html fixes
    * place in correct directory and use language code as appropriate
    * remove broken index.html from output [note the existing erroneous file
      is not removed by a program run, it has to be removed manually]

  * options, behavior of --find & --glob, can only be used on base directory
    level, (it is not possible to limit the glob to say en/... or fr/...), for
    now prints a message that sub-directories may not be provided for --find or
    --glob at this time

* sisu_3.1.8.orig.tar.xz (2011-12-13:50/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.8

  * texpdf, output by filetype, fix, produce pdf files with language code as
    part of filename (previously written over)

  * odf:odt, codeblocks, a match fix, affects e.g. "<<"

* sisu_3.1.7.orig.tar.xz (2011-12-08:49/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.7

  * dal, codeblocks
    * internal document identifier tags removed, consider
    * markup of greater than & less than, fix (but watch)

  * epub, css, codeblock, grey box

  * texpdf, use package listings for box around codeblocks (retain boites
    option)

  * sysenv, external images directory copied only if it exists

  * documentation, add --configure & use ascii characters for dir tree
    correction of a few typos
    * manpage
    * html

* sisu_3.1.6.orig.tar.xz (2011-12-02:48/5)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.6

  * dal, codeblocks, start flush left (no buffer spaces at start of line) to
    allow cut & paste [requested by chals irc.oftc] (fixed issue, numbering of
    (flush left) codeblocks; preliminary tests suggest this should be ok), need
    distinguishing marks for plaintext (& fix grey background in xetex/pdfs)

  * texpdf, use boites for box around codeblocks, use and adapt 'boitecoloriee'
    (found in boites_examples.sty)
    * in boitebox as setup normal tex hardspaces at start of line are removed,
      hack required to fix
    * [attempt to reconfigure boitebox: as setup normal tex hardspaces at start
      of line are removed;backround color not set (incompatible);keep box once
      background color is set?;remove first line indent of paragraph?]

  * require iconv (depreciated), use String#encode instead
    * removed iconv, required a number of places without being used, watch

* sisu_3.1.5.orig.tar.xz (2011-11-21:47/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.5

  * images, embedded symbol (previously overlooked, pre use of utf-8)
    * param, sisu markup image regex match
    * sisupod, sisu markup image regex match

  * odf v1.2
    * includes previously unimplemented hanging indents

  * hanging indent
    * done: dal, plaintext, html, epub, xhtml, xml (sax & dom), odt, pdf, sql;
      not done: man, info

  * dal_expand_insertions, link shortcut for multiple versions of sisu document,
    omit codeblocks

  * sisu manual, sisu markup, include example of: link shortcut for multiple
    versions of a sisu document in the same directory tree

* sisu_3.1.4.orig.tar.xz (2011-11-11:45/5)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.4

  * FileUtils, make more consistent (and explicit) use of
    * explicit calls (more verbose, easier to find)
    * replace system calls

* sisu_3.1.3.orig.tar.xz (2011-11-05:44/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.3

  * header, @make: :bold: :italic: fix necessary, Re (3.1.2): (bold & italic
    pattern matching) possibility to ignore case (reinstated)

* sisu_3.1.2.orig.tar.xz (2011-10-31:44/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.2

  * sysenv, skins, a fix
    [return to, identify sisupod more definitively]

  * header, @make: :bold: :italic: (bold & italic pattern matching) possibility
    to ignore case (reinstated)

  * markup-samples, Free as in Freedom 2.0
    * made use of old book index, better than none

  * concordance, information to terminal, minor

  * conf/convert/modify.rb minor fixes

* sisu_3.1.1.orig.tar.xz (2011-10-15:41/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.1

  * odf:odt v1.0
    * make odt header changes easier to track
    * get rid of (binary changeset) blob
    * make odt style names more easily recognizable

  * manifest, odt url lnk, fix

* sisu_3.1.0.orig.tar.xz (2011-10-03:40/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.0

  * bin/sisu, default sisu version 3

  * sysenv, rc_path adds ./.sisu/ (to existing ./_sisu/ & ~/.sisu/)

  * defaults, (sisu) home page
    * link to git repo
    * minor fixes

  * sysenv, output_structure_by: filename, fix to output directories created

  * texpdf, fonts, Liberation series default (Sans for main)
    * (mono) improved with selection of Liberation Mono as default
    * font (main font, mono) configurable in sisurc.yml under
      default: (texpdf_font:|texpdf_font_mono:)
      or within document under @make: (:texpdf_font:|:texpdf_font_mono:)

  * sisrc.yml, texpdf_font (main, mono) Liberation series (main default Sans)

  * vim syntax, :texpdf_font_mono: added to @make:

  * documentation, small update
    * sisu source
    * manpage
    * man2html html

* sisu_3.0.19.orig.tar.xz (2011-09-24:38/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.19

  * hub, processing options, remove cruft

  * qrcode, sisu generated manifest output, treat as such
    * place qrcode images in directory under manifest (manifest/qrcode)
    * fix remote placement of qrcode images when requested

  * texinfo, fix output

  * remote
    * rsync, include manpage, info file (when selected)
    * rsync, images, (html, xmls) only include images related to document
    * src & sisupod processing

  * sisupod processing

  * param, matching of date, years 1400 - 21\d\d

* sisu_3.0.18.orig.tar.xz (2011-01-13:37/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.18

  * options
    * match fix for --glob / --find
    * action (opt.act) modified to increase use possibilities
      (currently affects hub)

  * hub
    * opt.act modifications
    * sisupod processing (v2 processing also enabled)

  * epub
    * fix for different output structures, language codes not used
      internally (within epub)
    * adjustment to image paths for image copy

  * correct sisupod references and path to .txz (replace .zip)

  * image (relative) paths for different sisu output structures
    (re: by_language, by_filetype, by_filename)
    * sysenv, set path
    * html seg, scroll, manifest (qrcodes), xmls

  * dal_images, disabled imagemagick configuration permission check until
    sisupod reads local sisurc.yml (configuration file)

  * correct .orig.tar.xz name in CHANGELOG_v3 (>=3.0.15)

* sisu_3.0.17.orig.tar.xz (2011-01-05:36/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.17

  * sisupod v3
    * modify pod dir structure, place sisu source in dir/[lang_code]/ e.g. dir/en/
    * use tar.xz (.txz)
    * bundle all language version in pod
      * bundle .ssm and all included files for each selected language (rather
        than composited .ssm.sst file)
      * [DO] prioritize and warn where duplicate files in directory
      * [DO] ideally, allow selection those files selected in command line using -G
        (filename pattern) or named in files to be processed string
    * remote placement
    * sisu processing from sisupod v3
    * [DO] sisu processing from sisupod v2 (retain possibility)

  * rsync sisupod v3

  * sysenv, check that tree is available and use as desired when available

  * unix conditional tests ? : remove line break marker at end of line before
    :, cosmetic

  * Dir.chdir, remove "system cd" (change directory) use Dir.chdir

* sisu_3.0.16.orig.tar.xz (2011-08-18:33/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.16

  * epub tuning
    * include levels A - C as individual sections
      (xhtml file with consistent opf & ncx)
    * sync ncx with sisu internal structural logic
      (correct depth, include level A, place sisu toc)

  * dal, sisu document links (multiple output versions) shortcut, fix
    * links to multiple versions internal documents based on shortcut notation,
      e.g.
      { "Viral Spiral", David Bollier [3sS]}viral_spiral.david_bollier.sst
      resulting in all versions of the document that would be generated by
      running the command sisu3 -3sS viral_spiral.david_bollier.sst
    * added possibility to specify language where language directory structure
      is used for source documents
      { "Viral Spiral", David Bollier [3sS]}en/viral_spiral.david_bollier.sst

  * concordance, i18n, start adding alternative language alphabets
    (Danish, Norwegian, Swedish)

* sisu_3.0.15.orig.tar.xz (2011-08-08:32/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.15

  * switched sisu tarball compression to xz (from gz)

  * options, default action on running "sisu3 [filename.sst]", fix

  * sysenv, options, sisurc.yml base directory (default) language setting

  * po4a, make use of base directory (default) language setting
    (for setting original language, (instead of assuming English))

  * prog_text_translation, add contents, remove some repetition

  * texpdf, possibility to translate "Contents" for table of contents

  * epub, experiment with presentation
    * disable some internal "features"
    * make file and directory naming more flexible, now using
      'OEBPS', 'toc.ncx', 'content.opf',
    * adjustment of some headers and general tuning
    * add opf guide
    * clean processing directory between each build

  * constants
    * added constants Ep (for epub)
    * added DISABLE (used here with epub)
    * re-arranged

  * objects.txt, removed, cleaning

* sisu_3.0.14.orig.tar.gz (2011-07-26:30/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.14

  * hanging indent partially implemented, added markup possibilities

    __[1-9] hanging indent (initial indent 0); paragraph text indent [1-9]

    _[0-9]?_[1-9] initial indent; paragraph text indent

    * done: dal, plaintext, css, html, epub, xhtml, xml sax, xml dom, pdf, sql;
      not done: odf, man, info
      check: po4a, html_lite (used in sql search results)
    * syntax highlighting done: vim (sisu.vim), emacs (sisu-mode.el)

  * indent added bold words markup syntax (_[1-9]!) (_[0-9]?_[1-9]!)
    for indents

    __[1-9]! bold words
    part of hanging indent paragraph text

    __[1-9]! bold words \\ part of hanging indent paragraph text

  * param, manifest, qrcode, epub, added creator.editor field

  * sql db, constants, cgi-sql, structure changed, creator editor field added

  * sisu_manual, manpage, manpage html (man2html)
    * sisu_commands: --qrcode -Q; update shortcut options; line-breaks use \\
    * sisu_markup.sst: indent update; publisher

  * vim sisu syntax highlighting
    * markers for hanging indent added
    * added header for @creator: :editor:
    * minor comments added
    * deletion of an unused tag

  * emacs sisu-mode.el
    * markers for hanging indent added
    * line-break

  * qrcode, sysenv, manifest, generate & add QR code images of metadata to
    manifest (using qrencode) (consider where and how else to use images)

  * epub, opf fixes

  * sysenv, avoid creation of spurious directories in output tree
    (an image copy section removed, re-implement correctly later)

  * param, cleanup setting of auto endnotes

  * texpdf, XeTeX language settings ((setmainlanguage setotherlanguage) from
    directory or filename) if @make: :language: header not set

  * xmls (sax, dom, xhtml) use of xml tidy, correct output file location

  * urls, --concordance

* sisu_3.0.13.orig.tar.gz (2011-06-26:25/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.13

  * dal_syntax, linebreak within regular objects is \\ (<br> depreciated)
    [test, affects downstream outputs, there is the potential for breakage]
    [thanks to Jonas Stein for making me look at this, see  bug: #617298, <br>
    was not documented because there has been no intention to keep it, but
    there was no markup replacement until now]
    * ok for plaintext, html, xhtml, xml, epub, pdf, manpage
    * not properly honored in paragraph objects for odt [todo fix, but issue]

  * sisurc.yml, config settings

  * vim
    * sisu syntax highlighting, linebreak \\ added (<br> kept)
    * colors, added cursor line & column

  * documentation, on additional breaks in document
    * linebreak \\ (previously undocumented <br> kept but depreciated)
      [it is intended that this should close #617298]
    * page break (breaks column if column, else breaks page)
    * page new (new page, breaks page)
    * removed section on hyperestraier, too specialised for general manpage
      (also section not checked recently)

  * texpdf
    * define latex \newcommands for some special characters to simplify
      dealing with them in sisu code \hardspace \caret \pipe \curlyopen
      \curlyclose \lt \gt \slash \backslash \underscore \exclaim
    * provide backslash character in code block

  * plaintext, codeblock keep backslashes

  * html_tune revision
    * deal with angle brackets in markup (test, could cause breakage)
    * reduce loops

  * manpage
    * start to honor line-breaks within objects (revisit)
    * show double escape \\ (backslashes) in code blocks
    * place under web server directory

  * texinfo
    * backslashes & line-breaks
    * place under web server directory
    * info tool setting prompt

  * shared source markup (.sst .ssm & sisupod.zip)

  * manifest enable
    * manpage (in fututure have config setting with default false/off)
    * info (texinfo) (in fututure have config setting with default false/off)
    * hash digests
    * locate markup source
    * sisupod

  * urls (ansi screen reporting), add document language code

  * sysenv, accommodate
    * manifest
    * manpage
    * info (texinfo)
    * sisupod
    * shared source markup (.sst .ssm & sisupod.zip) fix some paths
      * placement of markup source, output_path.src.dir, fix
      * output_path.src.url, fix

  * constants, a sisupod & an xml related addition

  * ansi screen reporting include document language code

* sisu_3.0.12.orig.tar.gz (2011-06-09:23/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.12

  * harvest
    * correct paths to document manifests etc. for the possible output dir
      structures
    * produce authors and topics lists for the documents that are available,
      according to availability in each language

  * cgi generated sample search form
    * use ruby 1.9.2 shebang/header (sisu-pgsql, sisu-sqlite) recent upload
      of libdbi-ruby1.9.1 fixes bug reported as #596103 (against
      libdbd-pg-ruby1.9.1), search forms (pgsql & sqlite) can now use ruby
      1.9.2, so cgi headers changed back to #!/usr/bin/env ruby [however must
      use ruby >=1.9.2] (from #!/usr/bin/ruby1.8) [see sisu-3.0.8 NOTE &
      "sample search form" solution, (now superseded)]
    * force utf-8 character encoding to avoid issues, fix
      (incompatible character encodings: UTF-8 and US-ASCII)
    * correction of a variable name, fix

  * options
    * restrict glob rule checks to when --glob (-G) or --find (-f) requested
    * carry information on document language (from filename and or directory
    * (additional test)

  * sysenv, limit/prevent the creation of spurious output directories (based on
    language subdirectories), revisit

  * manifest, fix a full name

  * html, index.html syslink, remove and remake syslink
  * texpdf, index.html syslink, made similar

  * param, remove unused class variable '@@symlnk'

  * help
    * --help language, provides list of available languages (ISO 639-1 code (as
      varied by po4a) & name)
    * s/Bul garian/Bulgarian/ (Closes: #619068)

* sisu_3.0.11.orig.tar.gz (2011-05-29:21/7)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.11

  * sysenv, url webserver link (manifest) fix

  * cgi search form, fixes related to language code
    (filename with language code being required as unique document identifier)

  * options
    * filter out files not matching .ss[tm]
    * with -f -G (--find|--glob) flag glob all .ss[tm] files in dir including
      language sub-directories (e.g. in directory above language
      sub-directories where ./_sisu/sisurc.yml should be located:)
        sisu3 -3G live-manual
    * with -f (--find|--glob) flag and find .ss[tm] files that match given
      string in dir including language subdirectories
        sisu3 -3GR

  * i18n, constants, some language information moved to i18n (from constants)

  * documentation, minor update, includes --find / --glob

* sisu_3.0.10.orig.tar.gz (2011-05-23:21/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.10

  * copyright (minor) touch, dates for setup.rb

  * sysenv, rsync, embedded
    * rsync to remote host alternative output structures, fix
      (remove blocking test path)
    * get rid of annoying new nag to terminal (-v reporting
      Dir.pwd), prevent attempt to change directory unless different directory
      requested

  * param, html, epub, xml, simplify file-naming convention with language code
    (language code occurs in fixed location within file-name, could previously
    be configured to occur in 1 of 3 locations within file-name)

  * texpdf filenames

  * i18n, add language name translation column to hash/table

  * prog_text_translation:
    * fix to Portuguese language class name (missed the 't')
    * language name matching ('Portuguese Brazil')
    * indentation

  * options, include markup source "base" path, used to parse alternative
    markup source dir structures

  * manifest
    * relative paths to "available outputs" (for each dir structure), fix
    * show language versions published
      (needs 2 runs of manifest, polls output as to whether manifest files exist)

  * html
    * close files
    * syslink index.html to toc.html, needs revisit
      (will only "work" properly with by_language directory structure)

  * defaults, fix path to homepage image (more fixes remain ...)

* sisu_3.0.9.orig.tar.gz (2011-05-17:20/2)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.9

  * bin/sisu2 introduced (to complement bin/sisu3), currently same as bin/sisu
    (later switch bin/sisu to bin/sisu3; consider using update-alternatives)

  * vim, cterm colorschemes, touch search color

  * copyright file, softlink, make more visible in tarball and update
    * sisu-mode.el assigned to FSF (GNU EMACS)

  * options, expand name of file for selected language directories
    * only use for single file(name) available in multiple languages e.g.
      sisu3 -hv en/free_culture.lawrence_lessig.sst es fr
    * english assumed as default language, make default configurable later
    * particularly useful for po4a

  * sysenv
    * output directory structure check, fix & start testing alternatives
      sisurc.yml output_by: (language|filetype|filename)
    * output paths restructured, to have dir, url rel(ative) & rcp (for rsync or scp)
      * url paths to output files (requires setup in sisurc.yml)
      * consolidated output paths, directory & url, affecting many files

  * rsync of output must cope with alternative file structures

  * scp, disable until looked at

  * dal_expand_insertions, fix resulting urls for shortcut for sisu generated
    document in same output directory

  * cgi sample search form generated to provide different links depending on
    output structure, now links only to manifest and html toc

  * manifest, url path, fix

  * po4a, re-enabled, numerous issues

* sisu_3.0.8.orig.tar.gz (2011-05-05:18/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.8

  * bin/sisu3 bin/sisu /bin/sisu_webrick bin/sisu_termsheet
    * improved ruby version check

  * options, language setting, based on directory structure or filename
    * sysenv, language setting from options
    * affects multiple libraries

  * i18n, sysenv, options, language setting changes affecting many files
    * must be able to set language at options stage from filename or directory

  * prog_text_translation, renamed from what was i18n, i18n name reused

  * db, directory structure changed, database prefix renamed
    * language_document_char field made larger
      [consider renaming language_document_code or ..._id]
    * title, src_filename and language_document_char fields mandatory
      (title, title_main, src_filename, language_document_char)

  * NOTE: [libdbi-ruby1.9.1 fixed in unstable 2011-06-06, & for sisu-3.0.12]
    cgi sample search form caught by Ruby/DBI libdbi-ruby1.9.1 reported
    reported as libdbd-pg-ruby1.9.1 bug #596103, where "select_all fails". The
    cgi sample search scripts for postgresql and sqlite3 are almost identical,
    both work in ruby 1.8.7, both have the same error in ruby 1.9.2... a very
    similar bug is reported about the mysql library. Should #596103 and the
    upstream report be reported against Ruby/DBI (libdbi-ruby1.9.1) rather than
    libdbd-pg-ruby1.9.1?
    * <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596103>
    * <http://rubyforge.org/tracker/index.php?func=detail&aid=28624&group_id=234&atid=967>
    * <http://rubyforge.org/forum/forum.php?set=custom&forum_id=958&style=nested&max_rows=25&submit=Change+View>
    fix/workaround options include:
    * await bugfix, (bug has existed at least since 2010-09)
    * rewrite for ruby-dbi using other constructs
      e.g. s.fetch {|row| ...}
    * revert to ruby 1.8.7 for the cgi script (they work independently of the
      rest of the program anyway)
    * rewrite for individual database dbi re: psql  and sqlite3
    * await rdbi (ruby-dbi replacement), also needs to be packaged for Debian
      <rdbi https://github.com/RDBI/rdbi>
      <http://rdbi.hollensbe.org/>
      <http://rdbi.hollensbe.org/files/README_rdoc.html>
      and develop for that
    * use some other programming language for sample search form
      or some meaningful combination of any of the above.

  * sample search form, revert to generating ruby 1.8.7 sample
    * sisu3 using ruby >=1.9.2p180 generates search form for ruby 1.8.7, so:
      generate sample form using sisu3 -F (options), then; start webrick using
      ruby 1.8.7 & sisu -W (not sisu3)
    * take account of alternative output directory structures [work on, test]

  * manpage, reinstate escape of hyphens (clearly preferred, else lintian
    reports hyphen-used-as-minus-sign)

  * manpages, escaped hyphens reinstated (remove lintian info)

  * urls, a fix, sqlite

  * sysenv, lowriter (instead of libreoffice)

  * db_select, ansi screen reporting, correction for sqlite db update

  * concordance, output path, screen info correction

  * vim
    * sisu syntax change of a couple of color groups (Delimiter instead of
      Include)
    * 8 color cterm colorschemes
      * sparse series uses dark grey on black, usually looks better, but only
        works with a fixed color cursor, preferred in terms where you can get
        away with using it
      * frugal series avoids dark grey
      * slate for cterm now incorporates frugal-cterm-sisu
      * *-cterm-ruby & *-cterm-sisu colors adjusted where other color groupings are
        preferred for programming / sisu markup

* sisu_3.0.7.orig.tar.gz (2011-04-20:16/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.7

  * param, md remove md.cmd and md.mod shortcut methods, use use md.opt
    (md.opt.cmd md.opt.mod)
    * affects many files that now use @md.opt.cmd & @md.opt.mod
      (instead of @md.cmd & @md.mod)

  * options
    * new alias (for -M / --maintenance) --keep-processing-files (see Bug#622902)
    * introduce opt.act booleans made up of opt.cmd and opt.mod, more flexible
      than overused cmd characters
    * where possible move option setting from hub to options
    * separate out a few methods

  * odf:odt
    * maintenance, processing in separate subdirectories, that can be
      kept
    * odt.zip (bin) directory renamed odt from odf

  * hub
    * some option setting moved to options
    * favor use of opt.act over opt.cmd where appropriate

  * sysenv
    * variable directory path fixing (language, filetype, filname), making
      the stub for at least manifest and html available early for processing
      that do not or should not need to process individual markup files
      completely, such as the cgi search form and harvest
    * odf:odt paths adjusted for changes in maintenance and odt.zip

  * harvest
    * place with document manifests
    * variable directory path fixing (language, filetype, filname)

  * cgi, sample-search-form
    * results still not right, (ruby1.9.2 libraries? double check script)
    * not yet done variable directory path fixing for result links

  * vim colors colorscheme Slate reviewed, cterm 8 colors, & frugal added
    * Slate, review conflicting group colors
    * 8, cterm colors to work with
    * frugal, cterm colors ... my term oddly has 8 colors plus 242 for
      dark grey possibly more but odd numbers to set

  * sisu-mode.el header notes copyright assignment to FSF 2011-04-08
    (GNU EMACS)
    * url to sisu git repo source (when possible also track GNU EMACS location)

  * screen_text_color (ansi colors) touched, consider reviewing later

  * urls, report output locations
    * fix show all urls -U
    * share/reuse code
    * fix maintenance urls -M (where processing files are kept for examination)
    * odf maintenance added
    * html_tune maintenance fix

  * documentation, sisu-markup-samples, man page, html
    * document existence of new alias for -M (--maintenance)
      --keep-maintenance-files (see Bug#622902)

* sisu_3.0.6.orig.tar.gz (2011-03-30:13/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.6

  * (ruby 1.9.2 (transition related) fixes)
    * dal_doc_str
      * empty line not paragraph object
      * table structure issue, double spaced empty line creates spurious newline
    * dal_images, image path setting
    * cgi sample-search-form, string output (also cleaned unused help text)

  * sysenv, remove repeated method

  * vim colorscheme Slate, review console colors
    * change warning and diff colors, so as not to conflict
    * review cterm colors
    * for console use color names instead of numbers
    * rearrange

* sisu_3.0.5.orig.tar.gz (2011-03-24:12/4)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.5

  * move to ruby >=1.9.2p180: simplify development of v3 and maintenance of v2
    * bin/sisu demand ruby >=1.9.2p180 (version checks)
    * debian/control, dependencies
    [note should at least be v1.9.2p180, when issues in earlier versions of
     ruby-1.9.2 were first observed to be gone]

  * texpdf bugfix, where map_nametags not found, drop nametag (rather than
    crash)
    [Debian-live, live-manual (Ben Armstrong, chals?, reported new bug in a
    number of translations (that crashed the pdf generator). It turns out where
    map_nametags is not found the document crashes.]

  * vim syntax highlighting, fix typo

* sisu_3.0.4.orig.tar.gz (2011-03-11:10/5)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.4

  * move to ruby >=1.9.2p180: simplify development of v3 and maintenance of v2
    * bin/sisu demand ruby >=1.9.2p180 (version checks)
    * debian/control, dependencies
    [note should at least be v1.9.2p180, when issues in earlier versions of
     ruby-1.9.2 were first observed to be gone]

  * texpdf bugfix, where map_nametags not found, drop nametag (rather than
    crash)
    [Debian-live, live-manual (Ben Armstrong, chals?, reported new bug in a
    number of translations (that crashed the pdf generator). It turns out where
    map_nametags is not found the document crashes.]

  * vim syntax highlighting, fix typo

  * sisu_manual, sisu_download, remove references to versions of sisu

* sisu_3.0.3.orig.tar.gz (2011-03-11:10/5)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.3

  * dal_syntax and affected downstream output modules, revised pattern match
    for mail, (removes occasional interference with urls having embedded email
    addresses)

  * dal_syntax: (internal document) link matching, a fix

    [Debian-live, live-manual (Jose Luis Zabalza, Ben Armstrong, reported bug in
    Spanish translation markup (that crashed the pdf generator). Bug in markup
    subsequently identified as "versátil,#{iso-hybrid}#, se" which the interpreter
    identified as an internal document link to a comma (instead of as being
    monospace markup), markup should have been "versátil, #{iso-hybrid}#, se" this
    fix prevents that incorrect match, (but the markup remains faulty and the
    monospace markup is not identified as such without the corrected spacing).
    Unfortunate "grave" results for what is a pretty insignificant data entry
    typo (there are no doubt other such situations).]

  * dal_substitutions_and_insertions: regex for sisu header matching (in sisu
    markup code blocks), a fix

  * dal_doc_str: fix, looks like typo in regex

  * param: tidy, remove redundant document header tags

  * manpage output presentation fixes
    * manpage: (lowercase .br; correct newlines before .nf and
      after .fi; no escape of hyphens; remove redundant links; endnotes array
      requires flatten; screen info on output path)
    * param: manpage header .br and no escape of hyphens
    * urls: correct output path for manpage

  * texpdf: url (regex) pattern match fix (/https?/)

  * help (markup): correct path to markup-samples

  * documentation more link fixes

  * syntax highlighting
    * emacs sisu headers updated (subheaders omitted for now) sisu-mode.el
    * vim cleaning sisu.vim

* sisu_3.0.2.orig.tar.gz (2011-03-05:09/6)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.2

  v3, target ruby1.9.2, ruby1.9.2p180 is ok
  note: there are issues with sisu and early versions of ruby1.9.2
  ruby1.9.2p0 is known to segfault on a number of operations
  ruby1.9.2p180 does not have these issues

  * make sisu: v3 require >=ruby1.9.2 (v2 require >=ruby1.8.7)
    bin/sisu bin/sisu3 modified accordingly

  * use rb1.9.2 "require_relative" syntax

  * ruby 1.9 hash symbol syntax adopted

  * space between each and opening curly brace e.g. "x.each {|y| p y}"

  * use "encoding: utf-8" (instead of coding)

  * sysenv, processing_path method (separated from path) and resulting
    necessary changes

  * urls, param, two unrelated regex fixes, check

  * hub, minor rearranging

  * v2, v3: manpage, adjust output, fewer backslashes

  * v2, v3: defaults, clean homepage

  * v2, v3: consolidate manual & markup samples
    sisu markup source, manpages, man2html
    * clean up headers
    * update and correct links
    * tidy
    * small fixes

  * conf/skin remove less important skins and use syslink to share
    doc/skin_sisu.rb

* sisu_3.0.1.orig.tar.gz (2011-02-16:07/3)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.1

  * sysenv, sisurc.yml and elsewhere as affected, output_dir_structure:
    by_language_code; by_filetype; by_filename

  * css, fix css paths for xhtml, xml dom & xml sax

  * console feedback on selected files being processed, updates & fixes

  * sysenv & sisurc.yml: libreoffice, default odf reader

* sisu_3.0.0.orig.tar.gz (2011-02-07:06/1)
  http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.0

  NOTE: Processing defaults to v2, for v3 use 'sisu3' or 'sisu --v3'

  Versions 3 is experimental and attempts to introduce output more compatible
  with mobile devices and other non-web use and more internationalisation
  possibilities.

  NOTE: v3 branch opened, big patch, changes interim/incomplete (with
  possibility of breakage) primarily for: ebook-readers and other downloading
  viewers (alternative directory structures and use of title based filenames);
  internationalisation (use with po4a, export pot & po, alternative directory
  structures, use of git to ensure changes not lost).

  In v3 SiSU markup files may be organised in language directories that are
  given their language code. There are alternative output directory structures
  depending on whether you want: the v2 layout (mostly in a directory of the
  given filename/a generic filetype name); a monolingual version 3 layout,
  which organises files by filetype/given file name; multilingual v3 layout,
  which organises files by language code/filetype/given which is illustrated
  below

  * alternative output directory structures, configurable
    ├── en
    │   ├── epub
    │   ├── hashes
    │   ├── html
    │   │   └── live-manual
    │   ├── manifest
    │   ├── odt
    │   ├── pdf
    │   ├── sitemaps
    │   ├── txt
    │   ├── xhtml
    │   └── xml
    ├── fr
    │   ├── epub
    │   ├── hashes
    │   ├── html
    │   │   └── live-manual
    │   ├── manifest
    │   ├── odt
    │   ├── pdf
    │   ├── sitemaps
    │   ├── txt
    │   ├── xhtml
    │   └── xml
    ├── po4a
    │   └── live-manual
    │       ├── po
    │       │   └── fr
    │       └── pot
    └── _sisu
        ├── css
        ├── image
        ├── image_sys -> ../../_sisu/image_sys
        └── xml
            ├── rnc
            ├── rng
            └── xsd
    [FIX todo:
     * post rsync,
     * output url paths,
     * also processing of url,
     * processing of sisupod,
     * search db?,
     * search cgi
    ]

  * sisu processing possibility of using directory path and sisu source
    filename, rather than only content in current directory by filename
    [rc config rules are that if not processing from current directory, or
    directory above language sub-directory, will not find _sisu in sisu source
    file directory, but rather will use ~/.sisu if any or /etc/sisu]

  * po4a, work on
    * pot, po output from source language and translation
    * directory structure
    * alternative source directory structures: source and translation files
      organised either by existing file naming convention (file.sst
      filename~es.sst filname~fr.sst filename~de.sst), or; by placement in
      language subdirectories (that follow debian po4a language identification
      convention) ( ./en/file.sst ./es/file.sst ./fr/file.sst ./de/file.sst
      [./_sisu])
    * process po4a source composite file (.ssm) together with its includes
      (.ssi and/or .sst), by identifying composite file to process ... includes
      are identified and processed as well
      [extensive testing required, initial tests passed on "free_culture" and
      "live-manual" and translations]
    * integrate use of git, ensure changes are not lost

  * sisupod git, revisiting
    * internationalize directory structure
    ├── conf
    │   └── skin
    ├── mm
    │   └── image
    ├── po4a
    │   ├── po
    │   │   ├── en
    │   │   └── fr
    │   └── pot
    └── src
        ├── en
        └── fr
    [FIX todo: sisu parsing, not sorted!, directory path parsing major step]

  * object, block text of='block' (instead of 'group'), introduce is='block'
    * dal_doc_str, dal_doc_objects, identify
    * dal_syntax, introduce block syntax block{ }block, like group
    * vim syntax highlighting, match block
    * related downstream changes (many files affected)
      Note: adjust output representation later

  [UGLY HACKS:
    po4a, en assumed as source lanuage, should be configurable
    po4a, only configured so far to recognise fr & es, fix
    po4a for processing .ssm .ssi, skipping of md title & author
  ]
  [FIX todo:
    directory structure for multilingual outputs
    breakage to epub, where src and trans dirs
    manifest
    decide what to do about source output & po4a & git
  ]