Lspace

Terry Pratchett's Library Space

Books contain Knowledge. Knowledge is Power. Power is Energy. Energy is Mass. Mass bends Space.

(And thus the singularity at the heart of all libraries, connecting them ;)

Vault(s)

The sqlite3 database serving as store (and/or index) to the documents under its management.

Sub types:

• Integrated : This vault stores document content and index information in the same place, the vault's sqlite database.
• Indexed : This vault stores only index information in its aqlite database. The documents (content) are kept in the filesystem, in the locations where they were found.
• Detached : While this vault also stores document content in the filesystem, it however does not use the locations where it was found, but a directory specifically associated with the vault, the backing store.

It should be noted that while Integrated vs Detached are mutually exclusive, i.e. cannot be used together, Indexed can be mixed with either, on a per-document basis.

Document(s)

Generic name for the files stored in or indexed by an Lspace Vault.

Dex

Short for rolodex.

A limited-size history of recently used documents and searches. Note that documents and searches have separate dexes. Documents and searches in their respective dexes can be referenced by a (short) dex id instead of their (long) full name.

Document dex id's have the form @xxx where xxx is either a numeric id, or a unique prefix of current and previous for the two most recent elements of the dex.

Search dex id's have the form :xxx instead.

Tag

A named marker which can be associated with zero or more documents. When associated with documents each association (a document/tag pair) can have zero or more tag values attached to it.

Tag Value

Any kind of string which is attached to a document/tag pair.

Search

A series of match operators with arguments to find sets of documents, and logical operators combining them. Searches can be named for future recall and reuse. Recent searches can be recalled from the dex, even if not named.

Search Result

A set of documents matching the expression of a search. Search results are generally cached in the vault to make re-search quicker, however changes to documents and their tags will invalidate the cache.

Search results can be named, these are copies independent of the search they came from. Only document removal will affect such sets, general document and tag changes do not invalidate them.