documentation

git-svn-id: https://callirhoe.googlecode.com/svn/branches/phantome@232 81c8bb96-aa45-f2e2-0eef-c4fa4a15c6df
This commit is contained in:
geortz@gmail.com 2014-11-06 17:02:32 +00:00
parent 7cd1161aef
commit c0f65af504

55
INSTALL
View File

@ -9,7 +9,7 @@ QUICK INSTALLATION GUIDE
CONTENTS CONTENTS
1) FROM COMPRESSED ARCHIVE 1) FROM COMPRESSED ARCHIVE
2) FROM SVN 2) FROM SVN
3) INVOKING callirhoe FROM PATH 3) INSTALLING INTO BINARY PATH
4) INSTALLATION FOR ARCH LINUX 4) INSTALLATION FOR ARCH LINUX
(rough installation guide for novice users...) (rough installation guide for novice users...)
@ -20,7 +20,8 @@ Download the latest version from the project's page,
or directly from: or directly from:
https://callirhoe.googlecode.com/svn/wiki/releases/ https://callirhoe.googlecode.com/svn/wiki/releases/
You end up with a file named callirhoe-X.Y.Z.7z where X.Y.Z the version number (for example 0.4.0). You end up with a file named callirhoe-X.Y.Z.7z where X.Y.Z the version
number (for example 0.4.0).
Extract the contents of the archive Extract the contents of the archive
$ 7z x callirhoe-X.Y.Z.7z $ 7z x callirhoe-X.Y.Z.7z
@ -32,7 +33,8 @@ Now you can launch the program, e.g.
$ ./callirhoe.py foo.pdf $ ./callirhoe.py foo.pdf
See section 3 for how to install callirhoe so that it lies in your executable path. See section 3 for how to install callirhoe so that it lies in your
executable path.
2) FROM SVN 2) FROM SVN
@ -52,48 +54,48 @@ You can launch the program as usual:
$ ./callirhoe.py foo.pdf $ ./callirhoe.py foo.pdf
3) INVOKING callirhoe FROM PATH 3) INSTALLING INTO BINARY PATH
You can add a link to your path, $HOME/bin or /usr/local/bin: You can add a link to your path, $HOME/bin or /usr/local/bin:
$ ln -s `pwd`/callirhoe.py $HOME/bin/callirhoe $ ln -s `pwd`/callirhoe.py $HOME/bin/callirhoe
You can do the same with calmagick.py. You may also install it system-wide, You can do the same with calmagick.py. You may also install it
for example in /opt. In this case, keep in mind, that ~/.callirhoe/ is also system-wide, for example in /opt. In this case, keep in mind, that
searched for additional definitions, styles etc. ~/.callirhoe/ is also searched for additional definitions, styles etc.
If you do not plan to mess with the source, you may create a binary python package. If you do not plan to mess with the source, you may create a binary
This is not exactly a binary, it is a zip archive containing compiled python bytecode, python package. This is not exactly a binary, it is a zip archive
which is quite compact. To do so, go to the scripts directory: containing compiled python bytecode, which is quite compact. To do so,
simply run:
$ cd scripts $ make
and run This will create two executables, 'callirhoe' and 'calmagick'. Now you
can install them into your binary path as follows:
$ ./make_pkg $ make install
This will create in the parent directory two executables, 'callirhoe' and 'calmagick'. this will typically install to /usr/local/bin (and the holiday files into
Now copy them to your binary path. And you can remove the source dir, as it is no longer /usr/local/share/callirhoe/holidays). You can specify another prefix:
needed. You might want to copy the holiday data files first, if you want to use them
(callirhoe takes a full path to them, so you can store them wherever you want).
On a linux system, you will additionally see a Makefile created, which you can alternatively $ make install DESTDIR=/my/other/dir
run with 'make install' to install the files in the standard places,
instead of manually copying them. Now you can remove the source dir, as it is no longer needed.
4) INSTALLATION FOR ARCH LINUX 4) INSTALLATION FOR ARCH LINUX
There is a PKGBUILD file you can use to install. There is a PKGBUILD file you can use to install. Normally you get just
You can get the PKGBUILD either from SVN or compressed archive or from AUR. the PKGBUILD from the webpage from AUR (<INSERT LINK HERE>). It is also
For the first two options, the method to get the source tree is described in sections 1 and 2, included in the source distribution, but this is a bit redundant (see
while for the third option you can get it from here: <INSERT LINK HERE> below).
Place the PKGBUILD into a directory and run: Place the PKGBUILD into a directory and run:
$ makepkg -si $ makepkg -si
( -s will automatically install missing depedencies ) ( -s will automatically install missing depedencies; also note that this
will redownload the source from the svn )
Arch will do the rest for you. Arch will do the rest for you.
@ -101,4 +103,3 @@ In the unlikely event that you don't have "makepkg" already installed
you can find information about it's installation here: you can find information about it's installation here:
https://wiki.archlinux.org/index.php/Arch_User_Repository https://wiki.archlinux.org/index.php/Arch_User_Repository