GNUstepWiki - User contributions [en]

User Guides

2013-06-03T12:54:47Z

Sdw:

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]].

* [http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto_toc.html GNUstep Installation] instructions or [[Installation | Simple Installation]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto.pdf PDF], [http://www.gnustep.org/resources/documentation/GNUstep-HOWTO-Italian.text Italian])
* 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]

== 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)]
* [[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
* 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

2013-06-03T03:26:12Z

Sdw:

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]].

* [http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto_toc.html GNUstep Installation] instructions or [[Installation | Simple Installation]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto.pdf PDF], [http://www.gnustep.org/resources/documentation/GNUstep-HOWTO-Italian.text Italian])
* 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]]

== 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)]
* [[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
* 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]

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T03:25:31Z

Sdw:

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T03:18:15Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch working on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo/Funtoo Linux and Kubuntu 13. Funtoo takes a while to setup, but c
And now with reference to Ivan's script, here are issues I found:-
* Kubuntu 13 doesn't seem to have an openssl-dev package so left it out.
* libobjc2 uses cmake now. I tried to "make" as per the script, and it failed. There were build i
* you can run "make check" at the end of the gnustep-base install to run the tests

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T03:15:31Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch working on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script [https://bitbucket.org/ivucica/gnustep-ubuntu GNUstep libobjc2 on Ubuntu.sh]- click on the "source" link to get the script.
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo/Funtoo Linux and Kubuntu 13. Funtoo takes a while to setup, but can be simpler for something like this because there is no other cruft around. So far as clang on Funtoo, there is a guide for this, and I chose to use clang for all the programs related to this project and gcc for everything else, i.e. I used clang for libobjc2, gnustep-*, libdispatch. Gentoo config files at the end of this post.
And now with reference to Ivan's script, here are issues I found:-
* Kubuntu 13 doesn't seem to have an openssl-dev package so left it out.
* libobjc2 uses cmake now. I tried to "make" as per the script, and it failed. I

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T03:02:08Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch working on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script [https://bitbucket.org/ivucica/gnustep-ubuntu GNUstep libobjc2 on Ubuntu.sh]for download.
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo/Funtoo Linux and Kubuntu 13. Funtoo takes a while to setup, but can be simpler for something like this because there is no other cruft around. Some Funtoo clang config files at the bottom.
And now with reference to Ivan's script, here are issues I found:-
* Kubuntu 13 doesn't seem to have an openssl-dev package so left it out.
*

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T02:51:42Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch working on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo Linux and Kubuntu 13. Gentoo takes a while to setup, but can be simpler for something like this because there is no other cruft around.
* A gentoo install note on clang: I chose to use clang for everyting related to GNUstep, and gcc for the rest of the system. See end of this article for the config files

------------------------------------
Gentoo configuration
<code>
$ cat /etc/portage/package.env
gnustep-base/libobjc2 clang
dev-libs/boehm-gc clang
dev-libs/libatomic_ops clang
dev-libs/nettle clang
gnustep-base/gnustep-make clang
dev-libs/libtasn1 clang
net-libs/gnutls clang
gnustep-base/gnustep-base clang
app-arch/libarchive clang
dev-util/cmake clang
dev-libs/compiler-rt clang
gnustep-base/gnustep-gui clang
gnustep-base/gnustep-back-cairo clang
virtual/gnustep-back clang
gnustep-apps/projectcenter clang

$ cat /etc/portage/env/clang
CC=clang
CXX=clang++
#CFLAGS="-march=core2 -O2 -pipe "
CFLAGS="-march=core2 -O2 -pipe -fblocks "
#CFLAGS="-march=core2 -O2 -pipe -pthread -fblocks"
</code>

�

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T02:40:34Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch working on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo Linux and Kubuntu 13. Gentoo takes a while to setup, but can be simpler for something like this because there is no other cruft around.

�

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T02:39:26Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
* libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
* libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
* GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
* libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, expert posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source we go.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo Linux and Kubuntu 13. Gentoo takes a while to setup, but can be simpler for something like this because there is no other cruft around.

�

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T02:37:15Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes down to the install instructions.
=== GNUstep runtime ===
* So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
** libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
** libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
** GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
** libdispatch currently has some build requirements that necessitate using clang.
So we're going with a clang build since a working GCD is the aim here.

Next, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides instead of compiling from scratch, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make a decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and I started having the "bad smell" feeling that goes with graunching two ABIs. In addition, posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source I went.

== libobjc2 and gnustep-base installation from source ==
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, you should remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo Linux and Kubuntu 13. Gentoo takes a while to setup, but can be simpler for something like this because there is no other cruft around.

�

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T02:29:02Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch on Linux.

First some background as the information on this is scattered around the web.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes and everything should just build.
=== GNUstep runtime ===
* So far as GNUstep, the runtime library for Objective C code used to be called libobjc until Apple released Objective C version 2, and then is called libobjc2. You can get the background here: http://wiki.gnustep.org/index.php/ObjC2_FAQ . (Note Debian and Ubuntu libobjc3 and libobjc4 are still based on libobjc and libobjc2 but numbered differently).
** libobjc2 built with GCC 4.6 and 4.7 has most of Objective C v2 supported, but doesn't have blocks support
** libobjc2 built with Clang does have block support: (use -fblocks flag when compiling your own code)
** GNUstep provides block support, whether the compiler does or not. So if using GNUstep, you can use blocks with a GCC libobjc2.
Now the aim of this exercise is to run GCD, and libdispatch has to be built with clang right now.
Having settled on a clang build, we observe that Debian wheezy and Ubuntu 13 have a libdispatch infrastructure built on clang (libobjc2 and libdispatch are built using clang). So there are some more decisions:-
Why not just run with what Debian provides, i.e.
* libobjc2, libdispatch, cblocksruntime compiled with erlang
* gnustep programs compiled with gcc
To make this decision, here is some background on GCD and blocks
* GCD: As far as I can make out, there are two implementations of GCD out there for Linux. One by [https://www.heily.com/trac/libdispatch/ Mark Heily] and one called [http://opensource.mlba-team.de/xdispatch/docs/current/index.html libxdispatch]. So far as using GCD with GNUstep, Mark's library is the one to use, and this is also the libdispatch library in Debian and Ubuntu.
* GCD is more than just a C library. It requires support from the kernel with light threads (libpthread), and an adptation of BSD signals for Linux (libkqueue).
* Blocks: Using blocks with GCD will often result in simpler and more elegant code, but blocks are not part of standard C. Mark provides a 'blocks' library called 'libblocksruntime', but even better, GNUstep has its own implementation of blocks. The two libarires are based on Apples blocks library and have the same API. However, what is not obvious is that the ABI of libblocksruntime is C, however the ABI of GNUstep is objective C. And mixing the two ABIs could lead to memory corruption under certain circumstances. ([https://github.com/nickhutchinson/libdispatch/issues/2 See xcvista's second comment].)
In fact, I did try to get libdispatch on Kubuntu 13. I found that the gcc package must be installed in order to get the objc.h header to compile against, and I had to put the location of objc.h in <GNUstep root>/Makefiles/config.make, as well as adding clang in there. Being new to GNUstep I had a couple of other issues, and it all started having a bad smell about the thing. In addition, posts to the gnustep-discuss newsgroup this year consistently recommended installing from source, so to the the source I went.

libobjc2 and gnustep-base installation
Ivan Vucica has a handy install script for download: https://bitbucket.org/ivucica/
* I recommend you have a fresh Debian or Ubuntu installation. If not, I recommend you remove all gnustep packages, libobjc* packages, libdispatch* packages, and libblocksruntime* packages.
* I ran installs on both Gentoo Linux and Kubuntu 13. Gentoo takes a while to setup, but can be simpler for something like this because there is no other cruft around.�

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T01:03:24Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch.

First some background as the information on this is scattered around the web.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. The library for Grand Central Dispatch is called libdispatch, and tasks can be submitted to GCD in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes and everything should just build.
* As far as I can make out, there are two implementations of GCD out there. One by [https://www.heily.com/trac/libdispatch/ Mark Heily]

Building GNUstep with Clang, Blocks, and Grand Central Dispatch

2013-06-03T01:02:06Z

Sdw:

This guide shows how to install GNUstep-base with clang, blocks and Grand Central Dispatch.

First some background as the information on this is scattered around the web.

[http://en.wikipedia.org/wiki/Grand_Central_Dispatch Grand Central Dispatch] is a library to assist building apps on multi-core processors. Tasks can be submitted in blocks or with a C API. To understand the process below, some notes are in order. If you're in a hurry, you can probably skip the notes and everything should just build.
* The library for Grand Central Dispatch is called libdispatch
* As far as I can make out, there are two implementations of GCD out there. One by [https://www.heily.com/trac/libdispatch/ Mark Heily]

User Guides

2013-06-03T00:36:21Z

Sdw:

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]].

* [http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto_toc.html GNUstep Installation] instructions or [[Installation | Simple Installation]] ([http://www.gnustep.org/resources/documentation/User/GNUstep/gnustep-howto.pdf PDF], [http://www.gnustep.org/resources/documentation/GNUstep-HOWTO-Italian.text Italian])
* 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]]
* [[Building GNUstep with Clang, Blocks, and Grand Central Dispatch]]

== 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)]
* [[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
* 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]