From 50d45c6deb0afd2e4222d2e33a45487a9d1fa676 Mon Sep 17 00:00:00 2001 From: Ralph Amissah Date: Sun, 23 Sep 2007 05:16:21 +0100 Subject: primarily todo with sisu documentation, changelog reproduced below: * start documenting sisu using sisu * sisu markup source files in data/doc/sisu/sisu_markup_samples/sisu_manual/ /usr/share/doc/sisu/sisu_markup_samples/sisu_manual/ * default output [sisu -3] in data/doc/manuals_generated/sisu_manual/ /usr/share/doc/manuals_generated/sisu_manual/ (adds substantially to the size of sisu package!) * help related edits * manpage, work on ability to generate manpages, improved * param, exclude footnote mark count when occurs within code block * plaintext changes made * shared_txt, line wrap visited * file:// link option introduced (in addition to existing https?:// and ftp://) a bit arbitrarily, diff here, [double check changes in sysenv and hub] * minor adjustments * html url match refinement * css added tiny_center * plaintext * endnotes fix * footnote adjustment to make more easily distinguishable from substantive text * flag -a only [flags -A -e -E dropped] controlled by modifiers --unix/msdos --footnote/endnote * defaults, homepage * renamed homepage (instead of index) implications for modifying skins, which need likewise to have any homepage entry renamed * added link to sisu_manual in homepage * css the css for the default homepage is renamed homepage.css (instead of index.css) [consider removing this and relying on html.css] * ruby version < ruby1.9 * place stop on installation and working with for now [ruby String.strip broken in ruby 1.9.0 (2007-09-10 patchlevel 0) [i486-linux], 2007-09-18:38/2] * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * debian * debian/control restrict use to ruby > 1.8.4 and ruby < 1.9 * sisu-doc new sub-package for sisu documentation debian/control and sisu-doc.install --- .../sisu_manual/sisu_postgresql/sax.xml | 231 +++++++++++++++++++++ 1 file changed, 231 insertions(+) create mode 100644 data/doc/manuals_generated/sisu_manual/sisu_postgresql/sax.xml (limited to 'data/doc/manuals_generated/sisu_manual/sisu_postgresql/sax.xml') diff --git a/data/doc/manuals_generated/sisu_manual/sisu_postgresql/sax.xml b/data/doc/manuals_generated/sisu_manual/sisu_postgresql/sax.xml new file mode 100644 index 00000000..5a21caa1 --- /dev/null +++ b/data/doc/manuals_generated/sisu_manual/sisu_postgresql/sax.xml @@ -0,0 +1,231 @@ + + + + + + + Title: + + SiSU - SiSU information Structuring Universe - Search [0.58] + +
+ Creator: + + Ralph Amissah + +
+ Rights: + + Copyright (C) Ralph Amissah 2007, part of SiSU documentation, License GPL 3 + +
+ Type: + + information + +
+ Subject: + + ebook, epublishing, electronic book, electronic publishing, electronic document, electronic citation, data structure, citation systems, search + +
+ Date created: + + 2002-08-28 + +
+ Date issued: + + 2002-08-28 + +
+ Date available: + + 2002-08-28 + +
+ Date modified: + + 2007-09-16 + +
+ Date: + + 2007-09-16 + +
+ + + + 1 + + SiSU - SiSU information Structuring Universe - Search [0.58],
+Ralph Amissah +
+
+ + 2 + + SiSU Search + + + + 3 + + SiSU Postgresql + + + + 4 + + 1. Postgresql + + + + 5 + + 1.1 Name + + + + 6 + + SiSU - Structured information, Serialized Units - a document +publishing system, postgresql dependency package + + + + 7 + + 1.2 Description + + + + 8 + + Information related to using postgresql with sisu (and related to the +sisu_postgresql dependency package, which is a dummy package to install +dependencies needed for SiSU to populate a postgresql database, +this being part of SiSU - man sisu). + + + + 9 + + 1.3 Synopsis + + + + 10 + + sisu -D [instruction] [filename/wildcard if required] + + + + 11 + + sisu -D --pg --[instruction] [filename/wildcard if required] + + + + 12 + + 1.4 Commands + + + + 13 + + 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 + + + + 14 + + -D or --pgsql may be used interchangeably. + + + + 15 + + 1.4.1 create and destroy database + + + + 16 + + --pgsql --createall
initial step, creates required +relations (tables, indexes) in existing (postgresql) database (a +database should be created manually and given the same name as working +directory, as requested) (rb.dbi) +
+
+ + 17 + + sisu -D --createdb
creates database where no database +existed before +
+
+ + 18 + + sisu -D --create
creates database tables where no database +tables existed before +
+
+ + 19 + + 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). +
+
+ + 20 + + sisu -D --recreate
destroys existing database and builds a +new empty database structure +
+
+ + 21 + + 1.4.2 import and remove documents + + + + 22 + + sisu -D --import -v [filename/wildcard]
populates database +with the contents of the file. Imports documents(s) specified to a +postgresql database (at an object level). +
+
+ + 23 + + sisu -D --update -v [filename/wildcard]
updates file +contents in database +
+
+ + 24 + + sisu -D --remove -v [filename/wildcard]
removes specified +document from postgresql database. +
+
+ +
-- cgit v1.2.3