org mode (ruby code within)

178 files changed, 9246 insertions, 10075 deletions

diff --git a/lib/sisu.rb b/lib/sisu.rb
index b4dee16b..7fb49eba 100644
--- a/lib/sisu.rb
+++ b/lib/sisu.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** hub
-
-** Author: Ralph Amissah
-  <ralph@amissah.com>
-  <ralph.amissah@gmail.com>
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see <http://www.gnu.org/licenses/>.
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  <http://www.fsf.org/licensing/licenses/gpl.html>
-  <http://www.gnu.org/licenses/gpl.html>
-
-  <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  <http://www.jus.uio.no/sisu>
-  <http://www.sisudoc.org>
-
-** Git
-  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary>
-  <http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu.rb;hb=HEAD>
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sisu
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_libs
   require_relative 'sisu/hub'                               # sisu/hub.rb
   require_relative 'sisu/se'                                # sisu/se.rb
diff --git a/lib/sisu/air.rb b/lib/sisu/air.rb
index 08c67c5c..3644ebc6 100644
--- a/lib/sisu/air.rb
+++ b/lib/sisu/air.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/air.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Air
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
   class Source
diff --git a/lib/sisu/ao.rb b/lib/sisu/ao.rb
index 1a32f3c7..02dbad3e 100644
--- a/lib/sisu/ao.rb
+++ b/lib/sisu/ao.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** preprocessing, (document abstraction), data abstraction used in subsequent
-    processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/ao_appendices.rb b/lib/sisu/ao_appendices.rb
index 536c540a..6b0d09e5 100644
--- a/lib/sisu/ao_appendices.rb
+++ b/lib/sisu/ao_appendices.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_appendices.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Appendices
   class Glossary
     def initialize(md,data)
diff --git a/lib/sisu/ao_character_check.rb b/lib/sisu/ao_character_check.rb
index 314ccbf6..434902c2 100644
--- a/lib/sisu/ao_character_check.rb
+++ b/lib/sisu/ao_character_check.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_character_check.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_CharacterCheck
   class Check
     def initialize(data)
@@ -97,4 +95,3 @@ module SiSU_AO_CharacterCheck
     end
   end
 end
-__END__
diff --git a/lib/sisu/ao_composite.rb b/lib/sisu/ao_composite.rb
index 353b8ce9..81b3808f 100644
--- a/lib/sisu/ao_composite.rb
+++ b/lib/sisu/ao_composite.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** composite documents, assemble/build documents from other documents
-  or parts of marked up text
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_composite.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Assemble
   require_relative 'se'                                 # se.rb
   require_relative 'utils_composite'                    # utils_composite.rb
diff --git a/lib/sisu/ao_doc_objects.rb b/lib/sisu/ao_doc_objects.rb
index 7e1b7741..4e0366b1 100644
--- a/lib/sisu/ao_doc_objects.rb
+++ b/lib/sisu/ao_doc_objects.rb
@@ -1,58 +1,56 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document abstraction
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_doc_objects.rb;hb=HEAD]
-
-=end
-module SiSU_AO_DocumentStructure
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
+Module SiSU_AO_DocumentStructure
   class Extract
     def extract(h,o)
       h ? h : o
diff --git a/lib/sisu/ao_doc_str.rb b/lib/sisu/ao_doc_str.rb
index 31fd62ec..08394b92 100644
--- a/lib/sisu/ao_doc_str.rb
+++ b/lib/sisu/ao_doc_str.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document abstraction
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_doc_str.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_DocumentStructureExtract
   require_relative 'ao_persist'                     # ao_persist.rb
   class Instantiate < SiSU_Param::Parameters::Instructions
diff --git a/lib/sisu/ao_endnotes.rb b/lib/sisu/ao_endnotes.rb
index ecfae936..96b217e7 100644
--- a/lib/sisu/ao_endnotes.rb
+++ b/lib/sisu/ao_endnotes.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_doc_endnotes.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Endnotes
   class Endnotes
     def initialize(md,data,endnote_array=nil)
diff --git a/lib/sisu/ao_expand_insertions.rb b/lib/sisu/ao_expand_insertions.rb
index c65b62d6..38e05d9c 100644
--- a/lib/sisu/ao_expand_insertions.rb
+++ b/lib/sisu/ao_expand_insertions.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_expand_insertions.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Insertions
   class Insertions
     def initialize(md,data)
diff --git a/lib/sisu/ao_hash_digest.rb b/lib/sisu/ao_hash_digest.rb
index 9518af5a..853fc9e6 100644
--- a/lib/sisu/ao_hash_digest.rb
+++ b/lib/sisu/ao_hash_digest.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_hash_digest.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Hash
   require_relative 'shared_markup_alt.rb'               #shared_markup_alt.rb
   class ObjectDigest
diff --git a/lib/sisu/ao_idx.rb b/lib/sisu/ao_idx.rb
index 8dc53e99..506c2cc7 100644
--- a/lib/sisu/ao_idx.rb
+++ b/lib/sisu/ao_idx.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_idx.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_BookIndex
   class BookIndex
     def initialize(md,data,env=nil)
diff --git a/lib/sisu/ao_images.rb b/lib/sisu/ao_images.rb
index d563aef8..ce685090 100644
--- a/lib/sisu/ao_images.rb
+++ b/lib/sisu/ao_images.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_images.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Images
   class Images
     begin
diff --git a/lib/sisu/ao_metadata.rb b/lib/sisu/ao_metadata.rb
index c3144fb2..165d5fb2 100644
--- a/lib/sisu/ao_metadata.rb
+++ b/lib/sisu/ao_metadata.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_metadata.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Metadata
   class Metadata
     def initialize(md,metad)
diff --git a/lib/sisu/ao_misc_arrange.rb b/lib/sisu/ao_misc_arrange.rb
index d76f2b5b..5f107f04 100644
--- a/lib/sisu/ao_misc_arrange.rb
+++ b/lib/sisu/ao_misc_arrange.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_misc_arrange.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_MiscArrangeText
   class SI
     def initialize(md,data)
diff --git a/lib/sisu/ao_numbering.rb b/lib/sisu/ao_numbering.rb
index 777c5a44..7cfff564 100644
--- a/lib/sisu/ao_numbering.rb
+++ b/lib/sisu/ao_numbering.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_numbering.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Numbering
   class Numbering
     attr_accessor :obj,:osp,:ocn,:lv,:name,:index,:comment
diff --git a/lib/sisu/ao_persist.rb b/lib/sisu/ao_persist.rb
index d2a39c90..9c7d32c4 100644
--- a/lib/sisu/ao_persist.rb
+++ b/lib/sisu/ao_persist.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document abstraction
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_persist.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Persist
   class Persist
     @@persistance=nil
diff --git a/lib/sisu/ao_syntax.rb b/lib/sisu/ao_syntax.rb
index 61a2ef87..163d080f 100644
--- a/lib/sisu/ao_syntax.rb
+++ b/lib/sisu/ao_syntax.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Syntax for markup, input markup syntaxes, determined here
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/ao_syntax.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     abstraction
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_AO_Syntax
   class Words
     def initialize(line,md,mkp)
diff --git a/lib/sisu/cgi.rb b/lib/sisu/cgi.rb
index ecd45df7..4836f385 100644
--- a/lib/sisu/cgi.rb
+++ b/lib/sisu/cgi.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** generates naive cgi search form for search of sisu database (pgsql sqlite)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/cgi.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     cgi
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_CGI                                        #% database building documents
   require_relative 'se'                                 # se.rb
   require_relative 'cgi_pgsql'                          # cgi_pgsql.rb
diff --git a/lib/sisu/cgi_pgsql.rb b/lib/sisu/cgi_pgsql.rb
index 1cc277f1..490ab62d 100644
--- a/lib/sisu/cgi_pgsql.rb
+++ b/lib/sisu/cgi_pgsql.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** generates naive cgi search form for search of sisu database (pgsql)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/cgi_pgsql.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     cgi
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_CGI_PgSQL                                  #% database building documents
   require_relative 'se'                                 # se.rb
   require_relative 'cgi_sql_common'                     # cgi_sql_common.rb
diff --git a/lib/sisu/cgi_sql_common.rb b/lib/sisu/cgi_sql_common.rb
index b18a26c7..2c75393e 100644
--- a/lib/sisu/cgi_sql_common.rb
+++ b/lib/sisu/cgi_sql_common.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** generates naive cgi search form for search of sisu database (pgsql sqlite)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/cgi_sql_common.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     cgi
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_CGI_SQL
   class CGI_Common
     def initialize(webserv,opt,image_src,dir)
@@ -106,7 +104,7 @@ module SiSU_CGI_SQL
    * Standard SiSU meta-markup syntax, and the
    * Standard SiSU object citation numbering and system
 
- * Hompages:
+ * Homepages:
    [http://www.jus.uio.no/sisu]
    [http://www.sisudoc.org]
 
diff --git a/lib/sisu/cgi_sqlite.rb b/lib/sisu/cgi_sqlite.rb
index 7ca4ba83..cc77c45e 100644
--- a/lib/sisu/cgi_sqlite.rb
+++ b/lib/sisu/cgi_sqlite.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** generates naive cgi search form for search of sisu database (sqlite)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/cgi_sql_sqlite.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     cgi
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_CGI_SQLite                                 #% database building documents
   require_relative 'se'                                 # se.rb
   require_relative 'cgi_sql_common'                     # cgi_sql_common.rb
diff --git a/lib/sisu/conf.rb b/lib/sisu/conf.rb
index 4622bebc..800add9c 100644
--- a/lib/sisu/conf.rb
+++ b/lib/sisu/conf.rb
@@ -1,57 +1,54 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** configuration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/conf.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     config
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Initialize
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/constants.rb b/lib/sisu/constants.rb
index 1c126201..da25b7cd 100644
--- a/lib/sisu/constants.rb
+++ b/lib/sisu/constants.rb
@@ -1,59 +1,56 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** constants, system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/constants.rb;hb=HEAD]
-
-=end
-#Ax,Xx,Mx,Rx,Hx,Dx,Px,Ep,Db,Gt,Tex=Array.new(11){{}}
-YEAR='2016'
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
+YEAR='2021'
 Sfx={
   txt:                       '.txt',
   txt_textile:               '.textile',
diff --git a/lib/sisu/css.rb b/lib/sisu/css.rb
index aae9aeb8..6994e04b 100644
--- a/lib/sisu/css.rb
+++ b/lib/sisu/css.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** css stylesheets
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/css.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     css
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Style
   require_relative 'se'                                 # se.rb
   require_relative 'html_parts'                         # html_parts.rb
diff --git a/lib/sisu/db_columns.rb b/lib/sisu/db_columns.rb
index 608b59a7..8722d38d 100644
--- a/lib/sisu/db_columns.rb
+++ b/lib/sisu/db_columns.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_columns.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbColumns
   require_relative 'se'                                # se.rb
   require_relative 'db_sqltxt'                         # db_sqltxt.rb
diff --git a/lib/sisu/db_create.rb b/lib/sisu/db_create.rb
index 5cf26e4a..e61eb7d0 100644
--- a/lib/sisu/db_create.rb
+++ b/lib/sisu/db_create.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_create.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbCreate
   require_relative 'db_columns'                         # db_columns.rb
   class Create < SiSU_DbColumns::Columns
diff --git a/lib/sisu/db_dbi.rb b/lib/sisu/db_dbi.rb
index 38b2fd2a..d453dfe0 100644
--- a/lib/sisu/db_dbi.rb
+++ b/lib/sisu/db_dbi.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_dbi.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_DbDBI
   require_relative 'db_columns'                                             # db_columns.rb
   require_relative 'db_tests'                                               # db_tests.rb
diff --git a/lib/sisu/db_drop.rb b/lib/sisu/db_drop.rb
index 848713b1..aa91a8a6 100644
--- a/lib/sisu/db_drop.rb
+++ b/lib/sisu/db_drop.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_drop.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbDrop
   require_relative 'utils_response'                   # utils_response.rb
   class Drop
diff --git a/lib/sisu/db_import.rb b/lib/sisu/db_import.rb
index 9261a6a9..f021fea5 100644
--- a/lib/sisu/db_import.rb
+++ b/lib/sisu/db_import.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_import.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbImport
   require_relative 'db_columns'                         # db_columns.rb
   require_relative 'db_load_tuple'                      # db_load_tuple.rb
diff --git a/lib/sisu/db_indexes.rb b/lib/sisu/db_indexes.rb
index ec7006de..519a0c11 100644
--- a/lib/sisu/db_indexes.rb
+++ b/lib/sisu/db_indexes.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_indexes.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbIndex
   class Index                                           # create documents Indexes def initialize(opt,conn='',sql_type)
     def initialize(opt,conn,file,sql_type)
diff --git a/lib/sisu/db_load_tuple.rb b/lib/sisu/db_load_tuple.rb
index d7b8e857..84561fb7 100644
--- a/lib/sisu/db_load_tuple.rb
+++ b/lib/sisu/db_load_tuple.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_load_tuple.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbTuple
   require_relative 'db_columns'                         # db_columns.rb
   class LoadDocuments
diff --git a/lib/sisu/db_remove.rb b/lib/sisu/db_remove.rb
index 322f50a8..26a232a9 100644
--- a/lib/sisu/db_remove.rb
+++ b/lib/sisu/db_remove.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_remove.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbRemove
   class Remove
     include SiSU_DbAction
diff --git a/lib/sisu/db_select.rb b/lib/sisu/db_select.rb
index 47054c4a..d2e17835 100644
--- a/lib/sisu/db_select.rb
+++ b/lib/sisu/db_select.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_select.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbAction
   def db_action(sdb)
     @sdb=sdb
diff --git a/lib/sisu/db_sqltxt.rb b/lib/sisu/db_sqltxt.rb
index c6c2e301..7adee45c 100644
--- a/lib/sisu/db_sqltxt.rb
+++ b/lib/sisu/db_sqltxt.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_sqltxt.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbText
   class Prepare
     def special_character_escape(str)
diff --git a/lib/sisu/db_tests.rb b/lib/sisu/db_tests.rb
index d7924b6d..d6e81921 100644
--- a/lib/sisu/db_tests.rb
+++ b/lib/sisu/db_tests.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by the different db types, dbi, postgresql, sqlite
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/db_tests.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DbTests
   class Test
     def initialize(info,opt)
diff --git a/lib/sisu/dbi.rb b/lib/sisu/dbi.rb
index e6b005ec..d2bddb1d 100644
--- a/lib/sisu/dbi.rb
+++ b/lib/sisu/dbi.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** postgresql module, dbi import frame
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/dbi.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_DBI                                                                 #% database building
   require_relative 'se'                                 # se.rb
     include SiSU_Env; include SiSU_Screen
diff --git a/lib/sisu/dbi_discrete.rb b/lib/sisu/dbi_discrete.rb
index 226477c0..a80114cf 100644
--- a/lib/sisu/dbi_discrete.rb
+++ b/lib/sisu/dbi_discrete.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** postgresql module, dbi import frame
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/dbi_discrete.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     db sql
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module  SiSU_DBI_Discrete                               #% database building
   require_relative 'se'                                 # se.rb
     include SiSU_Env; include SiSU_Screen
diff --git a/lib/sisu/digests.rb b/lib/sisu/digests.rb
index 0507f2ff..fcd7a753 100644
--- a/lib/sisu/digests.rb
+++ b/lib/sisu/digests.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document digests (md5|sha256) and structure processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/digests.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     digests
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_DigestView
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
   require_relative 'prog_text_translation'              # prog_text_translation.rb
diff --git a/lib/sisu/dp.rb b/lib/sisu/dp.rb
index 3c7b9203..85b71c10 100644
--- a/lib/sisu/dp.rb
+++ b/lib/sisu/dp.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document parameters extracted from input files for program use
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/dp.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     param
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Param
   begin
     require 'uri'
diff --git a/lib/sisu/dp_identify_markup.rb b/lib/sisu/dp_identify_markup.rb
index fdc7a6ba..8439bff3 100644
--- a/lib/sisu/dp_identify_markup.rb
+++ b/lib/sisu/dp_identify_markup.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** A conversion script for canned substitutions, a fairly generic simple tool
-  that can be used to store other canned conversions, used here for altering
-  SiSU markup
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/dp_identify_markup.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     param
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_MarkupType
   class MarkupIdentify
     @@version={}
diff --git a/lib/sisu/dp_make.rb b/lib/sisu/dp_make.rb
index 5e20827b..25dfca6f 100644
--- a/lib/sisu/dp_make.rb
+++ b/lib/sisu/dp_make.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** document parameters make extracted for program use
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/dp_make.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     param
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Param_Make
   class MdMake
     def initialize(str,opt,env)
diff --git a/lib/sisu/embedded.rb b/lib/sisu/embedded.rb
index f99e5c1e..066cc39a 100644
--- a/lib/sisu/embedded.rb
+++ b/lib/sisu/embedded.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** sitemap created from parameters extracted from input file(s)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/embedded.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Embedded
   require_relative 'dp'                                 # dp.rb
     include SiSU_Param
diff --git a/lib/sisu/errors.rb b/lib/sisu/errors.rb
index 02d64638..bff4e0e8 100644
--- a/lib/sisu/errors.rb
+++ b/lib/sisu/errors.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, error screen reporting
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/errors.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Errors
   require_relative 'se'                                 # se.rb
     include SiSU_Env; include SiSU_Screen
diff --git a/lib/sisu/generic_parts.rb b/lib/sisu/generic_parts.rb
index 063c21af..4b1e0e6f 100644
--- a/lib/sisu/generic_parts.rb
+++ b/lib/sisu/generic_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_Generic
   def the_url
     def urify(uri)
diff --git a/lib/sisu/git.rb b/lib/sisu/git.rb
index 9e6b9e39..3b0a040d 100644
--- a/lib/sisu/git.rb
+++ b/lib/sisu/git.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/git.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Git
   require_relative 'dp'                                 # dp.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/html.rb b/lib/sisu/html.rb
index ddece373..ffe0b7b7 100644
--- a/lib/sisu/html.rb
+++ b/lib/sisu/html.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML
   begin
     require 'pstore'
diff --git a/lib/sisu/html_concordance.rb b/lib/sisu/html_concordance.rb
index c6dd3478..b80d2761 100644
--- a/lib/sisu/html_concordance.rb
+++ b/lib/sisu/html_concordance.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** concordance file (html, wordmap, linked index of words in document)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_concordance.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Concordance
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/html_format.rb b/lib/sisu/html_format.rb
index b371dbee..079edb3f 100644
--- a/lib/sisu/html_format.rb
+++ b/lib/sisu/html_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html formating, css template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Format
   require_relative 'html_parts'                         # html_parts.rb
   class ParagraphNumber
diff --git a/lib/sisu/html_harvest.rb b/lib/sisu/html_harvest.rb
index 4d6d77cc..22de54d7 100644
--- a/lib/sisu/html_harvest.rb
+++ b/lib/sisu/html_harvest.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** metadata harvest, harvest metadata from document corpus
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/harvest.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     harvest
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Harvest
   @@the_idx_topics,@@the_idx_authors={},{}
   class Source
@@ -104,4 +102,3 @@ WOK
     end
   end
 end
-__END__
diff --git a/lib/sisu/html_harvest_author_format.rb b/lib/sisu/html_harvest_author_format.rb
index 3ce0f3c2..20f9d3d0 100644
--- a/lib/sisu/html_harvest_author_format.rb
+++ b/lib/sisu/html_harvest_author_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/harvest_author_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     harvest
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_FormatAuthor
   class Author
     def initialize(author_param)
diff --git a/lib/sisu/html_harvest_authors.rb b/lib/sisu/html_harvest_authors.rb
index 76f0c87f..fbf6b9bc 100644
--- a/lib/sisu/html_harvest_authors.rb
+++ b/lib/sisu/html_harvest_authors.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** metadata harvest, extract authors and their writings from document set
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/harvest_authors.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     harvest
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HarvestAuthors
   require_relative 'html_harvest_author_format'          # html_harvest_author_format.rb
   require_relative 'html_parts'                          # html_parts.rb
diff --git a/lib/sisu/html_harvest_topics.rb b/lib/sisu/html_harvest_topics.rb
index b9437124..d6715aa0 100644
--- a/lib/sisu/html_harvest_topics.rb
+++ b/lib/sisu/html_harvest_topics.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-***  metadata harvest, extract topics and associated writings from document set
-  (topics use topic_register header)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/harvest_topics.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     harvest
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HarvestTopics
   require_relative 'html_harvest_author_format'          # html_harvest_author_format.rb
   require_relative 'html_parts'                          # html_parts.rb
@@ -181,7 +178,7 @@ module SiSU_HarvestTopics
       else
         if (@opt.act[:verbose_plus][:set]==:on \
         || @opt.act[:maintenance][:set]==:on)
-          p "missing required field in #{@filename} - [title]: <<#{@title}>>; [author]: <<#{@author_format}>>; [idx]: <<#{@idx_list}>>"
+          p "missing required field in #{@filename} - [title]: <#{@title}>; [author]: <#{@author_format}>; [idx]: <#{@idx_list}>"
         end
       end
       idx_array[lang]=idx_array[lang].flatten
diff --git a/lib/sisu/html_lite_shared.rb b/lib/sisu/html_lite_shared.rb
index b03a686c..f4260fa8 100644
--- a/lib/sisu/html_lite_shared.rb
+++ b/lib/sisu/html_lite_shared.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by db and flatfile output generators, mostly xml/xhtml/html
-  formatting
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_lite_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_FormatShared
   require_relative 'html_parts'                         # html_parts.rb
   class CSS_Format
diff --git a/lib/sisu/html_manifest.rb b/lib/sisu/html_manifest.rb
index 1fcf1d02..28117a00 100644
--- a/lib/sisu/html_manifest.rb
+++ b/lib/sisu/html_manifest.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** summary of generated outputs and metadata
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_manifest.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Manifest
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/html_minitoc.rb b/lib/sisu/html_minitoc.rb
index 158e391b..9346af8b 100644
--- a/lib/sisu/html_minitoc.rb
+++ b/lib/sisu/html_minitoc.rb
@@ -1,228 +1,226 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html minitoc
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_minitoc.rb;hb=HEAD]
-
-=end
-  module SiSU_HTML_MiniToc
-    require_relative 'html_tune'                        # html_tune.rb
-      include SiSU_HTML_Tune
-    class TocMini
-      @@seg_mini=nil
-      @@seg_url=''
-      @@firstseg=nil
-      def initialize(md,data)
-        @md,@data=md,data
-        @pat_strip_heading_name=/<a name="h?\d.*?">(.+?)<\/a>/
-        @tell=SiSU_Screen::Ansi.new(@md.opt.act[:color_state][:set]) if @md
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
+module SiSU_HTML_MiniToc
+  require_relative 'html_tune'                        # html_tune.rb
+    include SiSU_HTML_Tune
+  class TocMini
+    @@seg_mini=nil
+    @@seg_url=''
+    @@firstseg=nil
+    def initialize(md,data)
+      @md,@data=md,data
+      @pat_strip_heading_name=/<a name="h?\d.*?">(.+?)<\/a>/
+      @tell=SiSU_Screen::Ansi.new(@md.opt.act[:color_state][:set]) if @md
+    end
+    def songsheet
+      if (@md.opt.act[:verbose][:set]==:on \
+      || @md.opt.act[:verbose_plus][:set]==:on \
+      || @md.opt.act[:maintenance][:set]==:on)
+        SiSU_Screen::Ansi.new(@md.opt.act[:color_state][:set],'Toc').txt_grey
       end
-      def songsheet
-        if (@md.opt.act[:verbose][:set]==:on \
-        || @md.opt.act[:verbose_plus][:set]==:on \
-        || @md.opt.act[:maintenance][:set]==:on)
-          SiSU_Screen::Ansi.new(@md.opt.act[:color_state][:set],'Toc').txt_grey
-        end
-        toc=nil
-        @toc=[]
-        @data.each do |txt|
-          if txt.is ==:heading \
-          || txt.is ==:heading_insert
-            txt.obj=txt.obj.gsub(/(?:#{Mx[:en_a_o]}|#{Mx[:en_b_o]}).+?(?:#{Mx[:en_a_c]}|#{Mx[:en_b_c]})/m,''). #remove endnotes from toc
-              gsub(/<a name="-\d+" href="#_\d+">&nbsp;<sup>\d+<\/sup>&nbsp;<\/a>/,'').
-              gsub(@pat_strip_heading_name,'\1')
-              #gsub(/(.*?)<a name="(\d+)"><\/a>(.*)/,'\1') #2002w42 altered gsub - problematic? - suspect
-            toc=case txt.ln
-            when 0 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_0
-            when 1 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_1
-            when 2 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_2
-            when 3 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_3
-            when 4 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_4
-            when 5 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_5
-            when 6 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_6
-            else
-            end
-            @toc << toc
+      toc=nil
+      @toc=[]
+      @data.each do |txt|
+        if txt.is ==:heading \
+        || txt.is ==:heading_insert
+          txt.obj=txt.obj.gsub(/(?:#{Mx[:en_a_o]}|#{Mx[:en_b_o]}).+?(?:#{Mx[:en_a_c]}|#{Mx[:en_b_c]})/m,''). #remove endnotes from toc
+            gsub(/<a name="-\d+" href="#_\d+">&nbsp;<sup>\d+<\/sup>&nbsp;<\/a>/,'').
+            gsub(@pat_strip_heading_name,'\1')
+            #gsub(/(.*?)<a name="(\d+)"><\/a>(.*)/,'\1') #2002w42 altered gsub - problematic? - suspect
+          toc=case txt.ln
+          when 0 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_0
+          when 1 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_1
+          when 2 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_2
+          when 3 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_3
+          when 4 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_4
+          when 5 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_5
+          when 6 then SiSU_HTML_MiniToc::TocMini.new(@md,txt).level_6
+          else
           end
+          @toc << toc
         end
-        @toc
       end
-    protected
-      def level_concordance
-        format_head_toc=SiSU_HTML_Format::HeadToc.new(@md)
-        @@seg_mini << format_head_toc.mini_seg_concordance
+      @toc
+    end
+  protected
+    def level_concordance
+      format_head_toc=SiSU_HTML_Format::HeadToc.new(@md)
+      @@seg_mini << format_head_toc.mini_seg_concordance
+    end
+    def level_metadata
+      format_head_toc=SiSU_HTML_Format::HeadToc.new(@md)
+      @@seg_mini << format_head_toc.mini_seg_metadata
+    end
+    def level_word_index
+      format_head_toc=SiSU_HTML_Format::HeadToc.new(@d0c)
+      @@seg_mini << format_head_toc.mini_concordance
+    end
+    def level_0
+      txt=@data
+      if (txt.is ==:heading \
+      || txt.is ==:heading_insert) \
+      && txt.ocn !=0
+        txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
       end
-      def level_metadata
-        format_head_toc=SiSU_HTML_Format::HeadToc.new(@md)
-        @@seg_mini << format_head_toc.mini_seg_metadata
+      txt_obj={ txt: txt.obj }
+      format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+      toc_mini=format_toc.mini_lev0
+      toc_mini
+    end
+    def level_1
+      txt=@data
+      if (txt.is ==:heading \
+      || txt.is ==:heading_insert) \
+      && txt.ocn !=0
+        txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
       end
-      def level_word_index
-        format_head_toc=SiSU_HTML_Format::HeadToc.new(@d0c)
-        @@seg_mini << format_head_toc.mini_concordance
+      title=unless txt.obj =~/Document Information/ then txt.obj
+      else
+        link='metadata'
+        %{<b><a href="#{link}#{@md.lang_code_insert}#{Sfx[:html]}">#{txt.obj}</a></b>}
       end
-      def level_0
-        txt=@data
-        if (txt.is ==:heading \
-        || txt.is ==:heading_insert) \
-        && txt.ocn !=0
-          txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
-        end
-        txt_obj={ txt: txt.obj }
-        format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-        toc_mini=format_toc.mini_lev0
-        toc_mini
+      txt_obj={ txt: title }
+      format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+      toc_mini=if txt.name =~/^meta/ \
+      and txt.obj=~/Document Information/
+        format_toc.mini_tail
+      else format_toc.mini_lev1
       end
-      def level_1
-        txt=@data
-        if (txt.is ==:heading \
-        || txt.is ==:heading_insert) \
-        && txt.ocn !=0
-          txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
-        end
-        title=unless txt.obj =~/Document Information/ then txt.obj
-        else
-          link='metadata'
-          %{<b><a href="#{link}#{@md.lang_code_insert}#{Sfx[:html]}">#{txt.obj}</a></b>}
-        end
-        txt_obj={ txt: title }
-        format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-        toc_mini=if txt.name =~/^meta/ \
-        and txt.obj=~/Document Information/
-          format_toc.mini_tail
-        else format_toc.mini_lev1
-        end
-        toc_mini
+      toc_mini
+    end
+    def level_2
+      txt=@data
+      if (txt.is ==:heading \
+      || txt.is ==:heading_insert) \
+      && txt.ocn !=0
+        txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
       end
-      def level_2
-        txt=@data
-        if (txt.is ==:heading \
-        || txt.is ==:heading_insert) \
-        && txt.ocn !=0
-          txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
+      txt_obj={ txt: txt.obj }
+      format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+      toc_mini=format_toc.mini_lev2
+      toc_mini
+    end
+    def level_3
+      txt=@data
+      txt_obj={ txt: txt.obj }
+      format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+      toc_mini=format_toc.mini_lev3
+      toc_mini
+    end
+    def level_4
+      txt=@data
+      unless txt.obj =~/~metadata/
+        if txt.ln ==4
+          fnh={
+            fn: txt.name,
+          }
+          f=@md.file.base_filename.html_seg(fnh)
+          seg_link=%{  <a href="#{f}" target="_top">
+    #{txt.obj}
+  </a> }
+          @@seg_url=txt.name
+        elsif txt.obj =~/\d+.\d+.\d+.\d+|\d+.\d+.\d+|\d+.\d+|\d+/
+          fn,hd=/^(\d+.\d+.\d+.\d+|\d+.\d+.\d+|\d+.\d+|\d+)(.*)/.match(dob.obj)[1,2]
+          fnh={
+            fn: fn,
+          }
+          f=@md.file.base_filename.html_seg(fnh)
+          seg_link=%{<a href="#{f}" target="_top">#{fn} #{hd}</a> }
         end
-        txt_obj={ txt: txt.obj }
-        format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-        toc_mini=format_toc.mini_lev2
-        toc_mini
-      end
-      def level_3
-        txt=@data
-        txt_obj={ txt: txt.obj }
+        txt_obj={ txt: seg_link }
         format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-        toc_mini=format_toc.mini_lev3
+        toc_mini=format_toc.mini_lev4
         toc_mini
       end
-      def level_4
-        txt=@data
-        unless txt.obj =~/~metadata/
-          if txt.ln ==4
-            fnh={
-              fn: txt.name,
-            }
-            f=@md.file.base_filename.html_seg(fnh)
-            seg_link=%{  <a href="#{f}" target="_top">
-    #{txt.obj}
-  </a> }
-            @@seg_url=txt.name
-          elsif txt.obj =~/\d+.\d+.\d+.\d+|\d+.\d+.\d+|\d+.\d+|\d+/
-            fn,hd=/^(\d+.\d+.\d+.\d+|\d+.\d+.\d+|\d+.\d+|\d+)(.*)/.match(dob.obj)[1,2]
-            fnh={
-              fn: fn,
-            }
-            f=@md.file.base_filename.html_seg(fnh)
-            seg_link=%{<a href="#{f}" target="_top">#{fn} #{hd}</a> }
-          end
-          txt_obj={ txt: seg_link }
-          format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-          toc_mini=format_toc.mini_lev4
-          toc_mini
-        end
+    end
+    def level_5
+      txt=@data
+      if (txt.is ==:heading \
+      || txt.is ==:heading_insert) \
+      && txt.ocn !=0
+        txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
       end
-      def level_5
-        txt=@data
-        if (txt.is ==:heading \
-        || txt.is ==:heading_insert) \
-        && txt.ocn !=0
-          txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
-        end
-        fnh={
-          fn: @@seg_url,
-        }
-        f=@md.file.base_filename.html_seg(fnh)
-        lnk_n_txt=%{  <a href="#{f}##{txt.ocn}">
+      fnh={
+        fn: @@seg_url,
+      }
+      f=@md.file.base_filename.html_seg(fnh)
+      lnk_n_txt=%{  <a href="#{f}##{txt.ocn}">
     #{txt.obj}
   </a>}
-          txt_obj={ txt: lnk_n_txt }
-          format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-          toc_mini=format_toc.mini_lev5
-        toc_mini
+        txt_obj={ txt: lnk_n_txt }
+        format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+        toc_mini=format_toc.mini_lev5
+      toc_mini
+    end
+    def level_6
+      txt=@data
+      if (txt.is ==:heading \
+      || txt.is ==:heading_insert) \
+      && txt.ocn !=0
+        txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
       end
-      def level_6
-        txt=@data
-        if (txt.is ==:heading \
-        || txt.is ==:heading_insert) \
-        && txt.ocn !=0
-          txt.obj=txt.obj.gsub(@pat_strip_heading_name,'\1')
-        end
-        fnh={
-          fn: @@seg_url,
-        }
-        f=@md.file.base_filename.html_seg(fnh)
-        lnk_n_txt=%{  <a href="#{f}##{txt.ocn}">
+      fnh={
+        fn: @@seg_url,
+      }
+      f=@md.file.base_filename.html_seg(fnh)
+      lnk_n_txt=%{  <a href="#{f}##{txt.ocn}">
     #{txt.obj}
   </a>}
-          txt_obj={ txt: lnk_n_txt }
-          format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
-          toc_mini=format_toc.mini_lev6
-        toc_mini
-      end
+        txt_obj={ txt: lnk_n_txt }
+        format_toc=SiSU_HTML_Format::FormatToc.new(@md,txt_obj)
+        toc_mini=format_toc.mini_lev6
+      toc_mini
     end
   end
+end
 __END__
diff --git a/lib/sisu/html_parts.rb b/lib/sisu/html_parts.rb
index 0d4b8b06..60e0b4ea 100644
--- a/lib/sisu/html_parts.rb
+++ b/lib/sisu/html_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_HTML
   require_relative 'generic_parts'                       # generic_parts.rb
   include SiSU_Parts_Generic
diff --git a/lib/sisu/html_persist.rb b/lib/sisu/html_persist.rb
index 5ef100f3..1aa38eab 100644
--- a/lib/sisu/html_persist.rb
+++ b/lib/sisu/html_persist.rb
@@ -1,58 +1,56 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_persist.rb;hb=HEAD]
-
-=end
-module SiSU_HTML_Persist
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
+Module SiSU_HTML_Persist
   class Persist
     @@persist=nil
     attr_accessor :is0,:is1,:is2,:is3,:is4,:heading0,:heading1,:heading2,:heading3,:heading4, :title, :dot_nav, :tocband_banner, :tocband_bannerless, :headings, :heading_endnotes, :main, :endnote_all, :tail, :credits, :heading_idx, :idx, :seg_endnotes, :seg_endnotes_array, :segtocband, :get_hash_fn, :get_hash_to, :seg_subtoc, :seg_subtoc_array, :fn, :seg_name ,:seg_name_x,:seg_name_x_tracker
diff --git a/lib/sisu/html_promo.rb b/lib/sisu/html_promo.rb
index 1ff1c1d8..b7754e99 100644
--- a/lib/sisu/html_promo.rb
+++ b/lib/sisu/html_promo.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html advertising component, build here, mockup
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_promo.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Promo
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/html_scroll.rb b/lib/sisu/html_scroll.rb
index f2a8bb4f..650c90dd 100644
--- a/lib/sisu/html_scroll.rb
+++ b/lib/sisu/html_scroll.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html scroll generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_scroll.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Scroll
   require_relative 'html_shared'                        # html_shared.rb
   require_relative 'html'                               # html.rb
diff --git a/lib/sisu/html_segments.rb b/lib/sisu/html_segments.rb
index c31e90b8..99f6b760 100644
--- a/lib/sisu/html_segments.rb
+++ b/lib/sisu/html_segments.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_segments.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Seg
   require_relative 'html_shared'                        # html_shared.rb
   require_relative 'html'                               # html.rb
diff --git a/lib/sisu/html_shared.rb b/lib/sisu/html_shared.rb
index 40ee44dc..90f60d0a 100644
--- a/lib/sisu/html_shared.rb
+++ b/lib/sisu/html_shared.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Shared
   require_relative 'html_table'                         # html_table.rb
   class TableHTML < SiSU_HTML_Table::TableHTML
diff --git a/lib/sisu/html_table.rb b/lib/sisu/html_table.rb
index e341ed14..2daffc2e 100644
--- a/lib/sisu/html_table.rb
+++ b/lib/sisu/html_table.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts, table
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_table.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_HTML_Table
   require_relative 'xhtml_table'                         # xhtml_table.rb
   require_relative 'html_parts'                          # html_parts.rb
diff --git a/lib/sisu/html_tune.rb b/lib/sisu/html_tune.rb
index e9a489ad..c1c8a531 100644
--- a/lib/sisu/html_tune.rb
+++ b/lib/sisu/html_tune.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html generation, html pre-processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_tune.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     html
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 require_relative 'dp'                                   # dp.rb
 module SiSU_HTML_Tune
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/hub.rb b/lib/sisu/hub.rb
index 49d569a5..733d76fc 100644
--- a/lib/sisu/hub.rb
+++ b/lib/sisu/hub.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** hub
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/hub.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     hub
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU
   require_relative 'constants'                         # constants.rb
   require_relative 'se'                                # se.rb
diff --git a/lib/sisu/hub_actions.rb b/lib/sisu/hub_actions.rb
index a946591d..ac692bc7 100644
--- a/lib/sisu/hub_actions.rb
+++ b/lib/sisu/hub_actions.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** hub, perform selected actions
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/hub_actions.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     hub
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Hub_Actions
   class HubActions
     require_relative 'utils_composite'                    # utils_composite.rb
@@ -1104,15 +1102,15 @@ module SiSU_Hub_Actions
     end
     def webrick                                          # -W
       prt=SiSU_Env::InfoEnv.new(@fns).port.webrick_port
-      puts %{#{@cX.blue}<<#{@cX.off}#{@cX.green}Start Webrick web server on port: #{prt}#{@cX.off}#{@cX.blue}>> #{@cX.off*2} }
+      puts %{#{@cX.blue}[#{@cX.off}#{@cX.green}Start Webrick web server on port: #{prt}#{@cX.off}#{@cX.blue}] #{@cX.off*2} }
       require_relative 'webrick'
       SiSU_Webserv::WebrickStart.new
     end
     def not_found
-      puts "\n#{@cX.fuchsia}FILE NOT FOUND:#{@cX.off} << #{@opt.fns} >> - requested #{@opt.selections.str} processing skipped\n"
+      puts "\n#{@cX.fuchsia}FILE NOT FOUND:#{@cX.off} [ #{@opt.fns} ] - requested #{@opt.selections.str} processing skipped\n"
     end
     def convert_name_message(fns,type,i,o,rune)
-      %{\nIn filename: "#{@cX.fuchsia}#{fns}#{@cX.off}" << #{type} >> #{@cX.fuchsia}is apre 0.36 markup filename.#{@cX.off} #{@cX.brown}Please rename your file.#{@cX.off}\n\tAs of sisu-0.37, SiSU markup files with #{@cX.brown}the extensions #{i} should be re-named #{o}#{@cX.off}\n\tif you have the program called 'rename' installed, the following rune should do the trick:\n\t\t#{rune}\n\talternatively try:\n\t\tsisu --convert --36to37 #{fns}\n\trequested #{@opt.selections.str} processing skipped\n}
+      %{\nIn filename: "#{@cX.fuchsia}#{fns}#{@cX.off}" [ #{type} ] #{@cX.fuchsia}is apre 0.36 markup filename.#{@cX.off} #{@cX.brown}Please rename your file.#{@cX.off}\n\tAs of sisu-0.37, SiSU markup files with #{@cX.brown}the extensions #{i} should be re-named #{o}#{@cX.off}\n\tif you have the program called 'rename' installed, the following rune should do the trick:\n\t\t#{rune}\n\talternatively try:\n\t\tsisu --convert --36to37 #{fns}\n\trequested #{@opt.selections.str} processing skipped\n}
     end
     def not_recognised
       case @opt.fns
@@ -1126,9 +1124,9 @@ module SiSU_Hub_Actions
         puts convert_name_message(@opt.fns,type,'.r1 .r2 and .r3','.sst',rune)
         puts %{\n\tNote also that you will need to change the names of the files called/required\n\twithin the document text to build the composite document\n\t\t.s1 .s2 .s3 should be .sst \n\t\t.si should be .ssi\n\trequested #{@opt.selections.str} processing skipped\n}
       when /(\.ssi)$/
-        puts "\n#{@cX.fuchsia}component filetype:#{@cX.off} << #{@opt.fns} >> - is not a processed filetype, (it may be used as a component of a .ssm markup file)\n\trequested #{@opt.selections.str} processing skipped\n"
+        puts "\n#{@cX.fuchsia}component filetype:#{@cX.off} [ #{@opt.fns} ] - is not a processed filetype, (it may be used as a component of a .ssm markup file)\n\trequested #{@opt.selections.str} processing skipped\n"
       else
-        puts "\n#{@cX.fuchsia}FILETYPE NOT RECOGNISED:#{@cX.off} << #{@opt.fns} >> - is not a recognized filetype,\n\trequested #{@opt.selections.str} processing skipped\n"
+        puts "\n#{@cX.fuchsia}FILETYPE NOT RECOGNISED:#{@cX.off} [ #{@opt.fns} ] - is not a recognized filetype,\n\trequested #{@opt.selections.str} processing skipped\n"
       end
     end
   end
diff --git a/lib/sisu/hub_loop_markup_files.rb b/lib/sisu/hub_loop_markup_files.rb
index 28751b4e..ca02c800 100644
--- a/lib/sisu/hub_loop_markup_files.rb
+++ b/lib/sisu/hub_loop_markup_files.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** hub
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/hub_loop_markup_files.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     hub
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Hub_Loops
   require_relative 'constants'                         # constants.rb
   require_relative 'se'                                # se.rb
diff --git a/lib/sisu/hub_options.rb b/lib/sisu/hub_options.rb
index 194858f7..9f71e74b 100644
--- a/lib/sisu/hub_options.rb
+++ b/lib/sisu/hub_options.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** hub, command line options parsing
-
-*** hub
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/hub_options.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     hub
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Commandline
   begin
     require 'pathname'
diff --git a/lib/sisu/i18n.rb b/lib/sisu/i18n.rb
index f683858f..e9f11d50 100644
--- a/lib/sisu/i18n.rb
+++ b/lib/sisu/i18n.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** internationalisation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/i18n.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     i18n
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_i18n
   @@language_table,@@language_list=nil,nil
   class Languages
@@ -328,373 +326,4 @@ module SiSU_TextTranslation
     end
   end
 end
-#% Language List po4a
-http://www.debian.org/international/l10n/po/
-see polyglossia for subset
-* CSB (Unknown language)
-* KAB (Unknown language)
-* TLH (Unknown language)
-* aa (Afar)
-* ab (Abkhazian)
-* af (Afrikaans)
-* af_ZA (Afrikaans, as spoken in South Africa)
-* am (Amharic)
-* an (Unknown language)
-* ang (Unknown language)
-* ar (Arabic)
-* ar_AR (Arabic, as spoken in Argentina)
-* ar_EG (Arabic, as spoken in Egypt)
-* ar_OM (Arabic, as spoken in Oman)
-* ar_PS (Arabic, as spoken in Palestinian Territory, Occupied)
-* ar_SA (Arabic, as spoken in Saudi Arabia)
-* ar_SY (Arabic, as spoken in Syrian Arab Republic)
-* as (Assamese)
-* ast (Unknown language)
-* ay (Aymara)
-* az (Azerbaijani)
-* az_IR (Azerbaijani, as spoken in Iran)
-* be (Belarusian)
-* be@latin (Unknown language)
-* be@tarask (Unknown language)
-* bem (Unknown language)
-* bg (Bulgarian)
-* bg_BG (Bulgarian, as spoken in Bulgaria)
-* bi (Bislama)
-* bn (Bengali)
-* bn_BD (Bengali, as spoken in Bangladesh)
-* bn_IN (Bengali, as spoken in India)
-* bo (Tibetan)
-* br (Breton)
-* bs (Bosnian)
-* bs_BA (Bosnian, as spoken in Bosnia and Herzegovina)
-* bs_BS (Bosnian, as spoken in Bahamas)
-* byn (Unknown language)
-* ca (Catalan)
-* ca@valencia (Unknown language)
-* ca_AD (Catalan, as spoken in Andorra)
-* ca_ES (Catalan, as spoken in Spain)
-* ca_ES@valencia (Unknown language)
-* ca_FR (Catalan, as spoken in France)
-* ca_IT (Catalan, as spoken in Italy)
-* co (Corsican)
-* crh (Unknown language)
-* cs (Czech)
-* cs_CZ (Czech, as spoken in Czech Republic)
-* csb (Unknown language)
-* cy (Welsh)
-* cy_GB (Welsh, as spoken in Great Britain)
-* cz (Unknown language)
-* da (Danish)
-* da_DK (Danish, as spoken in Denmark)
-* de (German)
-* de_AT (German, as spoken in Austria)
-* de_CH (German, as spoken in Switzerland)
-* de_DE (German, as spoken in Germany)
-* dk (Unknown language)
-* dz (Dzongkha)
-* el (Greek)
-* el_GR (Greek, as spoken in Greece)
-* en (English)
-* en@boldquot (Unknown language)
-* en@quot (Unknown language)
-* en@shaw (Unknown language)
-* en_AU (English, as spoken in Australia)
-* en_CA (English, as spoken in Canada)
-* en_GB (English, as spoken in Great Britain)
-* en_NZ (English, as spoken in New Zealand)
-* en_US (English, as spoken in United States)
-* en_US@piglatin (Unknown language)
-* en_ZA (English, as spoken in South Africa)
-* eo (Esperanto)
-* es (Spanish)
-* es_AR (Spanish, as spoken in Argentina)
-* es_CL (Spanish, as spoken in Chile)
-* es_CO (Spanish, as spoken in Colombia)
-* es_CR (Spanish, as spoken in Costa Rica)
-* es_DO (Spanish, as spoken in Dominican Republic)
-* es_EC (Spanish, as spoken in Ecuador)
-* es_ES (Spanish, as spoken in Spain)
-* es_GA (Spanish, as spoken in Gabon)
-* es_GT (Spanish, as spoken in Guatemala)
-* es_HN (Spanish, as spoken in Honduras)
-* es_LA (Spanish, as spoken in Lao People''s Democratic Republic)
-* es_MX (Spanish, as spoken in Mexico)
-* es_NI (Spanish, as spoken in Nicaragua)
-* es_PA (Spanish, as spoken in Panama)
-* es_PE (Spanish, as spoken in Peru)
-* es_PR (Spanish, as spoken in Puerto Rico)
-* es_SV (Spanish, as spoken in El Salvador)
-* es_UY (Spanish, as spoken in Uruguay)
-* es_VE (Spanish, as spoken in Venezuela)
-* et (Estonian)
-* et_EE (Estonian, as spoken in Estonia)
-* eu (Basque)
-* eu_ES (Basque, as spoken in Spain)
-* fa (Persian)
-* fa_AF (Persian, as spoken in Afghanistan)
-* fa_IR (Persian, as spoken in Iran)
-* fi (Finnish)
-* fi_FI (Finnish, as spoken in Finland)
-* fil (Unknown language)
-* fo (Faeroese)
-* fo_FO (Faeroese, as spoken in Faroe Islands)
-* fr (French)
-* fr_BE (French, as spoken in Belgium)
-* fr_CA (French, as spoken in Canada)
-* fr_CH (French, as spoken in Switzerland)
-* fr_FR (French, as spoken in France)
-* fr_FX (French, as spoken in France, Metropolitan)
-* fr_LU (French, as spoken in Luxembourg)
-* frp (Unknown language)
-* fur (Unknown language)
-* fy (Frisian)
-* fy_NL (Frisian, as spoken in Netherlands)
-* ga (Irish)
-* gd (Gaelic (Scots))
-* gez (Unknown language)
-* gl (Galician)
-* gl_ES (Galician, as spoken in Spain)
-* gn (Guarani)
-* gu (Gujarati)
-* gv (Manx)
-* ha (Hausa)
-* he (Hebrew)
-* he_IL (Hebrew, as spoken in Israel)
-* hi (Hindi)
-* hne (Unknown language)
-* hr (Croatian)
-* hr_HR (Croatian, as spoken in Croatia)
-* ht (Unknown language)
-* hu (Hungarian)
-* hu_HU (Hungarian, as spoken in Hungary)
-* hy (Armenian)
-* ia (Interlingua)
-* id (Indonesian)
-* id_ID (Indonesian, as spoken in Indonesia)
-* ig (Unknown language)
-* io (Unknown language)
-* is (Icelandic)
-* is_IS (Icelandic, as spoken in Iceland)
-* it (Italian)
-* it_CH (Italian, as spoken in Switzerland)
-* it_IT (Italian, as spoken in Italy)
-* iu (Inuktitut)
-* ja (Japanese)
-* ja_JP (Japanese, as spoken in Japan)
-* jv (Unknown language)
-* jv_ID (Unknown language)
-* ka (Georgian)
-* kab (Unknown language)
-* kk (Kazakh)
-* kl (Kalaallisut)
-* km (Khmer)
-* km_KH (Khmer, as spoken in Cambodia)
-* kn (Kannada)
-* ko (Korean)
-* ko_KR (Korean, as spoken in Korea)
-* ks (Kashmiri)
-* ku (Kurdish)
-* kw (Cornish)
-* ky (Kirghiz)
-* la (Latin)
-* lb (Letzeburgesch)
-* lg (Unknown language)
-* li (Unknown language)
-* ln (Lingala)
-* lo (Lao)
-* lt (Lithuanian)
-* lt_LT (Lithuanian, as spoken in Lithuania)
-* lv (Latvian)
-* lv_LV (Latvian, as spoken in Latvia)
-* mai (Unknown language)
-* mal (Unknown language)
-* mg (Malagasy)
-* mi (Maori)
-* mk (Macedonian)
-* mk_MK (Macedonian, as spoken in Macedonia, the Former Yugoslav Republic of)
-* ml (Malayalam)
-* ml_IN (Malayalam, as spoken in India)
-* ml_ML (Malayalam, as spoken in Mali)
-* mn (Mongolian)
-* mr (Marathi)
-* ms (Malay)
-* ms_MY (Malay, as spoken in Malaysia)
-* mt (Maltese)
-* my (Burmese)
-* my_MM (Burmese, as spoken in Myanmar)
-* na (Nauru)
-* nb (Norwegian Bokmål)
-* nb_NO (Norwegian Bokmål, as spoken in Norway)
-* nds (Unknown language)
-* ne (Nepali)
-* new (Unknown language)
-* nl (Dutch)
-* nl_BE (Dutch, as spoken in Belgium)
-* nl_NL (Dutch, as spoken in Netherlands)
-* nn (Norwegian Nynorsk)
-* nn_NO (Norwegian Nynorsk, as spoken in Norway)
-* no (Norwegian)
-* no_NO (Norwegian, as spoken in Norway)
-* nr (Ndebele, South)
-* nso (Unknown language)
-* oc (Occitan (post 1500))
-* oc_FR (Occitan (post 1500), as spoken in France)
-* om (Oromo)
-* or (Oriya)
-* pa (Panjabi)
-* pl (Polish)
-* pl_PL (Polish, as spoken in Poland)
-* pms (Unknown language)
-* ps (Pushto)
-* pt (Portuguese)
-* pt_BR (Portuguese, as spoken in Brazil)
-* pt_PT (Portuguese, as spoken in Portugal)
-* qu (Quechua)
-* rm (Rhaeto-Romance)
-* ro (Romanian)
-* ro_RO (Romanian, as spoken in Romania)
-* ru (Russian)
-* ru_RU (Russian, as spoken in Russia)
-* rw (Kinyarwanda)
-* sa (Sanskrit)
-* sc (Sardinian)
-* sd (Sindhi)
-* se (Sami)
-* se_NO (Sami, as spoken in Norway)
-* si (Sinhalese)
-* si_LK (Sinhalese, as spoken in Sri Lanka)
-* si_SI (Sinhalese, as spoken in Slovenia)
-* sk (Slovak)
-* sk_SK (Slovak, as spoken in Slovakia)
-* sl (Slovenian)
-* sl_SI (Slovenian, as spoken in Slovenia)
-* sl_SL (Slovenian, as spoken in Sierra Leone)
-* so (Somali)
-* sp (Unknown language)
-* sq (Albanian)
-* sq_AL (Albanian, as spoken in Albania)
-* sr (Serbian)
-* sr@Latn (Unknown language)
-* sr@ije (Unknown language)
-* sr@ijekavian (Unknown language)
-* sr@ijekavianlatin (Unknown language)
-* sr@latin (Unknown language)
-* sr_SR (Serbian, as spoken in Suriname)
-* sr_YU (Serbian, as spoken in Yugoslavia)
-* st (Sotho)
-* su (Sundanese)
-* su_ID (Sundanese, as spoken in Indonesia)
-* sv (Swedish)
-* sv_SE (Swedish, as spoken in Sweden)
-* sw (Swahili)
-* ta (Tamil)
-* ta_LK (Tamil, as spoken in Sri Lanka)
-* te (Telugu)
-* tg (Tajik)
-* th (Thai)
-* th_TH (Thai, as spoken in Thailand)
-* ti (Tigrinya)
-* tig (Unknown language)
-* tk (Turkmen)
-* tl (Tagalog)
-* tlh (Unknown language)
-* to (Tonga)
-* tr (Turkish)
-* tr_TR (Turkish, as spoken in Turkey)
-* tt (Tatar)
-* ug (Uighur)
-* ug_CN (Uighur, as spoken in China)
-* uk (Ukrainian)
-* uk_UA (Ukrainian, as spoken in Ukraine)
-* ur (Urdu)
-* ur_PK (Urdu, as spoken in Pakistan)
-* uz (Uzbek)
-* uz@cyrillic (Unknown language)
-* ve (Unknown language)
-* vi (Vietnamese)
-* vi_AR (Vietnamese, as spoken in Argentina)
-* vi_DE (Vietnamese, as spoken in Germany)
-* vi_PL (Vietnamese, as spoken in Poland)
-* vi_TR (Vietnamese, as spoken in Turkey)
-* vi_VN (Vietnamese, as spoken in Vietnam)
-* wa (Unknown language)
-* wal (Unknown language)
-* wo (Wolof)
-* xh (Xhosa)
-* yi (Yiddish)
-* yo (Yoruba)
-* zh (Chinese)
-* zh_CN (Chinese, as spoken in China)
-* zh_HK (Chinese, as spoken in Hong Kong)
-* zh_TW (Chinese, as spoken in Taiwan)
-* zu (Zulu)
-
- 'sq';    'albanian'
- 'am';    'amharic'
-#'ar';    'arabic'         # see polyglossia
- 'hy';    'armenian'
-#'';      'asturian'       # polyglossia
-#'';      'bahasai'        # polyglossia
-#'';      'bahasam'        # polyglossia
- 'eu';    'basque'
- 'bn';    'bengali'
- 'pt_BR'; 'brazilian'
- 'br';    'breton'
- 'bg';    'bulgarian'
- 'ca';    'catalan'        # see polyglossia
-#'';      'coptic'         # polyglossia
- 'hr';    'croatian'
- 'cs';    'czech'
- 'da';    'danish'
-#'';      'divehi'         # polyglossia
- 'nl';    'dutch'          # see polyglossia
- 'en';    'english'        # see polyglossia
- 'eo';    'esperanto'      # see polyglossia
- 'et';    'estonian'
- 'gl';    'galician'
- 'de';    'german'
- 'el';    'greek'          #gl ?
- 'he';    'hebrew'
- 'hi';    'hindi'
- 'is';    'icelandic'
- 'ia';    'interlingua'
- 'ga';    'irish'
- 'it';    'italian'
-#'';      'farsi'          # polyglossia
- 'fi';    'finnish'
- 'fr';    'french'
- 'lo';    'lao'
- 'la';    'latin'
- 'lv';    'latvian'
- 'lt';    'lithuanian'
-#'';      'lsorbian'       # polyglossia
-#'';      'magyar'         # polyglossia
- 'ml';    'malayalam'
- 'mr';    'marathi'
-#'hu';    'magyar'
- 'no';    'norske'
- 'nn';    'nynorsk'
- 'oc';    'occitan'
- 'pl';    'polish'
- 'pt';    'portuges'
- 'ro';    'romanian'
- 'ru';    'russian'
- 'se';    'samin'          #(check sami?)
- 'sa';    'sanskrit'
- 'sr';    'serbian'
-#'';      'scottish'       # polyglossia  (gd (Gaelic (Scots)))
- 'sk';    'slovak'
- 'sl';    'slovenian'
- 'es';    'spanish'
- 'sv';    'swedish'
- 'ta';    'tamil'
- 'te';    'telugu'
- 'th';    'thai'
- 'tr';    'turkish'
- 'tk';    'turkmen'
- 'uk';    'ukrainian'
- 'ur';    'urdu'
-#'';      'usorbian'       # polyglossia
- 'vi';    'vietnamese'
- 'cy';    'welsh'
- 'us';    'USenglish'      # depreciated, see iso-639-2
+__END__
diff --git a/lib/sisu/json.rb b/lib/sisu/json.rb
index d491a9e4..99fd20e0 100644
--- a/lib/sisu/json.rb
+++ b/lib/sisu/json.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Description: json output logic, flow
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/json.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     json
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_JSON
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/json_format.rb b/lib/sisu/json_format.rb
index fd1d47fa..6e00172d 100644
--- a/lib/sisu/json_format.rb
+++ b/lib/sisu/json_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Description: json output logic, flow
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/json_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     json
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_JSON_Format
   require_relative 'dp'                                 # dp.rb
   require_relative 'json_parts'                         # json_parts.rb
diff --git a/lib/sisu/json_parts.rb b/lib/sisu/json_parts.rb
index e53c9935..2dce3049 100644
--- a/lib/sisu/json_parts.rb
+++ b/lib/sisu/json_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared xml parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/json_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     json
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_JSON
   require_relative 'generic_parts'                       # generic_parts.rb
   include SiSU_Parts_Generic
diff --git a/lib/sisu/json_persist.rb b/lib/sisu/json_persist.rb
index 47c3f66c..fdd15071 100644
--- a/lib/sisu/json_persist.rb
+++ b/lib/sisu/json_persist.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/json_persist.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     json
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_JSON_Persist
   class Persist
     @@persist=nil
diff --git a/lib/sisu/json_shared.rb b/lib/sisu/json_shared.rb
index 28bb0ad3..0125c444 100644
--- a/lib/sisu/json_shared.rb
+++ b/lib/sisu/json_shared.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Description: json output logic, flow
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/json_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     json
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_JSONutils
   require_relative 'generic_parts'                      # generic_parts.rb
   class Clean
diff --git a/lib/sisu/manpage.rb b/lib/sisu/manpage.rb
index 0d275ef1..0961d457 100644
--- a/lib/sisu/manpage.rb
+++ b/lib/sisu/manpage.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** manpage text generation, stripped manpage output (unix, linefeed)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/manpage.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     manpage
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Manpage
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/manpage_format.rb b/lib/sisu/manpage_format.rb
index aa9de580..45694bc1 100644
--- a/lib/sisu/manpage_format.rb
+++ b/lib/sisu/manpage_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** manpage formatting template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/manpage_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     manpage
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_ManpageFormat
   require_relative 'dp'                                 # dp.rb
     include SiSU_Param
diff --git a/lib/sisu/object_munge.rb b/lib/sisu/object_munge.rb
index 0e66756e..2d1fdf60 100644
--- a/lib/sisu/object_munge.rb
+++ b/lib/sisu/object_munge.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** object munge
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     object_munge
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Object_Munge
   def i_src_o_strip_markup(txtobj)
     txtobj=txtobj.
diff --git a/lib/sisu/prog_text_translation.rb b/lib/sisu/prog_text_translation.rb
index 3785cd9d..5ac594d4 100644
--- a/lib/sisu/prog_text_translation.rb
+++ b/lib/sisu/prog_text_translation.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** internationalisation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/prog_text_translation.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     i18n
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Translate
   require_relative 'se'                                 # se.rb
     include SiSU_Env; include SiSU_Param
@@ -1627,74 +1625,3 @@ module SiSU_Translate
   end
 end
 __END__
-http://www.debian.org/international/l10n/po/
-http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
-http://www.loc.gov/standards/iso639-2/php/code_list.php
-albanian           sq
-amharic            am
-arabic             ar
-armenian           hy
-asturian
-bahasai
-bahasam
-basque             eu
-bengali            bn
-brazil[ian]        pt_BR
-breton             br
-bulgarian          bg
-catalan            ca
-coptic
-croatian           hr
-czech              cs
-danish             da
-divehi
-dutch              nl
-english            en
-esperanto          eo
-estonian           et
-galician           gl
-german             de
-greek              el
-hebrew             he
-hindi              hi
-icelandic          is
-interlingua        ia
-irish              ga
-italian            it
-farsi
-finnish            fi
-french             fr
-lao                lo
-latin              la
-latvian            lv
-lithuanian         lt
-lsorbian
-magyar
-malayalam          ml
-marathi            mr
-norsk              no
-nynorsk            nn
-occitan            oc
-polish             pl
-portuges           pt
-romanian           ro
-russian            ru
-samin              se (check sami?)
-sanskrit           sa
-scottish            #  (gd (Gaelic (Scots)))
-serbian            sr
-slovak             sk
-slovenian          sl
-spanish            es
-swedish            sv
-syriac             #  (ar_SY (Arabic, as spoken in Syrian Arab Republic))
-tamil              ta
-telugu             te
-thai               th
-turkish            tr
-turkmen            tk
-ukrainian          uk
-urdu               ur
-usorbian
-vietnamese         vi
-welsh              cy
diff --git a/lib/sisu/qrcode.rb b/lib/sisu/qrcode.rb
index b5d123be..9e93f558 100644
--- a/lib/sisu/qrcode.rb
+++ b/lib/sisu/qrcode.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** summary of generated outputs and metadata
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/qrcode.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_QRcode
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/relaxng.rb b/lib/sisu/relaxng.rb
index 418c8eb5..8f1d0ba7 100644
--- a/lib/sisu/relaxng.rb
+++ b/lib/sisu/relaxng.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** relaxng flow/logic
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/relaxng.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Relaxng
   require_relative 'se'                                 # se.rb
   class RelaxNG
@@ -98,7 +96,7 @@ module SiSU_Relaxng
    * Standard SiSU meta-markup syntax, and the
    * Standard SiSU object citation numbering and system
 
- * Hompages:
+ * Homepages:
    [http://www.jus.uio.no/sisu]
    [http://www.sisudoc.org]
 
diff --git a/lib/sisu/remote.rb b/lib/sisu/remote.rb
index 4febc103..c7dd1b01 100644
--- a/lib/sisu/remote.rb
+++ b/lib/sisu/remote.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** remote operations, get source from or copy output to remote server
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/remote.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Remote
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/rexml.rb b/lib/sisu/rexml.rb
index db66d817..a9a2afc9 100644
--- a/lib/sisu/rexml.rb
+++ b/lib/sisu/rexml.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** rexml testing of xml
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/rexml.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Rexml
   # load XML file for REXML parsing
   begin
diff --git a/lib/sisu/se.rb b/lib/sisu/se.rb
index 4de6cd74..8e44434b 100644
--- a/lib/sisu/se.rb
+++ b/lib/sisu/se.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 @@cX=nil
 module SiSU_Env
   require_relative 'constants'                         # constants.rb
diff --git a/lib/sisu/se_cleanoutput.rb b/lib/sisu/se_cleanoutput.rb
index bdadc7e1..6d66f1b9 100644
--- a/lib/sisu/se_cleanoutput.rb
+++ b/lib/sisu/se_cleanoutput.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_cleanoutput.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Clean_Output
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_clear.rb b/lib/sisu/se_clear.rb
index 4fa97381..52374439 100644
--- a/lib/sisu/se_clear.rb
+++ b/lib/sisu/se_clear.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_clear.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Clear
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_createsite.rb b/lib/sisu/se_createsite.rb
index fd4477da..a680d022 100644
--- a/lib/sisu/se_createsite.rb
+++ b/lib/sisu/se_createsite.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_createsite.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Create_Site
   require_relative 'constants'                             # constants.rb
   require_relative 'html_parts'                            # html_parts.rb
diff --git a/lib/sisu/se_css.rb b/lib/sisu/se_css.rb
index 90618588..3d91636d 100644
--- a/lib/sisu/se_css.rb
+++ b/lib/sisu/se_css.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_css.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_CSS
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_date.rb b/lib/sisu/se_date.rb
index 235e66b8..11e8c3db 100644
--- a/lib/sisu/se_date.rb
+++ b/lib/sisu/se_date.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_date.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Date
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_db.rb b/lib/sisu/se_db.rb
index 8abde0ad..09fb81fc 100644
--- a/lib/sisu/se_db.rb
+++ b/lib/sisu/se_db.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_db.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Db
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_envcall.rb b/lib/sisu/se_envcall.rb
index 486f8151..1913dcb4 100644
--- a/lib/sisu/se_envcall.rb
+++ b/lib/sisu/se_envcall.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_envcall.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Env_Call
   begin
     require 'singleton'
diff --git a/lib/sisu/se_file_op.rb b/lib/sisu/se_file_op.rb
index 9a95baa5..3beea62c 100644
--- a/lib/sisu/se_file_op.rb
+++ b/lib/sisu/se_file_op.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_file_op.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_File
   require_relative 'utils'                                 # utils.rb
   require_relative 'se_info_env'                           # se_info_env.rb
diff --git a/lib/sisu/se_filemap.rb b/lib/sisu/se_filemap.rb
index 6d7cea2e..2364d116 100644
--- a/lib/sisu/se_filemap.rb
+++ b/lib/sisu/se_filemap.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_filemap.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_File_Map
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_get_init.rb b/lib/sisu/se_get_init.rb
index b2ef5141..4fe593be 100644
--- a/lib/sisu/se_get_init.rb
+++ b/lib/sisu/se_get_init.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_get_init.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Get_Init
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_hub_particulars.rb b/lib/sisu/se_hub_particulars.rb
index 904fda38..da8844f3 100644
--- a/lib/sisu/se_hub_particulars.rb
+++ b/lib/sisu/se_hub_particulars.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** particulars, composite information about document being processed
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_hub_particulars.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Particulars
   begin
     require 'singleton'
diff --git a/lib/sisu/se_info_env.rb b/lib/sisu/se_info_env.rb
index 72aa364b..bdcafe42 100644
--- a/lib/sisu/se_info_env.rb
+++ b/lib/sisu/se_info_env.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_info_env.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 @@current_document=Dir.pwd #nil #''
 module SiSU_Info_Env
   require_relative 'se_envcall'                            # se_envcall.rb
diff --git a/lib/sisu/se_info_port.rb b/lib/sisu/se_info_port.rb
index 824c26f1..fc40de2f 100644
--- a/lib/sisu/se_info_port.rb
+++ b/lib/sisu/se_info_port.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_info_port.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Port
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_info_system.rb b/lib/sisu/se_info_system.rb
index df7473b8..400696d3 100644
--- a/lib/sisu/se_info_system.rb
+++ b/lib/sisu/se_info_system.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_info_system.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Sys_Gen
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_load.rb b/lib/sisu/se_load.rb
index 7dce7a0f..bd3991da 100644
--- a/lib/sisu/se_load.rb
+++ b/lib/sisu/se_load.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_load.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Load
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_processing.rb b/lib/sisu/se_processing.rb
index 5aa2d45a..904812c6 100644
--- a/lib/sisu/se_processing.rb
+++ b/lib/sisu/se_processing.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_processing.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Processing_Settings
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_programs.rb b/lib/sisu/se_programs.rb
index efe89946..970bb24a 100644
--- a/lib/sisu/se_programs.rb
+++ b/lib/sisu/se_programs.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_programs.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Sys_Call
   begin
     require 'singleton'
diff --git a/lib/sisu/se_remotes.rb b/lib/sisu/se_remotes.rb
index 61e66117..f112589f 100644
--- a/lib/sisu/se_remotes.rb
+++ b/lib/sisu/se_remotes.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_remotes.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Remote_Host
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/se_standardise_lang.rb b/lib/sisu/se_standardise_lang.rb
index ab54ea96..1a513b02 100644
--- a/lib/sisu/se_standardise_lang.rb
+++ b/lib/sisu/se_standardise_lang.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_standardise_lang.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 @@lang_info=nil
 module SiSU_Standardise_Lang
   class StandardiseLanguage
diff --git a/lib/sisu/se_version.rb b/lib/sisu/se_version.rb
index de497888..44062ec4 100644
--- a/lib/sisu/se_version.rb
+++ b/lib/sisu/se_version.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/se_version.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     se
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Info_Version
   require_relative 'constants'                             # constants.rb
   require_relative 'utils'                                 # utils.rb
diff --git a/lib/sisu/shared_images.rb b/lib/sisu/shared_images.rb
index 7d739c8d..4badb84c 100644
--- a/lib/sisu/shared_images.rb
+++ b/lib/sisu/shared_images.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** common file for xml generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/shared_images.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Images
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
   class Source
diff --git a/lib/sisu/shared_markup_alt.rb b/lib/sisu/shared_markup_alt.rb
index b26fb951..db3dbbfe 100644
--- a/lib/sisu/shared_markup_alt.rb
+++ b/lib/sisu/shared_markup_alt.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/shared_markup_alt.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TextRepresentation
   class Alter
     def initialize(x)
diff --git a/lib/sisu/shared_metadata.rb b/lib/sisu/shared_metadata.rb
index 8a57eaeb..3214107a 100644
--- a/lib/sisu/shared_metadata.rb
+++ b/lib/sisu/shared_metadata.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, resource control and configuration details
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/shared_metadata.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Metadata
   require_relative 'xml_parts'                          # xml_parts.rb
   require_relative 'xml_shared'                         # xml_shared.rb
@@ -1367,3 +1365,4 @@ if @md.notes
   ]
   x.each {|y| p y if y}
 end
+__END__
diff --git a/lib/sisu/shared_sem.rb b/lib/sisu/shared_sem.rb
index de28bd26..3e30de17 100644
--- a/lib/sisu/shared_sem.rb
+++ b/lib/sisu/shared_sem.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Sematic tags
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/shared_sem.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     shared
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Sem
   require_relative 'dp'                                 # dp.rb
   class Tags
diff --git a/lib/sisu/sitemaps.rb b/lib/sisu/sitemaps.rb
index 1e254b6e..90c1f2b8 100644
--- a/lib/sisu/sitemaps.rb
+++ b/lib/sisu/sitemaps.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** sitemap created from document parameters
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/sitemaps.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Sitemaps
   require_relative 'dp'                                 # dp.rb
     include SiSU_Param
diff --git a/lib/sisu/src_kdissert_share.rb b/lib/sisu/src_kdissert_share.rb
index ded1e49d..c9241b25 100644
--- a/lib/sisu/src_kdissert_share.rb
+++ b/lib/sisu/src_kdissert_share.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** share sisu source markup file, copy it to output directory!
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_share_kdissert.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_KdiSource
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/src_po4a_share.rb b/lib/sisu/src_po4a_share.rb
index 5da5799d..a4f1a01b 100644
--- a/lib/sisu/src_po4a_share.rb
+++ b/lib/sisu/src_po4a_share.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** pot file generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_share.rb;hb=HEAD]
-
-=end
-#module SiSU_SStm_AO_SStm
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Languages_Selected
   require_relative 'utils_response'                   # utils_response.rb
   def language
diff --git a/lib/sisu/src_po4a_shelf.rb b/lib/sisu/src_po4a_shelf.rb
index 3aaac727..f8b749fc 100644
--- a/lib/sisu/src_po4a_shelf.rb
+++ b/lib/sisu/src_po4a_shelf.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** pot file generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_shelf.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Po4a
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/src_po4a_shelf_set.rb b/lib/sisu/src_po4a_shelf_set.rb
index c574c613..e3fc1c41 100644
--- a/lib/sisu/src_po4a_shelf_set.rb
+++ b/lib/sisu/src_po4a_shelf_set.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** po4a
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_shelf_set.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Po4aUtils
   class Wrap
     def initialize(md,orig='',trans='',is_desc='',n_char_max=76,n_indent=0,n_hang=nil)
diff --git a/lib/sisu/src_po4a_sst_ao_sst.rb b/lib/sisu/src_po4a_sst_ao_sst.rb
index 09c30659..1aef9e0d 100644
--- a/lib/sisu/src_po4a_sst_ao_sst.rb
+++ b/lib/sisu/src_po4a_sst_ao_sst.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** pot file generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_sst_ao_sst.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_SStm_AO_SStm
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/src_po4a_sst_ao_sst_set.rb b/lib/sisu/src_po4a_sst_ao_sst_set.rb
index 1130f790..278f6ae8 100644
--- a/lib/sisu/src_po4a_sst_ao_sst_set.rb
+++ b/lib/sisu/src_po4a_sst_ao_sst_set.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** po4a
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_sst_ao_sst_set.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Po4aUtils
   class Wrap
     def initialize(md,orig='',trans='',n_char_max=76,n_indent=0,n_hang=nil)
diff --git a/lib/sisu/src_po4a_sstm.rb b/lib/sisu/src_po4a_sstm.rb
index 96208d56..637fdfeb 100644
--- a/lib/sisu/src_po4a_sstm.rb
+++ b/lib/sisu/src_po4a_sstm.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** share sisu source markup file, copy it to output directory!
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_po4a_sstm.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Markup
   require_relative 'src_shared'                         # src_shared.rb
     include SiSU_Source
diff --git a/lib/sisu/src_shared.rb b/lib/sisu/src_shared.rb
index 7184c7c7..85a6ca69 100644
--- a/lib/sisu/src_shared.rb
+++ b/lib/sisu/src_shared.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** create sisupod filetype and copy it to output directory!
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Source
   include SiSU_Env
   class SiSUpodSource
diff --git a/lib/sisu/src_sisupod_make.rb b/lib/sisu/src_sisupod_make.rb
index 71523d50..def08830 100644
--- a/lib/sisu/src_sisupod_make.rb
+++ b/lib/sisu/src_sisupod_make.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** create sisupod filetype and copy it to output directory!
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_sisupod_make.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Doc
   require_relative 'src_shared'                         # scr_shared.rb
     include SiSU_Source
diff --git a/lib/sisu/src_sisupod_sstm.rb b/lib/sisu/src_sisupod_sstm.rb
index e578b6e8..71f71552 100644
--- a/lib/sisu/src_sisupod_sstm.rb
+++ b/lib/sisu/src_sisupod_sstm.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** share sisu source markup file, copy it to output directory!
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/src_sisupod_sstm.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     src
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Markup
   require_relative 'src_shared'                         # src_shared.rb
     include SiSU_Source
diff --git a/lib/sisu/sst_convert_markup.rb b/lib/sisu/sst_convert_markup.rb
index 5e1d9911..ed646cbf 100644
--- a/lib/sisu/sst_convert_markup.rb
+++ b/lib/sisu/sst_convert_markup.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** A conversion script for canned substitutions, a fairly generic
-   simple tool that can be used to store other canned conversions, used here for
-   altering SiSU markup
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/sst_convert_markup.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sst
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Modify
   require_relative 'sst_identify_markup'                # sst_identify_markup.rb
   require_relative 'sst_from_xml'                       # sst_from_xml.rb
diff --git a/lib/sisu/sst_do_inline_footnotes.rb b/lib/sisu/sst_do_inline_footnotes.rb
index 29a388de..16e420e8 100644
--- a/lib/sisu/sst_do_inline_footnotes.rb
+++ b/lib/sisu/sst_do_inline_footnotes.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** preprocessing, convert bi-footnotemarker-footnote to inline
-   footnotes, invoked using: sisu --to-footnotes filename.sst
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/set_do_inline_footnotes.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sst
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_ConvertFootnotes
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/sst_from_xml.rb b/lib/sisu/sst_from_xml.rb
index 1198a81e..dc822cb4 100644
--- a/lib/sisu/sst_from_xml.rb
+++ b/lib/sisu/sst_from_xml.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Conversion script from kdissert .kdi to sisu markup .ssm (master document)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/sst_from_xml.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sst
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_sstFromXML
   require_relative 'se'                                 # se.rb
   class Convert
diff --git a/lib/sisu/sst_identify_markup.rb b/lib/sisu/sst_identify_markup.rb
index 3f456982..f1ee73e3 100644
--- a/lib/sisu/sst_identify_markup.rb
+++ b/lib/sisu/sst_identify_markup.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** A conversion script for canned substitutions, a fairly generic
-   simple tool that can be used to store other canned conversions, used here for
-   altering SiSU markup
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/sst_identify_markup.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sst
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Markup
   class MarkupInform
     attr_accessor :version
diff --git a/lib/sisu/sst_to_s_xml_sax.rb b/lib/sisu/sst_to_s_xml_sax.rb
index d8675214..1480475b 100644
--- a/lib/sisu/sst_to_s_xml_sax.rb
+++ b/lib/sisu/sst_to_s_xml_sax.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** simple xml representation (sax style)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/sst_to_s_xml_sax.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     sst
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_SimpleXML_ModelSax
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/termsheet.rb b/lib/sisu/termsheet.rb
index 127bd9de..ea5905bb 100644
--- a/lib/sisu/termsheet.rb
+++ b/lib/sisu/termsheet.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** specialised pre-processing wrapper
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/termsheet.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 require_relative 'se'                                   # se.rb
 require_relative 'dp'                                   # dp.rb
   include SiSU_Param
diff --git a/lib/sisu/texinfo.rb b/lib/sisu/texinfo.rb
index d63dac1a..ba8e1619 100644
--- a/lib/sisu/texinfo.rb
+++ b/lib/sisu/texinfo.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** texinfo processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/texinfo.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     texinfo
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TexInfo
   require_relative 'html'                               # html.rb
   require_relative 'dp'                                 # dp.rb
diff --git a/lib/sisu/texinfo_format.rb b/lib/sisu/texinfo_format.rb
index 5dbca7b0..7029a5c8 100644
--- a/lib/sisu/texinfo_format.rb
+++ b/lib/sisu/texinfo_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** texinfo formatting template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/texinfo_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     texinfo
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TexInfoFormat
   @@table_pg_break_counter=1
   require_relative 'dp'                                 # dp.rb
diff --git a/lib/sisu/texpdf.rb b/lib/sisu/texpdf.rb
index 923b7ad1..19155eef 100644
--- a/lib/sisu/texpdf.rb
+++ b/lib/sisu/texpdf.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** LaTeX generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/texpdf.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     texpdf
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TeX
   begin
     require 'pstore'
diff --git a/lib/sisu/texpdf_format.rb b/lib/sisu/texpdf_format.rb
index 634bb591..11b0091c 100644
--- a/lib/sisu/texpdf_format.rb
+++ b/lib/sisu/texpdf_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** LaTeX formatting template, unicode utf-8 version, used for pdf
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/texpdf_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     texpdf
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TeX_Pdf
   require_relative 'texpdf_parts'                        # texpdf_parts.rb
   @@table_pg_break_counter=1
@@ -1642,4 +1640,3 @@ texlive-latex-extra
 texlive-latex-recommended
 texlive-plain-generic
 texlive-xetex
-
diff --git a/lib/sisu/texpdf_parts.rb b/lib/sisu/texpdf_parts.rb
index 5dde9c9e..0f3af456 100644
--- a/lib/sisu/texpdf_parts.rb
+++ b/lib/sisu/texpdf_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     texpdf
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_TeXpdf
   require_relative 'generic_parts'                       # generic_parts.rb
   include SiSU_Parts_Generic
diff --git a/lib/sisu/txt_asciidoc.rb b/lib/sisu/txt_asciidoc.rb
index 0fcb94d8..e62b769c 100644
--- a/lib/sisu/txt_asciidoc.rb
+++ b/lib/sisu/txt_asciidoc.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext (smarttext) generation, asciidoc
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_asciidoc.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_AsciiDoc
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_asciidoc_decorate.rb b/lib/sisu/txt_asciidoc_decorate.rb
index f9fe7f12..d9ff5bc6 100644
--- a/lib/sisu/txt_asciidoc_decorate.rb
+++ b/lib/sisu/txt_asciidoc_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_asciidoc_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_AsciiDoc
   def decorate
     def heading
diff --git a/lib/sisu/txt_markdown.rb b/lib/sisu/txt_markdown.rb
index 1f97ba12..2b157edb 100644
--- a/lib/sisu/txt_markdown.rb
+++ b/lib/sisu/txt_markdown.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext (smarttext) generation, markdown
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_markdown.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_Markdown
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_markdown_decorate.rb b/lib/sisu/txt_markdown_decorate.rb
index 603c99c3..b2888f92 100644
--- a/lib/sisu/txt_markdown_decorate.rb
+++ b/lib/sisu/txt_markdown_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_markdown_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_Markdown
   def decorate
     def heading
diff --git a/lib/sisu/txt_orgmode.rb b/lib/sisu/txt_orgmode.rb
index 93d65aaa..10c61b6e 100644
--- a/lib/sisu/txt_orgmode.rb
+++ b/lib/sisu/txt_orgmode.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext (smarttext) generation, orgmode structure
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_orgmode.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_OrgMode
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_orgmode_decorate.rb b/lib/sisu/txt_orgmode_decorate.rb
index 753be36b..d49c733a 100644
--- a/lib/sisu/txt_orgmode_decorate.rb
+++ b/lib/sisu/txt_orgmode_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_orgmode_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_OrgMode
   def decorate
     def heading
diff --git a/lib/sisu/txt_output.rb b/lib/sisu/txt_output.rb
index c2499c37..009aed14 100644
--- a/lib/sisu/txt_output.rb
+++ b/lib/sisu/txt_output.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_output.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module Txt_Output
   class Output
     include SiSU_Param
@@ -81,4 +79,3 @@ module Txt_Output
   end
 end
 __END__
-
diff --git a/lib/sisu/txt_plain.rb b/lib/sisu/txt_plain.rb
index f2ce14b5..0f9a721a 100644
--- a/lib/sisu/txt_plain.rb
+++ b/lib/sisu/txt_plain.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext text generation, stripped plaintext output (unix, linefeed)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_Plain
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_plain_decorate.rb b/lib/sisu/txt_plain_decorate.rb
index 7b4bbb3f..69b5344f 100644
--- a/lib/sisu/txt_plain_decorate.rb
+++ b/lib/sisu/txt_plain_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_plain_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_Plain
   def decorate
     def heading_underscore
diff --git a/lib/sisu/txt_read.rb b/lib/sisu/txt_read.rb
index 36413647..06606222 100644
--- a/lib/sisu/txt_read.rb
+++ b/lib/sisu/txt_read.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_read.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_Read
   require_relative 'se'                                 # se.rb
     include SiSU_Env
@@ -104,4 +102,4 @@ module SiSU_Txt_Read
     end
   end
 end
-
+__END__
diff --git a/lib/sisu/txt_rst.rb b/lib/sisu/txt_rst.rb
index cf86602c..5762a2fa 100644
--- a/lib/sisu/txt_rst.rb
+++ b/lib/sisu/txt_rst.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext (smarttext) generation, rST
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_rst.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_rST
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_rst_decorate.rb b/lib/sisu/txt_rst_decorate.rb
index 5593c513..bee406ea 100644
--- a/lib/sisu/txt_rst_decorate.rb
+++ b/lib/sisu/txt_rst_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_rst_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_rST
   def decorate
     def heading
diff --git a/lib/sisu/txt_shared.rb b/lib/sisu/txt_shared.rb
index f16f7e15..3c605a8f 100644
--- a/lib/sisu/txt_shared.rb
+++ b/lib/sisu/txt_shared.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** modules shared by flatfile output generators
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_TextUtils
   require_relative 'generic_parts'                      # generic_parts.rb
   class Wrap
diff --git a/lib/sisu/txt_textile.rb b/lib/sisu/txt_textile.rb
index cdd038ba..656afdf3 100644
--- a/lib/sisu/txt_textile.rb
+++ b/lib/sisu/txt_textile.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext (smarttext) generation, textile
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_textile.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Txt_Textile
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/txt_textile_decorate.rb b/lib/sisu/txt_textile_decorate.rb
index ca46c930..339a639d 100644
--- a/lib/sisu/txt_textile_decorate.rb
+++ b/lib/sisu/txt_textile_decorate.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** plaintext decoration
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/txt_textile_decorate.rb;hb=HEAD]
-
-=end
-
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     txt
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Decorate_Txt_Textile
   def decorate
     def heading
diff --git a/lib/sisu/update.rb b/lib/sisu/update.rb
index 87953d01..990d08ef 100644
--- a/lib/sisu/update.rb
+++ b/lib/sisu/update.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** update previous output (with similar output file type formats)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/update.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_UpdateControlFlag
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/urls.rb b/lib/sisu/urls.rb
index b2674fc4..9a8902b6 100644
--- a/lib/sisu/urls.rb
+++ b/lib/sisu/urls.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** urls for output files
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/urls.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Urls
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/utils.rb b/lib/sisu/utils.rb
index 6188aa47..2426bcf8 100644
--- a/lib/sisu/utils.rb
+++ b/lib/sisu/utils.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, debug related
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/utils.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     utils
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Utils
   class CodeMarker
     def initialize(line,file,color=:red)
diff --git a/lib/sisu/utils_composite.rb b/lib/sisu/utils_composite.rb
index 2d06abc4..97b46534 100644
--- a/lib/sisu/utils_composite.rb
+++ b/lib/sisu/utils_composite.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, debug related
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/utils_composite.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     utils
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Composite_Doc_Utils
   def inserts_array(loadfilename)
     IO.readlines(loadfilename,'')
diff --git a/lib/sisu/utils_response.rb b/lib/sisu/utils_response.rb
index fa1fccf1..0c8c63c6 100644
--- a/lib/sisu/utils_response.rb
+++ b/lib/sisu/utils_response.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Request response
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/utils_response.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     utils
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Response
   def available_selections_
     %{'yes', 'no', 'quit' or 'exit'; [ynqx]}
diff --git a/lib/sisu/utils_screen_text_color.rb b/lib/sisu/utils_screen_text_color.rb
index d06af55f..5b21cb45 100644
--- a/lib/sisu/utils_screen_text_color.rb
+++ b/lib/sisu/utils_screen_text_color.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** system environment, screen colors text
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/utils_screen_text_color.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     utils
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Screen
   class Color
     attr_accessor :off,:marker,:bold,:underline,:invert,:darkgrey_hi,:grey_hi,:pink_hi,:fuchsia_hi,:red_hi,:orange_hi,:yellow_hi,:brown_hi,:lightgreen_hi,:green_hi,:cyan_hi,:blue_hi,:navy_hi,:white,:white_bold,:grey,:pink,:fuchsia,:ruby,:red,:orange,:yellow,:brown,:green,:darkgreen,:cyan,:blue,:navy,:black
@@ -382,7 +380,7 @@ module SiSU_Screen
       puts %{\t#{@cX.grey}MetaVerse: MarshalLoad (creation of metaVerse skipped)#{@cX.off}}
     end
     def meta_verse_load
-      puts %{\t<<MetaVerse: MarshalLoad>>}
+      puts %{\t[ MetaVerse: MarshalLoad ]}
     end
     def html_title
       puts %{#{@cX.green_hi}#{@cX.black}HTML#{@cX.off*2}}
diff --git a/lib/sisu/utils_spell.rb b/lib/sisu/utils_spell.rb
index 4e72117a..da4fb7b7 100644
--- a/lib/sisu/utils_spell.rb
+++ b/lib/sisu/utils_spell.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** spellchecking
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/utils_spell.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     utils
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_SpellUtility
   class Spell
     def initialize(input,filesrc,flg)
@@ -85,7 +83,7 @@ module SiSU_SpellUtility
       @allwords=@allwords.uniq
       if @flg =~ /S/
         File.open('/home/ralph/spell_error','a+') do |file| #fix
-          file.puts %{\n\n<<#{@filename}>>}
+          file.puts %{\n\n[ #{@filename} ]}
         end
         @allwords.each { |y| puts y.inspect; system(%{cat #{y} | /usr/bin/#{@speller} -l -d #{@dictionary} >> ~/spell_error })}
       else
diff --git a/lib/sisu/webrick.rb b/lib/sisu/webrick.rb
index 15dd0d05..a9856a1f 100644
--- a/lib/sisu/webrick.rb
+++ b/lib/sisu/webrick.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** webrick share - note sisu by default does not link with file suffixes,
-  see man pages for options
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/webrick.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Webserv
   class WebrickStart
     begin
diff --git a/lib/sisu/wikispeak.rb b/lib/sisu/wikispeak.rb
index 2b914146..e656d8c7 100644
--- a/lib/sisu/wikispeak.rb
+++ b/lib/sisu/wikispeak.rb
@@ -1,58 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** wiki text generation, stripped wiki output (unix, linefeed)
-
-** Author: Ralph Amissah
-
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/wikispeak.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Wikispeak
   require_relative 'ao'                                 # ao.rb
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/xhtml.rb b/lib/sisu/xhtml.rb
index 888f6f0c..e7af6851 100644
--- a/lib/sisu/xhtml.rb
+++ b/lib/sisu/xhtml.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Description: xhtml output logic, flow
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xhtml_epub2.rb b/lib/sisu/xhtml_epub2.rb
index c80a90df..e0dc0801 100644
--- a/lib/sisu/xhtml_epub2.rb
+++ b/lib/sisu/xhtml_epub2.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** epub generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_EPUB2
   begin
     require 'pstore'
diff --git a/lib/sisu/xhtml_epub2_concordance.rb b/lib/sisu/xhtml_epub2_concordance.rb
index 82959de2..b5f7911d 100644
--- a/lib/sisu/xhtml_epub2_concordance.rb
+++ b/lib/sisu/xhtml_epub2_concordance.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** epub concordance file (wordmap, linked index of words in document)
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2_concordance.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_EPUB2_Concordance
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
@@ -312,7 +310,7 @@ WOK
           # special cases endnotes and header levels 1 - 3
         end
         credits=SiSU_Proj_XHTML::Bits.new.credits_sisu_epub
-        @file_concordance << %{</div>>#{credits}</body>\n</html>} # footer
+        @file_concordance << %{</div>#{credits}</body>\n</html>} # footer
       end
     end
   end
diff --git a/lib/sisu/xhtml_epub2_format.rb b/lib/sisu/xhtml_epub2_format.rb
index 3a7944c3..f18d52f9 100644
--- a/lib/sisu/xhtml_epub2_format.rb
+++ b/lib/sisu/xhtml_epub2_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** epub formating, css template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_EPUB2_Format
   class ParagraphNumber
     def initialize(md,ocn)
diff --git a/lib/sisu/xhtml_epub2_persist.rb b/lib/sisu/xhtml_epub2_persist.rb
index 958cddae..1ebe8d02 100644
--- a/lib/sisu/xhtml_epub2_persist.rb
+++ b/lib/sisu/xhtml_epub2_persist.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2_persist.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_EPUB2_Persist
   class Persist
     @@persist=nil
diff --git a/lib/sisu/xhtml_epub2_segments.rb b/lib/sisu/xhtml_epub2_segments.rb
index e1bab773..7b4da061 100644
--- a/lib/sisu/xhtml_epub2_segments.rb
+++ b/lib/sisu/xhtml_epub2_segments.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** epub segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2_segments.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_EPUB2_Seg
   require_relative 'xhtml_shared'                       # xhtml_shared.rb
   require_relative 'xhtml_epub2'                        # xhtml_epub2.rb
diff --git a/lib/sisu/xhtml_epub2_tune.rb b/lib/sisu/xhtml_epub2_tune.rb
index 3608d07f..b73281c7 100644
--- a/lib/sisu/xhtml_epub2_tune.rb
+++ b/lib/sisu/xhtml_epub2_tune.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** epub generation, epub pre-processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_epub2_tune.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 require_relative 'dp'                                   # dp.rb
 module SiSU_XHTML_EPUB2_Tune
   require_relative 'se'                                 # se.rb
diff --git a/lib/sisu/xhtml_parts.rb b/lib/sisu/xhtml_parts.rb
index 7c43eca8..05c3810d 100644
--- a/lib/sisu/xhtml_parts.rb
+++ b/lib/sisu/xhtml_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_XHTML
   require_relative 'generic_parts'                       # generic_parts.rb
   include SiSU_Parts_Generic
diff --git a/lib/sisu/xhtml_shared.rb b/lib/sisu/xhtml_shared.rb
index 94941ebe..7613f376 100644
--- a/lib/sisu/xhtml_shared.rb
+++ b/lib/sisu/xhtml_shared.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_shared.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_Shared
   require_relative 'xhtml_table'                        # xhtml_table.rb
   class TableXHTML < SiSU_XHTML_Table::TableXHTML
diff --git a/lib/sisu/xhtml_table.rb b/lib/sisu/xhtml_table.rb
index 06fa2c42..7e3d4b52 100644
--- a/lib/sisu/xhtml_table.rb
+++ b/lib/sisu/xhtml_table.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared html parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xhtml_table.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xhtml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XHTML_Table
   require_relative 'xhtml_parts'                         # xhtml_parts.rb
   class TableXHTML
diff --git a/lib/sisu/xml_docbook5.rb b/lib/sisu/xml_docbook5.rb
index 43ba9595..a3531b6c 100644
--- a/lib/sisu/xml_docbook5.rb
+++ b/lib/sisu/xml_docbook5.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Docbook book XML rendition
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_docbook_book.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Docbook_Book
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_dom.rb b/lib/sisu/xml_dom.rb
index b542ad53..5f1ff9fe 100644
--- a/lib/sisu/xml_dom.rb
+++ b/lib/sisu/xml_dom.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** xml (dom style) output processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_dom.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_DOM
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_fictionbook2.rb b/lib/sisu/xml_fictionbook2.rb
index b1e30949..6a7e0373 100644
--- a/lib/sisu/xml_fictionbook2.rb
+++ b/lib/sisu/xml_fictionbook2.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** Fictionbook XML rendition
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_fictionbook.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Fictionbook
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_format.rb b/lib/sisu/xml_format.rb
index 6578498d..21187b54 100644
--- a/lib/sisu/xml_format.rb
+++ b/lib/sisu/xml_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-** xml template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Format
   require_relative 'dp'                                 # dp.rb
   require_relative 'xml_parts'                          # xml_parts.rb
diff --git a/lib/sisu/xml_md_oai_pmh_dc.rb b/lib/sisu/xml_md_oai_pmh_dc.rb
index b73cdd16..7452abaa 100644
--- a/lib/sisu/xml_md_oai_pmh_dc.rb
+++ b/lib/sisu/xml_md_oai_pmh_dc.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** summary of generated outputs and metadata
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_md_oai_pmh_dc.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Metadata
   require_relative 'se'                                 # se.rb
     include SiSU_Env
diff --git a/lib/sisu/xml_odf_odt.rb b/lib/sisu/xml_odf_odt.rb
index 1f1c69b7..38381543 100644
--- a/lib/sisu/xml_odf_odt.rb
+++ b/lib/sisu/xml_odf_odt.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** opendocument text generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/odf.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_ODF_ODT
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_odf_odt_format.rb b/lib/sisu/xml_odf_odt_format.rb
index f45d67d5..cbaf94d7 100644
--- a/lib/sisu/xml_odf_odt_format.rb
+++ b/lib/sisu/xml_odf_odt_format.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** opendocument formatting, default opendocument template
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/odf_format.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_ODF_ODT_Format
   require_relative 'dp'                                 # dp.rb
     include SiSU_Param
diff --git a/lib/sisu/xml_parts.rb b/lib/sisu/xml_parts.rb
index 07c9e6c2..5fdc0f68 100644
--- a/lib/sisu/xml_parts.rb
+++ b/lib/sisu/xml_parts.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** shared xml parts
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/html_parts.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Parts_XML
   require_relative 'generic_parts'                       # generic_parts.rb
   include SiSU_Parts_Generic
diff --git a/lib/sisu/xml_persist.rb b/lib/sisu/xml_persist.rb
index 549d0f7c..9546d181 100644
--- a/lib/sisu/xml_persist.rb
+++ b/lib/sisu/xml_persist.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** html segment generation, processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_persist.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Persist
   class Persist
     @@persist=nil
diff --git a/lib/sisu/xml_sax.rb b/lib/sisu/xml_sax.rb
index b97843c8..3b8bf7c4 100644
--- a/lib/sisu/xml_sax.rb
+++ b/lib/sisu/xml_sax.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** xml output (sax style) processing
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_SAX
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_scaffold_structure_collapsed.rb b/lib/sisu/xml_scaffold_structure_collapsed.rb
index 2091baf9..12c572b7 100644
--- a/lib/sisu/xml_scaffold_structure_collapsed.rb
+++ b/lib/sisu/xml_scaffold_structure_collapsed.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** extract and print an XML rendition of document structure to screen
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_scaffold.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Scaffold_Structure_Collapse
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_scaffold_structure_sisu.rb b/lib/sisu/xml_scaffold_structure_sisu.rb
index 176e0814..28ffb0e6 100644
--- a/lib/sisu/xml_scaffold_structure_sisu.rb
+++ b/lib/sisu/xml_scaffold_structure_sisu.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** extract and print an XML rendition of document structure to screen
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_scaffold.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Scaffold_Structure_Sisu
   require_relative 'se_hub_particulars'                 # se_hub_particulars.rb
     include SiSU_Particulars
diff --git a/lib/sisu/xml_shared.rb b/lib/sisu/xml_shared.rb
index 906da2a0..61ba5444 100644
--- a/lib/sisu/xml_shared.rb
+++ b/lib/sisu/xml_shared.rb
@@ -1,59 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** common file for xml generation
-
-** Author: Ralph Amissah
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_shared.rb;hb=HEAD]
-
-** Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_XML_Munge
   require_relative 'xml_parts'                          # xml_parts.rb
   class Trans
diff --git a/lib/sisu/xml_tables.rb b/lib/sisu/xml_tables.rb
index dd0178a2..9342a951 100644
--- a/lib/sisu/xml_tables.rb
+++ b/lib/sisu/xml_tables.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** common file for xml table generation
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/xml_tables.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     xml
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Tables
   class Table #_xml
     @@tablehead=0
diff --git a/lib/sisu/zap.rb b/lib/sisu/zap.rb
index 8cec96bc..042a3ee4 100644
--- a/lib/sisu/zap.rb
+++ b/lib/sisu/zap.rb
@@ -1,57 +1,55 @@
 # encoding: utf-8
-=begin
-
-* Name: SiSU
-
-** Description: documents, structuring, processing, publishing, search
-*** zap wipe clean previous output of the type specified
-
-** Author: Ralph Amissah
-  [ralph@amissah.com]
-  [ralph.amissah@gmail.com]
-
-** Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
-  2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 Ralph Amissah,
-  All Rights Reserved.
-
-** License: GPL 3 or later:
-
-  SiSU, a framework for document structuring, publishing and search
-
-  Copyright (C) Ralph Amissah
-
-  This program is free software: you can redistribute it and/or modify it
-  under the terms of the GNU General Public License as published by the Free
-  Software Foundation, either version 3 of the License, or (at your option)
-  any later version.
-
-  This program is distributed in the hope that it will be useful, but WITHOUT
-  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
-  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
-  more details.
-
-  You should have received a copy of the GNU General Public License along with
-  this program. If not, see [http://www.gnu.org/licenses/].
-
-  If you have Internet connection, the latest version of the GPL should be
-  available at these locations:
-  [http://www.fsf.org/licensing/licenses/gpl.html]
-  [http://www.gnu.org/licenses/gpl.html]
-
-** SiSU uses:
-  * Standard SiSU markup syntax,
-  * Standard SiSU meta-markup syntax, and the
-  * Standard SiSU object citation numbering and system
-
-** Hompages:
-  [http://www.jus.uio.no/sisu]
-  [http://www.sisudoc.org]
-
-** Git
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=summary]
-  [http://git.sisudoc.org/gitweb/?p=code/sisu.git;a=blob;f=lib/sisu/zap.rb;hb=HEAD]
-
-=end
+# - Name: SiSU
+#
+#   - Description: documents, structuring, processing, publishing, search
+#     misc
+#
+#   - Author: Ralph Amissah
+#     <ralph.amissah@gmail.com>
+#
+#   - Copyright: (C) 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
+#     2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016, 2017, 2019,
+#     2020, 2021, Ralph Amissah,
+#     All Rights Reserved.
+#
+#   - License: GPL 3 or later:
+#
+#     SiSU, a framework for document structuring, publishing and search
+#
+#     Copyright (C) Ralph Amissah
+#
+#     This program is free software: you can redistribute it and/or modify it
+#     under the terms of the GNU General Public License as published by the Free
+#     Software Foundation, either version 3 of the License, or (at your option)
+#     any later version.
+#
+#     This program is distributed in the hope that it will be useful, but WITHOUT
+#     ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+#     FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for
+#     more details.
+#
+#     You should have received a copy of the GNU General Public License along with
+#     this program. If not, see <http://www.gnu.org/licenses/>.
+#
+#     If you have Internet connection, the latest version of the GPL should be
+#     available at these locations:
+#     <http://www.fsf.org/licensing/licenses/gpl.html>
+#     <http://www.gnu.org/licenses/gpl.html>
+#
+#     <http://www.sisudoc.org/sisu/en/manifest/gpl.fsf.html>
+#
+#   - SiSU uses:
+#     - Standard SiSU markup syntax,
+#     - Standard SiSU meta-markup syntax, and the
+#     - Standard SiSU object citation numbering and system
+#
+#   - Homepages:
+#     <http://www.sisudoc.org>
+#
+#   - Git
+#     <https://git.sisudoc.org/projects/>
+#     <https://git.sisudoc.org/projects/?p=software/sisu.git;a=summary>
+#     <https://git.sisudoc.org/projects/?p=markup/sisu-markup-samples.git;a=summary>
 module SiSU_Zap
   require_relative 'se'                                 # se.rb
     include SiSU_Env