Permalink
Switch branches/tags
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
159 lines (94 sloc) 4.58 KB

Installing Manos

Currently Manos can be installed on Linux, OS X and Windows.

You should read the whole guide before reading your operating system specific instructions.

Files

A properly installed Manos on OS X and Linux should install the following files:

<prefix>/lib/Manos.dll
<prefix>/lib/manos.exe
<prefix>/lib/pkgconfig/manos.pc
<prefix>/bin/manos
<prefix>/share/manos/docs/<documentation files>
<prefix>/share/manos/layouts/default/<the default layout files for new apps>

On windows all files will be installed in the same directory:

<prefix>/Manos.dll
<prefix>/manos.exe
<prefix>/docs/<documentation files>
<prefix>/layouts/default/<the default layout files>

Layouts

Layouts are the files that are copied to your new application directory when you use the manos --init command.

Installing from source

To build Manos from source you must run configure and make from the top level directory. Installation should be as simple as:

./configure sudo make install

The configure script also supports changing the installation prefix:

./configure --prefix=/tmp/install

To verify your installation you can use the manos --docs command. This will create a new server running on http://localhost:8181/ you should be able to navigate there in your browser and view the manos documentation.

Installing Manos on OS X

Install Mono 2.8

Grab the Mono 2.8 OSX package from the Mono Downloads Page.

You need to have Mono 2.8 installed on your system. An older Mono install won't cut it. Also, if you've installed Mono from source on your Mac, things might work, things might not work. This guide assumes you have it installed from packages.

Install Manos

Now that all the dependencies are installed you should be able to build and install Manos.

git clone https://jacksonh@github.com/jacksonh/manos.git
./autogen.sh
make
sudo make install

This will install Manos.dll and manos.exe into /usr/local/lib/manos. As well as a .pc file and a manos script for invoking manos.exe

Confirm your installation

You should now be able to run the manos documentation server:

manos --docs

and navigate to http://localhost:8181/ in your browser.

Installation on Linux

Install Mono 2.8

Follow the distro specific instructions on http://www.mono-project.com/download to install Mono 2.8.

Once Mono 2.8 is installed you can verify your installation by typing mono on the command line:

jackson@erm:~$ mono --version
Mono JIT compiler version 2.8 (mono-2-8/57dae7a Mon Oct  4 18:24:09 EDT 2010)

Build Dependencies

automake
gcc
make
libtool

Install Manos

Checkout Manos from github at http://github.com/jacksonh/manos/ and build/install it:

jackson@erm:manos$ ./autogen.sh
...
jackson@erm:manos$ make && sudo make install
...

To verify your installation you can use the manos --docs command. This will create a new server running on http://localhost:8181/ you should be able to navigate there in your browser and view the manos documentation.

Installation on OpenBSD

Install prerequisites

From ports or packages install mono 2.8

Install Manos

Checkout Manos from github at http://github.com/jacksonh/manos/ and build/install it:

$ ./autogen.sh
...
$ su
...
$ gmake install
...

To verify your installation you can use the manos --docs command. This will create a new server running on http://localhost:8181/ you should be able to navigate there in your browser and view the manos documentation.

Installation on Windows

Install Mono 2.8 (Optional)

Follow the Windows specific instructions on http://www.mono-project.com/download to install Mono 2.8. This step is optional but you will need the Mono.Posix.dll and PosixHelper.dll when you want to compile a single Manos dll for both Windows and Linux/MacOS.

Install Manos

Checkout Manos from github at http://github.com/jacksonh/manos/ and build/install it using Visual Studio.

If you do no have Mono installed you can define DISABLE_POSIX to remove the Mono.Posix dependency.

Copy all files to your install directory

Create a directory for the Manos binary files and copy Manos.dll manos.exe and the entire manos/data/layouts directory to your new directory. Your structure should look something like this:

C:\Program Files\Manos\manos.exe
C:\Program Files\Manos\Manos.dll
C:\Program Files\layouts\default\<layout files>