sisu_postgresql(7) manual page

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 --- data/doc/sisu/html/sisu_postgresql.7.html | 236 +++++++++++++++++++++--------- 1 file changed, 164 insertions(+), 72 deletions(-) (limited to 'data/doc/sisu/html/sisu_postgresql.7.html') diff --git a/data/doc/sisu/html/sisu_postgresql.7.html b/data/doc/sisu/html/sisu_postgresql.7.html index 90f04be4..5d50eaa3 100644 --- a/data/doc/sisu/html/sisu_postgresql.7.html +++ b/data/doc/sisu/html/sisu_postgresql.7.html @@ -1,95 +1,187 @@ - Universe . Description: sisu postgresql package manpage . arch-tag: sisu -manpage . later . -man -Tascii sisu.1 . most . sisu_postgresql 7 "September 09, -2006" "version 0.46" "sisu -I" + -sisu_postgresql(7) manual page +"sisu_postgresql"("1") manual page Table of Contents

+SISU - SISU INFORMATION STRUCTURING UNIVERSE - SEARCH [0.58], RALPH AMISSAH + +

SISU SEARCH +

SISU POSTGRESQL +

1. POSTGRESQL +

1.1 NAME +

SiSU - Structured +information, Serialized Units - a document publishing system, postgresql -

Name

-SiSU - Structured information, Serialized -Units - a document publishing system, postgresql dependency package

-Dummy -package to install the dependencies required by SiSU to populate a postgresql -database -

Synopsis

-sisu -D [instruction]

--d --(sqlite|pg) --[instruction] [filename/wildcard -if required]

-sisu --pgsql --[instruction] [filename/wildcard if required]

- - -

Description

-sisu_postgresql is part of SiSU (man sisu) sisu_postgresql is -a dummy dummy package to install dependencies needed for sisu to populate -a postgresql database, documented in man sisu -

databases

dependency package +

1.2 DESCRIPTION +

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). +

1.3 SYNOPSIS +

sisu -D [instruction] [filename/wildcard if required]
+ +

sisu -D --pg --[instruction] [filename/wildcard if required]
+ +

1.4 COMMANDS +

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 +

-D or --pgsql may +be used interchangeably. +

1.4.1 CREATE AND DESTROY DATABASE +

dbi - database interface +
--pgsql --createall: -D set for postgresql; 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) the same name + as working directory, as +
sisu -D --createdb: creates database where no database + existed before as +
sisu -D --create: creates database tables where no database + tables existed before database tables where no database tables existed + +
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). a +
sisu -D --recreate: destroys existing -
--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)

+1.4.2 IMPORT AND REMOVE -

--pgsql --import -v

[filename/wildcard] imports data specified to postgresql -db (rb.dbi)

DOCUMENTS +

--pgsql --update -v: [filename/wildcard] updates/imports specified -data to (postgresql) db (rb.dbi)
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). +
--pgsql --remove -v: [filename/wildcard] removes -specified data to (postgresql) db (rb.dbi)
sisu -D --update -v [filename/wildcard]: updates -
--pgsql --dropall: kills data" and -drops (postgresql) db, tables & indexes
--pgsql --recreate: kills data" and -drops and rebuilds empty (postgresql) db, tables &
sisu -D --remove -v [filename/wildcard]: removes +specified document from postgresql database. +

-indexes +DOCUMENT INFORMATION (METADATA) -

Further Information

METADATA +

Document Manifest @ <http://www.jus.uio.no/sisu/sisu_manual/sisu_postgresql/sisu_manifest.html +> + +

Dublin Core (DC) +

DC tags included with this document are provided here. + +

DC Title: SiSU - SiSU information Structuring Universe - Search [0.58] +

+ DC Creator: Ralph Amissah +

DC Rights: Copyright (C) Ralph Amissah 2007, +part of SiSU documentation, License GPL 3 +

DC Type: information +

DC Date +created: 2002-08-28 +

DC Date issued: 2002-08-28 +

DC Date available: 2002-08-28 + +

DC Date modified: 2007-09-16 +

DC Date: 2007-09-16 +

Version Information + +

Sourcefile: sisu_postgresql.sst +

Filetype: SiSU text 0.58 +

Sourcefile +Digest, MD5(sisu_postgresql.sst)= b81ba44e7946dfaf03d26f0dc5d749ab +

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)= + +

20fc43cf3eb6590bc3399a1aef65c5a9 +

Generated +

Document (metaverse) last +generated: Sun Sep 23 01:14:03 +0100 2007 +

Generated by: SiSU 0.58.3 of +2007w36/4 (2007-09-06) +

Ruby version: ruby 1.8.6 (2007-06-07 patchlevel 36) + [i486-linux] +

Other versions of this document:
manifest: <http://www.jus.uio.no/sisu/sisu_postgresql/sisu_manifest.html + +> +
html: <http://www.jus.uio.no/sisu/sisu_postgresql/toc.html + +>
pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/portrait.pdf + +> +
pdf: <http://www.jus.uio.no/sisu/sisu_postgresql/landscape.pdf + +>
at: <http://www.jus.uio.no/sisu + +> +
* Generated by: SiSU 0.58.3 of 2007w36/4 (2007-09-06)
* Ruby version: ruby +1.8.6 (2007-06-07 patchlevel 36) [i486-linux]
* Last Generated on: Sun Sep 23 +01:14:07 +0100 2007
* SiSU http://www.jus.uio.no/sisu +

-For -more information on SiSU see: <http://www.jus.uio.no/sisu ->

-or man sisu -

Author

-Ralph -Amissah <ralph@amissah.com> or <ralph.amissah@gmail.com> -