ryuslash/clark
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity
Store bookmarks, in common lisp.
79 commits 1 branch 2 tags 133 KiB
Common Lisp 78.6%
Makefile 12.7%
Shell 3.8%
CSS 2.8%
Emacs Lisp 2.1%
Find a file
Tom Willemse b4769c70c4 Move command definitions to separate file 
Hoping to keep the clark source file clean.
2013-10-06 02:29:23 +02:00
doc Add more space between nodes 2013-07-02 22:39:47 +02:00
lisp Move command definitions to separate file 2013-10-06 02:29:23 +02:00
site Add site and some complementary files 2013-04-07 03:52:48 +02:00
.gitignore Ignore Emacs desktop files 2013-07-02 22:41:13 +02:00
CONTRIBUTING Add site and some complementary files 2013-04-07 03:52:48 +02:00
COPYING Add GPLv3 license info 2013-03-23 00:51:31 +01:00
INSTALL Add site and some complementary files 2013-04-07 03:52:48 +02:00
Makefile Remove js/ 2013-08-26 23:58:50 +02:00
NEWS Remove false statement from NEWS 2013-04-07 03:54:58 +02:00
README.org Add site and some complementary files 2013-04-07 03:52:48 +02:00
run-clark Remove McCLIM dependency from run-clark 2013-04-07 03:28:09 +02:00

README.org

CLark

#

#

#

#

NAME

CLark - collect bookmarks on your command-line

SYNOPSIS

clark [<options>...] [<command> [<options>...] [<arguments>...]]

DESCRIPTION

CLark is a bookmarking program for the command-line. It is meant to interface with other programs to make its use easy, whilst remaining free of being locked in to any single browser or program (except for itself). This should allow you to keep your bookmarks in a single, easily accessible, place regardles of which browser you use at any moment.

CLark?! What the …?

I've been working on this program for a long time, though not very intensely, and it's gone through a few names.

At first I absolutely wanted to write it in C, and I named it linkwave. I made a little program that could store given URLs with names and descriptions, but not much else than that.

Then I started messing around with Lisp and some of its derivatives, such as chicken scheme. And then I thought it would be much cooler to (re)write this in scheme! I named it markam, because Markam collects books.

Now, I'm thinking that it would be much cooler still to write the thing in Common Lisp! So I name it CLark, because it is Common Lisp, and a rewrite of mARKam.

COMMANDS

Each command has it's own arguments and description, to see:

  clark help <command>
add
Add a new bookmark to the database.
edit
Edit a bookmark's information.
exists
Check if a bookmark is already present in the database.
help
Prints a usage and help message, showing a list of possible commands and some hints on how to use them. Can also show help messages for individual commands.
remove
Remove a bookmark from the database.
search
Search through bookmarks for a certain title or tag.
set-tags
Replace or remove a bookmark's tags.
version
Print CLark's version.

OPTIONS

Command-line options can be passed to CLark with either - or --.

script
Change the output of some commands to be somewhat more machine-friently, making it easier to parse the data.