From c1dbf3d24c2366f4b889389a88760ec60548e37a Mon Sep 17 00:00:00 2001 From: Arun Prakash Jana Date: Sun, 24 Apr 2016 20:07:51 +0530 Subject: [PATCH] Explain DB file location. --- README.md | 6 +++++- buku.1 | 9 +++++++-- 2 files changed, 12 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 4a620ea..171de17 100644 --- a/README.md +++ b/README.md @@ -155,7 +155,11 @@ You may need to use `sudo` with `PREFIX` depending on your permissions on destin ## Operational notes -- The SQLite3 database file is stored in `$HOME/.local/share/buku/bookmarks.db` (or `$XDG_DATA_HOME/buku/bookmarks.db`, if XDG_DATA_HOME is defined) for each user. Before version 1.9, buku stored database in `$HOME/.cache/buku/bookmarks.db`. If the file exists, buku automatically moves it to new location. +- The SQLite3 database file is stored in: + - **$XDG_DATA_HOME/buku/bookmarks.db**, if XDG_DATA_HOME is defined (first preference) or + - **$HOME/.local/share/buku/bookmarks.db**, if HOME is defined (second preference) or + - the **current directory**, on Windows for example. +- Before version 1.9, `buku`stored its database in **$HOME/.cache/buku/bookmarks.db**. If the file exists, buku automatically moves it to new location. - The database index for entries starts from 1. Index 0 is used for special operations like show or refresh or delete all bookmarks. - It's advisable to copy URLs directly from the browser address bar, i.e., along with the leading `http://` or `https://` token. `buku` looks up title data (found within tags of HTML) from the web ONLY for fully-formed HTTP(S) URLs. - If the URL contains characters like `;`, `&` or brackets they may be interpreted specially by the shell. To avoid it, add the URL within single `'` or double `"` quotes. diff --git a/buku.1 b/buku.1 index 9d1e006..2e18587 100644 --- a/buku.1 +++ b/buku.1 @@ -12,9 +12,14 @@ buku \- A private cmdline bookmark manager. Your mini web! is a command-line tool to save, tag and search bookmarks. .SH OPERATIONAL NOTES .PP -The SQLite3 database file is stored in \fB$HOME/.local/share/buku/bookmarks.db\fR (or \fB$XDG_DATA_HOME/buku/bookmarks.db\fR, if XDG_DATA_HOME is defined) for each user. Before version 1.9, +The SQLite3 database file is stored in: + - \fB$XDG_DATA_HOME/buku/bookmarks.db\fR, if XDG_DATA_HOME is defined (first preference) or + - \fB$HOME/.local/share/buku/bookmarks.db\fR, if HOME is defined (second preference) or + - the \fBcurrent directory\fR, on Windows for example. +.PP +Before version 1.9, .B buku -stored database in \fB$HOME/.cache/buku/bookmarks.db\fR. If the file exists, buku automatically moves it to new location. +stored its database in \fB$HOME/.cache/buku/bookmarks.db\fR. If the file exists, buku automatically moves it to new location. .PP The database index for entries starts from 1. Index 0 is used for special operations like show or refresh or delete all bookmarks. .PP