From 4a660c929a7871767966749e2a93035b2eb0d3f7 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Thu, 11 Dec 2008 21:53:41 -0500 Subject: help and changelog update --- data/doc/sisu/html/sisu.1.html | 37 ++++++++++++---------- .../sisu_manual/sisu_markup.sst | 2 +- 2 files changed, 22 insertions(+), 17 deletions(-) (limited to 'data/doc') diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html index 1848611b..c17fecc6 100644 --- a/data/doc/sisu/html/sisu.1.html +++ b/data/doc/sisu/html/sisu.1.html @@ -723,13 +723,13 @@ up files are available as html with syntax highlighting for viewing: </usr/share/doc/sisu/sisu_markup_samples/non-free

8. MARKUP OF HEADERS

- Headers consist of semantic meta-data about a document, which can be used -by any output module of the program; and may in addition include extra -processing instructions. -

Note: the first line of a document may include -information on the markup version used in the form of a comment. Comments -are a percentage mark at the start of a paragraph (and as the first character -in a line of text) followed by a space and the comment: + Headers contain either: semantic meta-data about a document, which can +be used by any output module of the program, or; processing instructions. + +

Note: the first line of a document may include information on the markup +version used in the form of a comment. Comments are a percentage mark at +the start of a paragraph (and as the first character in a line of text) +followed by a space and the comment: 


  % this would be a comment
@@ -742,13 +742,18 @@ one (without the comments):
 
  % SiSU 0.57
   @title: SiSU
   @subtitle: Markup
-  @creator: Ralph Amissah
+  @creator: Amissah, Ralph
+  % note formatting on author / creator field, surname comma then other
+names, if more than one author separate by semi-colon
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
 License GPL 3
   @type: information
   @subject: ebook, epublishing, electronic book, electronic publishing,
 electronic document, electronic citation, data structure, citation systems,
 search
+  @topic_register: text markup language; application:text processing;output:html|xml|latex|pdf|sql
+  % note formatting for topic_register topic levels are separated by a
+colon, a semi-colon separates main topics
   @date.created: 2002-08-28
   @date.issued: 2002-08-28
   @date.available: 2002-08-28
@@ -1147,17 +1152,17 @@ is used there is neither decoration nor hyperlinking, code blocks are discussed
 
  markup example: 
 
 
 
 

-
      [ tux.png ]
+
  { tux.png 64x80 }image
   % various url linked images
-      [ tux.png ]
-      [ GnuDebianLinuxRubyBetterWay.png ]
+  {tux.png 64x80
+  {GnuDebianLinuxRubyBetterWay.png 100x101
   {~^ ruby_logo.png
 

 
  resulting output: 
 
  [ tux.png ] 
 
  tux.png 64x80 
 
  [  ruby_logo  (png  missing)
- ]  [^14] 
+ ] [^14] 
 
  GnuDebianLinuxRubyBetterWay.png 100x101 and Ruby 
 
  linked url footnote
 
@@ -3378,15 +3383,15 @@ of this document: 
 
 

 
-
* Generated by: SiSU 0.68.0 of 2008w29/1 (2008-07-21) 

+
* Generated by: SiSU 0.70.0 of 2008w48/3 (2008-12-03) 

 

 
 
* Ruby version: ruby
-1.8.7 (2008-06-20 patchlevel 22) [i486-linux] 

+1.8.7 (2008-08-11 patchlevel 72) [i486-linux] 
 

 
-
* Last Generated on: Mon Jul 21
-02:54:35 -0400 2008 

+
* Last Generated on: Tue Dec 09
+12:24:07 -0500 2008 

 

 
 
* SiSU http://www.jus.uio.no/sisu
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
index 292bfe13..853b4124 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
@@ -127,7 +127,7 @@ code{
 
 @creator: Amissah, Ralph
 
-% note formatting on author / creator field, surname comma then other names, if more than one author separate by semi-colon
+% note formatting rules on author / creator field, "Surname, Other names", if more than one author separate by semi-colon (if name is of an institution just write name or the name contains a comma enclose in quotation marks)
 
 @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3
 
-- 
cgit v1.2.3


From f20476d31f60bd1e8c83e91379f414bdc0cfdd60 Mon Sep 17 00:00:00 2001
From: Ralph Amissah 
Date: Sat, 13 Dec 2008 14:08:19 -0500
Subject: mostly additional metadata fields

additional metadata fields
css minor touch
help minor info touch
---
 data/doc/sisu/html/sisu.1.html                               |  7 ++++---
 .../doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst | 12 ++++++++----
 2 files changed, 12 insertions(+), 7 deletions(-)

(limited to 'data/doc')

diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index c17fecc6..8f8bff3f 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -743,8 +743,7 @@ one (without the comments):
   @title: SiSU
   @subtitle: Markup
   @creator: Amissah, Ralph
-  % note formatting on author / creator field, surname comma then other
-names, if more than one author separate by semi-colon
+  % note formatting rules on author / creator field,
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
 License GPL 3
   @type: information
@@ -754,11 +753,13 @@ search
   @topic_register: text markup language; application:text processing;output:html|xml|latex|pdf|sql
   % note formatting for topic_register topic levels are separated by a
 colon, a semi-colon separates main topics
+  @date: 2007-09-16
+  % original publication date unless the substantive text is updated/modified,
+then date of update
   @date.created: 2002-08-28
   @date.issued: 2002-08-28
   @date.available: 2002-08-28
   @date.modified: 2007-09-16
-  @date: 2007-09-16
   @level: new=C; break=1; num_top=1
   % comment: in this @level header num_top=1 starts automatic heading numbering
 at heading level 1 (numbering continues 3 levels down); the new and break
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
index 853b4124..c31a1abe 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
@@ -10,8 +10,12 @@
 
 @type: information
 
+@topic_register: SiSU:manual:sisu markup
+
 @subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
 
+@date: 2008-05-22
+
 @date.created: 2002-08-28
 
 @date.issued: 2002-08-28
@@ -20,8 +24,6 @@
 
 @date.modified: 2008-05-22
 
-@date: 2008-05-22
-
 @level: new=C; break=1; num_top=1
 
 @skin: skin_sisu_manual
@@ -139,6 +141,10 @@ code{
 
 % note formatting for topic_register topic levels are separated by a colon, a semi-colon separates main topics
 
+@date: 2007-09-16
+
+% original publication date unless the substantive text is updated/modified, then date of update
+
 @date.created: 2002-08-28
 
 @date.issued: 2002-08-28
@@ -147,8 +153,6 @@ code{
 
 @date.modified: 2007-09-16
 
-@date: 2007-09-16
-
 @level: new=C; break=1; num_top=1
 
 % comment: in this @level header num_top=1 starts automatic heading numbering at heading level 1 (numbering continues 3 levels down); the new and break instructions are used by the LaTeX/pdf and odf output to determine where to put page breaks (that are not used by html output or say sql database population).
-- 
cgit v1.2.3


From 3827556849d7c9099c5bb2cbc3493d48f12f3594 Mon Sep 17 00:00:00 2001
From: Ralph Amissah 
Date: Sun, 14 Dec 2008 00:05:02 -0500
Subject: markup samples, minor updates

---
 ...edom.richard_stallman_crusade_for_free_software.sam_williams.sst | 6 +++++-
 data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst                 | 4 ++++
 data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst                 | 4 +++-
 3 files changed, 12 insertions(+), 2 deletions(-)

(limited to 'data/doc')

diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
index 503e6a6d..74b90a4f 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/free_as_in_freedom.richard_stallman_crusade_for_free_software.sam_williams.sst
@@ -4,10 +4,14 @@
 
 @subtitle: Richard Stallman's Crusade for Free Software
 
-@author: Sam Williams
+@author: Williams, Sam
 
 @rights: Copyright (C) Sam Williams 2002, published under the GNU Free Documentation License. Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Document License, Version 1.1 or any later version published by the Free Software Foundation; with the Invariant Sections being no invariant sections, with the Front-Cover Texts being no invariant sections, and with the Back-Cover Texts being no invariant sections. A copy of the license is included in Appendix C, GNU Free Documentation License. All images are to be included verbatim when the document is copied, distributed, or modified under the terms of the GFDL.
 
+@topic_register: SiSU:markup sample:book;copyright;GNU/Linux:GPL|copyleft|free software;free software;Software:Software Libré;GPL;Linux:GNU|Software Libré;book:biography
+
+@date: 2002
+
 @language: US
 
 @notes: March 2002
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
index dfabc14e..b091616b 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl2.fsf.sst
@@ -6,6 +6,10 @@
 
 @rights: Copyright Copyright 1989, 1991 Free Software Foundation, Inc. 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
 
+@date: 1991
+
+@topic_register: GPL;Software:license;GNU/Linux:License:GPL
+
 @links: {Free Software Foundation}http://www.fsf.org
 {GPL @ SiSU}http://www.jus.uio.no/sisu/gpl2.fsf
 {Markup}http://www.jus.uio.no/sisu/sample/markup/gpl2.fsf.sst
diff --git a/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
index 358accce..10889acf 100644
--- a/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
+++ b/data/doc/sisu/sisu_markup_samples/dfsg/gpl3.fsf.sst
@@ -6,6 +6,8 @@ SiSU 0.52
 
 @rights: Copyright (C) 2007 Free Software Foundation, Inc. http://fsf.org/ Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.
 
+@topic_register: GPL;Software:license
+
 @date: 2007-06-29
 
 @date.available: 2007-06-29
@@ -242,7 +244,7 @@ IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL ANY C
 
 If the disclaimer of warranty and limitation of liability provided above cannot be given local legal effect according to their terms, reviewing courts shall apply local law that most closely approximates an absolute waiver of all civil liability in connection with the Program, unless a warranty or assumption of liability accompanies a copy of the Program in return for a fee.
 
-END OF TERMS AND CONDITIONS
+!_ END OF TERMS AND CONDITIONS
 
 1~ How to Apply These Terms to Your New Programs
 
-- 
cgit v1.2.3


From 1deffbefc09b1521f9fac8c0796bebdf93a04698 Mon Sep 17 00:00:00 2001
From: Ralph Amissah 
Date: Sun, 14 Dec 2008 00:23:45 -0500
Subject: changelog synced and man pages, minor updates

---
 data/doc/sisu/html/sisu.1.html                                | 3 ++-
 data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm        | 4 ++--
 data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst | 4 ++--
 3 files changed, 6 insertions(+), 5 deletions(-)

(limited to 'data/doc')

diff --git a/data/doc/sisu/html/sisu.1.html b/data/doc/sisu/html/sisu.1.html
index 8f8bff3f..25b6e7e4 100644
--- a/data/doc/sisu/html/sisu.1.html
+++ b/data/doc/sisu/html/sisu.1.html
@@ -743,7 +743,8 @@ one (without the comments):
   @title: SiSU
   @subtitle: Markup
   @creator: Amissah, Ralph
-  % note formatting rules on author / creator field,
+  % note formatting on author / creator field, surname comma then other
+names, if more than one author separate using semi-colon
   @rights: Copyright (C) Ralph Amissah 2007, part of SiSU documentation,
 License GPL 3
   @type: information
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
index 676e23d7..9e891fcb 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu.ssm
@@ -18,9 +18,9 @@
 
 @date.available: 2002-08-28
 
-@date.modified: 2008-05-22
+@date.modified: 2008-12-14
 
-@date: 2008-05-22
+@date: 2008-12-14
 
 @level: new=C; break=1; num_top=1
 
diff --git a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
index c31a1abe..dd620872 100644
--- a/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
+++ b/data/doc/sisu/sisu_markup_samples/sisu_manual/sisu_markup.sst
@@ -14,7 +14,7 @@
 
 @subject: ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search
 
-@date: 2008-05-22
+@date: 2008-12-14
 
 @date.created: 2002-08-28
 
@@ -22,7 +22,7 @@
 
 @date.available: 2002-08-28
 
-@date.modified: 2008-05-22
+@date.modified: 2008-12-14
 
 @level: new=C; break=1; num_top=1
 
-- 
cgit v1.2.3