Explain DB file location.

This commit is contained in:
Arun Prakash Jana 2016-04-24 20:07:51 +05:30
parent 71946af3c0
commit c1dbf3d24c
No known key found for this signature in database
GPG Key ID: C0A712ED95043DCB
2 changed files with 12 additions and 3 deletions

View File

@ -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 <title></title> 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.

9
buku.1
View File

@ -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