aboutsummaryrefslogtreecommitdiffhomepage
path: root/data/doc/sisu/CHANGELOG_v5
blob: 7cd63393abd9f919ccaaa260c949b39a2908528c (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
%% SiSU version 5
  <http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
  <http://sources.sisudoc.org/?p=code/sisu.git;a=blob;f=data/doc/sisu/CHANGELOG_v5;hb=HEAD>
* debian/changelog
  <http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=blob_plain;f=debian/changelog;hb=refs/heads/debian/sid>

v5 stable branch (v6 development branch)
   markup rule change, document structure rule introduced:
   [v5 branch to become stable shortly, posted with 5.2.3, 2014-01-20]
   * single document root == document title == heading level A~
   * adds possible level D~
   (from 5.2 on (earlier v5 development branch insulated from v4))
v4 stable branch supersedes & replaces v3 branch
   [v4 branch closure imminent, v5 to become stable, posted with 4.2.20,
   2014-01-20]
   initial goals:
   * remove/retire "skins"; replace some functionality with headers and/or yml
     file (consider header like syntax for document and site appearance info)
   * bin/sisu $0 make possible to run sisu command on/within project dir tree
   * bin/sisu $*, hub, make possible to specify dir path for markup files
v3 branch is removed; it is available in sisu < 4.1.0
v2 branch is removed; it is available in sisu =< 3.3.2

* homepage at: <http://www.jus.uio.no/sisu>
* <http://www.jus.uio.no/sisu/SiSU/download>
* <http://www.jus.uio.no/sisu/SiSU/changelog>
* <http://sisudoc.org/sisu/sisu_manual>
* data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_manual.ssm
* data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_download.ssi
* CHANGELOG CHANGELOG_v2 CHANGELOG_v3 README data/doc/sisu/

%% Reverse Chronological:

%% 5.4.2.orig.tar.xz (2014-06-22:24/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.4.2
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.4.2-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.4.2.orig.tar.xz
  sisu_5.4.2.orig.tar.xz
  sisu_5.4.2-1.dsc

%% 5.4.1.orig.tar.xz (2014-06-19:24/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.4.1
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.4.1-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.4.1.orig.tar.xz
  sisu_5.4.1.orig.tar.xz
  sisu_5.4.1-1.dsc

* ao,
  * regex match for tics "```" followed by space tweaked
  * Symbol to match grouped text open & close (instead of String)
  * introduce way of removing unrecognized tic markers
  * turn id numbers (for tags) into a hash
  * code blocks, clean trailing newlines
  * misc, minorish

%% 5.4.0.orig.tar.xz (2014-05-25:20/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.4.0
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.4.0-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.4.0.orig.tar.xz
  sisu_5.4.0.orig.tar.xz
  sisu_5.4.0-1.dsc

* v5: merge v6 to v5, version bump to 5.4.*, reason adds structure check
  * ao, document structure check, stop processing on major error
    (with error message & text at location of failure)
    [reason for version bump the addition of structure check]
  * utils, add ok code marker
  * ao, heading with no ocn, distinguish ~# from -#
    * ~# is general & means no ocn (for any object to which it is applied)
    * -# is relevant only for 1~ dummy headings & instructs that they should be
      removed from output where possible
    * applied so far to pdf, odt & plaintext
  * ao_images, reduce warnings when ruby RMagic absent as program used directly
    * reduced dependency on ruby RMagic library (as some time way back had
      issues)
  * ao, document markup structure check, skip processing file on major error
    * with error message & text at location of failure
  * texpdf, urls in creator cause breakage
  * texpdf, mailto markup links set for normal text objects
  * texpdf, '&' in heading breaks toc (now removed from toc (not heading)), bug
    * revisit, bug
  * texpdf, for urls switch to sans serif (small fontsize)
    * instead of typewriter, latex default
  * texpdf, pdf colored hyperlinks configurable
    * --pdf-hyperlinks-color
      --pdf-hyperlinks-no-color or --pdf-hyperlinks-monochrome
    * ['default']['pdf_hyperlinks']='color'
      (other options switch hyperlink color off 'no-color' 'color-off'
      'monochrome')
  * texpdf, pdf default font size configurable (cli & sisurc.yml) (no fractions)
    * --pdf-fontsize-12 --pdf-fontsize-8
    * default:
      texpdf_fontsize: 12
  * texpdf, headings and table of contents representation
    * fixes 1~ and 2~ result in the same formatting
      1~ 2~ & 3~ now differentiated, see discussion in sisu.org under #744383
    * fixes :A smaller formatted than :B
      A~ B~ C~ now the same size, see discussion in sisu.org under #744383
    * :B and :C result in the same formatting, issue explained see sisu.org
  * texpdf, (internal coding) fontface, rename texpdf_font texpdf_fontface
  * texpdf, (internal coding) use symbols to identify page orientation
  * param, metadata rights, line-breaks instead of semicolons separating rights
    * fixes remove trailing semicolon after :copyright:
  * digests sha512 option implemented
    * options sha512 sha256 md5
    * command line --sha512
    * rcconf.yml ['defsault']['digest'] = sha512
  * xml object citation numbering (docbook fictionbook)

%% 5.3.6.orig.tar.xz (2014-05-18:19/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.6
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.6-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.6.orig.tar.xz
  sisu_5.3.6.orig.tar.xz
  sisu_5.3.6-1.dsc

* db,
  * use symbols to identify sql engine
  * remove require 'dbi' (ruby-dbi)
  * for pg: require 'pg' (use ruby-pg directly)
  * for sqlite: require 'sqlite3' (use ruby-sqlite3 directly) [already the case]

* cgi, sample search form generator
  * remove require 'dbi' (ruby-dbi)
  * for pg: require 'pg' (use ruby-pg directly)
  * for sqlite: require 'sqlite3' (use ruby-sqlite3 directly)

%% 5.3.5.orig.tar.xz (2014-05-12:19/1)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.5
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.5-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.5.orig.tar.xz
  sisu_5.3.5.orig.tar.xz
  sisu_5.3.5-1.dsc

* sisu, ensure return to start dir

* ao_syntax, address possible manual use of url delimiters「」

* composite, fix includes, provide extra newline after inserted comment
  (Closes: #744360) "includes do not work properly"

* composite (inserts), missing includes doesn't give an error, fix
  (Closes: #744379) see sisu.org for comment

* param, metadata add 'Copyright:' tag to output related to copyright
  (Closes: #744381) syntax: inconsistency \:copyright: and \:license:

* metadata, pdf, remove link to manifest page where --no-manifest is used
  (Closes: #744378)

* constants, db table sizes synced with v6, not needed by v5 but keeps tables
  compatible

* digests, cleaning

* added sisu.org emacs:evil:org mode notes related to sisu development

%% 5.3.4.orig.tar.xz (2014-02-14:06/5)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.4
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.4-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.4.orig.tar.xz
  sisu_5.3.4.orig.tar.xz
  sisu_5.3.4-1.dsc

* ocn, object citation numbering
  * add perhaps less cryptic --numbering --no-numbering command-line options
  * plaintext & odt switch default to ocn==true for consistency

%% 5.3.3.orig.tar.xz (2014-02-08:05/6)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.3
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.3-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.3.orig.tar.xz
  sisu_5.3.3.orig.tar.xz
  sisu_5.3.3-1.dsc

* cgi, search form (generator), using cgi ENV variables

* examples
  * nginx conf
  * cgi search forms pgsql & sqlite

* documentation, minor update

%% 5.3.2.orig.tar.xz (2014-02-05:05/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.2
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.2-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.2.orig.tar.xz
  sisu_5.3.2.orig.tar.xz
  sisu_5.3.2-1.dsc

* ao, html book index linking, follow --strict option

* utils, code markers & messages, notes/warning/errors, fix

* sysenv, concordance redirected paths, watch

* manual Rakefile, README & minor config adjustment

%% 5.3.1.orig.tar.xz (2014-02-05:05/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.1
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.1-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.1.orig.tar.xz
  sisu_5.3.1.orig.tar.xz
  sisu_5.3.1-1.dsc

* ao, document tags

* options
  * --strict html option
  * ocn switch on/off instructions (& defaults for plaintext & odt)

* html cleaning
  * --strict html option
    (various changes, e.g. ocn [url]#37 only available as [url]#o37)
  * tags
  * endnote name and nameref (make compliant)

* epub
  * use same endnote name and nameref as introduced here for html
  * hash digests used only if availabile (availability check)

* ocn turn on/off rules
  * txt
  * odt

* cgi (pgsql, sqlite) fixes

* error/warn messages, including wrappers round require

* documentation, manpage README etc.
  * sisu manual directory moved
  * sisu manual updated
    * README & sisu.1 (manpage) updated
  * removed html man pages (man2html)

%% 5.3.0.orig.tar.xz (2014-01-26:03/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.3.0
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.3.0-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.3.0.orig.tar.xz
  sisu_5.3.0.orig.tar.xz
  sisu_5.3.0-1.dsc

* v5 stable branch
  * v4 branch closed -(>4.2.20)-
  * v5 stable branch (>=5.3.0)
  * v6 development branch opened (copy v5) (>=6.0.0)

%% 5.2.4.orig.tar.xz (2014-01-26:03/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.2.4
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.2.4-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.2.4.orig.tar.xz
  sisu_5.2.4.orig.tar.xz
  sisu_5.2.4-1.dsc

* bin/sisu changes to simplify switching to new stable and development branches

%% 5.2.3.orig.tar.xz (2014-01-20:03/1)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.2.3
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.2.3-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.2.3.orig.tar.xz
  sisu_5.2.3.orig.tar.xz
  sisu_5.2.3-1.dsc

[good time to consider rollover: closing v4 branch, replacing it with v5 &
introducing v6 for development, proposed for this release + 1]

* bin/sisu & some related lib changes

* sysenv for texpdf, fix for when tex to pdf generator is absent

%% 5.2.2.orig.tar.xz (2014-01-17:02/5)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.2.2
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.2.2-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.2.2.orig.tar.xz
  sisu_5.2.2.orig.tar.xz
  sisu_5.2.2-1.dsc

* bin/sisu experimentation
  * start preparing for ruby changes
  * work on fix for bug related to gem path & system installed sisu

%% 5.2.1.orig.tar.xz (2014-01-12:01/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.2.1
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.2.1-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.2.1.orig.tar.xz
  sisu_5.2.1.orig.tar.xz
  sisu_5.2.1-1.dsc

* ao, add counter for various grouped / blocked texts & tables, of particular
  use for poems which are broken into verse

* recalibrate headings, downstream code fixes

* texinfo, fixes

* texpdf, report on pdf output, provide a working link to a generated file-size
  (multiple document file-sizes may be produced)

* asciidoc, file extension (for now .ad), inline footnotes, minor

%% 5.2.0.orig.tar.xz (2014-01-06:01/1)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.2.0
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.2.0-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.2.0.orig.tar.xz
  sisu_5.2.0.orig.tar.xz
  sisu_5.2.0-1.dsc

* single document root A~ (recalibrate headings); level D~ possible
  * :A~ document title, single document root (ln==0)
  * introduce additional possible heading level, D~
  * markup rule change: single document root
  * breaks much downstream code, recalibrate (fix, test, fix & test again)
    * heading recalibration, code (downstream) changes
  * v4 & v5 bifurcate (diverge "un-merge-ably")

  Notes, rule imposed: heading level A~ becomes, document title & sole document
  root. Significant as an expressed rule/principle, it simplifies making certain
  document formats in particular some xml outputs, however, this has been pretty
  much the case in practice (most documents have this implicit structure) and
  will affect the markup of very few documents (for example all markup examples
  so far provided are this way). This being the case, it is a subtle change,
  because it will not be noticed (by the user) in a majority of cases. The most
  significant changes are to internal sisu code: it is not yet enforced by the
  software (software checks); it has implications for the way document output is
  created; it has implications for document structure regex matches, that now
  are attached to levels starting below level A~ (from B~ down) rather than
  level A. One document affected by single root/title level A~ markup rule and
  that provides a short test (for a document prepared using document structure
  regex matches), is the U.N. Convention on Contracts for the International Sale
  of Goods (CISG) that requires levels A-D & 1, and in previous versions of sisu
  exceptionally required multiple level A's (using levels A-C & 1)

* vim syntax, updated to allow for possible level D~

* bin/sisu
  * (ensure SiSU_version_dir) fix
  * sisu version info, yml info also when installed via ruby gem
  * downstream libs

* fixes
  * ao_doc_str, nodes, possible parents, correction
  * epub, url closure decoration
  * sysenv, qrcode report absent program, minor
  * html scroll toc, clean links where none, exclude metadata

* asciidoc, rename AsciiDoc module, & recalibrate headings

* docbook, fictionbook, some tidying

* cosmetic, code case statement

* year updated, code headers

%% 5.1.3.orig.tar.xz (2013-12-15:49/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.1.3
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.1.3-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.1.3.orig.tar.xz
  sisu_5.1.3.orig.tar.xz
  sisu_5.1.3-1.dsc

* Rakefile, (installer), reduce actions

%% 5.1.2.orig.tar.xz (2013-12-09:49/1)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.1.2
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.1.2-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.1.2.orig.tar.xz
  sisu_5.1.2.orig.tar.xz
  sisu_5.1.2-1.dsc

* Rakefile, (installer) improve, re-arrange

* docbook, structure, a fix
  (construction zone: structure okish; docbook generated not usable)

[NOTE disk crash (2013-12-05), fairly good but incomplete backup affecting work]

%% 5.1.1.orig.tar.xz (2013-12-03:48/2)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.1.1
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.1.1-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.1.1.orig.tar.xz
  sisu_5.1.1.orig.tar.xz
  sisu_5.1.1-1.dsc

* rake create build & install sisu gemspec; (.gitignore), work on
  * gemspec adjusted to install only libraries related to a version (v4 or v5)
  * select sisu version to create, build & install

* bin/sisu, simplify in relation to sisu gem

%% 5.1.0.orig.tar.xz (2013-12-02:48/1)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.1.0
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.1.0-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.1.0.orig.tar.xz
  sisu_5.1.0.orig.tar.xz
  sisu_5.1.0-1.dsc

* ao_doc_str, changes related to headings provided for document structure
  without ocn, testing required

* ao endnotes, removed a space that should no longer be necessary,
  testing required

* minor code related to line breaks, various locations

* renaming of modules
  * use AO instead of DAL

* renaming of files
  * ao*.rb instead of dal*.rb
    ao (abstract objects) shorter, also easily searched, higher sort location
    abstract as representation of & extraction of document objects
    (dal (document abstraction layer))
  * shared files e.g. shared_xml becomes xml_shared
  * plaintext becomes txt_plain
  * epub becomes xhtml_epub2
  * odf becomes xml_odf_odt
  * xml sax file renamed xml_sax.rb (from xml.rb)

* new outputs under development, CONSTRUCTION_ZONE
  * plaintext, smarttext
    * textile
    * asciidoc
    * markdown
    * rst
  * xml
    * docbook, book
    * fictionbook

* sisu.gemspec

* xmlns xlink using xl

* rake create build & install sisu gemspec; bin/sisugem (add .gitignore)
  * rake gemcbi #(create build install sisu gem)
  * rake gemspecscreate && \
    rake gembuild && \
    sudo rake geminstall
  * rake gemspecscreate && \
    gem build sisu5.gemspec && \
    sudo gem install --no-rdoc --no-ri \
    sisu-5.1.0.gem
  * bin/sisu updated (modified to take account of gems)
  * bin/sisugem added
  * .gitignore sisu-*.gem sisu*.gemspec
    consider inclusion (& tracking) of rake created sisu4.gemspec sisu5.gemspec
    (as this makes their availability more obvious)
  * once gem is installed: "sisu _5.1.0_ -vM" (to see version, commands
    otherwise as usual) if paths are such that sisu is not available
    "sisugem _5.1.0_ -vM" should work (as it is installed by gemspec, but not
    other sisu installers)

* hub, sisu5 -M (maintenance mode) provide info as to path to hub.rb (i.e. where
  library is being drawn)

* documentation related to commands for new outputs in development

%% 5.0.25.orig.tar.xz (2013-11-08:44/5)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.25
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.25-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.25.orig.tar.xz
  sisu_5.0.25.orig.tar.xz
  sisu_5.0.25-1.dsc

* rake (& rant) sisu installer
  * do less by default
  * removed rant generated sisu-install

* vim, ftplugin sisu.vim, fix missing <leader>

* sisu_manual, minor info addition

* bin/sisu-*
  * use option flag full names
  * add sisu-html-scroll, sisu-html-seg, sisu-pdf-portrait, sisu-pdf-landscape

%% 5.0.24.orig.tar.xz (2013-11-05:44/2)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.24
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.24-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.24.orig.tar.xz
  sisu_5.0.24.orig.tar.xz
  sisu_5.0.24-1.dsc

* xml, scaffold, re-activated, split into sisu structure & collapsed structure

%% 5.0.23.orig.tar.xz (2013-11-02:43/6)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.23
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.23-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.23.orig.tar.xz
  sisu_5.0.23.orig.tar.xz
  sisu_5.0.23-1.dsc

* constants, ocn output delimiter (where used) changed to 「...」
  (from square brackets [...])

* plaintext
  * reorganize

%% 5.0.22.orig.tar.xz (2013-10-27:42/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.22
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.22-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.22.orig.tar.xz
  sisu_5.0.22.orig.tar.xz
  sisu_5.0.22-1.dsc

* dal, document_structure_check_info

%% 5.0.21.orig.tar.xz (2013-10-23:42/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.21
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.21-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.21.orig.tar.xz
  sisu_5.0.21.orig.tar.xz
  sisu_5.0.21-1.dsc

* options & downstream, more use of opt.act.*.set==:on instead of opt.cmd =~/\S/

* dal, parent & node info, fix
  (used e.g. for mind map type output (last for kdissert output, no longer
  supported))

* dal, collapsed levels implemented
  convenience, collapse sisu's dual level document structure for output of
  markup with straight linear structure

%% 5.0.20.orig.tar.xz (2013-10-17:41/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.20
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.20-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.20.orig.tar.xz
  sisu_5.0.20.orig.tar.xz
  sisu_5.0.20-1.dsc

* constants, change a couple of internal processing delimiter characters, that
  might be used in ordinary marked up text (to characters even less likely to be
  of use in ordinary (marked up) text)

%% 5.0.19.orig.tar.xz (2013-10-16:41/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.19
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.19-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.19.orig.tar.xz
  sisu_5.0.19.orig.tar.xz
  sisu_5.0.19-1.dsc

* constants, change a couple of internal processing delimiter characters, that
  might be used in ordinary marked up text

* vim, minor updates, not syntax related

* markup sample, update book index markup, appearance, minor

%% 5.0.18.orig.tar.xz (2013-09-22:37/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.18
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.18-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.18.orig.tar.xz
  sisu_5.0.18.orig.tar.xz
  sisu_5.0.18-1.dsc

* bin/sisu update language list ja ko zh, fix

%% 5.0.17.orig.tar.xz (2013-09-21:37/6)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.17
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.17-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.17.orig.tar.xz
  sisu_5.0.17.orig.tar.xz
  sisu_5.0.17-1.dsc

* i18n CJK: zh ja ko, add languages Chinese, Japanese, Korean
  * texpdf, has large texlive xetex dependencies (Korean untested)
  * [concordance, untouched does nothing cjk, decide whether to disable]

* sisu_manual, (in markup-samples) move to en/ sub-dir (permitting translations)
  * use of language sub-dir for source sisu markup suited to permitting
    translation management by po4a
  * sisurc.yml minor
  * Rakefile to help place sisu markup in a source language directory under po4a
    management

* Rakefile to assist in placing sisu markup under po4a management (sisu_manual)
  * Provided as an example with sisu_manual
  * fairly generic, but potentially dangerous, can be used to place sisu markup
    source translations under po4a management, but user needs to know what this
    is, (and how to set it up, hence sisu_manual as an example (despite the lack
    of translations)) as can clobber/destroy files that are not managed by po4a.

* minor cleaning

%% 5.0.16.orig.tar.xz (2013-09-07:35/6)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.16
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.16-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.16.orig.tar.xz
  sisu_5.0.16.orig.tar.xz
  sisu_5.0.16-1.dsc

* dal, book index, hash key, strip whitespace, a (required) fix

* db, book index, convert hash back to string

%% 5.0.15.orig.tar.xz (2013-09-05:35/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.15
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.15-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.15.orig.tar.xz
  sisu_5.0.15.orig.tar.xz
  sisu_5.0.15-1.dsc

* dal, objects, store book index as hash (simplify downstream processing)

* dal, book index markup, allow spaces on both sides of delimiters, or a space
  before and newline following a delimiter \s+[:|;](\s+|\n)
  [else parses as before no spaces]

* vim syntax, book index markup, hilight delimeters

%% 5.0.14.orig.tar.xz (2013-08-28:34/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.14
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.14-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.14.orig.tar.xz
  sisu_5.0.14.orig.tar.xz
  sisu_5.0.14-1.dsc

* config files (by filetype & filename) touched

* manifest, output organised by, info, minor touch

* vim syntax, sisu.vim, fix typo
  * ocn (object numbering) on, off, text block using "--~#" "---#" "--+#"

* dal
  * grouped text with fontface spanning newlines, partial solution, test
  * text blocks, tuning

* pdf (latex) tables, bugfix

* odf:odt, footnotes, fix

%% 5.0.13.orig.tar.xz (2013-08-25:33/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.13
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.13-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.13.orig.tar.xz
  sisu_5.0.13.orig.tar.xz
  sisu_5.0.13-1.dsc

* dal, refine grouped text open and close using tics "```"
  [note use of "~~" considered but more problematic, (tics not used elsewhere)]

* dal, improve font face matching within grouped text (other than code blocks)

* vim syntax, improve grouped text match, open, close of blocks using tics "```"

* css, html, epub, adjust paragraph spacing, (increase, whitespace aesthetic,
  review further)

%% 5.0.12.orig.tar.xz (2013-08-21:33/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.12
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.12-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.12.orig.tar.xz
  sisu_5.0.12.orig.tar.xz
  sisu_5.0.12-1.dsc

* syntax add
  * switch ocn off and on for a block of content, line containing only
    off: "--~#" (omit headings where possible) "---#" on: "--+#"
  * alternative open and close for blocks using line starting with "```", e.g.
    open code block:  "``` code"
    close code block: "```"
    start poem:       "``` poem"
    end poem:         "```"
  * remove need for an empty line between opening & closing of a text block

* vim syntax, add
  * ocn (object numbering) on, off, text block using "--~#" "---#" "--+#"
  * grouped text, open, close of blocks using tics "```"

* messages to terminal
  * code marker
  * rescued error messages
  * fuchsia (sp.)

%% 5.0.11.orig.tar.xz (2013-08-08:31/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.11
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.11-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.11.orig.tar.xz
  sisu_5.0.11.orig.tar.xz
  sisu_5.0.11-1.dsc

* dal_expand_insertions, refinement for monolingual output

%% 5.0.10.orig.tar.xz (2013-08-08:31/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.10
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.10-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.10.orig.tar.xz
  sisu_5.0.10.orig.tar.xz
  sisu_5.0.10-1.dsc

* output structure by, multilingual, monolingual filenames tweak

%% 5.0.9.orig.tar.xz (2013-08-01:30/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.9
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.9-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.9.orig.tar.xz
  sisu_5.0.9.orig.tar.xz
  sisu_5.0.9-1.dsc

* output structure by :filename or :filetype, multilingual default, fix

* concordance, fix

%% 5.0.8.orig.tar.xz (2013-07-30:30/2)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.8
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.8-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.8.orig.tar.xz
  sisu_5.0.8.orig.tar.xz
  sisu_5.0.8-1.dsc

* output structure by, add monolingual alternative for :filetype or :filename
  * filename without language code, if document is in default language
  * set a default language, 'en' or as specified
  * set in rc file or from command line instruction
    * command line e.g.
      sisu -hv --monolingual --by-filename sisu_markup.sst
      sisu -3v --monolingual --by-filetype sisu_manual.ssm
    * sisurc.yml lingual: 'mono' | 'multi'
      lingual: 'mono'
  * note: output by :filetype is roughly equivalent to what monolingual output
    by :language would be
  * allow command line setting of default language using language code
    --default-language='en' --default-lang-en if used together with
    --monolingual and --by-filetype or --by-filename the selected default
    language document will not have a language code in the output filename
  * documentation

* cgi helper script, sample search form
  * single cgi form, (with different internal variables set for output types)
  * monolingual output search form option

%% 5.0.7.orig.tar.xz (2013-06-25:25/2)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.7
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.7-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.7.orig.tar.xz
  sisu_5.0.7.orig.tar.xz
  sisu_5.0.7-1.dsc

* "general code cleaning" fix

%% 5.0.6.orig.tar.xz (2013-06-25:25/2)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.6
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.6-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.6.orig.tar.xz
  sisu_5.0.6.orig.tar.xz
  sisu_5.0.6-1.dsc

* "general code cleaning" fix

%% 5.0.5.orig.tar.xz (2013-06-22:24/6)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.5
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.5-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.5.orig.tar.xz
  sisu_5.0.5.orig.tar.xz
  sisu_5.0.5-1.dsc

* vim
  * colorscheme def, mark current line
  * ftplugin sisu.vim, c-\ hard wrap lines to line width (moved from c-j)

* general code cleaning, propagate back to v4 after testing

%% 5.0.4.orig.tar.xz (2013-06-06:22/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.4
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.4-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.4.orig.tar.xz
  sisu_5.0.4.orig.tar.xz
  sisu_5.0.4-1.dsc

* db, population of database (--update), import of master files (.ssm), fix
  (Note: for .ssm: @md.fns (is set during runtime & is) != @opt.fns @md.opt.fns,
  affects construction of unique identifier)

* cgi helper script, sample search form generator
  * file name matching, check
  * cosmetic, drop use of images in sample form

* sysenv, requested load warning removed, less screen clutter, consider

%% 5.0.3.orig.tar.xz (2013-05-30:21/4)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.3
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.3-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.3.orig.tar.xz
  sisu_5.0.3.orig.tar.xz
  sisu_5.0.3-1.dsc

* sysenv, pgsql db connect fix

* cgi_pgsql, cgi helper script, sample search form generator, detail

%% 5.0.2.orig.tar.xz (2013-05-29:21/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.2
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.2-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.2.orig.tar.xz
  sisu_5.0.2.orig.tar.xz
  sisu_5.0.2-1.dsc

* help update, concentrate on man pages
  * documentation, manpage update
  * interactive help, out of date, removed

* document version check, disable
  * automatic check disabled
  * check and correction of pre 0.38 markup removed

* sysenv, version info moved here from help

* cgi helper script sample search form generator, adjust/improve, adds settings:
    db type                         --db-pq or db-sqlite
    webserver for cgi script & db   --webserv-search=''
    webserver for sisu ouptut files --webserv-output=''
    cgi search form link name       --cgi-search-form-name=''
    db user (pg)                    --db-user=''

%% 5.0.1.orig.tar.xz (2013-05-18:19/7)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.1
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.1-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.1.orig.tar.xz
  sisu_5.0.1.orig.tar.xz
  sisu_5.0.1-1.dsc

* vim, ftplugin, sisu.vim, statusline

* cgi script for sample search form generator, sqlite, minor fixes (affects
  'sisu -F')

%% 5.0.0.orig.tar.xz (2013-05-08:18/3)
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_5.0.0
http://sources.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/debian/sisu_5.0.0-1
http://www.jus.uio.no/sisu/pkg/src/sisu_5.0.0.orig.tar.xz
  sisu_5.0.0.orig.tar.xz
  sisu_5.0.0-1.dsc

* v5: opened
  * v3 closed

v5 opened