Difference between revisions of "Leksah Installation"

First look to the general information in the Manual.

When you get the following error:

src/IDE/Completion.hs:87:26:

Not in scope: `sourceLanguageManagerGuessLanguage'</code>

you have to install gtksourceview2 in a version > 2.4.0

When you get the following error:

Linking dist/build/leksah/leksah ...

/usr/bin/ld: cannot find -ledit

collect2: ld returned 1 exit status</code>

you have to install libedit development files.

The package type-level considered toxic!

This package defines > 20000 newtypes for numbers and

wastes a lot of space for metadata. So consider to

unregister it, if you don't really need it.

== Installation of 0.6.1 on Windows from binary ==

There is a binary installer for Windows, that could be downloaded from [http://leksah.org leksah.org].

Before using it, you need to install the [http://hackage.haskell.org/platform/ Haskell Platform] (tested with version 2009.2).

== Installation of 0.4.3 on Windows (Vista) from scratch ==

In the future when Leksah reaches production quality I hope we can provide a Windows installer.

0. <tt>cabal-install</tt> was not working for me. Probably because currently there is no gtk2hs >= 0.10.0 on Hackage right now.

1. Install your GHC from http://www.haskell.org/ghc. Duh. Mine was GHC 6.10.1.

2. Install gtk2hs from http://www.haskell.org/gtk2hs/ or [http://sourceforge.net/project/showfiles.php?group_id=49207&package_id=42440 Sourceforge.net]. It was 0.10.0 when I checked.

3. Install Cygwin with the online installer from http://www.cygwin.com/

Select packages wget, curl and gcc-core in adition to the standard selection. I used the 1.7.0 version of Cygwin setup, but it is still beta.

4*. Download darcs from http://wiki.darcs.net/DarcsWiki/Binaries, unpack it in under Program Files and add the path to your environment variables. The file I downloaded was darcsdir-cygwin-2.2.0.tar.bz2.

5. Download the GHC sources from http://www.haskell.org/ghc. Open a Cygwin shell, make a directory Haskell, copy the source tarballs here and unpack them.

6*. Download the binary and utf-8 packages from [http://hackage.haskell.org/packages/archive/pkg-list.html Hackage] and copy them to the Haskell folder. Open a Cygwin shell in Administrator mode and unpack the tar files. Go to the directories and do <tt>runhaskell Setup configure</tt>, <tt>runhaskell Setup build</tt>, <tt>runhaskell Setup install</tt>.

7*. In the Haskell directory do a <tt>darcs get http://code.haskell.org/leksah</tt>. Go to the leksah directory and do a <tt>runhaskell Setup configure</tt>, <tt>runhaskell Setup build</tt>, <tt>runhaskell Setup install</tt>.

7a) Although I probably didn't get this, previously some gtk error message was resolved by editting C:/Program Files/Gtk2Hs/0.10.0/etc/gtk-2.0/gtkrc and change the theme name from MS-Windows to Raleigh: <tt>gtk-theme-name = "Raleigh"</tt>

8. You may wish to install a full Unicode monospace font if you want to use the source candy feature of leksah. e.g. [http://www.evertype.com/emono/ Everson Mono] or [http://dejavu-fonts.org/wiki/index.php?title=Download Deja Vu Sans Mono] (or perhaps the [http://www.gnu.org/software/freefont/ GNU FreeFont]s which are aesthetically pleasing to my eyes).

9. Start leksah and give your Haskell directory as source root. Select the right font from Help/Prefs.

10. Have fun with leksah, but remember it is a beta version!

NB* I actually experienced a bit of a problem here, darcs was taking too much time. While in Cygwin, I cabal-installed it! Voila! So the starred portions are actually unnecessary, I think.

== Installation of 0.6.1 on Ubuntu 9.04 ==

Built in Ubuntu 9.04 using GHC 6.10.4 from

[https://launchpad.net/~someone561/+archive/ppa Someone561's PPA]. cabal-install was bootstrapped using original ghc from the distribution, because of

dependency problems. GHC 6.10.4 was installed afterwards.

=== Install cabal-install from [http://hackage.haskell.org/trac/hackage/wiki/CabalInstall CabalInstall] ===

=== Upgrade GHC to 6.10.4 ===

=== Install gtk2hs ===

$ sudo aptitude build-deb libghc6-gtk-dev

$ sudo aptitude install libgtk2.0-dev libgtksourceview2.0-dev libcairo2-dev checkinstall

in gtk2hs sources:

$ ./configure

$ make

$ checkinstall

(say 'n' to question about making docs. checkinstall makes a deb package gtk2hs that could be easily uninstalled - normally you could do make install)

=== Install Leksah using cabal ===

$ cd ~/.cabal/bin

$ ./cabal update

$ ./cabal install leksah

Resolving dependencies...

cabal: cannot configure regex-compat-0.92. It requires regex-base >=0.93

For the dependency on regex-base >=0.93 there are these packages:

regex-base-0.93 and regex-base-0.93.1. However none of them are available.

regex-base-0.93 was excluded because regex-base-0.72.0.2 was selected instead

regex-base-0.93 was excluded because leksah-0.6.0 requires regex-base ==0.72.0.2

regex-base-0.93.1 was excluded because regex-base-0.72.0.2 was selected instead

regex-base-0.93.1 was excluded because leksah-0.6.1 requires regex-base 0.72.0.2

To solve these dependency problems, we need to add some constraints to the installation process like so:

$ ~/.cabal/bin/cabal install --constraint='regex-posix ==0.72.0.3' --constraint='regex-compat ==0.71.0.1' leksah

=== running the IDE ===

Leksah should now work. If you have problems running with config from older version, consider removing the old configuration:

$ rm ~/.leksah -r

To start the IDE:

$ export PATH=$PATH:~/.cabal/bin

$ leksah

== Installation of 0.4.4.1 on Ubuntu 8.10 ==

Hello, I've installed Leksah 0.4.4.1 today in Ubuntu 8.10. This

procedure is based on the one given in the manual, but uses GHC 6.10.2.

Hope it will be useful. (Maciej Noszczyński)

<hask>

# setup

cd ~

mkdir ghc-build

cd ghc-build

# compile ghc 6.10.2

sudo aptitude build-dep ghc6

wget http://www.haskell.org/ghc/dist/6.10.2/ghc-6.10.2-src.tar.bz2

wget http://www.haskell.org/ghc/dist/6.10.2/ghc-6.10.2-src-extralibs.tar.bz2

tar jxf ghc-6.10.2-src.tar.bz2

tar jxf ghc-6.10.2-src-extralibs.tar.bz2

cd ghc-6.10.2/

./configure --prefix ~/ghc

make

make install

cd ..

# cleanup and setup paths

sudo aptitude remove ghc6

export PATH=$PATH:/home/username/ghc/bin:/home/username/.cabal/bin

(you should put this export into some startup file e.g. .bash_profile

and source it when needed)

# gtk2hs from darcs (> 0.10.0) is needed for 6.10.2

sudo aptitude install darcs

darcs get --partial http://code.haskell.org/gtk2hs/

aptitude install happy alex libglib2.0-dev libgtk2.0-dev

libgtksourceview2.0-dev libgmp3-dev autoconf libtool

cd gtk2hs

autoreconf

./configure

make

sudo make install

cd ..

# cabal install

wget

http://hackage.haskell.org/packages/archive/cabal-install/0.6.2/cabal-install-0.6.2.tar.gz

tar zxf cabal-install-0.6.2.tar.gz

cd cabal-install-0.6.2

./bootstrap.sh

cd ..

# build and install Leksah

wget

http://hackage.haskell.org/packages/archive/leksah/0.4.4.1/leksah-0.4.4.1.tar.gz

tar zxf leksah-0.4.4.1.tar.gz

cd leksah-0.4.4.1

mv leksah.cabal leksah.cabal.old

sed -e 's/Cabal ==1.6.0.1/Cabal >=1.6.0.1/g' leksah.cabal.old > leksah.cabal

cabal update

cabal install binary

cabal install utf8-string

runhaskell Setup configure --user

runhaskell Setup build

runhaskell Setup install

cd ..

# run the IDE

leksah

</hask>

== Running ==

To run Leksah after installation using cabal, you could use this simple script:

#!/bin/bash

export PATH=$PATH:~/.cabal/bin

leksah &> ~/leksah.log

Leksah outputs quite a lot of useful information to stdout at the moment, so it might

be useful to watch the log by issuing

$ tail -f ~/leksah.log

in the terminal window.

If you want a nice icon for graphical environment shortcut, you could use ''data/leksah.png''.

'''WARNING''': Running leksah 0.6.1 from GNOME accelerator without terminal seemed to crash the whole X session

for me (MNo) after a while of editing.

If you have the same problem, you might be better off without output redirection ("&> ~/leksah.log") and

setting accelerator type to "terminal program".