From 1da073923fd749b6db5a9db120603ebd70371c4e Mon Sep 17 00:00:00 2001 From: Michael Homer Date: Fri, 20 Jun 2014 09:29:08 +1200 Subject: Add readme and licence The readme gives simple usage an installation instructions. --- README | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000..d50d26c --- /dev/null +++ b/README @@ -0,0 +1,34 @@ +dragon - simple drag-and-drop source/sink for X + +Many programs, particularly web applications, expect files to be dragged +into them now. If you don't habitually use a file manager that is a +problem. dragon is a lightweight drag-and-drop source for X where you +can run: + dragon file.tar.gz +to get a window with just that file in it, ready to be dragged where you +need it. + +What if you need to drag into something? Using: + dragon --target +you get a window you can drag files and text into. Dropped items are +printed to standard output. + +If you're only dealing with a single file, either source or sink, use +the --and-exit option to terminate as soon as one drag-and-drop +operation is complete. + +If you want to keep the files you drag in around for a while, use: + dragon --target --keep +and each file you drop becomes its own draggable button, which you can +drag elsewhere later. + +Installing +---------- +Just run `make` to compile dragon and get an executable you can run +immediately or put where you like. + +To install, run `make install`, which will put it into ~/.local/bin by +default. If you want a different destination, run `make +PREFIX=/path/here install` instead. + +dragon requires GTK+ 3 and is distributed under the GNU GPL version 3. -- cgit