Setting Rules-Requires-Root to no.
[software/sisu] / data / doc / sisu / CHANGELOG_v3
1 SiSU CHANGELOG -*- mode: org; -*-
2 #+OPTIONS: ^:nil _:nil
3
4 * SiSU version 3
5 <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
6 <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=data/doc/sisu/CHANGELOG_v3;hb=HEAD>
7 <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob_plain;f=debian/changelog;hb=refs/heads/debian/sid>
8
9 v3 branch closed with opening of v5 from >= 4.1
10 v3 branch is legacy: v4 branch supersedes & replaces it
11 v3 branch supersedes & replaces v2 branch
12 v2 introduces alternative (configurable) output structures
13 v1 branch is removed; it is available in sisu =< 2.7
14
15 * homepages: <http://sisudoc.org> <http://www.jus.uio.no/sisu>
16 * data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_manual.ssm
17 * CHANGELOG CHANGELOG_v2 CHANGELOG_v3 README data/doc/sisu/
18
19 * Legacy Branch, Reference
20
21 Version 3 to be closed on opening of version 4.1.* & v5 branch
22
23 Version 3 introduced output directory structures nad filenames more
24 compatible with mobile devices and other non-web use and more
25 internationalisation possibilities.
26
27 In v3 SiSU markup files may be organised in language directories that are
28 given their language code. There are alternative output directory structures
29 depending on whether you want: the v2 layout (mostly in a directory of the
30 given filename/a generic filetype name); a monolingual version 3 layout,
31 which organises files by filetype/given file name; multilingual v3 layout,
32 which organises files by language code/filetype/given
33
34 (see notes at bottom of file, near EOF)
35
36 Reverse Chronological:
37
38 --- HEAD --- [closed]
39
40 * sisu_3.3.11.orig.tar.xz (2013-02-20:07/3)
41 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.11
42
43 * epub, add markup of angle brackets '<' & '>' to early markup of amp. '&'
44
45 * vim, colorschemes, general housekeeping
46
47 * b_epub.png, epub icon (for manifest) updated to use official image
48
49 * sisu_3.3.10.orig.tar.xz (2013-02-10:05/7)
50 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.10
51
52 * vim, minimal color schemes, minor edits
53
54 * dbi_discrete, discreet should have been discrete, renames accordingly
55
56 * lib, bin/sisu, misc, code headers provide url to online git file source
57 * e.g. bin/sisu * Git
58 <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
59 <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=bin/sisu;hb=HEAD>
60
61 * sisu_3.3.9.orig.tar.xz (2013-02-06:05/3)
62 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.9
63
64 * utils (debug renamed), Utils::CodeMarker (from Debug::Mark)
65
66 * sisu_3.3.8.orig.tar.xz (2013-02-03:04/7)
67 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.8
68
69 * sysenv, on --redirect, stop creation of redundant dir
70
71 * html, includes book index fix, rest cosmetic
72
73 * css (html & epub) line spacing reduced, paragraph spacing increased
74 * may need to tune spacing further to distinguish lines from new paragraphs
75 (especially where ocn is not used as the distinction may be less
76 clear/obvious) [sync with v4]
77
78 * sisu_3.3.7.orig.tar.xz (2013-01-31:04/4)
79 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.7
80
81 * dal, on ocn excluded paragraphs (~# -#), hang/indent bullet, fix
82 [bug reported indirectly by Cory Doctorow (discovered in work with markup)]
83
84 * dal (obj), html, br_page* behavior in html depending on origin of break
85 (markup specified v auto)
86
87 * sisu_3.3.6.orig.tar.xz (2013-01-27:03/7)
88 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.6
89
90 * epub some fixing, more documents render in more readers/viewers
91 * ncx fix, navpoint_close
92
93 * remove markup-sample of the first edition of FaiF as redundant, the
94 markup for the second edition being available (& partly in response to
95 Bug#698664 which leads me to think about it), removed:
96 free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
97 associated skin and associated images
98
99 * sisu_3.3.5.orig.tar.xz (2013-01-23:03/3)
100 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.5
101
102 * epub
103 * remove unnecessary conversion of some utf-8 characters to xhtml
104 representation; fix as messed up table of contents, toc.ncx
105 (e.g. in calibre) [bug reported by Mikael Böök]
106 * provide full depth epub table of contents [request Mikael Böök]
107 * cosmetic arrangement of code <<-WOK
108 * xhtml structure error, fix missing </div>
109 [bug reported by Mikael Böök] (fix of additional detail)
110
111 * html
112 * remove unnecessary conversion of some utf-8 characters to html
113 representation
114
115 * texpdf_format
116 * list of .sty files (and their texlive source within Debian)
117 [not part of code]
118
119 * param, match possible sisu version, detail
120
121 * sisu_3.3.4.orig.tar.xz (2013-01-01:00/2)
122 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.4
123
124 * html_segments (by_filename by_filetype) internal document links do not
125 work filenames need to include lang code, fixed
126 [chals on irc, re live-manual, debian-live]
127
128 * plaintext, in code blocks retain a blank empty line, a fix
129 [known old bug, affects sisu_manual, fix request from SynrG on irc, re
130 live-manual]
131
132 * manpage, attempt to improve output (line-spacing)
133
134 * param, minor change any legacy <br> line break in metadata markup to \\
135
136 * debug (internal code use), color markers for line number & file name
137 (colored location markers to show when line passed within running code)
138
139 * sisu_3.3.3.orig.tar.xz (2012-10-03:40/3)
140 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=shortlog;h=refs/tags/sisu_3.3.3
141
142 * cosmetic, code
143 * true ? x : y
144 * if, else, remove some semicolons (;) replace with newlines
145 * if true ; x, remove semicolons replace with "then"
146 * .is_a?(X) replaces .class==X (& for some defined? and nil? tests)
147 * remove javascript holders js_ (not used)
148
149 * some fixes, cleaning, removing
150
151 * sisu -v, provide version information, fix
152
153 * options, opt_act, limit calls
154 ruby profiler indicates much time spent here, reduce
155
156 * constants, year static (current): YEAR=2012
157
158 * bin/sisu, hub, reorganize call
159
160 * dbi, pgsql, report need for instructions when none given, rather than
161 fail silently
162
163 * some pre-unicode meddling sorted
164 (covers bug reported as middle dot changed to asterisk by chals)
165
166 * sisupod source, paths fix
167
168 * odf, internal links/bookmarks, toc, book index
169
170 * pdflatex, fixes
171 * landscape cover page was botched, came out as portrait
172
173 * pdf, fix
174 * group text, bullet
175 * group text, hardspaces at start of line (indent)
176 * group text, pass through special characters safe
177 * poem, bold etc.
178
179 * html, epub, fix
180 * group text, bullet
181
182 * header @classify: :topic_register: provide greater classification "depth"
183 * param, manifest
184 * harvest_topics
185
186 * dal, sysenv
187 * markup file processing, change to sourcefile readlines & split of
188 sourcefile array
189 * removal of RUBY_VERSION references to older versions of ruby
190
191 * dal_syntax, new syntax: =\\= page new & -\\- page break
192 alias for <:pn> and <:pb> respectively
193
194 * db
195 * introduce book_idx
196 * minor re-arranging
197
198 * cgi search script, minor
199
200 * vim syntax sisu.vim, =\\= page new & -\\- page break
201
202 * markup samples, and help, minor updates
203
204 * vim ftplugin sisu.vim
205 * linenumbering: on; relative; off, <leader>nn
206 * cursor line & column: on; off, <leader>cu (existing cu+ & cu-)
207
208 * sisu_3.3.2.orig.tar.xz (2012-06-30:26/6)
209 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.2
210
211 * texpdf, xetex screen reporting of warnings off unless sisu -pV used
212
213 * sisu_3.3.1.orig.tar.xz (2012-06-23:25/6)
214 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.1
215
216 * texpdf_format, urls in headings break pdf documents, fix
217 (e.g. output generation of document sample gpl.fsf.sst pdf fixed)
218
219 * sysenv, rsync put (post to remote site), fix, needs comprehensive check
220 (broken since version 3 (did not cope with alternative output structures),
221 start to fix; still broken: rsync get (sisu source); also scp put & get)
222
223 * hub, some re-arrangement
224
225 * sisu_3.3.0.orig.tar.xz (2012-06-17:24/7)
226 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.3.0
227
228 * shared_sisupod_source, common build for sisu (markup) source representations
229 to be used by sisupod.txz, git, (and src)
230 * sisupod_make (--sisupod)
231 * share_source (--source)
232 NOTE not used git at present
233 * changed representation of shared sisu source, include related files in
234 directory rather than just markup file [reason for version bump]
235 NOTE there are no changes to sisu markup (only the sharing of source files)
236
237 * sisu_3.2.12.orig.tar.xz (2012-06-06:23/3)
238 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.12
239
240 * hub, post bundles
241 * sisupod_make, file selection selection for tar.xz, fix
242
243 * dbi_discreet, screen reporting db location, fix
244
245 * shared_images, fix
246
247 * excludes --exc-html-
248 * html (toc & scroll), (html_segments, concordance,) exclude top band, touch
249 sisu --exc-top-band --html --concordance filename.sst
250 * html_segments, @make.build.html_navigation? fix
251
252 * sysenv, check @md.make.respond_to?(:skin)
253
254 * screen reporting, ansi colors, cosmetic
255
256 * Rake, Rant installer sisu installer require ruby >= 1.9.3
257
258 * sisu_3.2.11.orig.tar.xz (2012-06-03:22/7)
259 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.11
260
261 * images, regular & sisupod
262 * shared_images, --html, --xhtml, --xml*
263 * sisupod images done: --html including skin images; --epub; --odf; --pdf
264 * copy (system link removed)
265
266 * manifest, paths, (for command line selection of output type) fix
267
268 * urls, sisupod, fix
269
270 * warn when files to be copied not found, add
271
272 * error & warning messages touched, revisit
273
274 * sisu_3.2.10.orig.tar.xz (2012-05-28:22/1)
275 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.10
276
277 * hub
278 * "requires", fix
279 * manifest re-run where related multilingual documents, fix
280 BUG breaks mini table of contents (minitoc) manifest for multilingual
281 files, better run without manifest minitoc, use --exc-manifest-minitoc
282 * share markup source (--source) not available at this time for composite
283 files (.ssm), suggest creating a sisupod instead
284
285 * options, --init-site, --configure, fix
286
287 * code headers, mostly copyright
288
289 * options, command line control of output directory structure
290 --output-by-language; --output-by-filetype; --output-by-filename, or
291 --by-language; --by-filetype; --by-filename
292 * documentation update sisu_commands.ssi, manpage sisu.1, man2html
293
294 * css, ensure css available for generated content (without need for
295 --init-site / --configure), checks whether exists if not copies (for
296 --init-site / --configure just copies, takes as a re-copy request)
297
298 * sisupod.txz processing
299 BUG image copying/processing for sisupod
300
301 * html_format, minor cleaning
302
303 BUGS
304 * broken mini table of contents (minitoc) manifest for multilingual files,
305 better run without use --exc-manifest-minitoc
306 * sisupood image copying/processing, broken
307
308 * sisu_3.2.9.orig.tar.xz (2012-05-19:20/6)
309 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.9
310
311 * harvest
312 * harvest by filename output paths
313 * harvest_topics, add level
314 * harvest_topics, alternative headings, fix
315
316 * options, create manifest touched
317
318 * sisu_3.2.8.orig.tar.xz (2012-05-12:19/6)
319 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.8
320
321 * sisupod make, re-fixed, check again
322
323 * hub, fixes, still a construction zone
324
325 * po4a, runs, needs checking
326
327 * misc fixes
328 * options, omissions and typo fix
329 * particulars, fix, check
330 * shared_metadata, fix
331
332 * sst_identify_markup, introduce document header SiSU 3.0,
333 pretty much the same as 2.0
334
335 * reporting
336 * composite file names touched
337 * rescue & error warnings, more touched
338
339 * sisu_3.2.7.orig.tar.xz (2012-05-06:18/7)
340 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.7
341
342 * hub, options, fixes
343 * dbi: pgsql, sqlite
344
345 * qrcode, fixes
346 * ensure manifest is run
347 * urls fix
348
349 * rescue & error warnings, some touched
350
351 * sisu_3.2.6.orig.tar.xz (2012-05-01:18/2)
352 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.6
353
354 * harvest (metadata, site/document summary) fixes
355 * harvest_topics, sort fix
356 * harvest_authors, minor fix
357 * sst content parsing lang dir
358 * output file location, currently works for (by?) :language & :filetype
359
360 * hub (seek finer grained control over what happens when; causes breakage)
361 * (primarily) cycle files then options (instead of options then files)
362 * manifest re-run on (currently generated) translated files if any
363
364 * sisu_3.2.5.orig.tar.xz (2012-04-22:16/7)
365 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.5
366
367 * shared_html_lite, codeblock fix, affecting sql:
368 SELECT ocn,body FROM doc_objects WHERE t_is='code';
369 SELECT ocn,clean FROM doc_objects;
370
371 * sisu_3.2.4.orig.tar.xz (2012-04-21:16/6)
372 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.4
373
374 * db bugfix in maintenance mode (variable name reused)
375
376 * sysenv, default processing dir name change
377 * distinguish sisu branch, add sisu branch to processing directory name
378 * if constants, 'DEVELOPER[:maintenance] == :true' then additionally add
379 sisu version number to processing directory name
380
381 * rescue reporting
382
383 * sisu_3.2.3.orig.tar.xz (2012-04-15:15/7)
384 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.3
385
386 * param, dal_syntax, document header (simple regex) substitution list
387 added, note $ and curly braces are escaped to allow the following:
388 @make:\n :substitute: /${linux-distro}/,'Debian' /${stable}/,'Squeeze' \
389 /${testing}/,'Wheezy'
390 changes are not made within text object types: code-blocks, tables or
391 metadata (document headers). Marked up document remains self-referential.
392 Note: the substitution list must be written on a single line, without
393 line-breaks.
394 [Substitutions possibility requested by Debian-live, live-manual (Ben
395 Armstrong & Daniel Baumann)]
396
397 * vim syntax highlighting, document header added :substitute: (under
398 @make:)
399
400 * sisu_3.2.2.orig.tar.xz (2012-04-05:14/4)
401 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.2
402
403 * reporting
404 * urls
405 * sql creation -v reporting reduced (to better suit use of
406 sqlite_discreet with other output types) for more use -V or -M
407
408 * sysenv, path.style (a quick fix, review)
409
410 * sisu_3.2.1.orig.tar.xz (2012-03-21:12/3)
411 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.1
412
413 * documentation sisu_commands, rearranged; update with regard to
414 excludes; & discreet sqlite output
415 * manpage
416 * html (man2html)
417
418 * COPYRIGHT add markup samples "Free as in Freedom"
419
420 * sisu_3.2.0.orig.tar.xz (2012-03-19:12/1)
421 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.2.0
422
423 * start 3.2: merge v3dv (3.2) into v3 (3.1)
424 * conf/sisu/v3dv --> conf/sisu/v3
425 * data/sisu/v3dv --> data/sisu/v3
426 * lib/sisu/v3dv --> lib/sisu/v3
427 * bin/sisu* (change v3dv references to v3)
428
429 * COPYRIGHT, format changed, influenced by Machine-readable debian/copyright
430 file <http://www.debian.org/doc/packaging-manuals/copyright-format/1.0/>
431
432 * sisu_3.1.15.orig.tar.xz (2012-03-12:11/1)
433 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.15
434
435 * v3dv: sysenv, ProcessingSettings, start to use hooks to make it possible to
436 control (via: the command line; the document markup header, or; the
437 configuration file) the likes of: ocn, toc, segsubtoc, minitoc,
438 links-to-manifest, search-form, html-navigation, html-navigation-bar,
439 html-right-pane, html-top-band; these are switched on by default and may be
440 switched off in omit lists within configuration file, the document markup
441 header, or command line. The command line takes precedence & may switch on
442 or off overriding settings within the document markup header or the sisu
443 configuration file.
444 * --inc- on by default, but if switched off in doc header or configuration,
445 the command line --inc- has precedence; for each possible exclude
446 configuration the --inc- switch that overrides configuration settings
447 * --exc- == --no-; exclude/switch off feature (but --inc- include has
448 precedence)
449 * document header @build: :omit: [list output features to be omitted]
450 * configuration (sisurc.yml) omit:
451 exclude output feature, overrides configuration settings (omit --dev
452 development branch modifier once merged back to main)
453 --exc-ocn, html (seg, scroll), epub, xml, pdf
454 sisu --dev --exc-ocn --html --epub --xml-sax --xml-dom --xhtml -v filename.sst
455 --exc-toc, html (scroll), epub, pdf
456 sisu --dev --exc-toc --html --epub --pdf -v filename.sst
457 --exc-segsubtoc html (seg), epub
458 sisu --dev --exc-segsubtoc --html --epub -v filename.sst
459 --exc-minitoc, html (seg), concordance, manifest
460 sisu --dev --exc-minitoc --html --concordance -v filename.sst
461 --exc-manifest-minitoc, manifest
462 sisu --dev --exc-manifest-minitoc --html -v filename.sst
463 --exc-links_to_manifest, --exc-manifest-links,
464 html (seg, scroll)
465 sisu --dev --exc-manifest-links --html -v filename.sst
466 --exc-search-form, html (seg, scroll), manifest
467 sisu --dev --exc-search-form --html -v filename.sst
468 --exc-html-minitoc, html (seg), concordance
469 sisu --dev --exc-html-minitoc --html --concordance -v filename.sst
470 --exc-html-navigation, html (seg, scroll)?
471 sisu --dev --exc-html-navigation --html -v filename.sst
472 --exc-html-navigation-bar, html (seg)
473 sisu --dev --exc-html-navigation-bar --html -v filename.sst
474 --exc-html-search-form, html (seg, scroll)
475 sisu --dev --exc-html-search-form --html -v filename.sst
476 --exc-html-right-pane, html (seg, scroll)
477 sisu --dev --exc-html-right-pane --html -v filename.sst
478 --exc-html-top-band, html (seg, scroll), concordance
479 (minitoc is forced on to provide seg navigation)
480 sisu --dev --exc-html-top-band --html --concordance -v filename.sst
481
482 * v3dv, vim syntax highlighting, document header added :omit: (under @make:)
483 for document output features to be omitted if any
484
485 * v3dv, documentation sisu_commands, rearranged; update with regard to
486 excludes; & discreet sqlite output
487
488 * v3dv, sqlite3 discreet .sql.db file for each document (in addition to
489 existing possibility of a shared db in sqlite3 or postgresql)
490
491 * texinfo, fix (break holding back 3.2 merge)
492 [proposed next version starts 3.2, (merge dev branch after 3.1.15)]
493
494 * sisu_3.1.14.orig.tar.xz (2012-02-14:07/2)
495 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.14
496
497 * v3dv: sysenv, output_dir_structure, rewritten, affected code modified
498
499 * v3dv: --redirect (--redirect=dir_path) & --dump (--dump=dir_path)
500 * --dump places output in directory specified, if none specified in the
501 current directory (pwd).
502 * --redirect places output in subdirectory under specified directory,
503 subdirectory uses the filename (without the suffix). If no output
504 directory is specified places the subdirectory under the current directory
505 (pwd).
506 * html, css incorporated into each file (concordance & manifest included)
507 * html, xhtml & xmls, css copied into css subdirectory (not used by html as
508 embedded)
509 * html xmls, images copied to output directory
510 * no links to manifest
511 * manifest with relative links only
512 * longer html filenames given to avoid names clashing (e.g. for toc,
513 manifest, concordance)
514
515 * v3dv: html, epub, remove manifest toc links
516
517 * v3dv: -j copy images associated with file (images used by html & xmls)
518 * automatically invoked by --dump & redirect
519
520 * v3dv: dal, remove sisu_manifest from document structure & toc (metadata
521 retained (provide link to sisu_manifest)), html & epub coding affected
522
523 * v3dv: hooks to make it possible to control (via: the command line; the
524 document markup header, or; the command line) the likes of: toc, manifest,
525 manifest-links, metadata, html-minitoc, html-navigation, html-navigation-bar;
526 these are switched on by default and control takes the form of making it
527 possible to switch them off.
528
529 * v3 v3dv: document --redirect, --dump, -j update sisu_commands.sst
530 [documents not generated until v3.2.0 (when v3dv branch is merged into v3)]
531
532 * sisu_3.1.13.orig.tar.xz (2012-02-03:05/5)
533 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.13
534
535 * v3 v3dv, path & url links, updates for multi output directory structure
536 possibilities (fixes)
537
538 * v3dv, dal (& code affected as a result), use symbols to identify document
539 objects type (is) and group (of)
540
541 * v3dv, epub, html, some cleaning of redundancy
542
543 * v3dv, texinfo BROKEN, since 3.1.12 at least
544
545 * v3 v3dv, vim syntax highlighting, patch from Thilo Six <T.Six@gmx.de> applied
546 Re: <http://thread.gmane.org/gmane.editors.vim.devel/32151> &
547 <http://vimdoc.sourceforge.net/htmldoc/options.html#cpo-l>
548
549 * sisu_3.1.12.orig.tar.xz (2012-01-23:04/1)
550 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.12
551
552 * texpdf, tampering with "safe" special character transformations, a fix (that
553 may introduce new issues, watch) [in response to report of a pdf title bug
554 "&" not represented, Timothy Hume]
555
556 * urls, odt maintenance path fix
557
558 * v3dv, messing with code, merge back likely to become v3.2
559 * call most methods by full name (include associated module & class names)
560 * replace most ruby exclamation (!) method actions
561
562 * v3dv, sysenv, use "which" instead of "whereis" to locate programs, test
563 [suggested by, Timothy Hume, used to get sisu texpdf to work on MacOS]
564
565 * sisu_3.1.11.orig.tar.xz (2012-01-10:02/2)
566 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.11
567
568 * date, year 2012, update
569
570 * v3dv, add dev branch, make some changes to module & class names & test
571 * short term branch, merge back into v3 once tested
572 * sisu --dev (to invoke)
573 * module names, use more CamelCase
574 * class names,
575 * use more CamelCase
576 * remove "SiSU_" (reserve for module names for consistency)
577
578 * modify.rb, prep script for year update, & changing module & class names
579
580 * sisu_3.1.10.orig.tar.xz (2011-12-31:52/6)
581 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.10
582
583 * html, epub, (& xml) codeblocks, treatment of '<<' & '>>', fix
584 (codeblock, remove legacy match rule, watch)
585
586 * sisu_3.1.9.orig.tar.xz (2011-12-19:51/1)
587 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.9
588
589 * manually created html files in _sisu/home (*.html) copied as home pages
590 (previous behavior was only to copy _sisu/home/index.html)
591
592 * html, seg output, index.html fixes
593 * place in correct directory and use language code as appropriate
594 * remove broken index.html from output [note the existing erroneous file
595 is not removed by a program run, it has to be removed manually]
596
597 * options, behavior of --find & --glob, can only be used on base directory
598 level, (it is not possible to limit the glob to say en/... or fr/...), for
599 now prints a message that sub-directories may not be provided for --find or
600 --glob at this time
601
602 * sisu_3.1.8.orig.tar.xz (2011-12-13:50/2)
603 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.8
604
605 * texpdf, output by filetype, fix, produce pdf files with language code as
606 part of filename (previously written over)
607
608 * odf:odt, codeblocks, a match fix, affects e.g. "<<"
609
610 * sisu_3.1.7.orig.tar.xz (2011-12-08:49/4)
611 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.7
612
613 * dal, codeblocks
614 * internal document identifier tags removed, consider
615 * markup of greater than & less than, fix (but watch)
616
617 * epub, css, codeblock, grey box
618
619 * texpdf, use package listings for box around codeblocks (retain boites
620 option)
621
622 * sysenv, external images directory copied only if it exists
623
624 * documentation, add --configure & use ascii characters for dir tree
625 correction of a few typos
626 * manpage
627 * html
628
629 * sisu_3.1.6.orig.tar.xz (2011-12-02:48/5)
630 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.6
631
632 * dal, codeblocks, start flush left (no buffer spaces at start of line) to
633 allow cut & paste [requested by chals irc.oftc] (fixed issue, numbering of
634 (flush left) codeblocks; preliminary tests suggest this should be ok), need
635 distinguishing marks for plaintext (& fix grey background in xetex/pdfs)
636
637 * texpdf, use boites for box around codeblocks, use and adapt 'boitecoloriee'
638 (found in boites_examples.sty)
639 * in boitebox as setup normal tex hardspaces at start of line are removed,
640 hack required to fix
641 * [attempt to reconfigure boitebox: as setup normal tex hardspaces at start
642 of line are removed;backround color not set (incompatible);keep box once
643 background color is set?;remove first line indent of paragraph?]
644
645 * require iconv (depreciated), use String#encode instead
646 * removed iconv, required a number of places without being used, watch
647
648 * sisu_3.1.5.orig.tar.xz (2011-11-21:47/1)
649 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.5
650
651 * images, embedded symbol (previously overlooked, pre use of utf-8)
652 * param, sisu markup image regex match
653 * sisupod, sisu markup image regex match
654
655 * odf v1.2
656 * includes previously unimplemented hanging indents
657
658 * hanging indent
659 * done: dal, plaintext, html, epub, xhtml, xml (sax & dom), odt, pdf, sql;
660 not done: man, info
661
662 * dal_expand_insertions, link shortcut for multiple versions of sisu document,
663 omit codeblocks
664
665 * sisu manual, sisu markup, include example of: link shortcut for multiple
666 versions of a sisu document in the same directory tree
667
668 * sisu_3.1.4.orig.tar.xz (2011-11-11:45/5)
669 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.4
670
671 * FileUtils, make more consistent (and explicit) use of
672 * explicit calls (more verbose, easier to find)
673 * replace system calls
674
675 * sisu_3.1.3.orig.tar.xz (2011-11-05:44/6)
676 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.3
677
678 * header, @make: :bold: :italic: fix necessary, Re (3.1.2): (bold & italic
679 pattern matching) possibility to ignore case (reinstated)
680
681 * sisu_3.1.2.orig.tar.xz (2011-10-31:44/1)
682 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.2
683
684 * sysenv, skins, a fix
685 [return to, identify sisupod more definitively]
686
687 * header, @make: :bold: :italic: (bold & italic pattern matching) possibility
688 to ignore case (reinstated)
689
690 * markup-samples, Free as in Freedom 2.0
691 * made use of old book index, better than none
692
693 * concordance, information to terminal, minor
694
695 * conf/convert/modify.rb minor fixes
696
697 * sisu_3.1.1.orig.tar.xz (2011-10-15:41/6)
698 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.1
699
700 * odf:odt v1.0
701 * make odt header changes easier to track
702 * get rid of (binary changeset) blob
703 * make odt style names more easily recognizable
704
705 * manifest, odt url lnk, fix
706
707 * sisu_3.1.0.orig.tar.xz (2011-10-03:40/1)
708 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu_3.1.0
709
710 * bin/sisu, default sisu version 3
711
712 * sysenv, rc_path adds ./.sisu/ (to existing ./_sisu/ & ~/.sisu/)
713
714 * defaults, (sisu) home page
715 * link to git repo
716 * minor fixes
717
718 * sysenv, output_structure_by: filename, fix to output directories created
719
720 * texpdf, fonts, Liberation series default (Sans for main)
721 * (mono) improved with selection of Liberation Mono as default
722 * font (main font, mono) configurable in sisurc.yml under
723 default: (texpdf_font:|texpdf_font_mono:)
724 or within document under @make: (:texpdf_font:|:texpdf_font_mono:)
725
726 * sisrc.yml, texpdf_font (main, mono) Liberation series (main default Sans)
727
728 * vim syntax, :texpdf_font_mono: added to @make:
729
730 * documentation, small update
731 * sisu source
732 * manpage
733 * man2html html
734
735 * sisu_3.0.19.orig.tar.xz (2011-09-24:38/6)
736 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.19
737
738 * hub, processing options, remove cruft
739
740 * qrcode, sisu generated manifest output, treat as such
741 * place qrcode images in directory under manifest (manifest/qrcode)
742 * fix remote placement of qrcode images when requested
743
744 * texinfo, fix output
745
746 * remote
747 * rsync, include manpage, info file (when selected)
748 * rsync, images, (html, xmls) only include images related to document
749 * src & sisupod processing
750
751 * sisupod processing
752
753 * param, matching of date, years 1400 - 21\d\d
754
755 * sisu_3.0.18.orig.tar.xz (2011-01-13:37/2)
756 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.18
757
758 * options
759 * match fix for --glob / --find
760 * action (opt.act) modified to increase use possibilities
761 (currently affects hub)
762
763 * hub
764 * opt.act modifications
765 * sisupod processing (v2 processing also enabled)
766
767 * epub
768 * fix for different output structures, language codes not used
769 internally (within epub)
770 * adjustment to image paths for image copy
771
772 * correct sisupod references and path to .txz (replace .zip)
773
774 * image (relative) paths for different sisu output structures
775 (re: by_language, by_filetype, by_filename)
776 * sysenv, set path
777 * html seg, scroll, manifest (qrcodes), xmls
778
779 * dal_images, disabled imagemagick configuration permission check until
780 sisupod reads local sisurc.yml (configuration file)
781
782 * correct .orig.tar.xz name in CHANGELOG_v3 (>=3.0.15)
783
784 * sisu_3.0.17.orig.tar.xz (2011-01-05:36/1)
785 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.17
786
787 * sisupod v3
788 * modify pod dir structure, place sisu source in dir/[lang_code]/ e.g. dir/en/
789 * use tar.xz (.txz)
790 * bundle all language version in pod
791 * bundle .ssm and all included files for each selected language (rather
792 than composited .ssm.sst file)
793 * [DO] prioritize and warn where duplicate files in directory
794 * [DO] ideally, allow selection those files selected in command line using -G
795 (filename pattern) or named in files to be processed string
796 * remote placement
797 * sisu processing from sisupod v3
798 * [DO] sisu processing from sisupod v2 (retain possibility)
799
800 * rsync sisupod v3
801
802 * sysenv, check that tree is available and use as desired when available
803
804 * unix conditional tests ? : remove line break marker at end of line before
805 :, cosmetic
806
807 * Dir.chdir, remove "system cd" (change directory) use Dir.chdir
808
809 * sisu_3.0.16.orig.tar.xz (2011-08-18:33/4)
810 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.16
811
812 * epub tuning
813 * include levels A - C as individual sections
814 (xhtml file with consistent opf & ncx)
815 * sync ncx with sisu internal structural logic
816 (correct depth, include level A, place sisu toc)
817
818 * dal, sisu document links (multiple output versions) shortcut, fix
819 * links to multiple versions internal documents based on shortcut notation,
820 e.g.
821 { "Viral Spiral", David Bollier [3sS]}viral_spiral.david_bollier.sst
822 resulting in all versions of the document that would be generated by
823 running the command sisu3 -3sS viral_spiral.david_bollier.sst
824 * added possibility to specify language where language directory structure
825 is used for source documents
826 { "Viral Spiral", David Bollier [3sS]}en/viral_spiral.david_bollier.sst
827
828 * concordance, i18n, start adding alternative language alphabets
829 (Danish, Norwegian, Swedish)
830
831 * sisu_3.0.15.orig.tar.xz (2011-08-08:32/1)
832 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.15
833
834 * switched sisu tarball compression to xz (from gz)
835
836 * options, default action on running "sisu3 [filename.sst]", fix
837
838 * sysenv, options, sisurc.yml base directory (default) language setting
839
840 * po4a, make use of base directory (default) language setting
841 (for setting original language, (instead of assuming English))
842
843 * prog_text_translation, add contents, remove some repetition
844
845 * texpdf, possibility to translate "Contents" for table of contents
846
847 * epub, experiment with presentation
848 * disable some internal "features"
849 * make file and directory naming more flexible, now using
850 'OEBPS', 'toc.ncx', 'content.opf',
851 * adjustment of some headers and general tuning
852 * add opf guide
853 * clean processing directory between each build
854
855 * constants
856 * added constants Ep (for epub)
857 * added DISABLE (used here with epub)
858 * re-arranged
859
860 * objects.txt, removed, cleaning
861
862 * sisu_3.0.14.orig.tar.gz (2011-07-26:30/2)
863 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.14
864
865 * hanging indent partially implemented, added markup possibilities
866
867 __[1-9] hanging indent (initial indent 0); paragraph text indent [1-9]
868
869 _[0-9]?_[1-9] initial indent; paragraph text indent
870
871 * done: dal, plaintext, css, html, epub, xhtml, xml sax, xml dom, pdf, sql;
872 not done: odf, man, info
873 check: po4a, html_lite (used in sql search results)
874 * syntax highlighting done: vim (sisu.vim), emacs (sisu-mode.el)
875
876 * indent added bold words markup syntax (_[1-9]!) (_[0-9]?_[1-9]!)
877 for indents
878
879 __[1-9]! bold words
880 part of hanging indent paragraph text
881
882 __[1-9]! bold words \\ part of hanging indent paragraph text
883
884 * param, manifest, qrcode, epub, added creator.editor field
885
886 * sql db, constants, cgi-sql, structure changed, creator editor field added
887
888 * sisu_manual, manpage, manpage html (man2html)
889 * sisu_commands: --qrcode -Q; update shortcut options; line-breaks use \\
890 * sisu_markup.sst: indent update; publisher
891
892 * vim sisu syntax highlighting
893 * markers for hanging indent added
894 * added header for @creator: :editor:
895 * minor comments added
896 * deletion of an unused tag
897
898 * emacs sisu-mode.el
899 * markers for hanging indent added
900 * line-break
901
902 * qrcode, sysenv, manifest, generate & add QR code images of metadata to
903 manifest (using qrencode) (consider where and how else to use images)
904
905 * epub, opf fixes
906
907 * sysenv, avoid creation of spurious directories in output tree
908 (an image copy section removed, re-implement correctly later)
909
910 * param, cleanup setting of auto endnotes
911
912 * texpdf, XeTeX language settings ((setmainlanguage setotherlanguage) from
913 directory or filename) if @make: :language: header not set
914
915 * xmls (sax, dom, xhtml) use of xml tidy, correct output file location
916
917 * urls, --concordance
918
919 * sisu_3.0.13.orig.tar.gz (2011-06-26:25/7)
920 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.13
921
922 * dal_syntax, linebreak within regular objects is \\ (<br> depreciated)
923 [test, affects downstream outputs, there is the potential for breakage]
924 [thanks to Jonas Stein for making me look at this, see bug: #617298, <br>
925 was not documented because there has been no intention to keep it, but
926 there was no markup replacement until now]
927 * ok for plaintext, html, xhtml, xml, epub, pdf, manpage
928 * not properly honored in paragraph objects for odt [todo fix, but issue]
929
930 * sisurc.yml, config settings
931
932 * vim
933 * sisu syntax highlighting, linebreak \\ added (<br> kept)
934 * colors, added cursor line & column
935
936 * documentation, on additional breaks in document
937 * linebreak \\ (previously undocumented <br> kept but depreciated)
938 [it is intended that this should close #617298]
939 * page break (breaks column if column, else breaks page)
940 * page new (new page, breaks page)
941 * removed section on hyperestraier, too specialised for general manpage
942 (also section not checked recently)
943
944 * texpdf
945 * define latex \newcommands for some special characters to simplify
946 dealing with them in sisu code \hardspace \caret \pipe \curlyopen
947 \curlyclose \lt \gt \slash \backslash \underscore \exclaim
948 * provide backslash character in code block
949
950 * plaintext, codeblock keep backslashes
951
952 * html_tune revision
953 * deal with angle brackets in markup (test, could cause breakage)
954 * reduce loops
955
956 * manpage
957 * start to honor line-breaks within objects (revisit)
958 * show double escape \\ (backslashes) in code blocks
959 * place under web server directory
960
961 * texinfo
962 * backslashes & line-breaks
963 * place under web server directory
964 * info tool setting prompt
965
966 * shared source markup (.sst .ssm & sisupod.zip)
967
968 * manifest enable
969 * manpage (in fututure have config setting with default false/off)
970 * info (texinfo) (in fututure have config setting with default false/off)
971 * hash digests
972 * locate markup source
973 * sisupod
974
975 * urls (ansi screen reporting), add document language code
976
977 * sysenv, accommodate
978 * manifest
979 * manpage
980 * info (texinfo)
981 * sisupod
982 * shared source markup (.sst .ssm & sisupod.zip) fix some paths
983 * placement of markup source, output_path.src.dir, fix
984 * output_path.src.url, fix
985
986 * constants, a sisupod & an xml related addition
987
988 * ansi screen reporting include document language code
989
990 * sisu_3.0.12.orig.tar.gz (2011-06-09:23/4)
991 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.12
992
993 * harvest
994 * correct paths to document manifests etc. for the possible output dir
995 structures
996 * produce authors and topics lists for the documents that are available,
997 according to availability in each language
998
999 * cgi generated sample search form
1000 * use ruby 1.9.2 shebang/header (sisu-pgsql, sisu-sqlite) recent upload
1001 of libdbi-ruby1.9.1 fixes bug reported as #596103 (against
1002 libdbd-pg-ruby1.9.1), search forms (pgsql & sqlite) can now use ruby
1003 1.9.2, so cgi headers changed back to #!/usr/bin/env ruby [however must
1004 use ruby >=1.9.2] (from #!/usr/bin/ruby1.8) [see sisu-3.0.8 NOTE &
1005 "sample search form" solution, (now superseded)]
1006 * force utf-8 character encoding to avoid issues, fix
1007 (incompatible character encodings: UTF-8 and US-ASCII)
1008 * correction of a variable name, fix
1009
1010 * options
1011 * restrict glob rule checks to when --glob (-G) or --find (-f) requested
1012 * carry information on document language (from filename and or directory
1013 * (additional test)
1014
1015 * sysenv, limit/prevent the creation of spurious output directories (based on
1016 language subdirectories), revisit
1017
1018 * manifest, fix a full name
1019
1020 * html, index.html syslink, remove and remake syslink
1021 * texpdf, index.html syslink, made similar
1022
1023 * param, remove unused class variable '@@symlnk'
1024
1025 * help
1026 * --help language, provides list of available languages (ISO 639-1 code (as
1027 varied by po4a) & name)
1028 * s/Bul garian/Bulgarian/ (Closes: #619068)
1029
1030 * sisu_3.0.11.orig.tar.gz (2011-05-29:21/7)
1031 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.11
1032
1033 * sysenv, url webserver link (manifest) fix
1034
1035 * cgi search form, fixes related to language code
1036 (filename with language code being required as unique document identifier)
1037
1038 * options
1039 * filter out files not matching .ss[tm]
1040 * with -f -G (--find|--glob) flag glob all .ss[tm] files in dir including
1041 language sub-directories (e.g. in directory above language
1042 sub-directories where ./_sisu/sisurc.yml should be located:)
1043 sisu3 -3G live-manual
1044 * with -f (--find|--glob) flag and find .ss[tm] files that match given
1045 string in dir including language subdirectories
1046 sisu3 -3GR
1047
1048 * i18n, constants, some language information moved to i18n (from constants)
1049
1050 * documentation, minor update, includes --find / --glob
1051
1052 * sisu_3.0.10.orig.tar.gz (2011-05-23:21/1)
1053 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.10
1054
1055 * copyright (minor) touch, dates for setup.rb
1056
1057 * sysenv, rsync, embedded
1058 * rsync to remote host alternative output structures, fix
1059 (remove blocking test path)
1060 * get rid of annoying new nag to terminal (-v reporting
1061 Dir.pwd), prevent attempt to change directory unless different directory
1062 requested
1063
1064 * param, html, epub, xml, simplify file-naming convention with language code
1065 (language code occurs in fixed location within file-name, could previously
1066 be configured to occur in 1 of 3 locations within file-name)
1067
1068 * texpdf filenames
1069
1070 * i18n, add language name translation column to hash/table
1071
1072 * prog_text_translation:
1073 * fix to Portuguese language class name (missed the 't')
1074 * language name matching ('Portuguese Brazil')
1075 * indentation
1076
1077 * options, include markup source "base" path, used to parse alternative
1078 markup source dir structures
1079
1080 * manifest
1081 * relative paths to "available outputs" (for each dir structure), fix
1082 * show language versions published
1083 (needs 2 runs of manifest, polls output as to whether manifest files exist)
1084
1085 * html
1086 * close files
1087 * syslink index.html to toc.html, needs revisit
1088 (will only "work" properly with by_language directory structure)
1089
1090 * defaults, fix path to homepage image (more fixes remain ...)
1091
1092 * sisu_3.0.9.orig.tar.gz (2011-05-17:20/2)
1093 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.9
1094
1095 * bin/sisu2 introduced (to complement bin/sisu3), currently same as bin/sisu
1096 (later switch bin/sisu to bin/sisu3; consider using update-alternatives)
1097
1098 * vim, cterm colorschemes, touch search color
1099
1100 * copyright file, softlink, make more visible in tarball and update
1101 * sisu-mode.el assigned to FSF (GNU EMACS)
1102
1103 * options, expand name of file for selected language directories
1104 * only use for single file(name) available in multiple languages e.g.
1105 sisu3 -hv en/free_culture.lawrence_lessig.sst es fr
1106 * english assumed as default language, make default configurable later
1107 * particularly useful for po4a
1108
1109 * sysenv
1110 * output directory structure check, fix & start testing alternatives
1111 sisurc.yml output_by: (language|filetype|filename)
1112 * output paths restructured, to have dir, url rel(ative) & rcp (for rsync or scp)
1113 * url paths to output files (requires setup in sisurc.yml)
1114 * consolidated output paths, directory & url, affecting many files
1115
1116 * rsync of output must cope with alternative file structures
1117
1118 * scp, disable until looked at
1119
1120 * dal_expand_insertions, fix resulting urls for shortcut for sisu generated
1121 document in same output directory
1122
1123 * cgi sample search form generated to provide different links depending on
1124 output structure, now links only to manifest and html toc
1125
1126 * manifest, url path, fix
1127
1128 * po4a, re-enabled, numerous issues
1129
1130 * sisu_3.0.8.orig.tar.gz (2011-05-05:18/4)
1131 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.8
1132
1133 * bin/sisu3 bin/sisu /bin/sisu_webrick bin/sisu_termsheet
1134 * improved ruby version check
1135
1136 * options, language setting, based on directory structure or filename
1137 * sysenv, language setting from options
1138 * affects multiple libraries
1139
1140 * i18n, sysenv, options, language setting changes affecting many files
1141 * must be able to set language at options stage from filename or directory
1142
1143 * prog_text_translation, renamed from what was i18n, i18n name reused
1144
1145 * db, directory structure changed, database prefix renamed
1146 * language_document_char field made larger
1147 [consider renaming language_document_code or ..._id]
1148 * title, src_filename and language_document_char fields mandatory
1149 (title, title_main, src_filename, language_document_char)
1150
1151 * NOTE: [libdbi-ruby1.9.1 fixed in unstable 2011-06-06, & for sisu-3.0.12]
1152 cgi sample search form caught by Ruby/DBI libdbi-ruby1.9.1 reported
1153 reported as libdbd-pg-ruby1.9.1 bug #596103, where "select_all fails". The
1154 cgi sample search scripts for postgresql and sqlite3 are almost identical,
1155 both work in ruby 1.8.7, both have the same error in ruby 1.9.2... a very
1156 similar bug is reported about the mysql library. Should #596103 and the
1157 upstream report be reported against Ruby/DBI (libdbi-ruby1.9.1) rather than
1158 libdbd-pg-ruby1.9.1?
1159 * <http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=596103>
1160 * <http://rubyforge.org/tracker/index.php?func=detail&aid=28624&group_id=234&atid=967>
1161 * <http://rubyforge.org/forum/forum.php?set=custom&forum_id=958&style=nested&max_rows=25&submit=Change+View>
1162 fix/workaround options include:
1163 * await bugfix, (bug has existed at least since 2010-09)
1164 * rewrite for ruby-dbi using other constructs
1165 e.g. s.fetch {|row| ...}
1166 * revert to ruby 1.8.7 for the cgi script (they work independently of the
1167 rest of the program anyway)
1168 * rewrite for individual database dbi re: psql and sqlite3
1169 * await rdbi (ruby-dbi replacement), also needs to be packaged for Debian
1170 <rdbi https://github.com/RDBI/rdbi>
1171 <http://rdbi.hollensbe.org/>
1172 <http://rdbi.hollensbe.org/files/README_rdoc.html>
1173 and develop for that
1174 * use some other programming language for sample search form
1175 or some meaningful combination of any of the above.
1176
1177 * sample search form, revert to generating ruby 1.8.7 sample
1178 * sisu3 using ruby >=1.9.2p180 generates search form for ruby 1.8.7, so:
1179 generate sample form using sisu3 -F (options), then; start webrick using
1180 ruby 1.8.7 & sisu -W (not sisu3)
1181 * take account of alternative output directory structures [work on, test]
1182
1183 * manpage, reinstate escape of hyphens (clearly preferred, else lintian
1184 reports hyphen-used-as-minus-sign)
1185
1186 * manpages, escaped hyphens reinstated (remove lintian info)
1187
1188 * urls, a fix, sqlite
1189
1190 * sysenv, lowriter (instead of libreoffice)
1191
1192 * db_select, ansi screen reporting, correction for sqlite db update
1193
1194 * concordance, output path, screen info correction
1195
1196 * vim
1197 * sisu syntax change of a couple of color groups (Delimiter instead of
1198 Include)
1199 * 8 color cterm colorschemes
1200 * sparse series uses dark grey on black, usually looks better, but only
1201 works with a fixed color cursor, preferred in terms where you can get
1202 away with using it
1203 * frugal series avoids dark grey
1204 * slate for cterm now incorporates frugal-cterm-sisu
1205 * *-cterm-ruby & *-cterm-sisu colors adjusted where other color groupings are
1206 preferred for programming / sisu markup
1207
1208 * sisu_3.0.7.orig.tar.gz (2011-04-20:16/3)
1209 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.7
1210
1211 * param, md remove md.cmd and md.mod shortcut methods, use use md.opt
1212 (md.opt.cmd md.opt.mod)
1213 * affects many files that now use @md.opt.cmd & @md.opt.mod
1214 (instead of @md.cmd & @md.mod)
1215
1216 * options
1217 * new alias (for -M / --maintenance) --keep-processing-files (see Bug#622902)
1218 * introduce opt.act booleans made up of opt.cmd and opt.mod, more flexible
1219 than overused cmd characters
1220 * where possible move option setting from hub to options
1221 * separate out a few methods
1222
1223 * odf:odt
1224 * maintenance, processing in separate subdirectories, that can be
1225 kept
1226 * odt.zip (bin) directory renamed odt from odf
1227
1228 * hub
1229 * some option setting moved to options
1230 * favor use of opt.act over opt.cmd where appropriate
1231
1232 * sysenv
1233 * variable directory path fixing (language, filetype, filname), making
1234 the stub for at least manifest and html available early for processing
1235 that do not or should not need to process individual markup files
1236 completely, such as the cgi search form and harvest
1237 * odf:odt paths adjusted for changes in maintenance and odt.zip
1238
1239 * harvest
1240 * place with document manifests
1241 * variable directory path fixing (language, filetype, filname)
1242
1243 * cgi, sample-search-form
1244 * results still not right, (ruby1.9.2 libraries? double check script)
1245 * not yet done variable directory path fixing for result links
1246
1247 * vim colors colorscheme Slate reviewed, cterm 8 colors, & frugal added
1248 * Slate, review conflicting group colors
1249 * 8, cterm colors to work with
1250 * frugal, cterm colors ... my term oddly has 8 colors plus 242 for
1251 dark grey possibly more but odd numbers to set
1252
1253 * sisu-mode.el header notes copyright assignment to FSF 2011-04-08
1254 (GNU EMACS)
1255 * url to sisu git repo source (when possible also track GNU EMACS location)
1256
1257 * screen_text_color (ansi colors) touched, consider reviewing later
1258
1259 * urls, report output locations
1260 * fix show all urls -U
1261 * share/reuse code
1262 * fix maintenance urls -M (where processing files are kept for examination)
1263 * odf maintenance added
1264 * html_tune maintenance fix
1265
1266 * documentation, sisu-markup-samples, man page, html
1267 * document existence of new alias for -M (--maintenance)
1268 --keep-maintenance-files (see Bug#622902)
1269
1270 * sisu_3.0.6.orig.tar.gz (2011-03-30:13/3)
1271 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.6
1272
1273 * (ruby 1.9.2 (transition related) fixes)
1274 * dal_doc_str
1275 * empty line not paragraph object
1276 * table structure issue, double spaced empty line creates spurious newline
1277 * dal_images, image path setting
1278 * cgi sample-search-form, string output (also cleaned unused help text)
1279
1280 * sysenv, remove repeated method
1281
1282 * vim colorscheme Slate, review console colors
1283 * change warning and diff colors, so as not to conflict
1284 * review cterm colors
1285 * for console use color names instead of numbers
1286 * rearrange
1287
1288 * sisu_3.0.5.orig.tar.gz (2011-03-24:12/4)
1289 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.5
1290
1291 * move to ruby >=1.9.2p180: simplify development of v3 and maintenance of v2
1292 * bin/sisu demand ruby >=1.9.2p180 (version checks)
1293 * debian/control, dependencies
1294 [note should at least be v1.9.2p180, when issues in earlier versions of
1295 ruby-1.9.2 were first observed to be gone]
1296
1297 * texpdf bugfix, where map_nametags not found, drop nametag (rather than
1298 crash)
1299 [Debian-live, live-manual (Ben Armstrong, chals?, reported new bug in a
1300 number of translations (that crashed the pdf generator). It turns out where
1301 map_nametags is not found the document crashes.]
1302
1303 * vim syntax highlighting, fix typo
1304
1305 * sisu_3.0.4.orig.tar.gz (2011-03-11:10/5)
1306 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.4
1307
1308 * move to ruby >=1.9.2p180: simplify development of v3 and maintenance of v2
1309 * bin/sisu demand ruby >=1.9.2p180 (version checks)
1310 * debian/control, dependencies
1311 [note should at least be v1.9.2p180, when issues in earlier versions of
1312 ruby-1.9.2 were first observed to be gone]
1313
1314 * texpdf bugfix, where map_nametags not found, drop nametag (rather than
1315 crash)
1316 [Debian-live, live-manual (Ben Armstrong, chals?, reported new bug in a
1317 number of translations (that crashed the pdf generator). It turns out where
1318 map_nametags is not found the document crashes.]
1319
1320 * vim syntax highlighting, fix typo
1321
1322 * sisu_manual, sisu_download, remove references to versions of sisu
1323
1324 * sisu_3.0.3.orig.tar.gz (2011-03-11:10/5)
1325 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.3
1326
1327 * dal_syntax and affected downstream output modules, revised pattern match
1328 for mail, (removes occasional interference with urls having embedded email
1329 addresses)
1330
1331 * dal_syntax: (internal document) link matching, a fix
1332
1333 [Debian-live, live-manual (Jose Luis Zabalza, Ben Armstrong, reported bug in
1334 Spanish translation markup (that crashed the pdf generator). Bug in markup
1335 subsequently identified as "versátil,#{iso-hybrid}#, se" which the interpreter
1336 identified as an internal document link to a comma (instead of as being
1337 monospace markup), markup should have been "versátil, #{iso-hybrid}#, se" this
1338 fix prevents that incorrect match, (but the markup remains faulty and the
1339 monospace markup is not identified as such without the corrected spacing).
1340 Unfortunate "grave" results for what is a pretty insignificant data entry
1341 typo (there are no doubt other such situations).]
1342
1343 * dal_substitutions_and_insertions: regex for sisu header matching (in sisu
1344 markup code blocks), a fix
1345
1346 * dal_doc_str: fix, looks like typo in regex
1347
1348 * param: tidy, remove redundant document header tags
1349
1350 * manpage output presentation fixes
1351 * manpage: (lowercase .br; correct newlines before .nf and
1352 after .fi; no escape of hyphens; remove redundant links; endnotes array
1353 requires flatten; screen info on output path)
1354 * param: manpage header .br and no escape of hyphens
1355 * urls: correct output path for manpage
1356
1357 * texpdf: url (regex) pattern match fix (/https?/)
1358
1359 * help (markup): correct path to markup-samples
1360
1361 * documentation more link fixes
1362
1363 * syntax highlighting
1364 * emacs sisu headers updated (subheaders omitted for now) sisu-mode.el
1365 * vim cleaning sisu.vim
1366
1367 * sisu_3.0.2.orig.tar.gz (2011-03-05:09/6)
1368 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.2
1369
1370 v3, target ruby1.9.2, ruby1.9.2p180 is ok
1371 note: there are issues with sisu and early versions of ruby1.9.2
1372 ruby1.9.2p0 is known to segfault on a number of operations
1373 ruby1.9.2p180 does not have these issues
1374
1375 * make sisu: v3 require >=ruby1.9.2 (v2 require >=ruby1.8.7)
1376 bin/sisu bin/sisu3 modified accordingly
1377
1378 * use rb1.9.2 "require_relative" syntax
1379
1380 * ruby 1.9 hash symbol syntax adopted
1381
1382 * space between each and opening curly brace e.g. "x.each {|y| p y}"
1383
1384 * use "encoding: utf-8" (instead of coding)
1385
1386 * sysenv, processing_path method (separated from path) and resulting
1387 necessary changes
1388
1389 * urls, param, two unrelated regex fixes, check
1390
1391 * hub, minor rearranging
1392
1393 * v2, v3: manpage, adjust output, fewer backslashes
1394
1395 * v2, v3: defaults, clean homepage
1396
1397 * v2, v3: consolidate manual & markup samples
1398 sisu markup source, manpages, man2html
1399 * clean up headers
1400 * update and correct links
1401 * tidy
1402 * small fixes
1403
1404 * conf/skin remove less important skins and use syslink to share
1405 doc/skin_sisu.rb
1406
1407 * sisu_3.0.1.orig.tar.gz (2011-02-16:07/3)
1408 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.1
1409
1410 * sysenv, sisurc.yml and elsewhere as affected, output_dir_structure:
1411 by_language_code; by_filetype; by_filename
1412
1413 * css, fix css paths for xhtml, xml dom & xml sax
1414
1415 * console feedback on selected files being processed, updates & fixes
1416
1417 * sysenv & sisurc.yml: libreoffice, default odf reader
1418
1419 * sisu_3.0.0.orig.tar.gz (2011-02-07:06/1)
1420 http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=log;h=refs/tags/sisu-3.0.0
1421
1422 NOTE: Processing defaults to v2, for v3 use 'sisu3' or 'sisu --v3'
1423
1424 Versions 3 is experimental and attempts to introduce output more compatible
1425 with mobile devices and other non-web use and more internationalisation
1426 possibilities.
1427
1428 NOTE: v3 branch opened, big patch, changes interim/incomplete (with
1429 possibility of breakage) primarily for: ebook-readers and other downloading
1430 viewers (alternative directory structures and use of title based filenames);
1431 internationalisation (use with po4a, export pot & po, alternative directory
1432 structures, use of git to ensure changes not lost).
1433
1434 In v3 SiSU markup files may be organised in language directories that are
1435 given their language code. There are alternative output directory structures
1436 depending on whether you want: the v2 layout (mostly in a directory of the
1437 given filename/a generic filetype name); a monolingual version 3 layout,
1438 which organises files by filetype/given file name; multilingual v3 layout,
1439 which organises files by language code/filetype/given which is illustrated
1440 below
1441
1442 * alternative output directory structures, configurable
1443 ├── en
1444 │   ├── epub
1445 │   ├── hashes
1446 │   ├── html
1447 │   │   └── live-manual
1448 │   ├── manifest
1449 │   ├── odt
1450 │   ├── pdf
1451 │   ├── sitemaps
1452 │   ├── txt
1453 │   ├── xhtml
1454 │   └── xml
1455 ├── fr
1456 │   ├── epub
1457 │   ├── hashes
1458 │   ├── html
1459 │   │   └── live-manual
1460 │   ├── manifest
1461 │   ├── odt
1462 │   ├── pdf
1463 │   ├── sitemaps
1464 │   ├── txt
1465 │   ├── xhtml
1466 │   └── xml
1467 ├── po4a
1468 │   └── live-manual
1469 │   ├── po
1470 │   │   └── fr
1471 │   └── pot
1472 └── _sisu
1473 ├── css
1474 ├── image
1475 ├── image_sys -> ../../_sisu/image_sys
1476 └── xml
1477 ├── rnc
1478 ├── rng
1479 └── xsd
1480 [FIX todo:
1481 * post rsync,
1482 * output url paths,
1483 * also processing of url,
1484 * processing of sisupod,
1485 * search db?,
1486 * search cgi
1487 ]
1488
1489 * sisu processing possibility of using directory path and sisu source
1490 filename, rather than only content in current directory by filename
1491 [rc config rules are that if not processing from current directory, or
1492 directory above language sub-directory, will not find _sisu in sisu source
1493 file directory, but rather will use ~/.sisu if any or /etc/sisu]
1494
1495 * po4a, work on
1496 * pot, po output from source language and translation
1497 * directory structure
1498 * alternative source directory structures: source and translation files
1499 organised either by existing file naming convention (file.sst
1500 filename~es.sst filname~fr.sst filename~de.sst), or; by placement in
1501 language subdirectories (that follow debian po4a language identification
1502 convention) ( ./en/file.sst ./es/file.sst ./fr/file.sst ./de/file.sst
1503 [./_sisu])
1504 * process po4a source composite file (.ssm) together with its includes
1505 (.ssi and/or .sst), by identifying composite file to process ... includes
1506 are identified and processed as well
1507 [extensive testing required, initial tests passed on "free_culture" and
1508 "live-manual" and translations]
1509 * integrate use of git, ensure changes are not lost
1510
1511 * sisupod git, revisiting
1512 * internationalize directory structure
1513 ├── conf
1514 │   └── skin
1515 ├── mm
1516 │   └── image
1517 ├── po4a
1518 │   ├── po
1519 │   │   ├── en
1520 │   │   └── fr
1521 │   └── pot
1522 └── src
1523 ├── en
1524 └── fr
1525 [FIX todo: sisu parsing, not sorted!, directory path parsing major step]
1526
1527 * object, block text of='block' (instead of 'group'), introduce is='block'
1528 * dal_doc_str, dal_doc_objects, identify
1529 * dal_syntax, introduce block syntax block{ }block, like group
1530 * vim syntax highlighting, match block
1531 * related downstream changes (many files affected)
1532 Note: adjust output representation later
1533
1534 [UGLY HACKS:
1535 po4a, en assumed as source lanuage, should be configurable
1536 po4a, only configured so far to recognise fr & es, fix
1537 po4a for processing .ssm .ssi, skipping of md title & author
1538 ]
1539 [FIX todo:
1540 directory structure for multilingual outputs
1541 breakage to epub, where src and trans dirs
1542 manifest
1543 decide what to do about source output & po4a & git
1544 ]