using sisu auto-generated man pages for pdf postgresql and sqlite

1 files changed, 217 insertions, 75 deletions

diff --git a/debian/man/man7/sisu_sqlite.7 b/debian/man/man7/sisu_sqlite.7
index 8a9c6e3e..43c68657 100644
--- a/debian/man/man7/sisu_sqlite.7
+++ b/debian/man/man7/sisu_sqlite.7
@@ -1,78 +1,220 @@
-.\"  Name: SiSU information Structuring Universe
-.\"  Author: Ralph Amissah
-.\"  Description: sisu sqlite package manpage
-.\"  arch-tag: sisu manpage
-.\"  License: GPL 2 or later
-.\"  Notes: Process this file with
-.\"    groff -man -Tascii sisu.1
-.\"    nroff -man sisu.1 | most
-.\"  |sisu.1|@|^|<url:sisu.1>
-.TH sisu_sqlite 7  "September 09, 2006" "version 0.46" "sisu \-I"
+.TH "sisu_sqlite" "1" "2007-09-16" "0.59.1" "SiSU"
 .SH NAME
-.B SiSU
-\- Structured information, Serialized Units \- a document publishing system, sqlite dependency package
-.PP
-This is a dummy package to install the dependencies required by SiSU to populate an sqlite database
+sisu \- package to install what sisu needs to to populate a postgresql database (postgresql dependency component)
 .SH SYNOPSIS
-.B sisu
-.I \-d [instruction]
-[filename/wildcard if required]
-.PP
-.B sisu
-.I \-d  \-\-(sqlite|pg) \-\-[instruction]
-[filename/wildcard if required]
-.PP
-.\"%% Description
-.SH DESCRIPTION
-.B sisu_sqlite
-.I is part of SiSU (man sisu)
-sisu_sqlite is a dummy package to install dependencies needed for sisu to populate an sqlite database, documented in man sisu
-.\"%% Flags Database
-.SH databases
-.TP
-dbi \- database interface
-.B \-d
-set for
-.I sqlite
-.TP
-.B \-\-sqlite \-\-createall
-initial step, creates required relations (tables, indexes) in existing (sqlite) database (a database should be created manually and given the same name as working directory, as requested) (rb.dbi)
-.TP
-.B \-\-sqlite \-\-import \-v
-.I [filename/wildcard]
-imports data specified to (sqlite) db (rb.dbi)
-.TP
-.B \-\-sqlite \-\-update \-v
-.I [filename/wildcard]
-updates/imports specified data to (sqlite) db (rb.dbi)
-.TP
-.B \-\-sqlite \-\-remove \-v
-.I [filename/wildcard]
-removes specified data to (sqlite) db (rb.dbi)
-.TP
-.B \-\-sqlite \-\-dropall
-kills data" and drops (postgresql) db, tables & indexes
-.TP
-.B \-\-sqlite \-\-recreate
-kills data" and drops and rebuilds empty (postgresql) db, tables & indexes
-.RE
-.\"%% Further Information
-.SH FURTHER INFORMATION
-.PP
-For more information on
+sisu \-dv [filename/wildcard ]
+.BR
+sisu \-dv [instruction]
+.SH
+SISU \- SEARCH,
+RALPH AMISSAH
+.BR
+
+.SH
+1. SQLITE
+.BR
+
+.SH
+1.1 NAME
+
+.BR
+.B SiSU
+\- Structured information, Serialized Units \- a document publishing system.
+
+.SH
+1.2 DESCRIPTION
+
+.BR
+Information related to using sqlite with sisu (and related to the sisu_sqlite
+dependency package, which is a dummy package to install dependencies needed for
+.B SiSU
+to populate an sqlite database, this being part of
+.B SiSU
+\- man sisu).
+
+.SH
+1.3 SYNOPSIS
+
+.BR
+  sisu \-d \ [instruction] \ [filename/wildcard \ if \ required]
+
+.BR
+  sisu \-d \-\-(sqlite|pg) \-\-[instruction] \ [filename/wildcard \ if \
+  required]
+
+.SH
+1.4 COMMANDS
+
+.BR
+Mappings to two databases are provided by default, postgresql and sqlite, the
+same commands are used within sisu to construct and populate databases however
+\-d (lowercase) denotes sqlite and \-D (uppercase) denotes postgresql,
+alternatively \-\-sqlite or \-\-pgsql may be used
+
+.BR
+.B \-d or \-\-sqlite
+may be used interchangeably.
+
+.SH
+1.4.1 CREATE AND DESTROY DATABASE
+
+.TP
+.B \ \-\-sqlite \ \-\-createall
+\ initial \ step, \ creates \ required \ relations \ (tables, \ indexes) \ in
+\ existing \ (sqlite) \ database \ (a \ database \ should \ be \ created \
+manually \ and \ given \ the \ same \ name \ as \ working \ directory, \ as \
+requested) \ (rb.dbi) \
+
+.TP
+.B \ sisu \ \-d \ \-\-createdb
+\ creates \ database \ where \ no \ database \ existed \ before \
+
+.TP
+.B \ sisu \ \-d \ \-\-create
+\ creates \ database \ tables \ where \ no \ database \ tables \ existed \
+before \
+
+.TP
+.B \ sisu \ \-d \ \-\-dropall
+\ destroys \ database \ (including \ all \ its \ content)! \ kills \ data \
+and \ drops \ tables, \ indexes \ and \ database \ associated \ with \ a \
+given \ directory \ (and \ directories \ of \ the \ same \ name). \
+
+.TP
+.B \ sisu \ \-d \ \-\-recreate
+\ destroys \ existing \ database \ and \ builds \ a \ new \ empty \ database
+\ structure \
+
+.SH
+1.4.2 IMPORT AND REMOVE DOCUMENTS
+
+.TP
+.B \ sisu \ \-d \ \-\-import \ \-v \ \ [filename/wildcard]
+populates database with the contents of the file. Imports documents(s)
+specified to an sqlite database (at an object level).
+
+.TP
+.B \ sisu \ \-d \ \-\-update \ \-v \ \ [filename/wildcard]
+updates file contents in database
+
+.TP
+.B \ sisu \ \-d \ \-\-remove \ \-v \ \ [filename/wildcard]
+removes specified document from sqlite database.
+
+.SH
+DOCUMENT INFORMATION (METADATA)
+.BR
+
+.SH
+METADATA
+.BR
+
+.BR
+Document Manifest @
+<http://sisudoc.org/sisu_manual/sisu_sqlite/sisu_manifest.html>
+
+.BR
+.B Dublin Core
+(DC)
+
+.BR
+.I DC tags included with this document are provided here.
+
+.BR
+DC Title:
+.I SiSU \- Search
+
+.BR
+DC Creator:
+.I Ralph Amissah
+
+.BR
+DC Rights:
+.I Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL
+3
+
+.BR
+DC Type:
+.I information
+
+.BR
+DC Date created:
+.I 2002\-08\-28
+
+.BR
+DC Date issued:
+.I 2002\-08\-28
+
+.BR
+DC Date available:
+.I 2002\-08\-28
+
+.BR
+DC Date modified:
+.I 2007\-09\-16
+
+.BR
+DC Date:
+.I 2007\-09\-16
+
+.BR
+.B Version Information
+
+.BR
+Sourcefile:
+.I sisu_sqlite.sst
+
+.BR
+Filetype:
+.I SiSU text 0.58
+
+.BR
+Sourcefile Digest, MD5(sisu_sqlite.sst)=
+.I c4717fcab8a43de498d41a916bb99551
+
+.BR
+Skin_Digest:
+MD5(/home/ralph/grotto/theatre/dbld/sisu\-dev/sisu/data/doc/sisu/sisu_markup_samples/sisu_manual/_sisu/skin/doc/skin_sisu_manual.rb)=
+.I 20fc43cf3eb6590bc3399a1aef65c5a9
+
+.BR
+.B Generated
+
+.BR
+Document (metaverse) last generated:
+.I Sat Sep 29 16:06:43 +0100 2007
+
+.BR
+Generated by:
 .I SiSU
-see:
-.I <http://www.jus.uio.no/sisu>
-.PP
-or
-.I man sisu
-.SH AUTHOR
-Ralph Amissah
-.I <ralph@amissah.com>
-or
-.I <ralph.amissah@gmail.com>
-.SH SEE ALSO
-.BR sisu(1),
-.BR sisu(8),
-.BR sisu_postgresql(7),
-.BR sisu_vim(7)
+.I 0.59.1
+of 2007w39/2 (2007\-09\-25)
+
+.BR
+Ruby version:
+.I ruby 1.8.6 (2007\-06\-07 patchlevel 36) \ [i486\-linux]
+
+
+.TP
+Other versions of this document:
+.TP
+manifest: <http://www.jus.uio.no/sisu/sisu_sqlite/sisu_manifest.html>
+.TP
+html: <http://www.jus.uio.no/sisu/sisu_sqlite/toc.html>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/portrait.pdf>
+.TP
+pdf: <http://www.jus.uio.no/sisu/sisu_sqlite/landscape.pdf>
+." .TP
+." manpage: http://www.jus.uio.no/sisu/sisu_sqlite/sisu_sqlite.1
+.TP
+at: <http://www.jus.uio.no/sisu>
+.TP
+.TP
+* Generated by: SiSU 0.59.1 of 2007w39/2 (2007-09-25)
+.TP
+* Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
+.TP
+* Last Generated on: Sat Sep 29 16:06:44 +0100 2007
+.TP
+* SiSU http://www.jus.uio.no/sisu