icomplete man page - dossier - console collection manager	Err	bitreich.org	70
1Log	/scm/dossier/log.gph	bitreich.org	70
1Files	/scm/dossier/files.gph	bitreich.org	70
1Refs	/scm/dossier/refs.gph	bitreich.org	70
1Tags	/scm/dossier/tag	bitreich.org	70
1README	/scm/dossier/file/README.gph	bitreich.org	70
1LICENSE	/scm/dossier/file/LICENSE.gph	bitreich.org	70
i---	Err	bitreich.org	70
1commit 8b28edf4c3948bdccc843471c826bfd6da0bd989	/scm/dossier/commit/8b28edf4c3948bdccc843471c826bfd6da0bd989.gph	bitreich.org	70
1parent 947da0780fdbb7c087d39fcf7dba25de32b91c50	/scm/dossier/commit/947da0780fdbb7c087d39fcf7dba25de32b91c50.gph	bitreich.org	70
hAuthor: Solene Rapenne <solene@perso.pw>	URL:mailto:solene@perso.pw	bitreich.org	70
iDate:   Sat, 21 Jul 2018 00:38:39 +0200	Err	bitreich.org	70
i	Err	bitreich.org	70
icomplete man page	Err	bitreich.org	70
i	Err	bitreich.org	70
iDiffstat:	Err	bitreich.org	70
i  M cdb.1                               |     103 ++++++++++++++++++++++++++++---	Err	bitreich.org	70
i	Err	bitreich.org	70
i1 file changed, 93 insertions(+), 10 deletions(-)	Err	bitreich.org	70
i---	Err	bitreich.org	70
1diff --git a/cdb.1 b/cdb.1	/scm/dossier/file/cdb.1.gph	bitreich.org	70
i@@ -5,28 +5,111 @@	Err	bitreich.org	70
i .Nm cdb	Err	bitreich.org	70
i .Nd a console collection manager	Err	bitreich.org	70
i .Sh SYNOPSIS	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+.Op Cm show | Cm help | Cm export | Cm collections | Cm search | Ar item attribute value	Err	bitreich.org	70
i .Sh DESCRIPTION	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i .Nm	Err	bitreich.org	70
i-is a tool to register "items" into collections with metadata.	Err	bitreich.org	70
i+is a tool to register "items" into collections with metadata. Allowing to	Err	bitreich.org	70
i+keep tracks of collections like wine, tea, video games, movie, music etc...	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+Collections are a set of items, attributes and values.	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+allows to manage different collections to not mix everything.	Err	bitreich.org	70
i .Bl -tag -width Ds	Err	bitreich.org	70
i .It Nm Cm help	Err	bitreich.org	70
i Show help	Err	bitreich.org	70
i .It Nm Cm show Op item-name	Err	bitreich.org	70
i-show item	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Cm show	Err	bitreich.org	70
i+without argument will display the list of items in the current collection.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+With the argument	Err	bitreich.org	70
i+.Ar item-name	Err	bitreich.org	70
i+it will show all the attributes known for that item.	Err	bitreich.org	70
i .It Nm Cm export	Err	bitreich.org	70
i-Export as CSV	Err	bitreich.org	70
i+Export the data of the current collection as CSV (Comma Separated Values).	Err	bitreich.org	70
i .It Nm Cm collections Oo register Pa full-path Ar collection-name Oc | Op use Ar collection	Err	bitreich.org	70
i-manage collections	Err	bitreich.org	70
i-.It Nm Cm search Oo register Pa full-path Ar collection-name Oc | Op use Ar collection	Err	bitreich.org	70
i-make search	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Cm collections	Err	bitreich.org	70
i+with no argument will show the list of collections that	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+is aware of aka the collections that have been registered. The collection currently in use	Err	bitreich.org	70
i+will be displayed with a	Err	bitreich.org	70
i+.Sy *	Err	bitreich.org	70
i+symbol after the name.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Cm collections	Err	bitreich.org	70
i+using the parameter	Err	bitreich.org	70
i+.Ar register	Err	bitreich.org	70
i+will make	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+aware of a collection, this requires the full path	Err	bitreich.org	70
i+.Ar full-path	Err	bitreich.org	70
i+where is stored the collection and a name	Err	bitreich.org	70
i+.Ar collection-name	Err	bitreich.org	70
i+to identify it. When a collection is registered,	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+will initialize a	Err	bitreich.org	70
i+.Xr git 1	Err	bitreich.org	70
i+repository in it if possible.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Cm collections	Err	bitreich.org	70
i+with the parameter	Err	bitreich.org	70
i+.Ar use	Err	bitreich.org	70
i+will switch the current collection in use to the collection	Err	bitreich.org	70
i+.Ar collection.	Err	bitreich.org	70
i+.It Nm Cm search Oo attribute Oo value Oc Oc Op attribute value	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Cm search	Err	bitreich.org	70
i+with no argument will return the list of known attributes in the collections with the	Err	bitreich.org	70
i+number of items for which the attribute is set.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+the command	Err	bitreich.org	70
i+.Nm search	Err	bitreich.org	70
i+with one parameter will return the list of the items for which	Err	bitreich.org	70
i+.Ar attribute	Err	bitreich.org	70
i+has been recorded and the associated value, using a semi colon as separator.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+The command	Err	bitreich.org	70
i+.Nm search	Err	bitreich.org	70
i+with two parameters will return the list of the items having the value	Err	bitreich.org	70
i+.Ar value	Err	bitreich.org	70
i+in the attribute	Err	bitreich.org	70
i+.Ar attribute.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+Using more arguments will return the list of the items matching all the conditions of values in attributes.	Err	bitreich.org	70
i .It Nm Ar item-name Ar attribute Ar value Op Ar attribute2 Ar value2 Ar ...	Err	bitreich.org	70
i-Assign	Err	bitreich.org	70
i+Associate the value	Err	bitreich.org	70
i .Ar value	Err	bitreich.org	70
i-to	Err	bitreich.org	70
i+to the attribute	Err	bitreich.org	70
i .Ar attribute	Err	bitreich.org	70
i-for	Err	bitreich.org	70
i+for item	Err	bitreich.org	70
i .Ar item-name.	Err	bitreich.org	70
i-Multiples sequences of	Err	bitreich.org	70
i+Multiples couple of	Err	bitreich.org	70
i .Ar attribute value	Err	bitreich.org	70
i can be used on the same command line to define multiples values.	Err	bitreich.org	70
i .Pp	Err	bitreich.org	70
i+This is the way to add and update data inside a collection.	Err	bitreich.org	70
i+.Pp	Err	bitreich.org	70
i+Every modification is recorded with	Err	bitreich.org	70
i+.Xr git 1.	Err	bitreich.org	70
i+	Err	bitreich.org	70
i+.Sh FILES	Err	bitreich.org	70
i+.Bl -tag -width "~/.collections" -compact	Err	bitreich.org	70
i+.It Pa ~/.collections	Err	bitreich.org	70
i+The directory where	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+stores the collections registered as symlinks to their full path.	Err	bitreich.org	70
i+.Sh EXIT 	Err	bitreich.org	70
i+.Ex -std notes	Err	bitreich.org	70
i+.Sh SEE ALSO	Err	bitreich.org	70
i+.Xr git 1	Err	bitreich.org	70
i+.Sh Authors	Err	bitreich.org	70
i+.An -nosplit	Err	bitreich.org	70
i+The	Err	bitreich.org	70
i+.Nm	Err	bitreich.org	70
i+program was written by	Err	bitreich.org	70
i+.An Solène Rapenne Aq Mt solene@perso.pw	Err	bitreich.org	70
.