Changes between Version 11 and Version 12 of InstallationGuide

Timestamp:

06/04/05 23:02:18 (8 years ago)

Author:

armin (IP: 84.162.215.159)

Comment:

Updated Windows and Gentoo-Linux part

InstallationGuide

@@ +1 @@
+If you encounter any problems while installing and/or compiling Gobby or its dependencies (libobby, net6), write into the WikiForum.
+
 = Microsoft Windows =
 
-We provide an installer for the Micrsoft Windows platforms [http://darcs.0x539.de/gobby-dist/Output/gobby_setup.exe here]. Note that this installer is not as up-to-date as the darcs repository at [http://darcs.0x539.de/cgi-bin/darcs.cgi/gobby darcs.0x539.de] and may be some weeks old (but mostly a stable version of Gobby). Before you install Gobby with the installer, be sure that gtkmm-2.6 is installed on your system. If it isn't, get it from [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ here]. The Windows version of Gobby ''should'' now run on systems other than Windows XP (#19 has been fixed for net6-1.0.1, but the patch is not in the 1.1.0-branch, so it is not marked as fixed here).
+We provide an installer for the Micrsoft Windows platforms [http://darcs.0x539.de/gobby-dist/Output/gobby_setup.exe here]. Note that this installer is not as up-to-date as the darcs repository at [http://darcs.0x539.de/cgi-bin/darcs.cgi/gobby darcs.0x539.de] and may be some weeks old (but it provides mostly a stable version of Gobby). Before you install Gobby with the installer, be sure that gtkmm-2.6 is installed on your system. If it isn't, get it from [http://www.pcpm.ucl.ac.be/~gustin/win32_ports/ here]. The Windows version of Gobby ''should'' now run on systems other than Windows XP.
 
-Alternatively, you can compile the whole source for your own. I suggest the [http://www.mingw.org MingW] compiler in combination with the [http://www.mingw.org/msys.html MSYS] shell replacement. You will need the gtkmm-2.6 developement package from the site mentioned above and a distribution tarball of net6, libobby and gobby which will soon be available. Until then, you can get the corresponding darcs repositories with ''darcs get --verbose [net6|libobby|gobby]@darcs.0x539.de:repo'', running ''autogen.sh'', ''configure'' and ''make dist'' on a unix machine. If you want to get net6-1.0.1 instead of net6-1.1.0 (which should be the case if you do not have Windows XP since the patch is not yet applied to net6-1.1.0), get ''net6@darcs.0x539.de:stable''.
+Alternatively, you can compile the whole source for your own. I suggest the [http://www.mingw.org MingW] compiler in combination with the [http://www.mingw.org/msys.html MSYS] shell replacement (I did not test any other build environments, so I would like to hear from you if you try another one). You will need the gtkmm-2.6 development package from the site mentioned above and a distribution tarball of net6, libobby and gobby which may be found at [http://releases.0x539.de http://releases.0x539.de].
 
-If you compile with gtksourceview support (say ''--with-gtksourceview'' to Gobby's configure) you will also need libgnomeprint and [http://gtksourceview.sourceforge.net gtksourceview]. If you do not want to compile the two, there are two developement packages containing header files, import and runtime libraries available in the [http://darcs.0x539.de/gobby-dist gobby-dist] on darcs.0x539.de. Note that I hacked gtksourceview to search in the common app data folder for its language-spec files (this is the place where the Gobby installer installs them, too). Another two packages are available for net6 and libobby. If you decide to compile libobby yourself, say ''--disable-tests'' to configure because two of them do not run on the windows platform. If you get an error in ''server_buffer.cpp'', change the return value of ''obby::server_buffer::on_login'' to ''void'' and remove the ''return 0;'' statement in the function definition. This will be the case if you compile libobby with a version of net6 less than 1.1.0.
+If you compile with gtksourceview support (say ''--with-gtksourceview'' to Gobby's configure) you will also need libgnomeprint and [http://gtksourceview.sourceforge.net gtksourceview]. If you do not want to compile the two, there are two developement packages containing header files, import libraries and runtime libraries available in the [http://darcs.0x539.de/gobby-dist gobby-dist] on darcs.0x539.de. Note that I hacked gtksourceview to search in the common app data folder for its language-spec files (this is the place where the Gobby installer installs them, too). Another two prebuilt packages are available for net6 and libobby. If you decide to compile libobby yourself, say ''--disable-tests'' to configure because two of them do not run on the windows platform.
 
 You also need to have working pkg-config ''.pc-files'' for the four libraries, so the configure scripts can detect that the dependencies are installed and where to find the haeder and library files of them. If you compile the libraries for your own, they will be generated and installed through ''make install'' automatically. If you use the precompiled binaries from [http://darcs.0x539.de/gobby-dist gobby-dist], you have to build your own files. Type ''echo $PKG_CONFIG_PATH'' in the [http://www.mingw.org/msys.html MSYS] shell to show up the directory where pkg-config looks for its files. Move to this directory and look on the already existing files to know how they work. It's pretty easy. I recommend to copy an existing file, rename it following this table and adjust the include and library paths.
@@ -16 +18 @@
 By the way: If you do not have pkg-config, you do not have gtkmm-devel properly installed.
 
-However, I currently strongly suggest to use the installer for Microsoft Windows. There is no real need to compile the whole packages for your own.
-
-Having any problems with the Windows installation or compilation, post them into the WikiForum or somewhere, and I will try to help you as good as I can.
+However, I currently strongly recommend to use the installer for Microsoft Windows. There is no real need to compile the whole packages for your own.
 
 = Linux =
@@ -24 +24 @@
 == Gentoo Linux ==
 
-Tom wrote ebuilds for net6, libobby and gobby that may be retrieved via the contrib/- sub directories in the corresponding repositories. Be sure to install [http://dev.gentoo.org/~kosmikus/darcs.eclass darcs.eclass] before you use them to emerge the packages. If you encounter any problems using the ebuilds, write them into the WikiForum or peek tom at [mailto:tom@0x539.de tom@0x539.de].
+Tom wrote ebuilds for net6, libobby and gobby that may be accessed [http://releases.0x539.de/ebuilds here]. To install them, set the ''PORTDIR_OVERLAY'' variable in your ''/etc/make.conf'' to the location where you would like to have them installed (normally ''/usr/local/portage''). Create two directories named ''net-libs'' and ''app-editors'' into that folder and another two directories called ''net6'' and ''obby'' in ''net-libs'' and one called ''gobby'' in ''app-editors''. Then move the ebuilds into the corresponding folders and type ''emerge gobby''. Gobby will be installed with [http://gtksourceview.sourceforge.net GtkSourceView] support if your USE variable contains ''gtksourceview''. If not and you want [http://gtksourceview.sourceforge.net GtkSourceView] nevertheless, type ''USE=gtksourceview emerge gobby''.
+
+If you prefer to live on the bleeding edge and you want to get the sources directly from the darcs repository, you can use the ebuilds you find in the ''contrib/''-sub-directory in the repositories. Install them as described above and move [http://dev.gentoo.org/~kosmikus/darcs.eclass darcs.eclass] to ''$PORTDIR_OVERLAY/eclass''. But note that these versions are pretty unstable and may not even compile!
 
 == Debian GNU/Linux ==