.. C-Munipack - User's manual Copyright 2012 David Motl Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.2 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. $Id: installation.rst,v 1.1.1.1 2012/08/12 16:57:45 dmotl Exp $ .. index:: pair: Installation; instructions .. _installation: Installation and uninstallation =============================== The latest version of the binaries and the source code can be obtained from the C-Munipack project's home page: http://c-munipack.sourceforge.net/. Choose the binary or source package according to your platform and download it. Using the installer on MS Windows --------------------------------- Download the installer (.exe file) from the project's home page and execute it. Follow the instructions in the installation wizard. By default, the files are installed to the Program Files folder. The software itself doesn't require the write access to the installation path and it doesn't read or modify the windows registry. All configuration files and other temporary files are stored in user's Application Data folder. To uninstall the software open your Control Panel, then open the Add/Remove programs tool. Select the C-Munipack 1.3 item and click on a Remove button. .. index:: pair: Source code; compiling Compiling the source code on Unix based systems ----------------------------------------------- Download the source code archive to your computer and unpack it using the tar command. The software comes with the GNU automake configuration scripts. First, run the configure script that is stored in the source's root directory. The script takes a while to finish. It automatically checks the dependencies and determines which features your system has or has not and makes a set of Makefiles that in turn are called to build and install the binaries. Here is the list of most frequently used command-line options that the script accepts. .. program:: configure .. option:: --help Print the complete set of command-line options. .. option:: --prefix=path Install software in subdirectories below prefix. The default value of prefix is /usr/local. The following options extends the default configure's set: .. option:: --enable-gui Compile and install the graphical user interface (Muniwin). The default value is yes. .. option:: --enable-toolkit Compile and install the set of user commands (toolkit). The default value is yes. Run 'make'. Once you have successfully compiled the software, run 'make install'. This will install a copy of the software, its libraries, and its documentation in the destination directory. The software is installed into following directories. In the list below, the prefix stands for the installation path, /usr/local is the default. .. object:: prefix/bin Binaries that can be run directly .. object:: prefix/lib Libraries that are used to build applications using the C-Munipack API .. object:: prefix/include Header files that are used to compile applications using the C-Munipack API .. object:: prefix/man Unix-style man pages .. object:: prefix/share/c-munipack-1.3 Icons, sounds and documentation