summaryrefslogtreecommitdiff
path: root/docs/man/lesana.rst
diff options
context:
space:
mode:
authorElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2020-10-01 23:30:04 +0200
committerElena ``of Valhalla'' Grandi <valhalla@trueelena.org>2020-10-01 23:30:04 +0200
commitea9af6f5521c86a8529d75db91455e8982e1d77f (patch)
treecb21c405b0ca6d425a966660be5b02a0c3c97469 /docs/man/lesana.rst
parent5e045d665f5057d3111939c1fa13133e53d7fb8d (diff)
parente3e1aac99ff15ef99ac6d3fd8539492a2c4801be (diff)
Merge branch 'master' into types
Diffstat (limited to 'docs/man/lesana.rst')
-rw-r--r--docs/man/lesana.rst76
1 files changed, 0 insertions, 76 deletions
diff --git a/docs/man/lesana.rst b/docs/man/lesana.rst
deleted file mode 100644
index 0d60e4f..0000000
--- a/docs/man/lesana.rst
+++ /dev/null
@@ -1,76 +0,0 @@
-======
-lesana
-======
-
-------------------------------
-manages collection inventories
-------------------------------
-
-:Author: valhalla@trueelena.org
-:Manual section: 1
-
-SYNOPSIS
-========
-
-lesana [--help] <command>
-
-DESCRIPTION
-===========
-
-lesana is a tool to organize collections of various kinds. It is
-designed to have a data storage / serialization format that is friendly
-to git and other VCSs, but decent performances.
-
-To reach this aim it uses yaml_ as its serialization format, which is
-easy to store in a VCS, share between people and syncronize between
-different computers, but it also keeps an index of this data in a local
-xapian_ database in order to allow for fast searches.
-
-.. _yaml: http://yaml.org/
-.. _xapian: https://xapian.org/
-
-lesana supports collections of any kind, as long as their entries can be
-described with a mostly flat dictionary of fields of the types described
-in the documentation file ``field_types``.
-
-Some example collection schemas are provided, but one big strenght of
-lesana is the ability to customize your collection with custom fields
-either by simply writing a personalized ``settings.yaml``.
-
-OPTIONS
-=======
-
--h, --help
- Prints an help message and exits.
-
-COMMANDS
-========
-
-new(1)
- Creates a new entry.
-edit(1)
- Edits an existing entry.
-show(1)
- Shows an existing entry.
-index(1)
- Index some entries in the xapian cache.
-search(1)
- Searches for entries in the xapian cache.
-export(1)
- Exports entries from one lesana collection to another
-init(1)
- Initialize a new lesana collection
-rm(1)
- Removes an entry.
-
-TEXT EDITOR
-===========
-
-Many lesana subcommands will try to open files in a text editor choosen
-as follows:
-
-* first, the value of $EDITOR is tried
-* then the command ``sensible-editor``, as available under e.g. Debian
- and its derivatives
-* lastly, it will try to fallback to ``vi``, which should be available
- under any posix system.