Add a README - bookmarks.sh - Simple bookmark manager
(HTM) hg clone https://bitbucket.org/iamleot/bookmarks.sh
(DIR) Log
(DIR) Files
(DIR) Refs
(DIR) README
---
(DIR) changeset abcdd5154ef89d37bfae02ca749a7ef0b5cee9bf
(DIR) parent 644e21164c4fc1b3c1cb66846701ac9bd08214ff
(HTM) Author: Leonardo Taccari <iamleot@gmail.com>
Date: Mon, 8 Jan 2018 02:32:40
Add a README
Diffstat:
README | 43 +++++++++++++++++++++++++++++++++++++++++++
1 files changed, 43 insertions(+), 0 deletions(-)
---
diff -r 644e21164c4f -r abcdd5154ef8 README
--- /dev/null Thu Jan 01 00:00:00 1970 +0000
+++ b/README Mon Jan 08 02:32:40 2018 +0100
@@ -0,0 +1,43 @@
+bookmarks is a shell script to manage bookmarks files.
+A bookmark file (by default ~/.bookmarks is used, but this can be adjusted
+via ${BOOKMARKS} environment variable) is just a TSV (tab-separated values) file
+with the following 4 fields:
+
+ - id
+ - URL
+ - tags `@tag' comma separated, e.g.: @tag0,@tag1,...,@tagn
+ - comment
+
+Invoking bookmarks without any arguments prints out usage information, e.g.:
+
+ % bookmarks
+ usage: bookmarks command ...
+ bookmarks add id url [tags [comment]]
+ bookmarks delete id
+ bookmarks list
+ bookmarks search id|url|tag
+
+To add a bookmark, e.g. `example':
+
+ % bookmarks add example http://www.example.org/ @example 'Example Domain'
+
+To delete a bookmark, e.g. `example':
+
+ % bookmarks delete example
+
+To list all bookmarks:
+
+ % bookmarks list
+ example http://www.example.org/ @example Example Domain
+
+To search a bookmark:
+
+ % bookmarks search example # via id
+ % bookmarks search http://www.example.org/ # via URL
+ % bookmarks search @example # via tag
+
+This format can also be used by `surfraw'. For more information about that
+please give a look to the `Bookmarks' section of the surfraw(1) man page.
+
+bookmarks needs a sed(1) implementation that supports the `-i' non-standard
+option.