From b4d88c72bfa316a82578ef5e515801eae9b1085c Mon Sep 17 00:00:00 2001 From: Matthias Beyer Date: Thu, 4 Feb 2016 13:51:46 +0100 Subject: [PATCH 1/2] doc: Add section store/tagging --- doc/src/02020-tagging.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) create mode 100644 doc/src/02020-tagging.md diff --git a/doc/src/02020-tagging.md b/doc/src/02020-tagging.md new file mode 100644 index 00000000..93fad092 --- /dev/null +++ b/doc/src/02020-tagging.md @@ -0,0 +1,13 @@ +## Tagging entries {#sec:thestore:tagging} + +A store entry MAY be tagged. A tag is a String which matches the +regular expression in @lst:tagging:regex + +```{#lst:tagging:regex .numberLines caption="Regular Expression for Tags"} +/^[a-zA-Z]([a-zA-Z0-9_-]*)$/ +``` + +Tags MUST BE stored in the header section "imag" in the key "tags" as an Array +of Strings. +The tags MUST BE sorted in alphabetical order. + From c25f32fd85bcb3a21a8e50c63937891e4b26cf2a Mon Sep 17 00:00:00 2001 From: Matthias Beyer Date: Thu, 4 Feb 2016 13:51:55 +0100 Subject: [PATCH 2/2] Add chapter on libtag --- doc/src/04200-lib-tag.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 doc/src/04200-lib-tag.md diff --git a/doc/src/04200-lib-tag.md b/doc/src/04200-lib-tag.md new file mode 100644 index 00000000..20d2bd1c --- /dev/null +++ b/doc/src/04200-lib-tag.md @@ -0,0 +1,18 @@ +# libtag {#sec:libtag} + +The "libtag" library contains functionality for tagging entries. + +The following functionality for entries is provided: + +* Adding a tag to an entry +* Removing a tag from an entry +* Fetching the list of tags from an entry +* Checking whether a tag is set in an entry + +The following additional functionality is provided: + +* Fetching all entries which contain a tag +* Fetching all entries which contain a list of tags +* Fetching all entries which fulfill a set of tag-requirements (either + present, or not present, chained by logical operators) +