GNUstepWiki - User contributions [en]

User Guides

2016-05-29T07:28:38Z

Eosorio: /* Stores */

This page is intended as a collection of guides for users.

== Installing GNUstep ==

Installation can be easy or complex, depending on the system you use. If you encounter problems that aren't discussed here, please [[Get Help|ask for help on the mailing lists]].

* [[Installation | Simple Installation]]
* Make sure you also check the [[Platform_compatibility|platform-specific]] instructions as well.
* Comprehensive [http://gnustep.made-it.com/BuildGuide/ build guide] for GNUstep on GNU/Linux.
* [http://www.gnustep.org/resources/documentation/User/Gui/KeyboardSetup.html User Keyboard Setup]
* [http://www.gnustep.org/resources/documentation/User/Gui/LanguageSetup.html Setup for East Asian Languages]
* User Defaults ([http://www.gnustep.org/resources/documentation/User/Gui/DefaultsSummary.html GUI]) ([http://www.gnustep.org/resources/documentation/Developer/Back/General/DefaultsSummary.html Back])
* [[GNUstep SVN Installation Guide]]

* [http://svn.gna.org/svn/etoile/trunk/Etoile/INSTALL.Ubuntu GNUstep and Étoilé dependency list]
* [[Building GNUstep with Clang]]
* [http://artinamessage.wordpress.com/2013/06/03/gnustep-install-with-clang-blocks-and-grand-central-dispatch-gcd/ Building GNUstep with clang, blocks, and Grand Central Dispatch]
* [[Raspbian Install| Raspbian Install]]

== Using GNUstep ==

* [[:Category:Applications|User Applications]]
* [http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem_toc.html Filesystem Layout] ([http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem.pdf PDF])
* [[User_FAQ|GNUstep Users' FAQ]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/userfaq.pdf PDF])
* [[Get Help|Mailing Lists, IRC and Newsgroups]]
* [[Cross Compiling]]
* [http://gnustep.files.wordpress.com/2010/11/objective-c_gnustep.pdf Manual de Objective-C y GNUstep (PDF en español)]
* [[Themes|Changing GNUstep Theme]]

== Other Info ==

* News and info:
** [http://freecode.com/tags/objective-c Freshmeat] ->Freecode Effective 2014-06-18 Freecode is no longer being updated (content may be stale).
** [http://www.gnustep.wordpress.com/ GNUstep en español] - Noticias e información
* Projects:
** [[:Category:Desktop Environments|Desktop Environments]]
*** [http://www.nongnu.org/backbone/ Backbone] - GNUstep Desktop project
*** [http://www.etoile-project.org/ Étoilé] - GNUstep based user environment
*** [http://www.nongnu.org/gap/ GAP] - GNUstep Application Project
** Live CDs
*** [http://io.debian.net/~tar/gnustep/ GNUstep Live CD Project] - based on Debian
*** ALT Linux based (i586/x86_64, BIOS/UEFI, considerable number of GNUstep/Étoilé apps):
**** [http://en.altlinux.org/Starterkits/gnustep GNUstep starterkit] - updated quarterly (as of June 2014) using stable package branch
**** [http://en.altlinux.org/Regular#experimental Regular GNUstep] - updated [http://nightly.altlinux.org/sisyphus/flavours/gnustep/ weekly] using unstable development branch
* Developer sites:
** [[For_Developers | Developers]] - List of developers
** [http://www.gnustep.it/ GNUstep.it] - Italian developer site
** [http://www.advogato.org/proj/GNUstep/ Advogato] - basic GNUstep project info and links to some developer diaries
** [http://www.collaboration-world.com/ Collaboration World] - home to GNUMail, Affiche and more
** [http://www.roard.com/docs/ GNUstep HelpCenter]
** [http://freshmeat.net/projects/gnustep-icons/ GNUstep Icons project]
* [[Success_Stories | GNUstep Success Stories]]

== Stores ==

* [http://www.cafepress.com/openlogic "Openlogic" GNUstep store] - A portion of these proceeds go to the FSF and GNUstep.
* The GNUstep project does not sponsor or benefit from these items:
** [http://www.cafepress.com/gnustep "GNUstep" store]

User Guides

2016-05-29T07:22:37Z

Eosorio: /* Other Info */

User Guides

2016-01-07T01:00:42Z

Eosorio: /* Installing GNUstep */

This page is intended as a collection of guides for users.

== Installing GNUstep ==

Installation can be easy or complex, depending on the system you use. If you encounter problems that aren't discussed here, please [[Get Help|ask for help on the mailing lists]].

* [[Installation | Simple Installation]]
* Make sure you also check the [[Platform_compatibility|platform-specific]] instructions as well.
* Comprehensive [http://gnustep.made-it.com/BuildGuide/ build guide] for GNUstep on GNU/Linux.
* [http://www.gnustep.org/resources/documentation/User/Gui/KeyboardSetup.html User Keyboard Setup]
* [http://www.gnustep.org/resources/documentation/User/Gui/LanguageSetup.html Setup for East Asian Languages]
* User Defaults ([http://www.gnustep.org/resources/documentation/User/Gui/DefaultsSummary.html GUI]) ([http://www.gnustep.org/resources/documentation/Developer/Back/General/DefaultsSummary.html Back])
* [[GNUstep SVN Installation Guide]]

* [http://svn.gna.org/svn/etoile/trunk/Etoile/INSTALL.Ubuntu GNUstep and Étoilé dependency list]
* [[Building GNUstep with Clang]]
* [http://artinamessage.wordpress.com/2013/06/03/gnustep-install-with-clang-blocks-and-grand-central-dispatch-gcd/ Building GNUstep with clang, blocks, and Grand Central Dispatch]
* [[Raspbian Install| Raspbian Install]]

== Using GNUstep ==

* [[:Category:Applications|User Applications]]
* [http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem_toc.html Filesystem Layout] ([http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem.pdf PDF])
* [[User_FAQ|GNUstep Users' FAQ]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/userfaq.pdf PDF])
* [[Get Help|Mailing Lists, IRC and Newsgroups]]
* [[Cross Compiling]]
* [http://gnustep.files.wordpress.com/2010/11/objective-c_gnustep.pdf Manual de Objective-C y GNUstep (PDF en español)]
* [[Themes|Changing GNUstep Theme]]

== Other Info ==

* News and info:
** [http://freshmeat.net/browse/806/?topic_id=806 Freshmeat]
** [http://www.gnustep.wordpress.com/ GNUstep en español] - Noticias e información
* Projects:
** [[:Category:Desktop Environments|Desktop Environments]]
*** [http://www.nongnu.org/backbone/ Backbone] - GNUstep Desktop project
*** [http://www.etoile-project.org/ Étoilé] - GNUstep based user environment
*** [http://www.nongnu.org/gap/ GAP] - GNUstep Application Project
** Live CDs
*** [http://io.debian.net/~tar/gnustep/ GNUstep Live CD Project] - based on Debian
*** ALT Linux based (i586/x86_64, BIOS/UEFI, considerable number of GNUstep/Étoilé apps):
**** [http://en.altlinux.org/Starterkits/gnustep GNUstep starterkit] - updated quarterly (as of June 2014) using stable package branch
**** [http://en.altlinux.org/Regular#experimental Regular GNUstep] - updated [http://nightly.altlinux.org/sisyphus/flavours/gnustep/ weekly] using unstable development branch
* Developer sites:
** [[For_Developers | Developers]] - List of developers
** [http://www.gnustep.it/ GNUstep.it] - Italian developer site
** [http://www.advogato.org/proj/GNUstep/ Advogato] - basic GNUstep project info and links to some developer diaries
** [http://www.collaboration-world.com/ Collaboration World] - home to GNUMail, Affiche and more
** [http://www.roard.com/docs/ GNUstep HelpCenter]
** [http://freshmeat.net/projects/gnustep-icons/ GNUstep Icons project]
* [[Success_Stories | GNUstep Success Stories]]

== Stores ==

* [http://www.cafepress.com/openlogic "Openlogic" GNUstep store] - A portion of these proceeds go to the FSF and GNUstep.
* The GNUstep project does not sponsor or benefit from these items:
** [http://www.cafepress.com/gnustep "GNUstep" store]
** [http://www.cafepress.com/opengnustep "OPENGNUstep" store]

User Guides

2016-01-07T00:57:19Z

Eosorio: /* Installing GNUstep */

This page is intended as a collection of guides for users.

== Installing GNUstep ==

Installation can be easy or complex, depending on the system you use. If you encounter problems that aren't discussed here, please [[Get Help|ask for help on the mailing lists]].

* [[Installation | Simple Installation]]
* Make sure you also check the [[Platform_compatibility|platform-specific]] instructions as well.
* Comprehensive [http://gnustep.made-it.com/BuildGuide/ build guide] for GNUstep on GNU/Linux.
* [http://www.gnustep.org/resources/documentation/User/Gui/KeyboardSetup.html User Keyboard Setup]
* [http://www.gnustep.org/resources/documentation/User/Gui/LanguageSetup.html Setup for East Asian Languages]
* User Defaults ([http://www.gnustep.org/resources/documentation/User/Gui/DefaultsSummary.html GUI]) ([http://www.gnustep.org/resources/documentation/Developer/Back/General/DefaultsSummary.html Back])
* [[GNUstep SVN Installation Guide]]

* [http://svn.gna.org/svn/etoile/trunk/Etoile/INSTALL.Ubuntu GNUstep and Étoilé dependency list]
* [[Building GNUstep with Clang]]
* [http://artinamessage.wordpress.com/2013/06/03/gnustep-install-with-clang-blocks-and-grand-central-dispatch-gcd/ Building GNUstep with clang, blocks, and Grand Central Dispatch]
* [Raspbian]

== Using GNUstep ==

* [[:Category:Applications|User Applications]]
* [http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem_toc.html Filesystem Layout] ([http://www.gnustep.org/resources/documentation/User/GNUstep/filesystem.pdf PDF])
* [[User_FAQ|GNUstep Users' FAQ]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/userfaq.pdf PDF])
* [[Get Help|Mailing Lists, IRC and Newsgroups]]
* [[Cross Compiling]]
* [http://gnustep.files.wordpress.com/2010/11/objective-c_gnustep.pdf Manual de Objective-C y GNUstep (PDF en español)]
* [[Themes|Changing GNUstep Theme]]

== Other Info ==

* News and info:
** [http://freshmeat.net/browse/806/?topic_id=806 Freshmeat]
** [http://www.gnustep.wordpress.com/ GNUstep en español] - Noticias e información
* Projects:
** [[:Category:Desktop Environments|Desktop Environments]]
*** [http://www.nongnu.org/backbone/ Backbone] - GNUstep Desktop project
*** [http://www.etoile-project.org/ Étoilé] - GNUstep based user environment
*** [http://www.nongnu.org/gap/ GAP] - GNUstep Application Project
** Live CDs
*** [http://io.debian.net/~tar/gnustep/ GNUstep Live CD Project] - based on Debian
*** ALT Linux based (i586/x86_64, BIOS/UEFI, considerable number of GNUstep/Étoilé apps):
**** [http://en.altlinux.org/Starterkits/gnustep GNUstep starterkit] - updated quarterly (as of June 2014) using stable package branch
**** [http://en.altlinux.org/Regular#experimental Regular GNUstep] - updated [http://nightly.altlinux.org/sisyphus/flavours/gnustep/ weekly] using unstable development branch
* Developer sites:
** [[For_Developers | Developers]] - List of developers
** [http://www.gnustep.it/ GNUstep.it] - Italian developer site
** [http://www.advogato.org/proj/GNUstep/ Advogato] - basic GNUstep project info and links to some developer diaries
** [http://www.collaboration-world.com/ Collaboration World] - home to GNUMail, Affiche and more
** [http://www.roard.com/docs/ GNUstep HelpCenter]
** [http://freshmeat.net/projects/gnustep-icons/ GNUstep Icons project]
* [[Success_Stories | GNUstep Success Stories]]

== Stores ==

* [http://www.cafepress.com/openlogic "Openlogic" GNUstep store] - A portion of these proceeds go to the FSF and GNUstep.
* The GNUstep project does not sponsor or benefit from these items:
** [http://www.cafepress.com/gnustep "GNUstep" store]
** [http://www.cafepress.com/opengnustep "OPENGNUstep" store]

Gemas.app

2015-02-05T09:40:06Z

Eosorio: added to categoy editor

{{Application|
shortdescription = A simple code editor for GNUstepers |
currentversion = [http://download.gna.org/gnustep-nonfsf/Gemas-0.4.tar.gz 0.4]|
releasedate = Feb 8, 2014 |
license = GPLv3 |
overview = [[Image:GemasWM.jpg|Gemas.app running on WindowMaker|230px]]
[[Image:Gemas.jpg|Gemas.app running on Gnome|230px]]
[[Image:GemasWindows.jpg|Gemas.app running on Windows 7|230px]]

This is a simple code editor with highlight syntax and auto indentation. Gemas depends on [[HighlighterKit]] framework of Saso Kiselkov. On Windows, when you launch Gemas, it open a new document for Objective-C. If you want other type of document, create the appropriate new document from menu. This is because currently you can't change the highlight syntax once you open a document. There are also a couple of themes for the syntax highlighter: [http://download.gna.org/gnustep-nonfsf/HKThemes-1.1.tar.gz HKThemes 1.1]|
features =
* Highlight syntax for languages C, C++, Obj-C, Obj-C++, GSmarkup.
* Highlight syntax to edit Strings, Plist, GNUmakefile, ChangeLog files and Plain text.
* Auto indentation.
* Autocomplete.
* Double click above a parentheses to select all code inside these.
* Emacs compatibility (this means that you can see correctly the indentation of a file you wrote on Emacs).
* Go to Line Panel.
* Preferences Panel to change colors, editor size, font, Highlighter theme, ...
* Menu options ''App'' and ''Tool'' to create a simple App or Tool |
maintainer = [mailto:germanandre@gmx.es Germán A. Arias] |
relatedlinks = [http://www.gnustep.org/softwareindex/showdetail.php?app=123 Gemas at Software Index]
[http://home.gna.org/gnustep-nonfsf/gemas.html Official Website]|
category = [[Category: Development Applications]][[Category:Editor Applications]]
}}

Platform:BSD

2015-01-30T23:29:51Z

Eosorio: /* PicoBSD */

{{stub}}

= Darwin =

=== Intel ===
Currently tested on Darwin 7.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)

Default compiler (Apple GCC) has unknown problems. Download the FSF GCC compiler (mirrors at http://gcc.gnu.org/mirrors.html) and configure it with -enable-threads=posix. You don't need binutils or anything else. Use the GNU runtime. Make sure to add

export CC=/usr/local/bin/gcc (use the correct path to FSF gcc)

so that the correct compiler is found

'''Extra libs needed'''
 Use libffi from http://sourceware.org/libffi/ or the older ffcall if this does not work for some reason.

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

=== PowerPC ===
This section is for building the complete GNUstep system. This system will not interact at all with Mac OS X/Cocoa. It uses different complilers, different display systems, etc. For building GNUstep extensions to be used with Mac OS X (for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail), see the MacOSX/PowerPC section.

Currently tested on Darwin 6.x, 7.x, 8.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)
 Apple GCC with Xcode 2.5.

'''Extra libs needed'''
 Use libffi (not ffcall). This should be enabled by default in gnustep-base so you don't have to type --enable-libffi. For 6.x, you need the dlcompat library (from www.opendarwin.org) to load bundles (not needed for 7.x).

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

See also the [[Platform:BSD#Mac_OS_X|Mac OSX / PowerPC]] section

= FreeBSD-based systems =

== DesktopBSD ==
[http://www.desktopbsd.net/ DesktopBSD] joins the ranks of [[#PC-BSD|PC-BSD]] and [[#FreeSBIE|FreeSBIE]] as a desktop-ready version of [[#FreeBSD|FreeBSD]]. However, their desktop is based on [http://www.kde.org KDE].

== DragonFly ==
[http://www.dragonflybsd.org DragonFly] is an operating system and environment designed to be the logical continuation of the [[#FreeBSD|FreeBSD]]-4.x OS series.

I have mostly ported GNUstep to DragonFly, I just need to submit patches now for both GNUstep and DragonFly. To know more, you can contact me. ''[[user:Qmathe | Quentin Mathé]]''

== FreeBSD ==
You can install GNUstep using the ''[http://www.freebsd.org/cgi/url.cgi?ports/devel/gnustep/pkg-descr /usr/ports/devel/gnustep/]'' meta port. To automatically install GNUstep '''and''' (literally) tons of GNUstep-related applications, take a look at the ''[http://www.freebsd.org/cgi/url.cgi?ports/x11/gnustep-app/pkg-descr /usr/ports/x11/gnustep-app/]'' meta port.

These ports should now install all dependencies -- a complete list can [[Dependencies|be found here]].

'''Note'''
: Prior to FreeBSD-6.0, there is a bug in ''kvm(3)'' that '''requires''' a mounted ''/proc'' for GNUstep to work properly. Until this bug is fixed, make sure you have an entry for ''/proc'' in your ''/etc/fstab'':

proc /proc procfs rw 0 0

References:
[http://www.freebsd.org/cgi/ports.cgi?query=gnustep&stype=all FreeBSD GNUstep ports],
[http://www.freshports.org/search.php?stype=longdescription&method=match&query=gnustep&num=10&orderby=category&orderbyupdown=asc&search=Search Freshports GNUstep]

== FreeBSD-Kernel w/ GNU userland, and GNU C library ==
It was reported that this runs GNUstep as well. For more details see the topic of
the IRC channel #gnu-kbsd on irc.gnu.org

== FreeSBIE ==
[http://www.freesbie.org/ FreeSBIE] is a Live-CD Version of FreeBSD.

== MidnightBSD ==
[http://www.midnightbsd.org/ MidnightBSD] is based on FreeBSD 6.1 pre-release. The goal of the project is to create a BSD with ease of use and simplicity in mind.

The most intriguing thing about MidnightBSD is their integration of GNUstep into the system.

== PicoBSD ==
[http://people.freebsd.org/~picobsd/old/picobsd.html PicoBSD] is a one floppy version of [[#FreeBSD|FreeBSD]] 3.0-current. You won't be able to use it as a platform for GNUstep.

== PC-BSD ==
[http://www.pcbsd.org/ PC-BSD] has as its goals to be an easy to install and use desktop OS, which is built on the [[#FreeBSD|FreeBSD]] operating system.

= Mac OS X =

=== Full Install ===

GNUstep *does* work on OS X 10.4 and later, too, but it will not work out of the box with the dependencies built from MacPorts (and I guess from fink either). The problem is not the Apple linker per se, but rather that many of our dependencies nowadays depend directly or indirectly on CoreFoundation on OS X and, unfortunately, CoreFoundation started to depend on Apple's libobjc in 10.4.

To successfully build and run GNUstep on Mac OS X 10.4 and later, you need (at least) to configure aspell with --disable-nls (the nonls variant of aspell should do for MacPorts). Next, you need a freetype configured with --without-old-mac-fonts (unfortunately no help from MacPorts here and the freetype shipped with Mac OS X 10.5 will not work either). Apart from that, configure GNUstep-base with --disable-tls and GNUstep-back with --disable-glx and use either the libart (the default) or xlib backend. Eventually, I may have forgotten some other libraries in this list, but you will notice that when looking at the crash report being produced in ~/Library/Logs/CrashReporter. Look for a line containing /usr/lib/libobjc.A.dylib.

See [https://github.com/ericwa/gnustep-macports-fixes Macport Patches] for patches to Macports that might also work

=== Extensions Install ===
This section is for building the GNUstep extensions only. Use this if, for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail. If you want to build the complete GNUstep system independant of Mac OS X, see the Full Install section above or Darwin/PowerPC section.

Currently tested on MacOSX 10.1.5, 10.2, 10.3

'''Recommended compiler'''
 Default. For 10.1.5, you need to add -no-cpp-precomp to CFLAGS (For instance, ./configure CFLAGS="-no-cpp-precomp" ...)

'''Extra libs needed'''
 None.

'''Special Instructions'''
 Warning ! To know how to install a complete GNUstep system on Mac OS X, read the Darwin/PowerPC section. By default, on Mac OS X, only the GNUstep extensions are built. Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

To build the GNUstep extensions only is useful, when you want to build on Mac OS X, GNUstep related projects like gdl2, etc linked to Cocoa. Xcode project files exist, but they may not be up-to-date. Make sure /usr/sbin is in your path:

PATH=$PATH:/usr/sbin

Then type:

cd make
./configure --with-library-combo=apple-apple-apple
make install
. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
cd ../base
./configure --with-xml-prefix=/usr --disable-xmltest
make debug=yes install

On Mac OS X 10.1.5, there is no libxml. Either install libxml2 or configure base with --disable-xml.

See also the [[Platform:BSD#Darwin|Darwin / PowerPC]] section.

= NetBSD =
Installing GNUstep from pkgsrc is really straight-forward for NetBSD if you're using a recent pkgsrc distribution. NetBSD/i386 has no known problems right now, however there are reports of crashout problems for gdomap on NetBSD/sparc which may be related to ffi/ffcall issues.

In terms of pre-requisites, ensure you've got a working X11 environment on your system and preferrably are using WindowMaker as your window manager.

'''Build instructions'''

To install GNUstep, you need to cd to your pkgsrc tree and then cd to the right package directory, on my system:

cd /usr/pkgsrc

then go to the package you wish to install, for example:

cd meta-pkgs/gnustep

and issue the command:

make install

This command will download source code and whatever dependencies and compile and install them. The version of the meta-packages I used (released with NetBSD 2.0 and called gnustep-1.10.0nb2) installs the following GNUstep components as parts of the meta-package:

* gnustep-make-1.10.0
* gnustep-base-1.10.1
* gnustep-ssl-1.10.1
* gnustep-gui-0.9.4
* gnustep-back-0.9.4
* gnustep-examples-1.0.0
* ImageViewer-0.6.3
* Pantomime-1.1.2
* Addresses-0.4.6
* GNUMail-1.1.2
* Gorm-0.8.0
* ProjectCenter-0.4.0
* GWLib-0.6.5
* Renaissance-0.8.0
* gworkspace-0.6.5

A number of dependency packages are also installed.

This may be overkill - if you don't need all the applications etc, you can install the packages individually.

= OpenBSD =

Since many years, GNUstep is available in the OpenBSD ports tree. Packages are available for amd64, i386, and powerpc.
The packages are based on the latest releases. Since some time, using libobjc2, but compiled with the system gcc.
For easy installation, a meta package is provided.

sudo pkg_add -i gnustep-desktop

Above command will install the meta package, and all the packages from the [http://www.openbsd.org/cgi-bin/cvsweb/ports/x11/gnustep/ x11/gnustep] part of the ports tree.

[[Category:Development]]

Platform:BSD

2015-01-30T23:24:44Z

Eosorio: /* DesktopBSD */

{{stub}}

= Darwin =

=== Intel ===
Currently tested on Darwin 7.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)

Default compiler (Apple GCC) has unknown problems. Download the FSF GCC compiler (mirrors at http://gcc.gnu.org/mirrors.html) and configure it with -enable-threads=posix. You don't need binutils or anything else. Use the GNU runtime. Make sure to add

export CC=/usr/local/bin/gcc (use the correct path to FSF gcc)

so that the correct compiler is found

'''Extra libs needed'''
 Use libffi from http://sourceware.org/libffi/ or the older ffcall if this does not work for some reason.

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

=== PowerPC ===
This section is for building the complete GNUstep system. This system will not interact at all with Mac OS X/Cocoa. It uses different complilers, different display systems, etc. For building GNUstep extensions to be used with Mac OS X (for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail), see the MacOSX/PowerPC section.

Currently tested on Darwin 6.x, 7.x, 8.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)
 Apple GCC with Xcode 2.5.

'''Extra libs needed'''
 Use libffi (not ffcall). This should be enabled by default in gnustep-base so you don't have to type --enable-libffi. For 6.x, you need the dlcompat library (from www.opendarwin.org) to load bundles (not needed for 7.x).

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

See also the [[Platform:BSD#Mac_OS_X|Mac OSX / PowerPC]] section

= FreeBSD-based systems =

== DesktopBSD ==
[http://www.desktopbsd.net/ DesktopBSD] joins the ranks of [[#PC-BSD|PC-BSD]] and [[#FreeSBIE|FreeSBIE]] as a desktop-ready version of [[#FreeBSD|FreeBSD]]. However, their desktop is based on [http://www.kde.org KDE].

== DragonFly ==
[http://www.dragonflybsd.org DragonFly] is an operating system and environment designed to be the logical continuation of the [[#FreeBSD|FreeBSD]]-4.x OS series.

I have mostly ported GNUstep to DragonFly, I just need to submit patches now for both GNUstep and DragonFly. To know more, you can contact me. ''[[user:Qmathe | Quentin Mathé]]''

== FreeBSD ==
You can install GNUstep using the ''[http://www.freebsd.org/cgi/url.cgi?ports/devel/gnustep/pkg-descr /usr/ports/devel/gnustep/]'' meta port. To automatically install GNUstep '''and''' (literally) tons of GNUstep-related applications, take a look at the ''[http://www.freebsd.org/cgi/url.cgi?ports/x11/gnustep-app/pkg-descr /usr/ports/x11/gnustep-app/]'' meta port.

These ports should now install all dependencies -- a complete list can [[Dependencies|be found here]].

'''Note'''
: Prior to FreeBSD-6.0, there is a bug in ''kvm(3)'' that '''requires''' a mounted ''/proc'' for GNUstep to work properly. Until this bug is fixed, make sure you have an entry for ''/proc'' in your ''/etc/fstab'':

proc /proc procfs rw 0 0

References:
[http://www.freebsd.org/cgi/ports.cgi?query=gnustep&stype=all FreeBSD GNUstep ports],
[http://www.freshports.org/search.php?stype=longdescription&method=match&query=gnustep&num=10&orderby=category&orderbyupdown=asc&search=Search Freshports GNUstep]

== FreeBSD-Kernel w/ GNU userland, and GNU C library ==
It was reported that this runs GNUstep as well. For more details see the topic of
the IRC channel #gnu-kbsd on irc.gnu.org

== FreeSBIE ==
[http://www.freesbie.org/ FreeSBIE] is a Live-CD Version of FreeBSD.

== MidnightBSD ==
[http://www.midnightbsd.org/ MidnightBSD] is based on FreeBSD 6.1 pre-release. The goal of the project is to create a BSD with ease of use and simplicity in mind.

The most intriguing thing about MidnightBSD is their integration of GNUstep into the system.

== PicoBSD ==
[http://people.freebsd.org/~picobsd/picobsd.html PicoBSD] is a one floppy version of [[#FreeBSD|FreeBSD]] 3.0-current. You won't be able to use it as a platform for GNUstep.

== PC-BSD ==
[http://www.pcbsd.org/ PC-BSD] has as its goals to be an easy to install and use desktop OS, which is built on the [[#FreeBSD|FreeBSD]] operating system.

= Mac OS X =

=== Full Install ===

GNUstep *does* work on OS X 10.4 and later, too, but it will not work out of the box with the dependencies built from MacPorts (and I guess from fink either). The problem is not the Apple linker per se, but rather that many of our dependencies nowadays depend directly or indirectly on CoreFoundation on OS X and, unfortunately, CoreFoundation started to depend on Apple's libobjc in 10.4.

To successfully build and run GNUstep on Mac OS X 10.4 and later, you need (at least) to configure aspell with --disable-nls (the nonls variant of aspell should do for MacPorts). Next, you need a freetype configured with --without-old-mac-fonts (unfortunately no help from MacPorts here and the freetype shipped with Mac OS X 10.5 will not work either). Apart from that, configure GNUstep-base with --disable-tls and GNUstep-back with --disable-glx and use either the libart (the default) or xlib backend. Eventually, I may have forgotten some other libraries in this list, but you will notice that when looking at the crash report being produced in ~/Library/Logs/CrashReporter. Look for a line containing /usr/lib/libobjc.A.dylib.

See [https://github.com/ericwa/gnustep-macports-fixes Macport Patches] for patches to Macports that might also work

=== Extensions Install ===
This section is for building the GNUstep extensions only. Use this if, for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail. If you want to build the complete GNUstep system independant of Mac OS X, see the Full Install section above or Darwin/PowerPC section.

Currently tested on MacOSX 10.1.5, 10.2, 10.3

'''Recommended compiler'''
 Default. For 10.1.5, you need to add -no-cpp-precomp to CFLAGS (For instance, ./configure CFLAGS="-no-cpp-precomp" ...)

'''Extra libs needed'''
 None.

'''Special Instructions'''
 Warning ! To know how to install a complete GNUstep system on Mac OS X, read the Darwin/PowerPC section. By default, on Mac OS X, only the GNUstep extensions are built. Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

To build the GNUstep extensions only is useful, when you want to build on Mac OS X, GNUstep related projects like gdl2, etc linked to Cocoa. Xcode project files exist, but they may not be up-to-date. Make sure /usr/sbin is in your path:

PATH=$PATH:/usr/sbin

Then type:

cd make
./configure --with-library-combo=apple-apple-apple
make install
. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
cd ../base
./configure --with-xml-prefix=/usr --disable-xmltest
make debug=yes install

On Mac OS X 10.1.5, there is no libxml. Either install libxml2 or configure base with --disable-xml.

See also the [[Platform:BSD#Darwin|Darwin / PowerPC]] section.

= NetBSD =
Installing GNUstep from pkgsrc is really straight-forward for NetBSD if you're using a recent pkgsrc distribution. NetBSD/i386 has no known problems right now, however there are reports of crashout problems for gdomap on NetBSD/sparc which may be related to ffi/ffcall issues.

In terms of pre-requisites, ensure you've got a working X11 environment on your system and preferrably are using WindowMaker as your window manager.

'''Build instructions'''

To install GNUstep, you need to cd to your pkgsrc tree and then cd to the right package directory, on my system:

cd /usr/pkgsrc

then go to the package you wish to install, for example:

cd meta-pkgs/gnustep

and issue the command:

make install

This command will download source code and whatever dependencies and compile and install them. The version of the meta-packages I used (released with NetBSD 2.0 and called gnustep-1.10.0nb2) installs the following GNUstep components as parts of the meta-package:

* gnustep-make-1.10.0
* gnustep-base-1.10.1
* gnustep-ssl-1.10.1
* gnustep-gui-0.9.4
* gnustep-back-0.9.4
* gnustep-examples-1.0.0
* ImageViewer-0.6.3
* Pantomime-1.1.2
* Addresses-0.4.6
* GNUMail-1.1.2
* Gorm-0.8.0
* ProjectCenter-0.4.0
* GWLib-0.6.5
* Renaissance-0.8.0
* gworkspace-0.6.5

A number of dependency packages are also installed.

This may be overkill - if you don't need all the applications etc, you can install the packages individually.

= OpenBSD =

Since many years, GNUstep is available in the OpenBSD ports tree. Packages are available for amd64, i386, and powerpc.
The packages are based on the latest releases. Since some time, using libobjc2, but compiled with the system gcc.
For easy installation, a meta package is provided.

sudo pkg_add -i gnustep-desktop

Above command will install the meta package, and all the packages from the [http://www.openbsd.org/cgi-bin/cvsweb/ports/x11/gnustep/ x11/gnustep] part of the ports tree.

[[Category:Development]]

Platform:BSD

2015-01-30T23:10:57Z

Eosorio: /* DragonFly */

{{stub}}

= Darwin =

=== Intel ===
Currently tested on Darwin 7.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)

Default compiler (Apple GCC) has unknown problems. Download the FSF GCC compiler (mirrors at http://gcc.gnu.org/mirrors.html) and configure it with -enable-threads=posix. You don't need binutils or anything else. Use the GNU runtime. Make sure to add

export CC=/usr/local/bin/gcc (use the correct path to FSF gcc)

so that the correct compiler is found

'''Extra libs needed'''
 Use libffi from http://sourceware.org/libffi/ or the older ffcall if this does not work for some reason.

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

=== PowerPC ===
This section is for building the complete GNUstep system. This system will not interact at all with Mac OS X/Cocoa. It uses different complilers, different display systems, etc. For building GNUstep extensions to be used with Mac OS X (for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail), see the MacOSX/PowerPC section.

Currently tested on Darwin 6.x, 7.x, 8.x

'''Recommended compiler'''
 gcc 3.3.2 or greater 3.3.* versions. Older versions will not compile on Darwin and 3.4.* versions don't support GNU runtime compilation on Darwin currently (The GCC bug report is http://gcc.gnu.org/bugzilla/show_bug.cgi?id=11572).
 gcc 4.0.3 or greater 4.* versions (the bug mentioned above has been fixed for 4.0.3 and newer)
 Apple GCC with Xcode 2.5.

'''Extra libs needed'''
 Use libffi (not ffcall). This should be enabled by default in gnustep-base so you don't have to type --enable-libffi. For 6.x, you need the dlcompat library (from www.opendarwin.org) to load bundles (not needed for 7.x).

'''Special Instructions'''
 Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

See also the [[Platform:BSD#Mac_OS_X|Mac OSX / PowerPC]] section

= FreeBSD-based systems =

== DesktopBSD ==
[http://desktopbsd.sourceforge.net/ DesktopBSD] joins the ranks of [[#PC-BSD|PC-BSD]] and [[#FreeSBIE|FreeSBIE]] as a desktop-ready version of [[#FreeBSD|FreeBSD]]. However, their desktop is based on [http://www.kde.org KDE].

== DragonFly ==
[http://www.dragonflybsd.org DragonFly] is an operating system and environment designed to be the logical continuation of the [[#FreeBSD|FreeBSD]]-4.x OS series.

I have mostly ported GNUstep to DragonFly, I just need to submit patches now for both GNUstep and DragonFly. To know more, you can contact me. ''[[user:Qmathe | Quentin Mathé]]''

== FreeBSD ==
You can install GNUstep using the ''[http://www.freebsd.org/cgi/url.cgi?ports/devel/gnustep/pkg-descr /usr/ports/devel/gnustep/]'' meta port. To automatically install GNUstep '''and''' (literally) tons of GNUstep-related applications, take a look at the ''[http://www.freebsd.org/cgi/url.cgi?ports/x11/gnustep-app/pkg-descr /usr/ports/x11/gnustep-app/]'' meta port.

These ports should now install all dependencies -- a complete list can [[Dependencies|be found here]].

'''Note'''
: Prior to FreeBSD-6.0, there is a bug in ''kvm(3)'' that '''requires''' a mounted ''/proc'' for GNUstep to work properly. Until this bug is fixed, make sure you have an entry for ''/proc'' in your ''/etc/fstab'':

proc /proc procfs rw 0 0

References:
[http://www.freebsd.org/cgi/ports.cgi?query=gnustep&stype=all FreeBSD GNUstep ports],
[http://www.freshports.org/search.php?stype=longdescription&method=match&query=gnustep&num=10&orderby=category&orderbyupdown=asc&search=Search Freshports GNUstep]

== FreeBSD-Kernel w/ GNU userland, and GNU C library ==
It was reported that this runs GNUstep as well. For more details see the topic of
the IRC channel #gnu-kbsd on irc.gnu.org

== FreeSBIE ==
[http://www.freesbie.org/ FreeSBIE] is a Live-CD Version of FreeBSD.

== MidnightBSD ==
[http://www.midnightbsd.org/ MidnightBSD] is based on FreeBSD 6.1 pre-release. The goal of the project is to create a BSD with ease of use and simplicity in mind.

The most intriguing thing about MidnightBSD is their integration of GNUstep into the system.

== PicoBSD ==
[http://people.freebsd.org/~picobsd/picobsd.html PicoBSD] is a one floppy version of [[#FreeBSD|FreeBSD]] 3.0-current. You won't be able to use it as a platform for GNUstep.

== PC-BSD ==
[http://www.pcbsd.org/ PC-BSD] has as its goals to be an easy to install and use desktop OS, which is built on the [[#FreeBSD|FreeBSD]] operating system.

= Mac OS X =

=== Full Install ===

GNUstep *does* work on OS X 10.4 and later, too, but it will not work out of the box with the dependencies built from MacPorts (and I guess from fink either). The problem is not the Apple linker per se, but rather that many of our dependencies nowadays depend directly or indirectly on CoreFoundation on OS X and, unfortunately, CoreFoundation started to depend on Apple's libobjc in 10.4.

To successfully build and run GNUstep on Mac OS X 10.4 and later, you need (at least) to configure aspell with --disable-nls (the nonls variant of aspell should do for MacPorts). Next, you need a freetype configured with --without-old-mac-fonts (unfortunately no help from MacPorts here and the freetype shipped with Mac OS X 10.5 will not work either). Apart from that, configure GNUstep-base with --disable-tls and GNUstep-back with --disable-glx and use either the libart (the default) or xlib backend. Eventually, I may have forgotten some other libraries in this list, but you will notice that when looking at the crash report being produced in ~/Library/Logs/CrashReporter. Look for a line containing /usr/lib/libobjc.A.dylib.

See [https://github.com/ericwa/gnustep-macports-fixes Macport Patches] for patches to Macports that might also work

=== Extensions Install ===
This section is for building the GNUstep extensions only. Use this if, for instance, if you want to build something based on GNUstep, such as GSWeb or GNUMail. If you want to build the complete GNUstep system independant of Mac OS X, see the Full Install section above or Darwin/PowerPC section.

Currently tested on MacOSX 10.1.5, 10.2, 10.3

'''Recommended compiler'''
 Default. For 10.1.5, you need to add -no-cpp-precomp to CFLAGS (For instance, ./configure CFLAGS="-no-cpp-precomp" ...)

'''Extra libs needed'''
 None.

'''Special Instructions'''
 Warning ! To know how to install a complete GNUstep system on Mac OS X, read the Darwin/PowerPC section. By default, on Mac OS X, only the GNUstep extensions are built. Read the README.Darwin file in the gnustep-make/Documentation directory for complete instructions.

To build the GNUstep extensions only is useful, when you want to build on Mac OS X, GNUstep related projects like gdl2, etc linked to Cocoa. Xcode project files exist, but they may not be up-to-date. Make sure /usr/sbin is in your path:

PATH=$PATH:/usr/sbin

Then type:

cd make
./configure --with-library-combo=apple-apple-apple
make install
. /usr/GNUstep/System/Library/Makefiles/GNUstep.sh
cd ../base
./configure --with-xml-prefix=/usr --disable-xmltest
make debug=yes install

On Mac OS X 10.1.5, there is no libxml. Either install libxml2 or configure base with --disable-xml.

See also the [[Platform:BSD#Darwin|Darwin / PowerPC]] section.

= NetBSD =
Installing GNUstep from pkgsrc is really straight-forward for NetBSD if you're using a recent pkgsrc distribution. NetBSD/i386 has no known problems right now, however there are reports of crashout problems for gdomap on NetBSD/sparc which may be related to ffi/ffcall issues.

In terms of pre-requisites, ensure you've got a working X11 environment on your system and preferrably are using WindowMaker as your window manager.

'''Build instructions'''

To install GNUstep, you need to cd to your pkgsrc tree and then cd to the right package directory, on my system:

cd /usr/pkgsrc

then go to the package you wish to install, for example:

cd meta-pkgs/gnustep

and issue the command:

make install

This command will download source code and whatever dependencies and compile and install them. The version of the meta-packages I used (released with NetBSD 2.0 and called gnustep-1.10.0nb2) installs the following GNUstep components as parts of the meta-package:

* gnustep-make-1.10.0
* gnustep-base-1.10.1
* gnustep-ssl-1.10.1
* gnustep-gui-0.9.4
* gnustep-back-0.9.4
* gnustep-examples-1.0.0
* ImageViewer-0.6.3
* Pantomime-1.1.2
* Addresses-0.4.6
* GNUMail-1.1.2
* Gorm-0.8.0
* ProjectCenter-0.4.0
* GWLib-0.6.5
* Renaissance-0.8.0
* gworkspace-0.6.5

A number of dependency packages are also installed.

This may be overkill - if you don't need all the applications etc, you can install the packages individually.

= OpenBSD =

Since many years, GNUstep is available in the OpenBSD ports tree. Packages are available for amd64, i386, and powerpc.
The packages are based on the latest releases. Since some time, using libobjc2, but compiled with the system gcc.
For easy installation, a meta package is provided.

sudo pkg_add -i gnustep-desktop

Above command will install the meta package, and all the packages from the [http://www.openbsd.org/cgi-bin/cvsweb/ports/x11/gnustep/ x11/gnustep] part of the ports tree.

[[Category:Development]]