GNUstepWiki - User contributions [en]

Platform:BSD

2007-06-05T22:56:15Z

Theraven: /* OpenBSD */

{{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).

Default compiler (Apple GCC) has unknown problems. Download the FSF GCC compiler 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 ffcall because libffi hasn't been ported to Darwin x86.

'''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

'''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).

Default compiler (Apple GCC) has unknown problems. Download the FSF GCC compiler 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 (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/main/ 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 ==
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 =

=== Intel ===
''To be provided''

=== Power PC ===
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 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 =
Please take a look at http://mail.rochester.edu/~asveikau/gnustep-openbsd/

As of May 2007, GNUstep is in the OpenBSD ports tree. If you are running a snapshot of the base system from after this date, you can grab the latest version of the ports tree and build it from /usr/ports/x11/gnustep. This includes the core GNUstep components and some others, such as Gorm.

The port will not work with OpenBSD 4.1 (release or -STABLE) due to changes in the ports system.

Binary packages should be available for OpenBSD 4.2 and later.

[[Category:Development]]

Text System Project

2007-04-13T14:44:44Z

Theraven: /* Deliverables */

== People ==

Student: Christopher Elsmore

Mentor: David Chisnall

== Overview ==

This project aims to create an updated and profiled text system, with better Cocoa-compatibility and maintainability, and to implement missing NSCell subclasses from AppKit.

== Deliverables ==

* Implementations of:
** NSDatePicker
** NSLevelIndicator
** Accompanying NSCell subclasses.
* A cleaned, profiled and improved Text System.

== Milestones ==

{To be agreed}

== Progress ==

None (project not officially started)

Summer Of Code Ideas

2007-04-13T14:44:00Z

Theraven: Moved text from original SoC07 page.

These are the ideas that were proposed as projects. This section is maintained for historical interest, and to aid planning for the Summer of Code 2008 (if it happens again). If you have a project that would be interesting for next year, feel free to add it here.

=== Bindings, KVO support ===
* We need NSController, NSArrayController, NSObjectController, NSTreeController, NSUserDefaultController, NSValueTransformer implementations. NSSortDescriptor has already been implemented by Saso Kiselkov. The current NSTreeController is known to be a bit buggy and have an API a bit flawed, as Apple rushed the release of this class in Mac OS 10.4. It is widely believed that these shortcomings will be fixed in Leopard (10.5), so perhaps we should wait a while.
* Key Value Observing implementation was written by Richard Frith-Macdonald, and is only about 80% finished. Needs completion and testing.

=== Porting ===
* Port [http://developer.apple.com/opensource/internet/webkit.html WebKit] (using GCC 4.x with ObjC++ support). There's been discussion of a bounty for this, [http://www.nabble.com/WebKit-Bounty-tf3331066.html#a9262324 see the mailing list]. The WebKit team is willing to help whoever wants to take on this project, please see [http://lists.gnu.org/archive/html/discuss-gnustep/2007-03/msg00290.html this email].
* Port the [[Platform:Other|mySTEP]] changes. [http://www.nabble.com/Call-for-volunteers%3A-Backporting-mySTEP-changes-tf3370983.html Some have already volunteered], but as this is a big project, more help is welcome.

=== General Improvements ===
* Printing Support (better postcript generation, etc. see [https://savannah.gnu.org/bugs/?16262 bug #16262])
* MS Windows support (better integration in the MS Windows look and feel, especially the in-window-menu support needs work)
* [[GNUstepWeb]] (add script language support, etc)
* Finish input server [http://svn.gna.org/viewcvs/gnustep/libs/gui/branches/kazunobu_input_management/ support]
* Compare current API with Tiger's API, indicate which classes are missing, and summarize the current status of the existing ones, then work to complete them... ;) The best would be to have a tool which parses all headers (both from Cocoa and GNUstep) and outputs differences in HTML (XML probably too by the way). This would summarize missing classes, missing or partially implemented methods in existing classes and GNUstep-specific extensions. Eventually we should include links to the related documentation on both GNUstep and Cocoa web sites.
** That is being done here on the wiki, see [[ApplicationKitCompatibility]] [[User:Martin|Martin]] 08:47, 7 March 2007 (CET)

=== AppKit ===
* Text System should be cleaned, profiled and finished. Many methods in NSLayoutManager are unfinished or unimplemented, so we currently cannot tweak the test system as much as the one provided by Cocoa. (Quentin Mathe)
* We need NSTypeSetter, NSGlyphStorage, NSGlyphInfo, and NSGlyphGenerator implementations. If NSTypeSetter and NSLayoutManager were implemented, they would probably be used in Etoile. (Quentin Mathe)
* NSTextTable, NSTextTableBlock, NSTextList, & NSTextBlock implementations would also bring the GNUstep text system in line with that of Cocoa as of Mac OS 10.4. The classes could be useful to build a powerful word processor. (Quentin Mathe)
* NSOpenGL Classes could be improved, made compatible with current Cocoa implementations, and further tested (Quentin Mathe)
* NSBitmapImageRep formats: Currenly, we support only reading and writing for TIFF, read-only for GIF, JPEG, PNG, PNM. We would like to have write support for these NSBitmapImageRep categories. Afterwards, SVG reading, then write support, would be nice. (Quentin Mathe)
* NSDatePicker, NSLevelIndicator (and obligatory companion NSCell subclasses) implementations.
* NSFormatter isn't working very well at this time (Quentin Mathe)

=== Base ===
* NSDateComponents implementation.
* NSCalendar implementation.
* Finish the NSPredicate implementation. This was partially done by Quentin Mathe, but is untested. The most important part is not done, which is to write a parser and lexer for the custom language used by NSPredicate. Also needed for this are NSComparisonPredicate, NSCompoundPredicate, and NSExpression implementations.
* Test the NSXMLParser Cocoa class wrapper around GSXML, written by Richard-Frith Macdonald. Once this is thoroughly tested, NSXMLDocument, NSXMLDTD, and NSXMLDTDNode, and NSXMLElement, and NSXMLNode implementations may be useful for compatibility.

=== Core Data ===
* Saso Kiselkov started implementing this [http://gscoredata.nongnu.org/ framework]. However, NSManagedObjectContext & NSPersistentStoreCoordinator have yet to be tackled according to his web page. Presumably NSPersistentDocument also needs to be implemented.

=== Misc ===
* Create a AJAX Framework for GNUstepWeb
* Create Objective-C bindings for DBUS

Summer Of Code 2007

2007-04-13T14:43:35Z

Theraven: Updated page to reflect accepted projects

The [http://code.google.com/soc/ Summer Of Code] is a Google program that offers student developers stipends to create new freely available programs or to help currently established projects. This year, GNUstep had two projects accepted:

{| class="wikitable"
|-
! Project
! Student
! Mentor
|-
| [[Text_System_Project|Improving GNUstep AppKit components and the Text System]]
| Christopher Elsmore
| David Chisnall
|-
| Key Value Observing and Bindings implementation
| Christopher Farber
| Nicola Pero
|}

The original [[Summer_Of_Code_Ideas|proposed ideas]] are maintained for historical interest, and for students thinking of applying next year.

=== Mentors ===

The following agreed to provide additional mentoring, and answer questions for students in addition to their assigned mentors:

* Adam Fedor (Also main administrator)
* Nicolas Roard
* Richard Frith-Macdonald

Text System Project

2007-04-13T14:25:33Z

Theraven: /* People */

== People ==

Student: Christopher Elsmore

Mentor: David Chisnall

== Overview ==

This project aims to create an updated and profiled text system, with better Cocoa-compatibility and maintainability, as well as implement some missing NSCell subclasses from AppKit.

== Milestones ==

{To be agreed}

== Progress ==

None (project not officially started)

Text System Project

2007-04-13T14:25:20Z

Theraven:

== People ==

Student: Christopher Elsmore
Mentor: David Chisnall

== Overview ==

This project aims to create an updated and profiled text system, with better Cocoa-compatibility and maintainability, as well as implement some missing NSCell subclasses from AppKit.

== Milestones ==

{To be agreed}

== Progress ==

None (project not officially started)

Summer Of Code 2007

2007-03-19T12:52:31Z

Theraven: /* Mentors */

The [http://code.google.com/soc/ Summer Of Code] is a Google program that offers student developers stipends to create new freely available programs or to help currently established projects. It would be an excellent opportunity for GNUstep to fund some developments.

== Ideas ==
Here are some ideas -- Feel free to add more

=== Bindings, KVO support ===
* We need NSController, NSArrayController, NSObjectController, NSTreeController, NSUserDefaultController, NSValueTransformer implementations. NSSortDescriptor has already been implemented by Saso Kiselkov. The current NSTreeController is known to be a bit buggy and have an API a bit flawed, as Apple rushed the release of this class in Mac OS 10.4. It is widely believed that these shortcomings will be fixed in Leopard (10.5), so perhaps we should wait a while.
* Key Value Observing implementation was written by Richard Frith-Macdonald, and is only about 80% finished. Needs completion and testing.

=== Porting ===
* Port [http://developer.apple.com/opensource/internet/webkit.html WebKit] (using GCC 4.x with ObjC++ support). There's been discussion of a bounty for this, [http://www.nabble.com/WebKit-Bounty-tf3331066.html#a9262324 see the mailing list]. The WebKit team is willing to help whoever wants to take on this project, please see [http://lists.gnu.org/archive/html/discuss-gnustep/2007-03/msg00290.html this email].
* Port the [[Platform:Other|mySTEP]] changes. [http://www.nabble.com/Call-for-volunteers%3A-Backporting-mySTEP-changes-tf3370983.html Some have already volunteered], but as this is a big project, more help is welcome.

=== General Improvements ===
* Printing Support (better postcript generation, etc. see [https://savannah.gnu.org/bugs/?16262 bug #16262])
* MS Windows support (better integration in the MS Windows look and feel, especially the in-window-menu support needs work)
* [[GNUstepWeb]] (add script language support, etc)
* Finish input server [http://svn.gna.org/viewcvs/gnustep/libs/gui/branches/kazunobu_input_management/ support]
* Compare current API with Tiger's API, indicate which classes are missing, and summarize the current status of the existing ones, then work to complete them... ;) The best would be to have a tool which parses all headers (both from Cocoa and GNUstep) and outputs differences in HTML (XML probably too by the way). This would summarize missing classes, missing or partially implemented methods in existing classes and GNUstep-specific extensions. Eventually we should include links to the related documentation on both GNUstep and Cocoa web sites.
** That is being done here on the wiki, see [[ApplicationKitCompatibility]] [[User:Martin|Martin]] 08:47, 7 March 2007 (CET)

=== AppKit ===
* Text System should be cleaned, profiled and finished. Many methods in NSLayoutManager are unfinished or unimplemented, so we currently cannot tweak the test system as much as the one provided by Cocoa. (Quentin Mathe)
* We need NSTypeSetter, NSGlyphStorage, NSGlyphInfo, and NSGlyphGenerator implementations. If NSTypeSetter and NSLayoutManager were implemented, they would probably be used in Etoile. (Quentin Mathe)
* NSTextTable, NSTextTableBlock, NSTextList, & NSTextBlock implementations would also bring the GNUstep text system in line with that of Cocoa as of Mac OS 10.4. The classes could be useful to build a powerful word processor. (Quentin Mathe)
* NSOpenGL Classes could be improved, made compatible with current Cocoa implementations, and further tested (Quentin Mathe)
* NSBitmapImageRep formats: Currenly, we support only reading and writing for TIFF, read-only for GIF, JPEG, PNG, PNM. We would like to have write support for these NSBitmapImageRep categories. Afterwards, SVG reading, then write support, would be nice. (Quentin Mathe)
* NSDatePicker, NSLevelIndicator (and obligatory companion NSCell subclasses) implementations.
* NSFormatter isn't working very well at this time (Quentin Mathe)

=== Base ===
* NSDateComponents implementation.
* NSCalendar implementation.
* Finish the NSPredicate implementation. This was partially done by Quentin Mathe, but is untested. The most important part is not done, which is to write a parser and lexer for the custom language used by NSPredicate. Also needed for this are NSComparisonPredicate, NSCompoundPredicate, and NSExpression implementations.
* Test the NSXMLParser Cocoa class wrapper around GSXML, written by Richard-Frith Macdonald. Once this is thoroughly tested, NSXMLDocument, NSXMLDTD, and NSXMLDTDNode, and NSXMLElement, and NSXMLNode implementations may be useful for compatibility.

=== Misc ===
* Create a AJAX Framework for GNUstepWeb

== Note ==

We need [http://code.google.com/soc/mentorfaq.html mentor(s)] to manage the volunteers and a backup administrator. In addition to putting your name here make sure you also sign up at the [http://code.google.com/soc/mentor_step1.html Google Mentors] page.

=== Mentors ===

* Adam Fedor (Also main administrator)
* Nicolas Roard
* David Chisnall

=== Students ===

* Daniel J Farrell
* Fabio Andreoz.