GNUstepWiki - User contributions [en]

Document based app with Gorm and PC

2024-09-07T21:10:53Z

Buzzdee:

== About ==

As a result of learning about document based applications, and how to implement
them with PC and Gorm, I ended up with this, not overly useful, but working test application: https://github.com/buzzdeee/TestDocument

It features:
* following MVC pattern
* built with PC and Gorm
* separate AppController and AppDelegate
* support for multiple document types
** separate .gorm files for each supported document type
* KVC/KVO
* ARC
* using some modern syntax
* Localization
** and switched default language to something else than English

I'll cover some topics here, that will help understanding the application, and it's workflow.

== MVC and document based apps ==

Cocoa MVC (Model-View-Controller) is a design pattern used in Apple's Cocoa framework to separate concerns in an application. The Model represents the data and business logic, the View displays the data and handles user interface elements, and the Controller manages communication between the Model and View, updating the UI based on changes in the data. This separation promotes modularity, making the code more maintainable and reusable.

In a Cocoa (or GNUstep) document-based app that supports multiple documents, the classes involved can be mapped to the Model-View-Controller (MVC) pattern. Here’s how the various components like NSDocument, NSDocumentController, NSWindowController, document model classes, and UI built with Gorm fit into MVC:

# '''Model (M)''' The model represents the application's data and business logic. In a document-based app, the following components are part of the model:
## '''Plain classes for the document models''': These are your custom classes that contain the data and logic specific to your document. These classes are independent of the UI and are responsible for holding the document's data, performing any processing, and managing state.
## For example, if you’re building a text editor, the model class might store the text, keep track of formatting, and manage metadata (like the document title or file path).
## '''NSDocument''': While NSDocument primarily fits into the '''controller''' part of MVC, it also has some aspects of the '''model''' in Cocoa’s architecture. NSDocument handles saving, loading, and managing the undo functionality, so it acts as a mediator between the model data and persistence (reading/writing the file). It interacts closely with the document model classes to manage the actual content.
# '''View (V)''' The view is responsible for displaying the data and handling user input.
## '''UI built with Gorm''': Gorm is used to build the UI components in the app, which form the view. These include:
### Windows, menus, buttons, text fields, etc. created in Gorm are part of the '''view''' layer. They display the content of your document and allow users to interact with it.
### For example, if you're using a text editor, the NSTextView or custom views to display text are part of the view layer.
## '''NSWindowController''': The NSWindowController is responsible for managing the app’s windows and handling the interaction between the '''view''' and the document (controller). It loads the interface from a .gorm file (which contains the window and its views) and binds the UI elements to the document data. In strict MVC, it is part of the controller, but because it manages UI and views, it has aspects of both the '''controller''' and '''view''' layers.
# '''Controller (C)''' The '''controller''' manages the interactions between the '''model''' and the '''view''', mediating user input, updating the view, and manipulating the model as needed.
## '''NSDocument''': As mentioned, NSDocument serves as the document controller in this architecture. It communicates with the model (plain document classes) to retrieve and save the document data and updates the view when necessary. It also handles document-specific tasks like managing undo/redo, saving, and opening documents. It doesn't directly manage the UI but works closely with the NSWindowController to coordinate the display of the document.
## '''NSDocumentController''': This class is responsible for managing all documents in the application. It keeps track of which documents are open, handles creating new documents, and ensures that the correct document is presented in the appropriate window. NSDocumentController also manages interactions like opening recent files, handling document lifecycle events (new, open, close), and interacting with NSDocument objects. It plays a key role in coordinating the flow between the user’s actions and the document management.
## '''NSWindowController''': Though it has a close relationship with the view, NSWindowController also has controller responsibilities. It coordinates with NSDocument to ensure that the correct data is presented in the view. It manages the window’s lifecycle and keeps the UI in sync with the document data.

=== Breakdown of the MVC components ===

* '''Model''': Plain document classes (contain the data and business logic).
* '''View''': UI components built with Gorm, which display the document’s data.
* '''Controller''':
** ''NSDocument'': Bridges the model and the view, managing document-specific tasks (loading, saving, undo/redo).
** ''NSWindowController'': Manages windows and interfaces with NSDocument to update the views.
** ''NSDocumentController'': Oversees multiple documents, handles document creation, and ensures that the correct documents are open/active.

=== Workflow example in MVC context ===

# '''User Action''': A user opens an existing document from the File menu (View).
# '''Controller Response''': The NSDocumentController coordinates opening the file by creating or loading the corresponding NSDocument object (Controller).
# '''Model Interaction''': The NSDocument interacts with the plain document model class to load the data from the file (Model).
# '''UI Update''': The NSWindowController ensures that the document’s data is reflected in the views loaded from the Gorm interface file (View).
# '''User Edits''': The user modifies the document content via the UI (View), and the NSDocument updates the document model class accordingly (Model).

In this way, each class in a Cocoa (GNUstep) document-based app has a clear responsibility within the MVC framework, ensuring separation of concerns and maintainability of the application’s architecture.

== Development Environment ==

The application was developed on OpenBSD, with just the main GNUstep packages installed. If you're up to it, and it's probably one of the easiest ways to get a a modern GNUstep development environment supporting libobjc2 and ARC up and running ;)

# Install OpenBSD on a spare machine or VM, enable xdm
# install GNUstep as easy as: ''pkg_add gnustep-desktop''
# configure your .xsession alike:

if [ -f /usr/local/share/GNUstep/Makefiles/GNUstep.sh ];then
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
fi
export GNUSTEP_STRING_ENCODING=NSUTF8StringEncoding
export LC_ALL='en_EN.UTF-8'
export LC_CTYPE='en_US.UTF-8'
if [ -x /usr/local/bin/gpbs ];then
/usr/local/bin/gpbs
fi
if [ -x /usr/local/bin/gdnc ];then
/usr/local/bin/gdnc
fi
wmaker &
if [ -x /usr/local/bin/GWorkspace ];then
/usr/local/bin/make_services
/usr/local/bin/GWorkspace
fi

With these simple steps, you'll have a working GNUstep development environment.

== Debugging ==
If you want to debug, you may want to install egdb from packages as well.
To ease debugging, it might make sense to have the gnustep library sources around, and those build with debugging symbols, to do so:
# add the following to your /etc/doas.conf file:
permit nopass keepenv :wsrc
permit nopass keepenv :wheel
## NOTE: this allows passwordless root for the main user
# echo "echo 'DEBUG=-g -O0'" > /etc/mk.conf
# echo "echo 'SUDO=doas'" >> /etc/mk.conf
# doas pkg_delete gnustep-base gnustep-libobjc2 gnustep-make
# download and extract the ports.tar.gz to /usr/ports
# cd /usr/ports/x11/gnustep/
# make install
# make patch

just reboot, or relogin, then you should have your GNUstep packages around, built with debugging symbols, as well as the sources on disk.
This will dramatically ease debugging using egdb.

== ProjectCenter and Gorm ==

GNUstep ProjectCenter and Gorm are tools for developing applications using the GNUstep framework.

* '''ProjectCenter''' is an integrated development environment (IDE) that helps developers manage their projects, providing tools to create, organize, and compile GNUstep applications. It simplifies the setup and management of project files, source code, and build configurations, making it easier to develop Objective-C applications.
* '''Gorm''': (GNUstep Object Relationship Modeler) is a visual interface builder similar to Apple's Interface Builder. It allows developers to design user interfaces by dragging and dropping UI components, connecting them to the application's code, and managing the relationships between UI elements and objects, without writing the UI code manually.

Together, these tools streamline the development of GNUstep-based applications by providing a cohesive environment for both project management and user interface design.

== About ARC ==

Automatic Reference Counting (ARC) in Cocoa is a memory management feature that automatically manages the retain and release of objects. ARC ensures that objects are deallocated when they are no longer needed by automatically inserting the necessary memory management calls (retain, release, autorelease) at compile time. This reduces the risk of memory leaks and eliminates the need for developers to manually manage memory, making code cleaner and less error-prone, while improving performance by avoiding manual reference counting.

=== use ARC in your ProjectCenter application ===

GNUstep PC doesn't default to use ARC when creating projects. Therefore you have to tweak the default Application
a bit:

* Open the ''Project Inspector'' -> ''Build Attributes''
** ''ObjC Compiler Flags'': -fobjc-arc -g
* find the ''AppController.m'' in the ''Classes'' and remove the ''[super dealloc];'' line from the dealloc method
* find the ''<YOUR APPLICATION>_main.m'' in the ''Other Sources'' and add @autoreleasepool to it, so it looks alike:

int
main(int argc, const char *argv[])
{
@autoreleasepool
{
return NSApplicationMain (argc, argv);
}
}

With ARC, explicit calls to ''dealloc'' are prohibited, and the ''@autoreleasepool'' context takes care about the memory management within your application.

==== Separate AppDelegate and AppController responsibilities ====
GNUstep ProjectCenter default applications just provide a AppController class. To separate concerns, it might make sense to
separate out some life-cycle management from the AppController into the AppDelegate.

In a document-based application, both AppDelegate and AppController play essential roles in the lifecycle and behavior of the app, but they serve different purposes. Let's clarify their jobs:

'''AppDelegate''':
The AppDelegate class is responsible for handling the high-level app lifecycle and state transitions. It is defined in the Application Kit as a delegate for NSApplication. This class manages events such as the launch, termination, and background/foreground state of the application.
In a document-based app, the AppDelegate is not directly involved with managing individual documents (that's the job of NSDocument and NSDocumentController), but it coordinates the application-wide behavior.

We'll let the ''AppDelegate'' handle Application Lifecycle Events:
* ''applicationDidFinishLaunching'': This method is called after the application has launched, and you can use it to perform setup tasks, like initializing application-wide data or settings.
* ''applicationWillTerminate'': Called before the application terminates, and you can use it to save data or clean up resources.

'''AppController''':
The ''AppController'' class, though not a part of the default AppKit architecture, is a custom controller you can introduce. Its primary function is to act as the controller in the MVC pattern but on an application-wide level. This class often handles custom application logic that is not tied to a specific document or the app's lifecycle, unlike AppDelegate.

In a document-based app, AppController might:

* ''Coordinate Document Management'': It may interact with NSDocumentController to manage app-wide document-related features, like managing multiple types of documents or integrating additional functionality across all documents.
* ''Setup Application-Specific Logic'': It could handle custom actions like opening recent documents, setting up application-wide notifications, or dealing with specific app-wide user interface elements.
* ''Interface with UI Components'': It might be responsible for handling non-document-specific UI components like toolbars, menus, or status indicators that aren't directly tied to an individual document.

=== Custom Document Controller ===

Important facts about the custom NSDocumentController:
* It should be a subclass of NSDocumentController
* it's a Singleton, means, there's ever only one NSDocumentController class or subclass thereof in your application
* You might want to load it early, so the first instantiated NSDocumentController, will be your custom subclas.
** We're using the ''CustomInitializer'' class to help with that.

Document based app with Gorm and PC

2024-09-07T20:53:20Z

Buzzdee:

== About ==

This tutorial is going to show off how to create a Document based app, it'll cover the following:

* simple overview about MVC and document based apps
** what classes to be used and how it fits into the MVC model
** we'll use an ''AppDelegate'' to manage the main lifecycle
* using ProjectCenter to manage the project and coding
** simple introduction into PC, and some tips 'n tricks
** how to enable ARC in ProjectCenter
* using Gorm to create the UI
** main .gorm file for the menu
** separate .gorm files for the document types
* KVC/KVO to keep the UI in sync with the model
* the App we're going to create will be localized
** we'll switch the default language to something else than English ;)
* the app will handle multiple documents

This tutorial is not meant for long time Mac Cocoa Objective-C developers. It's more for people like me, lacking a Mac, but
want to give the Cocoa Framework a try. To be honest, I read through "Cocoa Programming Developer's Handbook" by David Chisnall,
but still, afterward it took me a couple of weeks with the help of ChatGPT to get the test app we're going over here, to finally
work and being well structured. Reading the book, is very helpful in the first place, and dramatically helps talking to ChatGPT.
ChatGPT is actually not too bad, it's even aware of some differences between GNUstep and Cocoa, but sometimes hallucinates methods
that don't exist, or it might guide you into the wrong direction.

== Structure ==

* first there will be an overview about MVC, and the classes we're going to use in the App, and how these fit into the paradigm
** how things are wiring up
* then continue with a quick introduction into PC and Gorm
** some small tips 'n tricks to make using them a bit easier
* then we'll start implementing the application
** step by step, dealing with one type of document to be managed in the app
* at the end, you should be able to implement handling of a second type of document

Code for the example application can be found here: https://github.com/buzzdeee/TestDocument

== MVC and document based apps ==

Cocoa MVC (Model-View-Controller) is a design pattern used in Apple's Cocoa framework to separate concerns in an application. The Model represents the data and business logic, the View displays the data and handles user interface elements, and the Controller manages communication between the Model and View, updating the UI based on changes in the data. This separation promotes modularity, making the code more maintainable and reusable.

In a Cocoa (or GNUstep) document-based app that supports multiple documents, the classes involved can be mapped to the Model-View-Controller (MVC) pattern. Here’s how the various components like NSDocument, NSDocumentController, NSWindowController, document model classes, and UI built with Gorm fit into MVC:

# '''Model (M)''' The model represents the application's data and business logic. In a document-based app, the following components are part of the model:
## '''Plain classes for the document models''': These are your custom classes that contain the data and logic specific to your document. These classes are independent of the UI and are responsible for holding the document's data, performing any processing, and managing state.
## For example, if you’re building a text editor, the model class might store the text, keep track of formatting, and manage metadata (like the document title or file path).
## '''NSDocument''': While NSDocument primarily fits into the '''controller''' part of MVC, it also has some aspects of the '''model''' in Cocoa’s architecture. NSDocument handles saving, loading, and managing the undo functionality, so it acts as a mediator between the model data and persistence (reading/writing the file). It interacts closely with the document model classes to manage the actual content.
# '''View (V)''' The view is responsible for displaying the data and handling user input.
## '''UI built with Gorm''': Gorm is used to build the UI components in the app, which form the view. These include:
### Windows, menus, buttons, text fields, etc. created in Gorm are part of the '''view''' layer. They display the content of your document and allow users to interact with it.
### For example, if you're using a text editor, the NSTextView or custom views to display text are part of the view layer.
## '''NSWindowController''': The NSWindowController is responsible for managing the app’s windows and handling the interaction between the '''view''' and the document (controller). It loads the interface from a .gorm file (which contains the window and its views) and binds the UI elements to the document data. In strict MVC, it is part of the controller, but because it manages UI and views, it has aspects of both the '''controller''' and '''view''' layers.
# '''Controller (C)''' The '''controller''' manages the interactions between the '''model''' and the '''view''', mediating user input, updating the view, and manipulating the model as needed.
## '''NSDocument''': As mentioned, NSDocument serves as the document controller in this architecture. It communicates with the model (plain document classes) to retrieve and save the document data and updates the view when necessary. It also handles document-specific tasks like managing undo/redo, saving, and opening documents. It doesn't directly manage the UI but works closely with the NSWindowController to coordinate the display of the document.
## '''NSDocumentController''': This class is responsible for managing all documents in the application. It keeps track of which documents are open, handles creating new documents, and ensures that the correct document is presented in the appropriate window. NSDocumentController also manages interactions like opening recent files, handling document lifecycle events (new, open, close), and interacting with NSDocument objects. It plays a key role in coordinating the flow between the user’s actions and the document management.
## '''NSWindowController''': Though it has a close relationship with the view, NSWindowController also has controller responsibilities. It coordinates with NSDocument to ensure that the correct data is presented in the view. It manages the window’s lifecycle and keeps the UI in sync with the document data.

=== Breakdown of the MVC components ===

* '''Model''': Plain document classes (contain the data and business logic).
* '''View''': UI components built with Gorm, which display the document’s data.
* '''Controller''':
** ''NSDocument'': Bridges the model and the view, managing document-specific tasks (loading, saving, undo/redo).
** ''NSWindowController'': Manages windows and interfaces with NSDocument to update the views.
** ''NSDocumentController'': Oversees multiple documents, handles document creation, and ensures that the correct documents are open/active.

=== Workflow example in MVC context ===

# '''User Action''': A user opens an existing document from the File menu (View).
# '''Controller Response''': The NSDocumentController coordinates opening the file by creating or loading the corresponding NSDocument object (Controller).
# '''Model Interaction''': The NSDocument interacts with the plain document model class to load the data from the file (Model).
# '''UI Update''': The NSWindowController ensures that the document’s data is reflected in the views loaded from the Gorm interface file (View).
# '''User Edits''': The user modifies the document content via the UI (View), and the NSDocument updates the document model class accordingly (Model).

In this way, each class in a Cocoa (GNUstep) document-based app has a clear responsibility within the MVC framework, ensuring separation of concerns and maintainability of the application’s architecture.

== Development Environment ==

This tutorial was developed on OpenBSD, with just the main GNUstep packages installed. If you're up to it, and it's probably one of the easiest ways to get a a modern GNUstep development environment supporting libobjc2 and ARC up and running ;)

# Install OpenBSD on a spare machine or VM, enable xdm
# install GNUstep as easy as: ''pkg_add gnustep-desktop''
# configure your .xsession alike:

if [ -f /usr/local/share/GNUstep/Makefiles/GNUstep.sh ];then
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
fi
export GNUSTEP_STRING_ENCODING=NSUTF8StringEncoding
export LC_ALL='en_EN.UTF-8'
export LC_CTYPE='en_US.UTF-8'
if [ -x /usr/local/bin/gpbs ];then
/usr/local/bin/gpbs
fi
if [ -x /usr/local/bin/gdnc ];then
/usr/local/bin/gdnc
fi
wmaker &
if [ -x /usr/local/bin/GWorkspace ];then
/usr/local/bin/make_services
/usr/local/bin/GWorkspace
fi

With these simple steps, you'll have a working GNUstep development environment.

== Debugging ==
If you want to debug, you may want to install egdb from packages as well.
To ease debugging, it might make sense to have the gnustep library sources around, and those build with debugging symbols, to do so:
# add the following to your /etc/doas.conf file:
permit nopass keepenv :wsrc
permit nopass keepenv :wheel
## NOTE: this allows passwordless root for the main user
# echo "echo 'DEBUG=-g -O0'" > /etc/mk.conf
# echo "echo 'SUDO=doas'" >> /etc/mk.conf
# doas pkg_delete gnustep-base gnustep-libobjc2 gnustep-make
# download and extract the ports.tar.gz to /usr/ports
# cd /usr/ports/x11/gnustep/
# make install
# make patch

just reboot, or relogin, then you should have your GNUstep packages around, built with debugging symbols, as well as the sources on disk.
This will dramatically ease debugging using egdb.

== ProjectCenter and Gorm ==

GNUstep ProjectCenter and Gorm are tools for developing applications using the GNUstep framework.

* '''ProjectCenter''' is an integrated development environment (IDE) that helps developers manage their projects, providing tools to create, organize, and compile GNUstep applications. It simplifies the setup and management of project files, source code, and build configurations, making it easier to develop Objective-C applications.
* '''Gorm''': (GNUstep Object Relationship Modeler) is a visual interface builder similar to Apple's Interface Builder. It allows developers to design user interfaces by dragging and dropping UI components, connecting them to the application's code, and managing the relationships between UI elements and objects, without writing the UI code manually.

Together, these tools streamline the development of GNUstep-based applications by providing a cohesive environment for both project management and user interface design.

== Creating your Project ==
With all that prepared, you're now ready to create the basic project:

=== ProjectCenter ===
With either just gnustep-desktop package(s) installed, or even built by yourself from ports, you should now be able to just
start ProjectCenter from the command line, i.e. xterm window.

Once it's started, you want to configure it a bit, to ensure a smooth experience ;)

* Open the '''Preferences''' Build menu
** ensure '''External Build Tool''' points to ''/usr/local/bin/gmake'' or wherever your GNU Make is when you're not on OpenBSD. A BSD make just won't work.
* Open the '''Preferences''' Miscellaneous menu
** ensure '''Debugger''' points to ''/usr/local/bin/egdb'' or whatever is the right one for your platform
** ensure '''Editor''' is ''ProjectCenter''. That should be the default, you may use others, i.e. Gemas...

Now Open the ''Project'' -> ''New'' menu, select a suitable place where you want to have your project reside.
Ensure '''Project Type''' is set to '''Application''' and give it a name. We'll name our project '''DocumentBasedApp''' as you can see in the screenshot below.
(You may actually not want to choose /tmp as your destination folder ;)

Voila, your first project.

Now do some configurations, to add support for ARC, debugging, multiple languages...

* Open the ''Project Inspector'' -> ''Project Languages''
** and add a second language, i.e. ''German''
* Open the ''Project Inspector'' -> ''Project Attributes''
** switch the ''Language'' to ''German''
** you may specify a bundle identifier, i.e. com.mydomain.documentbasedapp
** open the ''Document Types...'' button
*** activate the '''Document-based''' checkbox
*** enter the fields below (always hit return when finished editing):
**** ''Type'': MyDoc1
***** As it's identified throughout the application in code
**** ''Name'': My Doc 1
***** Not exactly sure where this is used
**** ''Icon'': not yet
***** we don't need it yet
**** ''Extension'': doc1
***** the file extension for your document type, without the leading .
**** ''Role'': Editor
***** might be ''Editor'' or ''Viewer'' depending on whether your app will edit or only view your documents
**** ''Class'': MyDoc1
***** the class in your code, that will handle these types of documents
*** finally hit the '''+''' sign to add it to the list of document types
*** you may now do the same for a second document type in a similar way: MyDoc2, or do it later
* Open the ''Project Inspector'' -> ''Build Attributes''
** ''ObjC Compiler Flags'': -fobjc-arc -g
*** to tell it to use ARC and add debugging symbols when building
** ''Install Domain'': you may change it to ''User''
* You may Open the ''Project Inspector'' -> ''Project Description''
** update there as well as you see fit

With that, your project should be well configured.

=== ARC support finished ===
* find the ''AppController.m'' in the ''Classes'' and remove the ''[super dealloc];'' line from the dealloc method
* find the ''DocumentBasedApp_main.m'' in the ''Other Sources'' and add @autoreleasepool to it, so it looks alike:

int
main(int argc, const char *argv[])
{
@autoreleasepool
{
return NSApplicationMain (argc, argv);
}
}

With ARC, explicit calls to dealloc are prohibited, and the ''@autoreleasepool'' takes care about the memory management within your application.

=== Build the app ===

* open the build window
** configure the ''Build Options''
*** enable ''verbose output'''
** hit the build button

With a bit of luck and no typos, the build should have succeeded!

=== Launch the app ===

* from the main project window, hit the launcher icon to open the launcher window
** NSLog output will show up here when you add it for your debugging aid
* hit the launch icon

Voila, your first (quite useless) app is up and running.

=== Add some classes we need ===
We're going to add some initial classes, put in a number of stub methods, we'll fill in with code later on.
We won't need all methods, but NSLog messages in them, will show the flow the application takes.

==== Separate AppDelegate and AppController responsibilities ====
GNUstep ProjectCenter default applications just provide a AppController class. We're going to
separate out some life-cycle management from the AppController into the AppDelegate.

In a document-based application, both AppDelegate and AppController play essential roles in the lifecycle and behavior of the app, but they serve different purposes. Let's clarify their jobs:

'''AppDelegate''':
The AppDelegate class is responsible for handling the high-level app lifecycle and state transitions. It is defined in the Application Kit as a delegate for NSApplication. This class manages events such as the launch, termination, and background/foreground state of the application.
In a document-based app, the AppDelegate is not directly involved with managing individual documents (that's the job of NSDocument and NSDocumentController), but it coordinates the application-wide behavior.

We'll let the ''AppDelegate'' handle Application Lifecycle Events:
* ''applicationDidFinishLaunching'': This method is called after the application has launched, and you can use it to perform setup tasks, like initializing application-wide data or settings.
* ''applicationWillTerminate'': Called before the application terminates, and you can use it to save data or clean up resources.

'''AppController''':
The ''AppController'' class, though not a part of the default AppKit architecture, is a custom controller you can introduce. Its primary function is to act as the controller in the MVC pattern but on an application-wide level. This class often handles custom application logic that is not tied to a specific document or the app's lifecycle, unlike AppDelegate.

In a document-based app, AppController might:

* ''Coordinate Document Management'': It may interact with NSDocumentController to manage app-wide document-related features, like managing multiple types of documents or integrating additional functionality across all documents.
* ''Setup Application-Specific Logic'': It could handle custom actions like opening recent documents, setting up application-wide notifications, or dealing with specific app-wide user interface elements.
* ''Interface with UI Components'': It might be responsible for handling non-document-specific UI components like toolbars, menus, or status indicators that aren't directly tied to an individual document.

==== Create AppDelegate ====

* in the main project window select ''Classes''
* from the ''File'' menu open ''New in Project''
** select ''Objective-C class''
** enter the name: ''AppDelegate''
** activate checkbox: ''Add Header File''
* click the create

Find and open your AppDelegate.h in the ''Headers''

Update it to include the following:

<pre>
#import <AppKit/AppKit.h>

@class AppController;

// the AppDelegate shall implement the NSApplicationDelegate protocol
@interface AppDelegate : NSObject <NSApplicationDelegate>
{

}

// to link up the AppController
@property (nonatomic, strong) AppController *appController;

@end
</pre>

Find the corresponding AppDelegate.m file in the ''Classes'' section.
Update it to include the following:

<pre>
#import "AppDelegate.h"
#import "AppController.h"

@implementation AppDelegate

- (void)applicationWillFinishLaunching:(NSNotification *)notification
{
// Initialize app here

NSLog(@"AppDelegate: applicationWillFinishLaunching: was called");
}

- (void)applicationDidFinishLaunching:(NSNotification *)notification
{
// Initialize app here
NSLog(@"AppDelegate: applicationDidFinishLaunching: was called");

// link up the AppController
self.appController = [[AppController alloc] init];
[self.appController setupApplication];
}

// Invoked just before the application terminates.
// Use this method to perform cleanup tasks, save data, or release resources.
- (void)applicationWillTerminate:(NSNotification *)notification
{
NSLog(@"AppDelegate: applicationWillTerminate: %@", notification);
}

// Asks the delegate whether the application should terminate.
// Useful for prompting the user to save unsaved changes or cancel termination under certain conditions.
- (NSApplicationTerminateReply)applicationShouldTerminate:(NSApplication *)sender
{
// if ([self.appController hasUnsavedChanges]) {
// Prompt the user to save changes
// Return NSTerminateLater if waiting for user input
// return NSTerminateCancel; // Or NSTerminateNow based on user response
// }
NSLog(@"AppDelegate: applicationShouldTerminate: %@", sender);
return NSTerminateNow;
}

// Determines whether the application should quit when the last window is closed.
// Returning YES makes the app quit automatically, which is common for utility applications.
- (BOOL)applicationShouldTerminateAfterLastWindowClosed:(NSApplication *)sender
{
NSLog(@"AppDelegate: applicationShouldTerminateAfterLastWindowClosed: was called");
return NO; // Return YES if the app should quit after the last window closes
}

// Handles requests to open files, typically when the user double-clicks a
// file associated with your app or drags a file onto the app icon.
- (void)application:(NSApplication *)sender openFiles:(NSArray<NSString *> *)filenames
{
NSLog(@"AppDelegate: openFiles: was called");
// for (NSString *filename in filenames) {
// Open each file using your NSDocumentController
// [[NSDocumentController sharedDocumentController] openDocumentWithContentsOfURL:[NSURL fileURLWithPath:filename]
// display:YES
// error:nil];
// }
// [sender replyToOpenOrPrint:NSApplicationDelegateReplySuccess];
}

// Handles opening multiple URLs (including files) in response to user actions.
- (void)application:(NSApplication *)application openURLs:(NSArray<NSURL *> *)urls
{
NSLog(@"AppDelegate: openURLs: was called");
// for (NSURL *url in urls) {
// Open each URL using your NSDocumentController
// [[NSDocumentController sharedDocumentController] openDocumentWithContentsOfURL:url
// display:YES
// error:nil];
// }
}

// Called when the user tries to reopen the application (e.g., clicking the app icon in the Dock)
// while it’s already running. Useful for restoring windows or bringing the app to the foreground.
- (BOOL)applicationShouldHandleReopen:(NSApplication *)sender hasVisibleWindows:(BOOL)flag
{
NSLog(@"AppDelegate: applicationShouldHandleReopen: was called");
// if (!flag) {
// No visible windows, so open a new document window
// [[NSDocumentController sharedDocumentController] newDocument:self];
// }
return YES;
}

// Called when the application is about to become active.
// Useful for refreshing UI elements or updating data when the app gains focus.
- (void)applicationWillBecomeActive:(NSNotification *)notification
{
NSLog(@"AppDelegate: Application will become active.");
// Prepare for activation
}

// Called when the application has become active.
// Useful for refreshing UI elements or updating data when the app gains focus.
- (void)applicationDidBecomeActive:(NSNotification *)notification
{
NSLog(@"AppDelegate: Application did become active.");
// Refresh UI or data
}

// Called when the application is about to resign its active status.
// Useful for pausing ongoing tasks or saving transient state.
- (void)applicationWillResignActive:(NSNotification *)notification
{
NSLog(@"AppDelegate: Application will resign active.");
// Pause tasks or disable certain UI elements
}

// Called when the application has resigned its active status.
// Useful for pausing ongoing tasks or saving transient state.
- (void)applicationDidResignActive:(NSNotification *)notification
{
NSLog(@"AppDelegate: Application did resign active.");
// Perform actions after resigning active status
}

// Indicates whether the application supports secure state restoration.
// Returning YES allows your app to participate in state restoration,
// which can restore windows and their states after the app restarts.
- (BOOL)applicationSupportsSecureRestorableState:(NSApplication *)app
{
NSLog(@"AppDelegate: applicationSupportsSecureRestorableState was called");
return NO;
}

// Allows the delegate to encode additional information into the state restoration process.
- (void)application:(NSApplication *)app willEncodeRestorableState:(NSCoder *)state
{
NSLog(@"AppDelegate: willEncodeRestorableState was called");
// Encode additional state information
}

// Allows the delegate to respond after the state has been decoded.
- (void)application:(NSApplication *)app didDecodeRestorableState:(NSCoder *)state
{
NSLog(@"AppDelegate: didDecodeRestorableState was called");
// Decode and apply additional state information
}

// Handles registration for remote notifications (e.g., push notifications).
// While more common in iOS, macOS applications can also use these for similar purposes.
- (void)application:(NSApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken
{
NSLog(@"Registered for remote notifications with device token: %@", deviceToken);
// Send device token to server
}

// Handles registration for remote notifications (e.g., push notifications).
// While more common in iOS, macOS applications can also use these for similar purposes.
- (void)application:(NSApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error
{
NSLog(@"Failed to register for remote notifications: %@", error);
// Handle the failure
}

// Allows the delegate to customize error presentation to the user.
- (NSError *)application:(NSApplication *)app willPresentError:(NSError *)error
{
NSLog(@"AppDelegate: willPresentError");
// Customize error before it’s presented
return nil;
}

// Allows the delegate to customize to respond after an error has been presented to the user.
- (void)application:(NSApplication *)app didPresentError:(NSError *)error
{
NSLog(@"AppDelegate: didPresentError");
// Perform actions after error presentation
}
</pre>

==== Clean-up and update AppController ====

Open your ''AppController.h'' file, and clean-up methods we don't need, and add ''setupApplication'' method, so it will look like the following:

<pre>
#import <AppKit/AppKit.h>

@interface AppController : NSObject
{
}

+ (void) initialize;

- (id) init;
- (void) dealloc;

- (void) showPrefPanel: (id)sender;

// called by the AppDelegate on startup
- (void)setupApplication;

@end
</pre>

Clean-up and update your AppController.m class file as well, so it's going to look like this:

<pre>
#import "AppController.h"

@implementation AppController

+ (void) initialize
{
NSMutableDictionary *defaults = [NSMutableDictionary dictionary];

/*
* Register your app's defaults here by adding objects to the
* dictionary, eg
*
* [defaults setObject:anObject forKey:keyForThatObject];
*
*/

[[NSUserDefaults standardUserDefaults] registerDefaults: defaults];
[[NSUserDefaults standardUserDefaults] synchronize];
}

- (id) init
{
if ((self = [super init]))
{
}
return self;
}

- (void) dealloc
{
}

- (void) showPrefPanel: (id)sender
{
}

- (void)setupApplication
{
// Setup global settings, preferences, or shared resources here
NSLog(@"AppController is setting up the application");
}

@end
</pre>

Try building application, eventually it should succeed.

Given that, the AppController will take care of the NSUserDefaults for the application, so the global configuration, taking care of the preferences Panel, and setting up global application specific stuff.

=== Custom Document Controller ===
Now we need to get our custom document controller into play.

Important facts about the custom NSDocumentController:
* It should be a subclass of NSDocumentController
* it's a Singleton, means, there's ever only one NSDocumentController class or subclass thereof in your application
* You might want to load it early, so the first instantiated NSDocumentController, will be your custom subclas.
** We're using the ''CustomInitializer'' class to help with that.

Document based app with Gorm and PC

2024-09-06T21:37:49Z

Buzzdee: /* Creating your Project */

== About ==

This tutorial is going to show off how to create a Document based app, it'll cover the following:

* simple overview about MVC and document based apps
** what classes to be used and how it fits into the MVC model
* using ProjectCenter and Gorm
** simple introduction into both tools, some tips 'n tricks
** how to enable ARC in ProjectCenter
* KVC/KVO to keep the UI in sync with the model
* the App we're going to create will be localized
** we'll switch the default language to something else than English ;)
* the app will handle multiple documents

This tutorial is not meant for long time Mac Cocoa Objective-C developers. It's more for people like me, lacking a Mac, but
want to give the Cocoa Framework a try. To be honest, I read through "Cocoa Programming Developer's Handbook" by David Chisnall,
but still, afterward it took me a couple of weeks with the help of ChatGPT to get the test app we're going over here, to finally
work and being well structured. Reading the book, is very helpful in the first place, and dramatically helps talking to ChatGPT.
ChatGPT is actually not too bad, it's even aware of some differences between GNUstep and Cocoa, but sometimes hallucinates methods
that don't exist, or it might guide you into the wrong direction.

== Structure ==

* first there will be an overview about MVC, and the classes we're going to use in the App, and how these fit into the paradigm
** how things are wiring up
* then continue with a quick introduction into PC and Gorm
** some small tips 'n tricks to make using them a bit easier
* then we'll start implementing the application
** step by step, dealing with one type of document to be managed in the app
* at the end, you should be able to implement handling of a second type of document

Code for the example application can be found here: https://github.com/buzzdeee/DocumentBasedAppTutorial

== MVC and document based apps ==

Cocoa MVC (Model-View-Controller) is a design pattern used in Apple's Cocoa framework to separate concerns in an application. The Model represents the data and business logic, the View displays the data and handles user interface elements, and the Controller manages communication between the Model and View, updating the UI based on changes in the data. This separation promotes modularity, making the code more maintainable and reusable.

In a Cocoa (or GNUstep) document-based app that supports multiple documents, the classes involved can be mapped to the Model-View-Controller (MVC) pattern. Here’s how the various components like NSDocument, NSDocumentController, NSWindowController, document model classes, and UI built with Gorm fit into MVC:

# '''Model (M)''' The model represents the application's data and business logic. In a document-based app, the following components are part of the model:
## '''Plain classes for the document models''': These are your custom classes that contain the data and logic specific to your document. These classes are independent of the UI and are responsible for holding the document's data, performing any processing, and managing state.
## For example, if you’re building a text editor, the model class might store the text, keep track of formatting, and manage metadata (like the document title or file path).
## '''NSDocument''': While NSDocument primarily fits into the '''controller''' part of MVC, it also has some aspects of the '''model''' in Cocoa’s architecture. NSDocument handles saving, loading, and managing the undo functionality, so it acts as a mediator between the model data and persistence (reading/writing the file). It interacts closely with the document model classes to manage the actual content.
# '''View (V)''' The view is responsible for displaying the data and handling user input.
## '''UI built with Gorm''': Gorm is used to build the UI components in the app, which form the view. These include:
### Windows, menus, buttons, text fields, etc. created in Gorm are part of the '''view''' layer. They display the content of your document and allow users to interact with it.
### For example, if you're using a text editor, the NSTextView or custom views to display text are part of the view layer.
## '''NSWindowController''': The NSWindowController is responsible for managing the app’s windows and handling the interaction between the '''view''' and the document (controller). It loads the interface from a .gorm file (which contains the window and its views) and binds the UI elements to the document data. In strict MVC, it is part of the controller, but because it manages UI and views, it has aspects of both the '''controller''' and '''view''' layers.
# '''Controller (C)''' The '''controller''' manages the interactions between the '''model''' and the '''view''', mediating user input, updating the view, and manipulating the model as needed.
## '''NSDocument''': As mentioned, NSDocument serves as the document controller in this architecture. It communicates with the model (plain document classes) to retrieve and save the document data and updates the view when necessary. It also handles document-specific tasks like managing undo/redo, saving, and opening documents. It doesn't directly manage the UI but works closely with the NSWindowController to coordinate the display of the document.
## '''NSDocumentController''': This class is responsible for managing all documents in the application. It keeps track of which documents are open, handles creating new documents, and ensures that the correct document is presented in the appropriate window. NSDocumentController also manages interactions like opening recent files, handling document lifecycle events (new, open, close), and interacting with NSDocument objects. It plays a key role in coordinating the flow between the user’s actions and the document management.
## '''NSWindowController''': Though it has a close relationship with the view, NSWindowController also has controller responsibilities. It coordinates with NSDocument to ensure that the correct data is presented in the view. It manages the window’s lifecycle and keeps the UI in sync with the document data.

=== Breakdown of the MVC components ===

* '''Model''': Plain document classes (contain the data and business logic).
* '''View''': UI components built with Gorm, which display the document’s data.
* '''Controller''':
** ''NSDocument'': Bridges the model and the view, managing document-specific tasks (loading, saving, undo/redo).
** ''NSWindowController'': Manages windows and interfaces with NSDocument to update the views.
** ''NSDocumentController'': Oversees multiple documents, handles document creation, and ensures that the correct documents are open/active.

=== Workflow example in MVC context ===

# '''User Action''': A user opens an existing document from the File menu (View).
# '''Controller Response''': The NSDocumentController coordinates opening the file by creating or loading the corresponding NSDocument object (Controller).
# '''Model Interaction''': The NSDocument interacts with the plain document model class to load the data from the file (Model).
# '''UI Update''': The NSWindowController ensures that the document’s data is reflected in the views loaded from the Gorm interface file (View).
# '''User Edits''': The user modifies the document content via the UI (View), and the NSDocument updates the document model class accordingly (Model).

In this way, each class in a Cocoa (GNUstep) document-based app has a clear responsibility within the MVC framework, ensuring separation of concerns and maintainability of the application’s architecture.

== Development Environment ==

This tutorial was developed on OpenBSD, with just the main GNUstep packages installed. If you're up to it, and it's probably one of the easiest ways to get a a modern GNUstep development environment supporting libobjc2 and ARC up and running ;)

# Install OpenBSD on a spare machine or VM, enable xdm
# install GNUstep as easy as: ''pkg_add gnustep-desktop''
# configure your .xsession alike:

if [ -f /usr/local/share/GNUstep/Makefiles/GNUstep.sh ];then
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
fi
export GNUSTEP_STRING_ENCODING=NSUTF8StringEncoding
export LC_ALL='en_EN.UTF-8'
export LC_CTYPE='en_US.UTF-8'
if [ -x /usr/local/bin/gpbs ];then
/usr/local/bin/gpbs
fi
if [ -x /usr/local/bin/gdnc ];then
/usr/local/bin/gdnc
fi
wmaker &
if [ -x /usr/local/bin/GWorkspace ];then
/usr/local/bin/make_services
/usr/local/bin/GWorkspace
fi

With these simple steps, you'll have a working GNUstep development environment.

== Debugging ==
If you want to debug, you may want to install egdb from packages as well.
To ease debugging, it might make sense to have the gnustep library sources around, and those build with debugging symbols, to do so:
# add the following to your /etc/doas.conf file:
permit nopass keepenv :wsrc
permit nopass keepenv :wheel
## NOTE: this allows passwordless root for the main user
# echo "echo 'DEBUG=-g -O0'" > /etc/mk.conf
# echo "echo 'SUDO=doas'" >> /etc/mk.conf
# doas pkg_delete gnustep-base gnustep-libobjc2 gnustep-make
# download and extract the ports.tar.gz to /usr/ports
# cd /usr/ports/x11/gnustep/
# make install
# make patch

just reboot, or relogin, then you should have your GNUstep packages around, built with debugging symbols, as well as the sources on disk.
This will dramatically ease debugging using egdb.

== ProjectCenter and Gorm ==

GNUstep ProjectCenter and Gorm are tools for developing applications using the GNUstep framework.

* '''ProjectCenter''' is an integrated development environment (IDE) that helps developers manage their projects, providing tools to create, organize, and compile GNUstep applications. It simplifies the setup and management of project files, source code, and build configurations, making it easier to develop Objective-C applications.
* '''Gorm''': (GNUstep Object Relationship Modeler) is a visual interface builder similar to Apple's Interface Builder. It allows developers to design user interfaces by dragging and dropping UI components, connecting them to the application's code, and managing the relationships between UI elements and objects, without writing the UI code manually.

Together, these tools streamline the development of GNUstep-based applications by providing a cohesive environment for both project management and user interface design.

== Creating your Project ==
With all that prepared, you're now ready to create the basic project:

=== ProjectCenter ===
With either just gnustep-desktop package(s) installed, or even built by yourself from ports, you should now be able to just
start ProjectCenter from the command line, i.e. xterm window.

Once it's started, you want to configure it a bit, to ensure a smooth experience ;)

* Open the '''Preferences''' Build menu
** ensure '''External Build Tool''' points to ''/usr/local/bin/gmake'' or wherever your GNU Make is when you're not on OpenBSD. A BSD make just won't work.
* Open the '''Preferences''' Miscellaneous menu
** ensure '''Debugger''' points to ''/usr/local/bin/egdb'' or whatever is the right one for your platform
** ensure '''Editor''' is ''ProjectCenter''. That should be the default, you may use others, i.e. Gemas...

Now Open the ''Project'' -> ''New'' menu, select a suitable place where you want to have your project reside.
Ensure '''Project Type''' is set to '''Application''' and give it a name. We'll name our project '''DocumentBasedApp''' as you can see in the screenshot below.
(You may actually not want to choose /tmp as your destination folder ;)

Voila, your first project.

Now do some configurations, to add support for ARC, debugging, multiple languages...

* Open the ''Project Inspector'' -> ''Project Languages''
** and add a second language, i.e. ''German''
* Open the ''Project Inspector'' -> ''Project Attributes''
** switch the ''Language'' to ''German''
** you may specify a bundle identifier, i.e. com.mydomain.documentbasedapp
** open the ''Document Types...'' button
*** activate the '''Document-based''' checkbox
*** enter the fields below (always hit return when finished editing):
**** ''Type'': MyDoc1
***** As it's identified throughout the application in code
**** ''Name'': My Doc 1
***** Not exactly sure where this is used
**** ''Icon'': not yet
***** we don't need it yet
**** ''Extension'': doc1
***** the file extension for your document type, without the leading .
**** ''Role'': Editor
***** might be ''Editor'' or ''Viewer'' depending on whether your app will edit or only view your documents
**** ''Class'': MyDoc1
***** the class in your code, that will handle these types of documents
*** finally hit the '''+''' sign to add it to the list of document types
*** you may now do the same for a second document type in a similar way: MyDoc2, or do it later
* Open the ''Project Inspector'' -> ''Build Attributes''
** ''ObjC Compiler Flags'': -fobjc-arc -g
*** to tell it to use ARC and add debugging symbols when building
** ''Install Domain'': you may change it to ''User''
* You may Open the ''Project Inspector'' -> ''Project Description''
** update there as well as you see fit

With that, your project should be well configured.

=== ARC support finished ===
* find the ''AppController.m'' in the ''Classes'' and remove the ''[super dealloc];'' line from the dealloc method
* find the ''DocumentBasedApp_main.m'' in the ''Other Sources'' and add @autoreleasepool to it, so it looks alike:

int
main(int argc, const char *argv[])
{
@autoreleasepool
{
return NSApplicationMain (argc, argv);
}
}

With ARC, explicit calls to dealloc are prohibited, and the ''@autoreleasepool'' takes care about the memory management within your application.

=== Build the app ===

* open the build window
** configure the ''Build Options''
*** enable ''verbose output'''
** hit the build button

With a bit of luck and no typos, the build should have succeeded!

=== Launch the app ===

* from the main project window, hit the launcher icon to open the launcher window
** NSLog output will show up here when you add it for your debugging aid
* hit the launch icon

Voila, your first (quite useless) app is up and running.

Document based app with Gorm and PC

2024-09-06T21:00:47Z

Buzzdee: Created page with "== About == This tutorial is going to show off how to create a Document based app, it'll cover the following: * simple overview about MVC and document based apps ** what cla..."

== About ==

This tutorial is going to show off how to create a Document based app, it'll cover the following:

* simple overview about MVC and document based apps
** what classes to be used and how it fits into the MVC model
* using ProjectCenter and Gorm
** simple introduction into both tools, some tips 'n tricks
** how to enable ARC in ProjectCenter
* KVC/KVO to keep the UI in sync with the model
* the App we're going to create will be localized
** we'll switch the default language to something else than English ;)
* the app will handle multiple documents

This tutorial is not meant for long time Mac Cocoa Objective-C developers. It's more for people like me, lacking a Mac, but
want to give the Cocoa Framework a try. To be honest, I read through "Cocoa Programming Developer's Handbook" by David Chisnall,
but still, afterward it took me a couple of weeks with the help of ChatGPT to get the test app we're going over here, to finally
work and being well structured. Reading the book, is very helpful in the first place, and dramatically helps talking to ChatGPT.
ChatGPT is actually not too bad, it's even aware of some differences between GNUstep and Cocoa, but sometimes hallucinates methods
that don't exist, or it might guide you into the wrong direction.

== Structure ==

* first there will be an overview about MVC, and the classes we're going to use in the App, and how these fit into the paradigm
** how things are wiring up
* then continue with a quick introduction into PC and Gorm
** some small tips 'n tricks to make using them a bit easier
* then we'll start implementing the application
** step by step, dealing with one type of document to be managed in the app
* at the end, you should be able to implement handling of a second type of document

Code for the example application can be found here: https://github.com/buzzdeee/DocumentBasedAppTutorial

== MVC and document based apps ==

Cocoa MVC (Model-View-Controller) is a design pattern used in Apple's Cocoa framework to separate concerns in an application. The Model represents the data and business logic, the View displays the data and handles user interface elements, and the Controller manages communication between the Model and View, updating the UI based on changes in the data. This separation promotes modularity, making the code more maintainable and reusable.

In a Cocoa (or GNUstep) document-based app that supports multiple documents, the classes involved can be mapped to the Model-View-Controller (MVC) pattern. Here’s how the various components like NSDocument, NSDocumentController, NSWindowController, document model classes, and UI built with Gorm fit into MVC:

# '''Model (M)''' The model represents the application's data and business logic. In a document-based app, the following components are part of the model:
## '''Plain classes for the document models''': These are your custom classes that contain the data and logic specific to your document. These classes are independent of the UI and are responsible for holding the document's data, performing any processing, and managing state.
## For example, if you’re building a text editor, the model class might store the text, keep track of formatting, and manage metadata (like the document title or file path).
## '''NSDocument''': While NSDocument primarily fits into the '''controller''' part of MVC, it also has some aspects of the '''model''' in Cocoa’s architecture. NSDocument handles saving, loading, and managing the undo functionality, so it acts as a mediator between the model data and persistence (reading/writing the file). It interacts closely with the document model classes to manage the actual content.
# '''View (V)''' The view is responsible for displaying the data and handling user input.
## '''UI built with Gorm''': Gorm is used to build the UI components in the app, which form the view. These include:
### Windows, menus, buttons, text fields, etc. created in Gorm are part of the '''view''' layer. They display the content of your document and allow users to interact with it.
### For example, if you're using a text editor, the NSTextView or custom views to display text are part of the view layer.
## '''NSWindowController''': The NSWindowController is responsible for managing the app’s windows and handling the interaction between the '''view''' and the document (controller). It loads the interface from a .gorm file (which contains the window and its views) and binds the UI elements to the document data. In strict MVC, it is part of the controller, but because it manages UI and views, it has aspects of both the '''controller''' and '''view''' layers.
# '''Controller (C)''' The '''controller''' manages the interactions between the '''model''' and the '''view''', mediating user input, updating the view, and manipulating the model as needed.
## '''NSDocument''': As mentioned, NSDocument serves as the document controller in this architecture. It communicates with the model (plain document classes) to retrieve and save the document data and updates the view when necessary. It also handles document-specific tasks like managing undo/redo, saving, and opening documents. It doesn't directly manage the UI but works closely with the NSWindowController to coordinate the display of the document.
## '''NSDocumentController''': This class is responsible for managing all documents in the application. It keeps track of which documents are open, handles creating new documents, and ensures that the correct document is presented in the appropriate window. NSDocumentController also manages interactions like opening recent files, handling document lifecycle events (new, open, close), and interacting with NSDocument objects. It plays a key role in coordinating the flow between the user’s actions and the document management.
## '''NSWindowController''': Though it has a close relationship with the view, NSWindowController also has controller responsibilities. It coordinates with NSDocument to ensure that the correct data is presented in the view. It manages the window’s lifecycle and keeps the UI in sync with the document data.

=== Breakdown of the MVC components ===

* '''Model''': Plain document classes (contain the data and business logic).
* '''View''': UI components built with Gorm, which display the document’s data.
* '''Controller''':
** ''NSDocument'': Bridges the model and the view, managing document-specific tasks (loading, saving, undo/redo).
** ''NSWindowController'': Manages windows and interfaces with NSDocument to update the views.
** ''NSDocumentController'': Oversees multiple documents, handles document creation, and ensures that the correct documents are open/active.

=== Workflow example in MVC context ===

# '''User Action''': A user opens an existing document from the File menu (View).
# '''Controller Response''': The NSDocumentController coordinates opening the file by creating or loading the corresponding NSDocument object (Controller).
# '''Model Interaction''': The NSDocument interacts with the plain document model class to load the data from the file (Model).
# '''UI Update''': The NSWindowController ensures that the document’s data is reflected in the views loaded from the Gorm interface file (View).
# '''User Edits''': The user modifies the document content via the UI (View), and the NSDocument updates the document model class accordingly (Model).

In this way, each class in a Cocoa (GNUstep) document-based app has a clear responsibility within the MVC framework, ensuring separation of concerns and maintainability of the application’s architecture.

== Development Environment ==

This tutorial was developed on OpenBSD, with just the main GNUstep packages installed. If you're up to it, and it's probably one of the easiest ways to get a a modern GNUstep development environment supporting libobjc2 and ARC up and running ;)

# Install OpenBSD on a spare machine or VM, enable xdm
# install GNUstep as easy as: ''pkg_add gnustep-desktop''
# configure your .xsession alike:

if [ -f /usr/local/share/GNUstep/Makefiles/GNUstep.sh ];then
. /usr/local/share/GNUstep/Makefiles/GNUstep.sh
fi
export GNUSTEP_STRING_ENCODING=NSUTF8StringEncoding
export LC_ALL='en_EN.UTF-8'
export LC_CTYPE='en_US.UTF-8'
if [ -x /usr/local/bin/gpbs ];then
/usr/local/bin/gpbs
fi
if [ -x /usr/local/bin/gdnc ];then
/usr/local/bin/gdnc
fi
wmaker &
if [ -x /usr/local/bin/GWorkspace ];then
/usr/local/bin/make_services
/usr/local/bin/GWorkspace
fi

With these simple steps, you'll have a working GNUstep development environment.

== Debugging ==
If you want to debug, you may want to install egdb from packages as well.
To ease debugging, it might make sense to have the gnustep library sources around, and those build with debugging symbols, to do so:
# add the following to your /etc/doas.conf file:
permit nopass keepenv :wsrc
permit nopass keepenv :wheel
## NOTE: this allows passwordless root for the main user
# echo "echo 'DEBUG=-g -O0'" > /etc/mk.conf
# echo "echo 'SUDO=doas'" >> /etc/mk.conf
# doas pkg_delete gnustep-base gnustep-libobjc2 gnustep-make
# download and extract the ports.tar.gz to /usr/ports
# cd /usr/ports/x11/gnustep/
# make install
# make patch

just reboot, or relogin, then you should have your GNUstep packages around, built with debugging symbols, as well as the sources on disk.
This will dramatically ease debugging using egdb.

== ProjectCenter and Gorm ==

GNUstep ProjectCenter and Gorm are tools for developing applications using the GNUstep framework.

* '''ProjectCenter''' is an integrated development environment (IDE) that helps developers manage their projects, providing tools to create, organize, and compile GNUstep applications. It simplifies the setup and management of project files, source code, and build configurations, making it easier to develop Objective-C applications.
* '''Gorm''': (GNUstep Object Relationship Modeler) is a visual interface builder similar to Apple's Interface Builder. It allows developers to design user interfaces by dragging and dropping UI components, connecting them to the application's code, and managing the relationships between UI elements and objects, without writing the UI code manually.

Together, these tools streamline the development of GNUstep-based applications by providing a cohesive environment for both project management and user interface design.

== Creating your Project ==
With all that prepared, you're now ready to create the basic project:

=== ProjectCenter ===
With either just gnustep-desktop package(s) installed, or even built by yourself from ports, you should now be able to just
start ProjectCenter from the command line, i.e. xterm window.

Once it's started, you want to configure it a bit, to ensure a smooth experience ;)

* Open the '''Preferences''' Build menu
** ensure '''External Build Tool''' points to ''/usr/local/bin/gmake'' or wherever your GNU Make is when you're not on OpenBSD. A BSD make just won't work.
* Open the '''Preferences''' Miscellaneous menu
** ensure '''Debugger''' points to ''/usr/local/bin/egdb'' or whatever is the right one for your platform
** ensure '''Editor''' is ''ProjectCenter''. That should be the default, you may use others, i.e. Gemas...

Now Open the ''Project'' -> ''New'' menu, select a suitable place where you want to have your project reside.
Ensure '''Project Type''' is set to '''Application''' and give it a name. We'll name our project '''DocumentBasedApp''' as you can see in the screenshot below.
(You may actually not want to choose /tmp as your destination folder ;)

MPDCon.app

2013-12-10T16:18:44Z

Buzzdee:

{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.5.1.tar.gz 1.5.1] |
releasedate = December 10, 2013 |
license = GPLv2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections
* browse collection by tag or filesystem layout
* Lyrics Inspector connecting to lyrics.wikia.com
* retrieved lyrics are cached in local SQLite3 database
* Song Inspector
* Rating of songs in the Playlist
* ratings are saved in SQLite3 database
* Playlist Inspector
* allows configuring a random feed to the playlist
* the random feed may be based on the song ratings

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://mpd.wikia.com/wiki/Client:MPDCon |
category = [[Category:Audio Applications]]
}}

MPDCon.app

2013-12-03T06:27:59Z

Buzzdee:

{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.5.tar.gz 1.5] |
releasedate = December 03, 2013 |
license = GPLv2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections
* browse collection by tag or filesystem layout
* Lyrics Inspector connecting to lyrics.wikia.com
* retrieved lyrics are cached in local SQLite3 database
* Song Inspector
* Rating of songs in the Playlist
* ratings are saved in SQLite3 database
* Playlist Inspector
* allows configuring a random feed to the playlist
* the random feed may be based on the song ratings

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://mpd.wikia.com/wiki/Client:MPDCon |
category = [[Category:Audio Applications]]
}}

Zipper.app

2013-04-21T14:35:10Z

Buzzdee:

{{stub}}

{{Application|

shortdescription = Tool for inspecting the contents of a compressed archive. |

currentversion = [http://savannah.nongnu.org/download/gap/Zipper-1.5.tar.gz 1.5] |

releasedate = April 21, 2013 |

license = GPL v2 or later |

overview = Zipper consists only of a single window, displaying the contents of the selected archive. Currently, you can view and extract .tar, .tar.gz, .tar.bz2, .rar, .lha, .lhz and .zip archives.

Since Version 1.4, Zipper moved to GAP in accordance to the original Author and changed its license to GPL v2+
|

features =

* Multi-document
* ZIP, TAR (and BSD tar), LHA, 7Zip, ACE, ARJ, ZOO
* TAR, LHA, 7Zip, ZIP and ZOO creation
* GWorkspace integration|

maintainer = GNUstep Application Project team |

relatedlinks =
* http://gap.nongnu.org/zipper/index.html |

category = [[Category:Archiver Applications]]
}}

Zipper.app

2013-04-21T14:34:52Z

Buzzdee:

{{stub}}

{{Application|

shortdescription = Tool for inspecting the contents of a compressed archive. |

currentversion = [http://savannah.nongnu.org/download/gap/Zipper-1.5.tar.gz 1.5] |

releasedate = April 21, 2013 |

license = GPL v2 or later |

overview = Zipper consists only of a single window, displaying the contents of the selected archive. Currently, you can view and extract .tar, .tar.gz, .tar.bz2, .rar, .lha, .lhz and .zip archives.

Sinve Version 1.4, Zipper moved to GAP in accordance to the original Author and changed its license to GPL v2+
|

features =

* Multi-document
* ZIP, TAR (and BSD tar), LHA, 7Zip, ACE, ARJ, ZOO
* TAR, LHA, 7Zip, ZIP and ZOO creation
* GWorkspace integration|

maintainer = GNUstep Application Project team |

relatedlinks =
* http://gap.nongnu.org/zipper/index.html |

category = [[Category:Archiver Applications]]
}}

Template:GNUstep News

2013-04-21T14:31:39Z

Buzzdee:

=== Apr 21 2013 ===
* '''[[Zipper.app]] 1.5'''
: ([http://gap.nongnu.org/zipper Zipper Homepage])

=== Apr 02 2013 ===
* '''GNUstep [[Gui]] 0.23.1 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-gui-0.23.1.tar.gz Download Gui])
* '''GNUstep [[Make]] 2.6.4 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-make-2.6.4.tar.gz Download Make])
* '''GNUstep [[Base]] 1.24.4 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-base-1.24.4.tar.gz Download Base])

=== Mar 02 2013 ===
* '''GNUstep [[Gui]] 0.23.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-gui-0.23.0.tar.gz Download Gui])
* '''GNUstep [[Back]] 0.23.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-back-0.23.0.tar.gz Download Back])
* '''GNUstep [[Make]] 2.6.3 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-make-2.6.3.tar.gz Download Make])
* '''GNUstep [[Base]] 1.24.3 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-base-1.24.3.tar.gz Download Base])

=== Oct 21 2012 ===
* '''[[MPDCon.app]] 1.3'''
: ([http://gap.nongnu.org/mpdcon MPDCon Homepage])

=== Oct 2 2012 ===
* '''[[FisicaLab.app]] 0.3.0'''
: ([http://www.nongnu.org/fisicalab/descargas_eng.html Download FisicaLab])

=== Sep 4 2012 ===
* '''GNUstep CoreBase 0.1.1 release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/libs/gnustep-corebase-0.1.1.tar.gz Download CoreBase])

=== Aug 21 2012 ===
* '''Windows Installer snapshot (unstable) update'''
: ([http://www.gnustep.org/experience/Windows.html 0.31.0 Release])

=== Jul 27 2012 ===
* '''GNUstep CoreBase 0.1.0 initial release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/libs/gnustep-corebase-0.1.tar.gz Download CoreBase])

=== Jul 27 2012 ===
* '''[[AddressManager.app]] 0.4.8'''
: New release

=== Jul 14 2012 ===
* '''Windows Installer update'''
: ([http://www.gnustep.org/experience/Windows.html 0.30.0 Release])

=== Jun 30 2012 ===
* '''[[Grr]] 1.0.0''' and RSSkit
: New releases

=== Jun 20 2012 ===
* '''[[PDFKit]] 0.9.2'''
: New release

=== Jun 13 2012 ===
* '''[[ProjectCenter.app]] 0.6.1'''
: Minor update release

=== Jun 09 2012 ===
* '''[[MPDCon.app]] 1.2'''
: First release from GAP

=== Jun 03 2012 ===
* '''[[GSPdf.app]] 0.5'''
: New maintenance release

* '''[[Terminal.app]] 0.9.8'''
: Maintenance release

=== May 31 2012 ===
* '''[[GWorkspace.app]] 0.9.1'''
: New release

=== May 24 2012 ===
* '''[[DataBasin.app]] 0.5'''
: New release, improved functions and bug fixes.

=== May 10 2012 ===
* '''[[Zipper.app]] 1.4'''
: First release from the GAP team.

=== May 01 2012 ===
* '''[[Graphos.app]] 0.3'''
: New release (modeless inspector, new improved file format...)

=== Apr 23 2012 ===
* '''[[PRICE.app]] 1.1.0'''
: New release (new filters, enhancements, bug and portability fixes)

=== Apr 09 2012 ===
* '''[[FisicaLab.app]] 0.2.2'''
: New release (bugfix for latest GNUstep packages)

=== Apr 06 2012 ===
* '''[[FTP.app]] 0.3'''
: New release

=== Mar 29 2012 ===
* '''GNUstep participates in Google Summer of Code 2012'''
: ([[Summer of Code 2012]])

=== Feb 17 2012 ===
* '''Windows Installer update'''
: ([http://www.gnustep.org/experience/Windows.html GNUstep-Core 0.29.1])

=== Feb 14 2012 ===
* '''Silver theme 2.5'''
: ([http://wiki.gnustep.org/images/6/6d/Silver.theme.tar.bz2 Silver theme])

=== Feb 14 2012 ===
* '''[[Gemas.app]] 0.3'''
: ([http://download.gna.org/gnustep-nonfsf/Gemas-0.3.tar.gz Download Gemas])
* '''[[HighlighterKit]] 0.1.2'''
: ([http://download.gna.org/gnustep-nonfsf/HighlighterKit-0.1.2.tar.gz Download HighlighterKit])
* '''HKThemes 1.0'''
: ([http://download.gna.org/gnustep-nonfsf/HKThemes-1.0.tar.gz Download HKThemes])

=== Feb 03 2012 ===
* '''GNUstep [[Gui]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-gui-0.22.0.tar.gz Download Gui])
* '''GNUstep [[Back]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-back-0.22.0.tar.gz Download Back])
* '''GNUstep [[Make]] 2.6.2 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-make-2.6.2.tar.gz Download Make])
* '''GNUstep [[Base]] 1.24.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-base-1.24.0.tar.gz Download Base])

Platform:BSD

2013-02-06T17:40:46Z

Buzzdee: /* 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).
 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/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, 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.

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

2013-02-06T05:35:07Z

Buzzdee: /* 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).
 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/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, 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.

=== 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 x11/gnustep part of the ports tree.

[[Category:Development]]

MPDCon.app

2012-12-30T16:49:22Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.4.tar.gz 1.4] |
releasedate = December 30, 2012 |
license = GPLv2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections
* Lyrics Inspector connecting to lyrics.wikia.com
* retrieved lyrics are cached in local SQLite3 database
* Song Inspector
* Rating of songs in the Playlist
* ratings are saved in SQLite3 database
* Playlist Inspector
* allows configuring a random feed to the playlist
* the random feed may be based on the song ratings

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://mpd.wikia.com/wiki/Client:MPDCon |
category = [[Category:Audio Applications]]
}}

MPDCon.app

2012-12-30T16:29:36Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.4.tar.gz 1.4] |
releasedate = December 30, 2012 |
license = GPLv2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections
* Lyrics Inspector connecting to lyrics.wikia.com
* retrieved lyrics are cached in local SQLite3 database
* Song Inspector
* Rating of songs in the Playlist
* ratings are saved in SQLite3 database
* Playlist Inspector
* allows configuring a random feed to the playlist
* the random feed may be based on the song ratings

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://www.musicpd.org/MPDCon.shtml |
category = [[Category:Audio Applications]]
}}

SQLClient

2012-12-30T16:05:54Z

Buzzdee:

{{Framework|

shortdescription = Lightweight database abstraction layer. |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/libs/SQLClient-1.6.0.tar.gz 1.6.0] |

releasedate = Nov 10, 2012 |

license = LGPL |

overview = The SQLClient library is designed to provide a simple interface to SQL
databases for GNUstep applications. It does not attempt the sort of
abstraction provided by the much more sophisticated GDL2 library
but rather allows applications to directly execute SQL queries and statements.

SQLClient provides for the Objective-C programmer much the same thing that
JDBC provides for the Java programmer (though SQLClient is a bit faster,
easier to use, and easier to add new database backends for than JDBC). |

features =
* Simple API for executing queries and statements... a variable length sequence of comma separated strings and other objects (NSNumber, NSDate, NSData) are concatenated into a single SQL statement and executed.
* Simple API for combining multiple SQL statements into a single transaction which can be used to minimise client-server interactions to get the best possible performance from your database.
* Supports multiple simultaneous named connections to a database server in a thread-safe manner.
* Supports multiple simultaneous connections to different database servers with backend driver bundles loaded for different database engines. Clear, simple subclassing of the abstract base class to enable easy implementation of new backend bundles.
* Configuration for all connections held in one place and referenced by connection name for ease of configuration control. Changes via NSUserDefaults can even allow reconfiguration of client instances within a running application.
* Thread safe operation... The base class supports locking such that a single instance can be shared between multiple threads.
* Supports batching of statements into a single transaction to minimise client-server interaction overheads.
* Has backends for PostgreSQL, MySQL, SQLite and JDBC (the latter allowing you to use any database for which JDBC drivers exist , but suffering from the performance overhead of going through Java). |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Database Frameworks]]
}}

Template:GNUstep News

2012-10-21T10:32:05Z

Buzzdee: new version 1.3 of MPDCon

=== Oct 21 2012 ===
* '''[[MPDCon.app]] 1.3'''
: ([http://gap.nongnu.org/mpdcon MPDCon Homepage])

=== Oct 2 2012 ===
* '''[[FisicaLab.app]] 0.3.0'''
: ([http://www.nongnu.org/fisicalab/descargas_eng.html Download FisicaLab])

=== Sep 4 2012 ===
* '''GNUstep CoreBase 0.1.1 release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/libs/gnustep-corebase-0.1.1.tar.gz Download CoreBase])

=== Aug 21 2012 ===
* '''Windows Installer snapshot (unstable) update'''
: ([http://www.gnustep.org/experience/Windows.html 0.31.0 Release])

=== Jul 27 2012 ===
* '''GNUstep CoreBase 0.1.0 initial release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/libs/gnustep-corebase-0.1.tar.gz Download CoreBase])

=== Jul 27 2012 ===
* '''[[AddressManager.app]] 0.4.8'''
: New release

=== Jul 14 2012 ===
* '''Windows Installer update'''
: ([http://www.gnustep.org/experience/Windows.html 0.30.0 Release])

=== Jun 30 2012 ===
* '''[[Grr]] 1.0.0''' and RSSkit
: New releases

=== Jun 20 2012 ===
* '''[[PDFKit]] 0.9.2'''
: New release

=== Jun 13 2012 ===
* '''[[ProjectCenter.app]] 0.6.1'''
: Minor update release

=== Jun 09 2012 ===
* '''[[MPDCon.app]] 1.2'''
: First release from GAP

=== Jun 03 2012 ===
* '''[[GSPdf.app]] 0.5'''
: New maintenance release

* '''[[Terminal.app]] 0.9.8'''
: Maintenance release

=== May 31 2012 ===
* '''[[GWorkspace.app]] 0.9.1'''
: New release

=== May 24 2012 ===
* '''[[DataBasin.app]] 0.5'''
: New release, improved functions and bug fixes.

=== May 10 2012 ===
* '''[[Zipper.app]] 1.4'''
: First release from the GAP team.

=== May 01 2012 ===
* '''[[Graphos.app]] 0.3'''
: New release (modeless inspector, new improved file format...)

=== Apr 23 2012 ===
* '''[[PRICE.app]] 1.1.0'''
: New release (new filters, enhancements, bug and portability fixes)

=== Apr 09 2012 ===
* '''[[FisicaLab.app]] 0.2.2'''
: New release (bugfix for latest GNUstep packages)

=== Apr 06 2012 ===
* '''[[FTP.app]] 0.3'''
: New release

=== Mar 29 2012 ===
* '''GNUstep participates in Google Summer of Code 2012'''
: ([[Summer of Code 2012]])

=== Feb 17 2012 ===
* '''Windows Installer update'''
: ([http://www.gnustep.org/experience/Windows.html GNUstep-Core 0.29.1])

=== Feb 14 2012 ===
* '''Silver theme 2.5'''
: ([http://wiki.gnustep.org/images/6/6d/Silver.theme.tar.bz2 Silver theme])

=== Feb 14 2012 ===
* '''[[Gemas.app]] 0.3'''
: ([http://download.gna.org/gnustep-nonfsf/Gemas-0.3.tar.gz Download Gemas])
* '''[[HighlighterKit]] 0.1.2'''
: ([http://download.gna.org/gnustep-nonfsf/HighlighterKit-0.1.2.tar.gz Download HighlighterKit])
* '''HKThemes 1.0'''
: ([http://download.gna.org/gnustep-nonfsf/HKThemes-1.0.tar.gz Download HKThemes])

=== Feb 03 2012 ===
* '''GNUstep [[Gui]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-gui-0.22.0.tar.gz Download Gui])
* '''GNUstep [[Back]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-back-0.22.0.tar.gz Download Back])
* '''GNUstep [[Make]] 2.6.2 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-make-2.6.2.tar.gz Download Make])
* '''GNUstep [[Base]] 1.24.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-base-1.24.0.tar.gz Download Base])

MPDCon.app

2012-10-21T10:30:06Z

Buzzdee: new version 1.3

{{stub}}
{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.3.tar.gz 1.3] |
releasedate = October 21, 2012 |
license = GPLv2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections
* Lyrics Inspector connecting to lyrics.wikia.com
* Song Inspector

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://www.musicpd.org/MPDCon.shtml |
category = [[Category:Audio Applications]]
}}

Paje.app

2012-06-19T18:05:11Z

Buzzdee: Update Version and download link

{{Application|
shortdescription = Pajé is an interactive and scalable trace-based visualization tool which can be used for a large variety of visualizations including performance monitoring of parallel applications, monitoring the execution of processors in a large scale PC cluster or representing the behavior of distributed applications. |
currentversion = [http://downloads.sourceforge.net/project/paje/Releases/Paje-1.98.tar.gz 1.98] |
releasedate = December 20, 2011 |
license = LGPL |
overview = Users of Pajé can tailor the visualization to their needs, without having to know any insight nor to modify any component of Pajé. This can be done by defining the type hierarchy of objects to be visualized as well as how these objects should be visualized. This feature allows the use of Pajé for a wide variety of visualizations such as the use of resources by applications in a large-size cluster or the behavior of distributed Java applications. |
features = |
maintainer =
* Benhur Stein
* Vincent Danjean
* Edmar Pessoa Araújo Neto
* Geovani Ricardo Wiedenhoft
* Gregory Mounie |
relatedlinks =
* [http://www-id.imag.fr/Logiciels/paje/index.html Paje's Official Web Site]
* [http://www-id.imag.fr/Logiciels/paje/usermanual.html Paje User Manual] |
category = [[Category:Science_Applications]]
}}

MPDCon.app

2012-06-09T17:55:50Z

Buzzdee: Release 1.2

{{stub}}
{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://savannah.nongnu.org/download/gap/MPDCon-1.2.tar.gz 1.2] |
releasedate = June 09, 2012 |
license = GPL2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections

|
maintainer = Daniel Luederwald (initial Author), now GAP Team |
relatedlinks =
* http://www.musicpd.org/MPDCon.shtml |
category = [[Category:Audio Applications]]
}}

Template:GNUstep News

2012-06-09T17:51:15Z

Buzzdee: Added MPDCon release

=== Jun 09 2012 ===
* '''[[MPDCon.app]] 1.2'''
: First release from GAP

=== Jun 03 2012 ===
* '''[[GSPdf.app]] 0.5'''
: New maintenance release

* '''[[Terminal.app]] 0.9.8'''
: Maintenance release

=== May 31 2012 ===
* '''[[GWorkspace.app]] 0.9.1'''
: New release

=== May 24 2012 ===
* '''[[DataBasin.app]] 0.5'''
: New release, improved functions and bug fixes.

=== May 10 2012 ===
* '''[[Zipper.app]] 1.4'''
: First release from the GAP team.

=== May 01 2012 ===
* '''[[Graphos.app]] 0.3'''
: New release (modeless inspector, new improved file format...)

=== Apr 23 2012 ===
* '''[[PRICE.app]] 1.1.0'''
: New release (new filters, enhancements, bug and portability fixes)

=== Apr 09 2012 ===
* '''[[FisicaLab.app]] 0.2.2'''
: New release (bugfix for latest GNUstep packages)

=== Apr 06 2012 ===
* '''[[FTP.app]] 0.3'''
: New release

=== Mar 29 2012 ===
* '''GNUstep participates in Google Summer of Code 2012'''
: ([[Summer of Code 2012]])

=== Feb 17 2012 ===
* '''Windows Installer update'''
: ([http://www.gnustep.org/experience/Windows.html GNUstep-Core 0.29.1])

=== Feb 14 2012 ===
* '''Silver theme 2.5'''
: ([http://wiki.gnustep.org/images/6/6d/Silver.theme.tar.bz2 Silver theme])

=== Feb 14 2012 ===
* '''[[Gemas.app]] 0.3'''
: ([http://download.gna.org/gnustep-nonfsf/Gemas-0.3.tar.gz Download Gemas])
* '''[[HighlighterKit]] 0.1.2'''
: ([http://download.gna.org/gnustep-nonfsf/HighlighterKit-0.1.2.tar.gz Download HighlighterKit])
* '''HKThemes 1.0'''
: ([http://download.gna.org/gnustep-nonfsf/HKThemes-1.0.tar.gz Download HKThemes])

=== Feb 03 2012 ===
* '''GNUstep [[Gui]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-gui-0.22.0.tar.gz Download Gui])
* '''GNUstep [[Back]] 0.22.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-back-0.22.0.tar.gz Download Back])
* '''GNUstep [[Make]] 2.6.2 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-make-2.6.2.tar.gz Download Make])
* '''GNUstep [[Base]] 1.24.0 stable release'''
: ([ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-base-1.24.0.tar.gz Download Base])

FOSDEM 2012

2012-02-13T08:08:46Z

Buzzdee: /* Schedule */

== FOSDEM 2012 Announcement ==

[http://fosdem.org/2012/ FOSDEM 2012] will take place at at the '''Université Libre de Bruxelles''', in '''Brussels''' on '''Saturday 4 and Sunday 5 February 2012'''.

This page is for organizing GNUstep's participation in the event. This includes the organization of a developer meeting
the Friday before FOSDEM.

== Organizer(s) ==

* Lars Sonchocky-Helldorf (lars dot sonchocky dash helldorf at hamburg dot de)
* is somebody else interested in lending me a hand?

== Who will attend FOSDEM ==

One of the main reasons people attend the event is that you can meet, and talk directly to, other developers, whom you would otherwise meet only virtually (on mailing lists, emails, newsgroups, IRC etc.). We expect many lead developers and contributors to be present, so if you have never met them, you shouldn't miss this occasion!

The following is a list of people of GNUstep fame who have confirmed (or denied) that they will be able to join us at the GNUstep meeting at FOSDEM 2012:

{| border="1"
! Name
! Friday
3. Feb
! Saturday
4. Feb
! Sunday
5. Feb
! Monday
6. Feb
! Special comments / topics
! Hotel

|-
| Lars S.-Helldorf ||| Yes || Yes || Yes || No || event organizer || Argus
|-
| Nikolaus Schaller || No || Yes || Yes || No || QuantumSTEP + Openmoko / GTA04.org || Argus
|-
| Quentin Mathé || Yes || Yes || Yes || No || Étoilé ||
|-
| Niels Grewe || || || || || Étoilé, DBusKit ||
|-
| David Chisnall || || || || || Étoilé ||
|-
| Sebastian Reitenbach || Yes || Yes || Yes || No || OpenBSD packages, GAP, OpenGroupware || Hotel The Moon
|-
| Nicolas Roard || || || || ? || Étoilé ||
|-
| Fred Kiefer || Yes || Yes || Yes || No || GNUstep (GUI, Cairo) || Hotel Aqua
|-
| Riccardo Mottola || || || || ? || GNUstep, GAP ||
|-
| Gerold Rupprecht || ? || Yes || Yes || ? || GNUstep ||
|-
| Richard Frith-Macdonald || Late || Yes || Yes || No || GNUstep || Argus
|-
| N.N. || t.b.d. || t.b.d. || t.b.d. || t.b.d. || t.b.d. ||
|}

== Dev-Room Presentations and Events ==

The room at out disposal will be '''AW1.126''' (capacity is 72 seats (this is more than twice of what we had the years ago); in the building "AW"),
-- on '''Saturday 2011-02-04''' from (to be confirmed) '''11:00''' to '''19:00'''

=== Call for participation ===

We are looking for people who want to give a talk, moderate a discussion, hold a hand ons (practice) / hacking session or organize a code sprint. Please send your proposals to [mailto:discuss-gnustep@gnu.org GNUstep discussion list], the organizers mentioned [[FOSDEM_2011#Organizers|above]] or - if you've got a wiki account - enter them right [http://wiki.gnustep.org/index.php?title=FOSDEM_2011&action=edit&section=6 here]. At first a title, a short summary, proposed duration and a preffered time slot would do, so we can start scheduling as soon as possible.

'''deadline for filing is t.b.d., deadline for the papers is t.b.d.'''

'''Note:''' The FOSDEM organizers strongly recommend a '''granularity of 15 minute blocks'''. So if a talk is just 15 (lightning talk), 30 or 45 minutes long - fine! But we should have 15 minutes breaks between the talks so that the visitors have enough time to find a seat and the presenters have enough time to get ready.

=== List of submitted talk/discussion/session proposals ===

Please submit through *[mailto:discuss-gnustep@gnu.org GNUstep discussion list]* until *2011-12-31*

=== Wishlist for talks/discussions/sessions ===

Enter talks/discussions/sessions here you would be interested in.

* GNUstep Progresses and Roadmap
* CoreBase and CoreGraphics/Opal in GNUstep

=== Schedule ===

{| border="1"
!width="65pt"| Time Slot !! width="130pt"| Author !! width="360pt"| Title / Abstract !! width="130pt"| Kind !! width="40pt" | Slides
|-
| colspan="5" style="background:#ddd;" | '''Saturday, Feb 04, 2012'''
|-
| 11:00 - 11:15 || GNUstep Developers || '''GNUstep Developer's Meeting'''

Meet the GNUstep developers face to face, discuss current afairs of GNUstep, share news about the latest development and plans on GNUstep, improve collaboration between the several GNUstep related projects

|| meeting, discussion || -
|-
| 11:15 - 11:45 || Sebastian Reitenbach || '''OpenBSD GNUstep ports update'''

Topics covered:
* Why the hell on OpenBSD
* How easy it is to create a new GNUstep port
* What's new compared to last year
* Problems I encountered over the last year
* Goals for the next year

|| talk || [[Image:OpenBSD-ports-FOSDEM-2012.pdf]]
|-
| 12:00 - 12:30 || Sebastian Reitenbach || '''OpenGroupware - Phoenix from the ashes'''

Topics covered:
* short history of OpenGroupware, overview of its features
* porting effort from gnustep-make 1 to gnustep-make 2, and from libFoundation to gnustep-base
* OpenGroupware is now based on SOPE fork from the SOGo team, lots of bugs in SOPE got fixed
* talk about some new features
* OpenGroupware-5.5rc1 (I hope to agree with Adam to release it even before the FOSDEM)
* short Demo

|| talk || [[Image:OpenGroupware-FOSDEM-2012.pdf]]
|-
| 12:45 - 13:30 || Sebastian Reitenbach || '''A GNUstep Applications Overview'''

* it will feature GAP (GNUstep Application Project)
** introduce the project, and its goals
** cover some of the applications found there
* it will also include the usual known suspects: GWorkspace, ProjectCenter, Gorm, ...
* it will also cover some other nice GNUstep applications found scattered all over the web, for example:
** CDPlayer, Burn, GNUMail, SimpleAgenda, Zipper and more
* show/demonstrate some of the applications live

|| talk || t.b.d. link to slides
|-
| 13:45 - 14:15 || Fred Kiefer || '''GNUstep GUI: Recent Developments - Graphics and Text'''

* New features in the text system this year
* Resolution Independence/scale factor support
* Other graphics improvements
* Demo

|| talk || [[Image:Gnustep-gui-FOSDEM-2012.pdf]]
|-
| 14:30 - 15:00 || Quentin Mathé || '''Étoilé: What has been done over the past year and what's next?'''

In this presentation, we will take a look at the Étoilé progresses over the past year. We will summarize our work on both our core frameworks and GNUstep. We will also discuss the project status in a broader way, and what can be expected in 2012.

|| talk || t.b.d. link to slides
|-
| 15:15 - 16:00 || Richard Frith-Macdonald || '''Enterprise Control, Configuration and Logging/Alarming using GNUstep-base'''

1. An overview of the problem of dealing with multiple server processes on multiple hosts and sites. How to provide fault tolerance and how to scale up without losing control.
2. A discussion of the use of the basic technologies such as Distributed Objects and property lists etc to implement these systems.
3. Control ... how we start/stop server processes, prevent duplication of processes, support automated restart, and query the state of processes.
4. Configuration ... how we provide specific configuration to each process under central control, yet allow those servers to operate independently.
5. Logging/Alarming ... how we provide and manage simple and consistent audit/debug logging facilities for server processes, and how we integrate with SNMP.

|| talk || t.b.d. link to slides
|-
| 16:15 - 17:00 || Quentin Mathé || '''CoreObject : An Object Store built for Revision Control and Desktop Environment Needs'''

This talk will introduce CoreObject, an Object Store built from the ground up to support features such as selective undo, live collaboration without locking, branching, etc. not found in Object-Oriented Databases until now. CoreObject is not based on Operational Transformations but a new Object Graph Diffing and Merging model, that makes possible to integrate these revision control features into a database and ensure they scale to large object histories.
From a desktop environment perspective, revision tracks are available to create interactive views on the history and support multiple undo/redo granularity levels. CoreObject also comes with a collection of reusable object models to solve recurrent use cases in document management, organization and edition.

|| talk || t.b.d. link to slides
|-
| 17:15 - 18:00 || David Chisnall || '''New Features of Objective-C'''

With iOS 5 and OS X 10.7, Apple introduced a number of new Objective-C features. With the release of version 1.6 of the GNUstep Objective-C runtime and version 3.0 of clang these are now all available to GNUstep developers. The new features include better data hiding, automatic reference counting, and a number of other features. This talk will cover these features, as well as some of the extensions beyond Apple's version and the improvements in Objective-C performance since FOSDEM last year.

|| talk || [http://www.fosdem.org/2012/schedule/event/new_objc_features link to slides]
|-
| 18:15 - 19:00 || Dr. H. Nikolaus Schaller || '''QuantumSTEP: new frameworks and future directions'''

QuantumSTEP is a technology study framework and application
suite that is partially based on GNUstep. It aims at consequently
using Objective-C on embedded and portable devices. This talk
describes the latest additions to the frameworks: CoreLocation,
MKMapKit, CoreWLAN, CoreTelephony and demonstrates how
they work on the new GTA04 hardware.

|| talk || t.b.d. link to slides
|}

== Suggested Hotels ==

last year Sebastian Reitenbach and Nikolaus Schaller have booked here. Ask them on the mailing list on their Experience:

=== Louise Hotel ===
* 40, rue Veydt
* 1050 Bruxelles
* http://www.louisehotel.com/
* Sebastian Reitenbach says:
** book via: http://www.hotelreservierungen.de , which is cheaper than the offer on the hotel site. The reservation includes breakfast.
** free WiFi is available
** it costs only about half the price of the Argus hotel from last year.
** Its near avenue louise, only a foot walk away from the university campus.

NOTE Dec 2011: appears to have changed owner and is no longer listed in online booking portals

=== Argus Hotel Brussels (Belguim) (good experiences from past years) ===
*6, Rue Capitaine Crespel
*B-1050 Bruxelles, Belgique
*Tel +32 2 514 07 70
*Fax +32 2 514 12 22
*reception@hotel-argus.be
*Rate: 65/night - but you have to ask for the 'GNUstep/FOSDEM' discount
*has free Internet ;-)

Normal prices are here:

http://www.hotel-argus.be/ukrates.htm

but there are discounts available:

http://www.hotel-argus.be/ukpromotions.htm

and we'll ask for even better discounts for a group booking (we need to know who's will be there for that!)

Some people booked that hotel in the last years: Nicolas, Marcus, Helge ,Lars.

=== Sun Hotel in Brussels (Belguim) (not recommended) ===
*Rue du Berger, 38
*1050 Brussels (near Porte de Namur)
*Tel : +32(0)2 511 21 19
*Fax : +32(0)2 512 32 71
*sunhotel@skynet.be
*www.hotels-belgium.com/brussel-al/sunhotel.htm

*50 EUR/Single room with breakfast
*22 rooms total
*3km distance to University

has internet access, will make breakfast room available for developers after 11:00 am. Two electrical plugs for breakfast room, so need extension cord with additional plugs. Ask for first or second floor rooms close to reception for good wifi connections.

=== Hotel Sabina in Brussels (Belgium)===
*Rue du Nord 78
*B-1000 Brussels
*Tel: (32)2 218 26 37
*Fax: (32)2 219 32 39
(very good rating by visitors)
63 EUR/Single with breakfast
8 single only + 16 double rooms
4,2km distance

=== Hotel Mozart in Bruxelles (Belgium)===
*Rue Marché aux Fromages 23
*B-1000 Brussels
*Tel +32 2 502 66 61
*Fax +32 2 502 77 58
*Email Hotel.mozart@skynet.be
http://www.hotels-belgium.com/brussel-center/mozart.htm

70 EUR/Single room NO breakfast
WLAN

51 rooms total
4,2km distance

We are open to other suggestions. Please take into account distance to the University and access to public transportation.

----
A quick introduction to Brussels:
http://wikitravel.org/en/Brussel

----

[[Category:FOSDEM]]

{| style="background: #ff958e;"
| If you want to participate, you need to [[Special:Userlogin|create an account]] and send a mail with your user name to ''<tt>gnustep-webmasters [AT] gnu.org</tt>'' to request write-access. We are sorry for the inconvenience, but this procedure has become necessary to prevent SPAM'ing of this site.
|}

File:Gnustep-gui-FOSDEM-2012.pdf

2012-02-13T08:05:03Z

Buzzdee: GUI improvements talk FOSDEM 2012

GUI improvements talk FOSDEM 2012

File:OpenGroupware-FOSDEM-2012.pdf

2012-02-13T08:04:11Z

Buzzdee: Slides of the OpenGroupware talk FOSDEM 2012

Slides of the OpenGroupware talk FOSDEM 2012

File:OpenBSD-ports-FOSDEM-2012.pdf

2012-02-13T08:03:20Z

Buzzdee: FOSDEM 2012 slides for OpenBSD ports update

FOSDEM 2012 slides for OpenBSD ports update

FOSDEM 2012

2012-01-26T18:20:01Z

Buzzdee: /* Who will attend FOSDEM */

== FOSDEM 2012 Announcement ==

[http://fosdem.org/2012/ FOSDEM 2012] will take place at at the '''Université Libre de Bruxelles''', in '''Brussels''' on '''Saturday 4 and Sunday 5 February 2012'''.

This page is for organizing GNUstep's participation in the event. This includes the organization of a developer meeting
the Friday before FOSDEM.

== Organizer(s) ==

* Lars Sonchocky-Helldorf (lars dot sonchocky dash helldorf at hamburg dot de)
* is somebody else interested in lending me a hand?

== Who will attend FOSDEM ==

One of the main reasons people attend the event is that you can meet, and talk directly to, other developers, whom you would otherwise meet only virtually (on mailing lists, emails, newsgroups, IRC etc.). We expect many lead developers and contributors to be present, so if you have never met them, you shouldn't miss this occasion!

The following is a list of people of GNUstep fame who have confirmed (or denied) that they will be able to join us at the GNUstep meeting at FOSDEM 2012:

{| border="1"
! Name
! Friday
3. Feb
! Saturday
4. Feb
! Sunday
5. Feb
! Monday
6. Feb
! Special comments / topics
! Hotel

|-
| Lars S.-Helldorf ||| Yes || Yes || Yes || No || event organizer || Argus
|-
| Nikolaus Schaller || No || Yes || Yes || No || QuantumSTEP + Openmoko / GTA04.org || Argus
|-
| Quentin Mathé || Yes || Yes || Yes || No || Étoilé ||
|-
| Niels Grewe || || || || || Étoilé, DBusKit ||
|-
| David Chisnall || || || || || Étoilé ||
|-
| Sebastian Reitenbach || Yes || Yes || Yes || No || OpenBSD packages, GAP, OpenGroupware || Hotel The Moon
|-
| Nicolas Roard || || || || ? || Étoilé ||
|-
| Fred Kiefer || YES || YES || YES || NO || GNUstep (GUI, Cairo) || Hotel Aqua
|-
| Riccardo Mottola || || || || ? || GNUstep, GAP ||
|-
| Gerold Rupprecht || || || || ? || GNUstep ||
|-
| Richard Frith-Macdonald || Yes || Yes || Yes || No || GNUstep || Argus
|-
| N.N. || t.b.d. || t.b.d. || t.b.d. || t.b.d. || t.b.d. ||
|}

== Dev-Room Presentations and Events ==

The room at out disposal will be '''AW1.126''' (capacity is 72 seats (this is more than twice of what we had the years ago); in the building "AW"),
-- on '''Saturday 2011-02-04''' from (to be confirmed) '''11:00''' to '''19:00'''

=== Call for participation ===

We are looking for people who want to give a talk, moderate a discussion, hold a hand ons (practice) / hacking session or organize a code sprint. Please send your proposals to [mailto:discuss-gnustep@gnu.org GNUstep discussion list], the organizers mentioned [[FOSDEM_2011#Organizers|above]] or - if you've got a wiki account - enter them right [http://wiki.gnustep.org/index.php?title=FOSDEM_2011&action=edit&section=6 here]. At first a title, a short summary, proposed duration and a preffered time slot would do, so we can start scheduling as soon as possible.

'''deadline for filing is t.b.d., deadline for the papers is t.b.d.'''

'''Note:''' The FOSDEM organizers strongly recommend a '''granularity of 15 minute blocks'''. So if a talk is just 15 (lightning talk), 30 or 45 minutes long - fine! But we should have 15 minutes breaks between the talks so that the visitors have enough time to find a seat and the presenters have enough time to get ready.

=== List of submitted talk/discussion/session proposals ===

Please submit through *[mailto:discuss-gnustep@gnu.org GNUstep discussion list]* until *2011-12-31*

=== Wishlist for talks/discussions/sessions ===

Enter talks/discussions/sessions here you would be interested in.

* GNUstep Progresses and Roadmap
* CoreBase and CoreGraphics/Opal in GNUstep

=== Schedule ===

{| border="1"
!width="65pt"| Time Slot !! width="130pt"| Author !! width="360pt"| Title / Abstract !! width="130pt"| Kind !! width="40pt" | Slides
|-
| colspan="5" style="background:#ddd;" | '''Saturday, Feb 04, 2012'''
|-
| 11:00 - 11:15 || GNUstep Developers || '''GNUstep Developer's Meeting'''

Meet the GNUstep developers face to face, discuss current afairs of GNUstep, share news about the latest development and plans on GNUstep, improve collaboration between the several GNUstep related projects

|| meeting, discussion || -
|-
| 11:15 - 11:45 || Sebastian Reitenbach || '''OpenBSD GNUstep ports update'''

Topics covered:
* Why the hell on OpenBSD
* How easy it is to create a new GNUstep port
* What's new compared to last year
* Problems I encountered over the last year
* Goals for the next year

|| talk || t.b.d. link to slides
|-
| 12:00 - 12:30 || Sebastian Reitenbach || '''OpenGroupware - Phoenix from the ashes'''

Topics covered:
* short history of OpenGroupware, overview of its features
* porting effort from gnustep-make 1 to gnustep-make 2, and from libFoundation to gnustep-base
* OpenGroupware is now based on SOPE fork from the SOGo team, lots of bugs in SOPE got fixed
* talk about some new features
* OpenGroupware-5.5rc1 (I hope to agree with Adam to release it even before the FOSDEM)
* short Demo

|| talk || t.b.d. link to slides
|-
| 12:45 - 13:30 || Sebastian Reitenbach || '''A GNUstep Applications Overview'''

* it will feature GAP (GNUstep Application Project)
** introduce the project, and its goals
** cover some of the applications found there
* it will also include the usual known suspects: GWorkspace, ProjectCenter, Gorm, ...
* it will also cover some other nice GNUstep applications found scattered all over the web, for example:
** CDPlayer, Burn, GNUMail, SimpleAgenda, Zipper and more
* show/demonstrate some of the applications live

|| talk || t.b.d. link to slides
|-
| 13:45 - 14:15 || Fred Kiefer || '''GNUstep GUI: Recent Developments - Graphics and Text'''

* New features in the text system this year
* Resolution Independence/scale factor support
* Other graphics improvements
* Demo

|| talk || t.b.d. link to slides
|-
| 14:30 - 15:00 || Quentin Mathé || '''Étoilé: What has been done over the past year and what's next?'''

In this presentation, we will take a look at the Étoilé progresses over the past year. We will summarize our work on both our core frameworks and GNUstep. We will also discuss the project status in a broader way, and what can be expected in 2012.

|| talk || t.b.d. link to slides
|-
| 15:15 - 16:00 || Richard Frith-Macdonald || '''Enterprise Control, Configuration and Logging/Alarming using GNUstep-base'''

1. An overview of the problem of dealing with multiple server processes on multiple hosts and sites. How to provide fault tolerance and how to scale up without losing control.
2. A discussion of the use of the basic technologies such as Distributed Objects and property lists etc to implement these systems.
3. Control ... how we start/stop server processes, prevent duplication of processes, support automated restart, and query the state of processes.
4. Configuration ... how we provide specific configuration to each process under central control, yet allow those servers to operate independently.
5. Logging/Alarming ... how we provide and manage simple and consistent audit/debug logging facilities for server processes, and how we integrate with SNMP.

|| talk || t.b.d. link to slides
|-
| 16:15 - 17:00 || Quentin Mathé || '''CoreObject : An Object Store built for Revision Control and Desktop Environment Needs'''

This talk will introduce CoreObject, an Object Store built from the ground up to support features such as selective undo, live collaboration without locking, branching, etc. not found in Object-Oriented Databases until now. CoreObject is not based on Operational Transformations but a new Object Graph Diffing and Merging model, that makes possible to integrate these revision control features into a database and ensure they scale to large object histories.
From a desktop environment perspective, revision tracks are available to create interactive views on the history and support multiple undo/redo granularity levels. CoreObject also comes with a collection of reusable object models to solve recurrent use cases in document management, organization and edition.

|| talk || t.b.d. link to slides
|-
| 17:15 - 18:00 || David Chisnall || '''New Features of Objective-C'''

With iOS 5 and OS X 10.7, Apple introduced a number of new Objective-C features. With the release of version 1.6 of the GNUstep Objective-C runtime and version 3.0 of clang these are now all available to GNUstep developers. The new features include better data hiding, automatic reference counting, and a number of other features. This talk will cover these features, as well as some of the extensions beyond Apple's version and the improvements in Objective-C performance since FOSDEM last year.

|| talk || t.b.d. link to slides
|-
| 18:15 - 19:00 || Dr. H. Nikolaus Schaller || '''QuantumSTEP: new frameworks and future directions'''

QuantumSTEP is a technology study framework and application
suite that is partially based on GNUstep. It aims at consequently
using Objective-C on embedded and portable devices. This talk
describes the latest additions to the frameworks: CoreLocation,
MKMapKit, CoreWLAN, CoreTelephony and demonstrates how
they work on the new GTA04 hardware.

|| talk || t.b.d. link to slides
|}

== Suggested Hotels ==

last year Sebastian Reitenbach and Nikolaus Schaller have booked here. Ask them on the mailing list on their Experience:

=== Louise Hotel ===
* 40, rue Veydt
* 1050 Bruxelles
* http://www.louisehotel.com/
* Sebastian Reitenbach says:
** book via: http://www.hotelreservierungen.de , which is cheaper than the offer on the hotel site. The reservation includes breakfast.
** free WiFi is available
** it costs only about half the price of the Argus hotel from last year.
** Its near avenue louise, only a foot walk away from the university campus.

NOTE Dec 2011: appears to have changed owner and is no longer listed in online booking portals

=== Argus Hotel Brussels (Belguim) (good experiences from past years) ===
*6, Rue Capitaine Crespel
*B-1050 Bruxelles, Belgique
*Tel +32 2 514 07 70
*Fax +32 2 514 12 22
*reception@hotel-argus.be
*Rate: 65/night - but you have to ask for the 'GNUstep/FOSDEM' discount
*has free Internet ;-)

Normal prices are here:

http://www.hotel-argus.be/ukrates.htm

but there are discounts available:

http://www.hotel-argus.be/ukpromotions.htm

and we'll ask for even better discounts for a group booking (we need to know who's will be there for that!)

Some people booked that hotel in the last years: Nicolas, Marcus, Helge ,Lars.

=== Sun Hotel in Brussels (Belguim) (not recommended) ===
*Rue du Berger, 38
*1050 Brussels (near Porte de Namur)
*Tel : +32(0)2 511 21 19
*Fax : +32(0)2 512 32 71
*sunhotel@skynet.be
*www.hotels-belgium.com/brussel-al/sunhotel.htm

*50 EUR/Single room with breakfast
*22 rooms total
*3km distance to University

has internet access, will make breakfast room available for developers after 11:00 am. Two electrical plugs for breakfast room, so need extension cord with additional plugs. Ask for first or second floor rooms close to reception for good wifi connections.

=== Hotel Sabina in Brussels (Belgium)===
*Rue du Nord 78
*B-1000 Brussels
*Tel: (32)2 218 26 37
*Fax: (32)2 219 32 39
(very good rating by visitors)
63 EUR/Single with breakfast
8 single only + 16 double rooms
4,2km distance

=== Hotel Mozart in Bruxelles (Belgium)===
*Rue Marché aux Fromages 23
*B-1000 Brussels
*Tel +32 2 502 66 61
*Fax +32 2 502 77 58
*Email Hotel.mozart@skynet.be
http://www.hotels-belgium.com/brussel-center/mozart.htm

70 EUR/Single room NO breakfast
WLAN

51 rooms total
4,2km distance

We are open to other suggestions. Please take into account distance to the University and access to public transportation.

----
A quick introduction to Brussels:
http://wikitravel.org/en/Brussel

----

[[Category:FOSDEM]]

{| style="background: #ff958e;"
| If you want to participate, you need to [[Special:Userlogin|create an account]] and send a mail with your user name to ''<tt>webmasters [AT] gnustep.org</tt>'' to request write-access. We are sorry for the inconvenience, but this procedure has become necessary to prevent SPAM'ing of this site.
|}

ImageViewer.app

2012-01-19T17:43:46Z

Buzzdee:

{{stub}}

{{Application|

shortdescription = ImageViewer is a small application which display images. |

currentversion = [http://www.nice.ch/~phip/ImageViewer-0.6.3.tar.gz 0.6.3] |

releasedate = Aug 1, 2003 |

license = GPL 2 |

overview = Image viewing application
|

features =
* can open single files
* or all files in directories (also recursively)
* "List and view directories Pictures" Service
* Image Inspector
|

maintainer = Philippe Robert |

relatedlinks = http://www.nice.ch/~phip/softcorner.html#img |

category = [[Category:Graphics Applications]]
}}

Vespucci.app

2012-01-15T16:30:49Z

Buzzdee:

{{Application|
shortdescription = Vespucci is a simple Web Browser using WebKit or [[SimpleWebKit]] |

currentversion = 0.1 |

releasedate = not yet released |

license = GPLv2 or later|

overview = Vespucci is a browser for the World Wide Web. |

features =

* multiple-document support, with recent document list
* standard back/forward buttons
* bookmarks, in Safari-compatible format (it can read safari bookmarks directly)
* Workspace integration
* webloc link file support (just copy over the file from Mac)
* Open URL service

Vespucci can be built against Apple's WebKit (currently on Macintosh only) and against GNUstep's [[SimpleWebKit]] |

maintainer = rmottola@users.sf.net |

relatedlinks =
* [http://gap.nongnu.org/vespucci/index.html Vespucci in GAP] |
category = [[Category:Network Applications]] [[Category:Workspace Applications]]
}}

Ink.app

2012-01-15T16:10:04Z

Buzzdee:

{{stub}}

{{Application|

shortdescription = Ink is the GNUstep editor. |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-examples-1.3.0.tar.gz GNUStep Examples 1.3.0]|

releasedate = Feb 02, 2010 |

license = GPL 2 |

overview = Ink is a basic editor for rtf(d) and plain text. Its main purpose is to demonstrate how to build a document-centered application by subclassing [[NSDocument]]. |

features =
* printing
* spell checker

|

maintainer = Fred Kiefer |

relatedlinks =
*[http://www.gnustep.org/experience/examples.html GNUStep Examples page]
* [http://gnustep.blogspot.com/2008/01/ink-gnustep-text-editor-and-services.html Ink, a GNUstep text editor, and services]|

category = [[Category:Editor Applications]]
}}

Ink.app

2012-01-15T16:07:49Z

Buzzdee:

{{stub}}

{{Application|

shortdescription = Ink is the GNUstep editor. |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/core/gnustep-examples-1.3.0.tar.gz GNUStep Examples 1.3.0]|

releasedate = Feb 02, 2010 |

license = GPL 2 |

overview = Ink is a basic editor for rtf(d) and plain text. Its main purpose is to demonstrate how to build a document-centered application by subclassing [[NSDocument]]. |

features = |

maintainer = Fred Kiefer |

relatedlinks =
*[http://www.gnustep.org/experience/examples.html GNUStep Examples page]
* [http://gnustep.blogspot.com/2008/01/ink-gnustep-text-editor-and-services.html Ink, a GNUstep text editor, and services]|

category = [[Category:Editor Applications]]
}}

MPDCon.app

2012-01-15T16:04:04Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = A GNUstep MPD client. |
currentversion = [http://heanet.dl.sourceforge.net/sourceforge/mpdcon/MPDCon-1.1.99.tar.gz 1.1.99] |
releasedate = Mar 13, 2006 |
license = GPL2 |
overview = A client for the Music Player Daemon (MPD) |
features =
* connects to an MPD server
* Playlist and Collections

|
maintainer = Daniel Luederwald |
relatedlinks =
* http://www.musicpd.org/MPDCon.shtml |
category = [[Category:Audio Applications]]
}}

FOSDEM 2012

2011-12-30T08:51:39Z

Buzzdee: /* Who will attend FOSDEM */

FOSDEM 2012

2011-12-30T08:49:52Z

Buzzdee: /* Who will attend FOSDEM */

WebServer

2011-12-21T17:43:44Z

Buzzdee:

{{Framework|
shortdescription = Framework for a GNUstep program to act as an HTTP or HTTPS server. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/WebServer-1.4.6.tar.gz 1.4.6] |

releasedate = Dec 14, 2011 |

license = LGPL |

overview = This provides a class to do all the heavy lifting of acting as a web server handling the HTTP and HTTPS protocols. You just need to create an instance of it in your program, configure it with a port it is to listen on, and set another object in your program to act as a delegate. The delegate then handles the pre-parsed incoming requests in a similar way to a CGI script being run by a more conventional web server. The library also handles logging and provides many configuration options and helper methods of course. |

features =
* Robust single threaded default operation, for ease of debugging your programs
* Minimal configuration required
* Parses parameter strings in requests
* Parses URL encoded form data
* Parses multi-part form data
* Supports SSL
* Supports basic authentication
* Supports substitution of values into html templates
* Provides logging |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}

Performance

2011-12-12T11:25:16Z

Buzzdee:

{{Framework|
shortdescription = Help improve the performance of GNUstep applications. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/Performance-0.3.2.tar.gz 0.3.2] |

releasedate = Oct 25, 2011 |

license = LGPL |

overview = A collection of classes to help improve/tune performance of your software |

features =
* The GSThroughput class allows you to track the total counts of transactions/events as well as the rate (per second) and the minimum, maximum and average durations of operations. You can look at this information to see how your program ha been performing over a particular time period, and to isolate frequently used operations which may need optimizing.
* The GSCache class provides effective caching for all sorts of data. You can configure the size (memory footprint) and/or maximum number of items in a cache, and you can specify the lifetime of objects in the cache. Cache removal is done on a least-recently-used flushed first basis, but hooks are provided to override that. The status of one or all caches can be easily reported, showing the size and the number of cache hits/misses.
* Provides a method to obtain a skip-list based NSMutableArray subclass. This is intended for use where you need a large array which you are going to insert/delete items from. The insertion/deletion operation in a skip-list array is similar in performance to a linked list (ie much faster than a conventional array), but the time to access an item at an arbitrary index, while not as slow as a conventional array, is enormously faster than a simple linked list implementation. |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Development Frameworks]]
}}

Performance

2011-12-12T11:24:35Z

Buzzdee:

{{Framework|
shortdescription = Help improve the performance of GNUstep applications. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/Performance-0.3.2.tar.gz 0.3.2] |

releasedate = Oct 25, 2011 |

license = LGPL |

overview = A collection of classes to help improve/tune performance of your software |

features =
* The GSThroughput class allows you to track the total counts of transactions/events as well as the rate (per second) and the minimum, maximum and average durations of operations. You can look at this information to see how your program ha been performing over a particular time period, and to isolate frequently used operations which may need optimising.
* The GSCache class provides effective caching for all sorts of data. You can configure the size (memory footprint) and/or maximum number of items in a cache, and you can specify the lifetime of objects in the cache. Cache removal is done on a least-recently-used flushed first basis, but hooks are provided to override that. The status of one or all caches can be easily reported, showing the size and the number of cache hits/misses.
* Provides a method to obtain a skip-list based NSMutableArray subclass. This is intended for use where you need a large arraay which you are going to insert/delete items from. The insertion/deletion operation in a skip-list array is similar in performance to a linked list (ie much faster than a conventional array), but the time to access an item at an arbitrary index, while not as slow as a conventional array, is enormously faster than a simple linked list implementaqtion. |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Development Frameworks]]
}}

MathArray

2011-11-16T12:11:43Z

Buzzdee:

{{Framework|
shortdescription = Class library for mathematical manipulation of matrices. |
currentversion = [ftp://ftp.gnustep.org/pub/gnustep/contrib/MathArray-1.2.tar.gz 1.2] |
releasedate = Oct 09, 2010 |
license = LGPL 2 |
overview = MathArray is a general library of classes for performing mathematical
operations on arrays (vectors, matrices, etc) of values. It can
operate on any standard 'C' number type plus numbers of complex
type. [...] MathArray knows implicitly what types of operations can
be performed on what types of numbers and will automatically cast
itself to the correct number type representation to handle the
specific operation. Standard operations include addition, scalar and
matrix multiplication and logical operations. Mathematical operations
in the standard C math library are also supported, as well as
user-defined functions.
 – From the README file. |
features = <...> |
maintainer = Adam Fedor |
relatedlinks =
* [ftp://ftp.gnustep.org/pub/gnustep/contrib/MathArray-1.0.README README]|
category = [[Category:Development Frameworks]]
}}

DataBasin.app

2011-11-02T17:59:37Z

Buzzdee:

{{Application|
shortdescription = DataBasin is a data access tool and for SalesForce.com based on the SOAP API interfaces.|

currentversion = [http://savannah.nongnu.org/download/gap/DataBasin-0.4.tar.gz 0.4] |
releasedate = Nov 02, 2011 |
license = DataBasin: GPL / Soap Core: LGPL v3+ |

maintainer = Riccardo Mottola |

overview =

DataBasin is a tool to access and work with SalesForce.com. It allows to perform queries remotely, export and import data.
[[Image:databasin_01_debian.png|thumb|v0.1 session on Debian]]
To connect to SFDC, DataBasin uses the WebServices exposed by the SFDC API and exposes them as methods of the DBSoap class. Currently not all methods are implemented yet. To send and receive the SOAP messages, DB uses the websevices (GSWS) available from GNUstep libraries and which is a mandatory requisite.
|

features =
* Reusable core library
* Session and User inspectors
* connect via http or https
* Data Operations
** Insert
** Query and QueryAll
** Quick Delete
** execute select on records identified by Id or Unique identifier
* Describe Object (and export to CSV)
|
relatedlinks = *[http://www.nongnu.org/gap/databasin/index.html DataBasin.app Website]
*[http://www.nongnu.org/gap/index.html GNUstep Application Project]|

category = [[Category:Database Applications]][[Category:GAP]]
}}

SQLClient

2011-10-09T08:48:37Z

Buzzdee:

{{Framework|

shortdescription = Lightweight database abstraction layer. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/SQLClient-1.5.3.tar.gz 1.5.3] |

releasedate = Sep 30, 2009 |

license = LGPL |

overview = The SQLClient library is designed to provide a simple interface to SQL
databases for GNUstep applications. It does not attempt the sort of
abstraction provided by the much more sophisticated GDL2 library
but rather allows applications to directly execute SQL queries and statements.

SQLClient provides for the Objective-C programmer much the same thing that
JDBC provides for the Java programmer (though SQLClient is a bit faster,
easier to use, and easier to add new database backends for than JDBC). |

features =
* Simple API for executing queries and statements... a variable length sequence of comma separated strings and other objects (NSNumber, NSDate, NSData) are concatenated into a single SQL statement and executed.
* Simple API for combining multiple SQL statements into a single transaction which can be used to minimise client-server interactions to get the best possible performance from your database.
* Supports multiple simultaneous named connections to a database server in a thread-safe manner.
* Supports multiple simultaneous connections to different database servers with backend driver bundles loaded for different database engines. Clear, simple subclassing of the abstract base class to enable easy implementation of new backend bundles.
* Configuration for all connections held in one place and referenced by connection name for ease of configuration control. Changes via NSUserDefaults can even allow reconfiguration of client instances within a running application.
* Thread safe operation... The base class supports locking such that a single instance can be shared between multiple threads.
* Supports batching of statements into a single transaction to minimise client-server interaction overheads.
* Has backends for PostgreSQL, MySQL, SQLite and JDBC (the latter allowing you to use any database for which JDBC drivers exist , but suffering from the performance overhead of going through Java). |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Database Frameworks]]
}}

GWorkspace.app

2011-09-30T17:07:45Z

Buzzdee:

{{Application|
shortdescription = GWorkspace is the official GNUstep workspace manager. |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/usr-apps/gworkspace-0.9.0.tar.gz 0.9.0] |

releasedate = September 30, 2011 |

license = GPL 2.0 or later|

overview = GWorkspace is a clone of NeXT's workspace manager and already ready for daily usage. GWorkspace is one of the most useful and usable workspace managers available on any platform, owing to its well-designed interface and the natural, consistent design that it inherits from the GNUstep framework. |

features = Currently GWorkspace is a very stable application and can be used as your file manager for daily usage.

==== Additional Inspectors ====

===== IMImage =====

IMImage image Inspector for GWorkspace.app to preview many types of
graphics formats not supported by NSImage utilizing Image Magick. The
following graphics formats are currently supported: art, bmp, cgm,
eps, fig, fpx, hpgl, ico, miff, mng, mvg, pbm, pcd, pcl, pcx, pgm,
pict, pix, pnm, ppm, psd, rla, rle, svg, tga, wmf, wpg, xbm, xcf, xpm,
and xwd. It can also be used to preview Type 1 and TrueType fonts.
* [http://www.gnustep.it/enrico/gworkspace/inspectors/IMImageViewer.tar.gz Download IMImage]

===== SGContentViewer =====

A contents Inspector that can play Ogg Vorbis, mp3, speex, flac, shorten, voc, midi, and mod files.
* [http://www.gnustep.it/enrico/gworkspace/inspectors/SGContentViewer.tar.gz Download SGContentViewer]

===== RpmViewer =====

A contents Inspector to see the contents of rpm packages.
* [http://www.gnustep.it/enrico/gworkspace/inspectors/RpmViewer.tar.gz Download RpmViewer]

===== VCFViewer =====

A contents Inspector for VCF files.
* [http://www.gnustep.it/enrico/gworkspace/inspectors/VCFViewer.tar.gz Download VCFViewer] |

maintainer =
* [mailto:rmottola@users.sf.net Riccardo Mottola] |

relatedlinks =
* [http://www.gnustep.org/experience/GWorkspace.html GWorkspace's Official Web Site]
* [http://gnustep.made-it.com/GWorkspace/GWorkspace.html GWorkspace User Guide] |

category = [[Category:Workspace Applications]] [[Category:Desktop Environments]]
}}

SQLClient

2011-09-16T12:45:25Z

Buzzdee:

{{Framework|

shortdescription = Lightweight database abstraction layer. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/SQLClient-1.5.2.tar.gz 1.5.2] |

releasedate = Sep 16, 2006 |

license = LGPL |

overview = The SQLClient library is designed to provide a simple interface to SQL
databases for GNUstep applications. It does not attempt the sort of
abstraction provided by the much more sophisticated GDL2 library
but rather allows applications to directly execute SQL queries and statements.

SQLClient provides for the Objective-C programmer much the same thing that
JDBC provides for the Java programmer (though SQLClient is a bit faster,
easier to use, and easier to add new database backends for than JDBC). |

features =
* Simple API for executing queries and statements... a variable length sequence of comma separated strings and other objects (NSNumber, NSDate, NSData) are concatenated into a single SQL statement and executed.
* Simple API for combining multiple SQL statements into a single transaction which can be used to minimise client-server interactions to get the best possible performance from your database.
* Supports multiple simultaneous named connections to a database server in a thread-safe manner.
* Supports multiple simultaneous connections to different database servers with backend driver bundles loaded for different database engines. Clear, simple subclassing of the abstract base class to enable easy implementation of new backend bundles.
* Configuration for all connections held in one place and referenced by connection name for ease of configuration control. Changes via NSUserDefaults can even allow reconfiguration of client instances within a running application.
* Thread safe operation... The base class supports locking such that a single instance can be shared between multiple threads.
* Supports batching of statements into a single transaction to minimise client-server interaction overheads.
* Has backends for PostgreSQL, MySQL, SQLite and JDBC (the latter allowing you to use any database for which JDBC drivers exist , but suffering from the performance overhead of going through Java). |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Database Frameworks]]
}}

WebServer

2011-09-16T12:44:28Z

Buzzdee:

{{Framework|
shortdescription = Framework for a GNUstep program to act as an HTTP or HTTPS server. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/WebServer-1.4.4.tar.gz 1.4.4] |

releasedate = Sep 09, 2011 |

license = LGPL |

overview = This provides a class to do all the heavy lifting of acting as a web server handling the HTTP and HTTPS protocols. You just need to create an instance of it in your program, configure it with a port it is to listen on, and set another object in your program to act as a delegate. The delegate then handles the pre-parsed incoming requests in a similar way to a CGI script being run by a more conventional web server. The library also handles logging and provides many configuration options and helper methods of course. |

features =
* Robust single threaded default operation, for ease of debugging your programs
* Minimal configuration required
* Parses parameter strings in requests
* Parses URL encoded form data
* Parses multi-part form data
* Supports SSL
* Supports basic authentication
* Supports substitution of values into html templates
* Provides logging |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}

WebServer

2011-08-23T06:31:15Z

Buzzdee:

{{Framework|
shortdescription = Framework for a GNUstep program to act as an HTTP or HTTPS server. |

currentversion = [http://downloads.planetmirror.com/pub/gnustep/gnustep/libs/WebServer-1.4.3.tar.gz 1.4.3] |

releasedate = Aug 04, 2011 |

license = LGPL |

overview = This provides a class to do all the heavy lifting of acting as a web server handling the HTTP and HTTPS protocols. You just need to create an instance of it in your program, configure it with a port it is to listen on, and set another object in your program to act as a delegate. The delegate then handles the pre-parsed incoming requests in a similar way to a CGI script being run by a more conventional web server. The library also handles logging and provides many configuration options and helper methods of course. |

features =
* Robust single threaded default operation, for ease of debugging your programs
* Minimal configuration required
* Parses parameter strings in requests
* Parses URL encoded form data
* Parses multi-part form data
* Supports SSL
* Supports basic authentication
* Supports substitution of values into html templates
* Provides logging |

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}

GPuzzle.app

2011-07-19T12:40:24Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = Simulates a jigsaw puzzle and illustrates the use of clipping paths. |

currentversion = [http://www.gnustep.it/marko/GPuzzle2/GPuzzle2.tgz 0.2] |

releasedate = July 16, 2006 (?) |

license = GPL2 |

overview =

'''NOTE: GPuzzle was renamed to Jigsaw, latest version can be found when looking for [[Jigsaw.app]]'''

You need a medium-sized TIFF file to play this game.
Left-click and drag to move a piece or cluster.
Ctrl-left-click and drag to connect knobs to slots.
Right-click to disassemble a cluster.
Ctrl-right-click to extract a piece from a cluster. |

features = |

maintainer =
* [mailto:markoriedelde@yahoo.de Marko Riedel] |

relatedlinks =
* [http://www.gnustep.it/marko/GPuzzle2/ Official Page] |

category = [[Category:Games Applications]]
}}

Jigsaw.app

2011-07-19T12:36:38Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = Simulates a jigsaw puzzle and illustrates the use of clipping paths. |

currentversion = [http://savannah.nongnu.org/download/gap/Jigsaw-0.8.tar.gz 0.8] |

releasedate = July 18, 2011 |

license = GPL2 |

overview = You need a medium-sized TIFF file to play this game.
Left-click and drag to move a piece or cluster.
Ctrl-left-click and drag to connect knobs to slots.
Right-click to disassemble a cluster.
Ctrl-right-click to extract a piece from a cluster. |

features = |

maintainer =
* GAP Team
* original author: [mailto:markoriedelde@yahoo.de Marko Riedel] |

relatedlinks =
* [http://gap.nongnu.org/jigsaw/ Official Page] |

category = [[Category:Games Applications]]
}}

Sudoku.app

2011-07-16T11:33:34Z

Buzzdee:

{{stub}}

{{Application|
shortdescription= [[Image:Sudoku.png|frame|Sudoku on Gnome]] | Sudoku solver and generator. |

currentversion=[http://savannah.nongnu.org/download/gap/Sudoku-0.7.tar.gz 0.7] |

releasedate= July 15, 2011 |

license=GPL2 |

overview= Create any number of Sudokus and solve them. Store Sudokus for in-depth study.
Solvability guaranteed. Drag digits from the palette or click on the board
and wait for the desired digit to appear. Neither method will let you place
double digits.|

features= Includes automatic markup.
You can input external sudokus for solution.|

maintainer=
* GAP Team
* original author: [mailto:markoriedelde@yahoo.de Marko Riedel] |

relatedlinks=
* http://www.nongnu.org/gap/sudoku/index.html |
category=[[Category:Games_Applications]][[Category:GAP]]
}}

GMastermind.app

2011-07-16T11:28:25Z

Buzzdee:

{{stub}}
{{Application|
shortdescription = The well-known mastermind game. |

currentversion = [http://savannah.nongnu.org/download/gap/GMastermind-0.6.tar.gz 0.6] |

releasedate = July 15, 2011 |

license = GPL2 |

overview = Drag-and-drop colors from the palette or from the board itself. The object is to determine the hidden combination of four colors. The game may be played in two modes: with replacement, which means that colors may repeat, and without replacement, which means that colors are unique. The user selects a choice of four colors and "commits" them. The program replies with an evaluation -- a black peg for a color that is placed correctly, and a white peg for a color that is in the wrong position. The user may make a total of eight queries. |

features = Two panels, one containing guesses and one containing sources of the six colors.
[[Image:GMastermind.jpg]]
|

maintainer =
* GAP team
* original author: [mailto:markoriedelde@yahoo.de Marko Riedel] |

relatedlinks =
* [http://gap.nongnu.org/gmastermind/ Official Page] |

category = [[Category:Games Applications]]
}}

LapisPuzzle.app

2011-07-16T11:24:43Z

Buzzdee:

{{stub}}
{{Application|
shortdescription=LapisPuzzle is a [http://en.wikipedia.org/wiki/Tetris Tetris]-like game where each player is effected by the others game play. When one player clears blocks, the other gets more put on! Attractive graphics as well.|

currentversion=[http://savannah.nongnu.org/download/gap/LapisPuzzle-1.2.tar.gz 1.2]|

releasedate= July 15, 2011 |

license=GPL 2.0|

overview=|

features=|

maintainer=
* GAP Team
* originally written by [mailto:object@gmail.com Banlu Kemiyatorn]|

relatedlinks=
* http://www.nongnu.org/gap/lapispuzzle/index.html|

category=[[Category:Games_Applications]][[Category:GAP]]
}}

GMines.app

2011-07-11T08:13:53Z

Buzzdee: new release on GAP

{{stub}}

{{Application|

shortdescription = The well-known minesweeper game. |

currentversion = 0.2|

releasedate = 2011-07-11 |

license = GPLv2+ |

overview = Minimal implementation of 8x8 minesweeper game. |

features = |

original author = Marko Riedel |

maintainer = GAP Team |

relatedlinks = http://gap.nongnu.org/gmines/ |

category = [[Category:Games Applications]]
}}

WebServices

2011-06-26T11:06:37Z

Buzzdee:

{{stub}}

{{Framework|
shortdescription = Framework for a GNUstep program to interact with web services |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/libs/WebServices-0.5.3.tar.gz 0.5.3] |

releasedate = Jun 26, 2010 |

license = LGPL |

overview =

The WebServices library contains a collection of classes to be used for creating client and server 'web service' applications. It is also useful for general XML work as the API that is particularly simple and efficient.

The GWSService class is used to make RPCs as a client. This class makes use of GWSCoder classes to serialize the request before sending it to the remote system, and to deserialize the response received.

Different GWSCoder sublasses handle different encoding mechanisms, and this library provides one for XMLRPC (because it's a nice, simple mechanism good for most normal applications), and one for SOAP (because, while it's a horrible, bloated, designed-by-comittee mechanism, it's also the most common one by far and the standard one for web services).

The GWSCoder base class provides support for decoding an XML document to a tree of GWSElement objects, and encoding a tree of GWSElement objects to form an XML document.

The GWSElement class represents an element in an XML document and provides a concise set of methods for locating and manipulating the elements within a tree representing the entire document.

The remaining classes in the library provide support for WSDL, allowing a WSDL document to be parsed, and SOAP calls to be made to a service described in the WSDL, with binding information from the WSDL used to build the calls from a minimal set of parameters.
|

features =
* Easy/simple ObjectiveC API for parsing/generating XML documents, XMLRPC and SOAP remote procedure call support, WSDL support, GNUstep and OSX|

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}

WebServices

2011-06-26T11:05:27Z

Buzzdee:

{{stub}}

{{Framework|
shortdescription = Framework for a GNUstep program to interact with web services |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/libs/WebServices-0.5.3.tar.gz 0.5.3] |

releasedate = Jun 26, 2010 |

license = LGPL |

overview =

The WebServices library contains a collection of classes to be used for creating client and server 'web service' applications. it is also useful for general XML work as the API that that is particularly simple and efficient.

The GWSService class is used to make RPCs as a client. This class makes use of GWSCoder classes to serialize the request before sending it to the remote system, and to deserialize the response received.

Different GWSCoder sublasses handle different encoding mechanisms, and this library provides one for XMLRPC (because it's a nice, simple mechanism good for most normal applications), and one for SOAP (because, while it's a horrible, bloated, designed-by-comittee mechanism, it's also the most common one by far and the standard one for web services).

The GWSCoder base class provides support for decoding an XML document to a tree of GWSElement objects, and encoding a tree of GWSElement objects to form an XML document.

The GWSElement class represents an element in an XML document and provides a concise set of methods for locating and manipulating the elements within a tree representing the entire document.

The remaining classes in the library provide support for WSDL, allowing a WSDL document to be parsed, and SOAP calls to be made to a service described in the WSDL, with binding information from the WSDL used to build the calls from a minimal set of parameters.
|

features =
* Easy/simple ObjectiveC API for parsing/generating XML documents, XMLRPC and SOAP remote procedure call support, WSDL support, GNUstep and OSX|

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}

WebServices

2011-06-26T10:42:01Z

Buzzdee:

{{stub}}

{{Framework|
shortdescription = Framework for a GNUstep program to interact with web services |

currentversion = [ftp://ftp.gnustep.org/pub/gnustep/libs/WebServices-0.5.3.tar.gz 0.5.3] |

releasedate = Jun 26, 2010 |

license = LGPL |

overview =

The WebServer library contains a collection of classes to be used for creating client and server 'web service' applications. it is also useful for general XML work as the API that that is particularly simple and efficient.

The GWSService class is used to make RPCs as a client. This class makes use of GWSCoder classes to serialize the request before sending it to the remote system, and to deserialize the response received.

Different GWSCoder sublasses handle different encoding mechanisms, and this library provides one for XMLRPC (because it's a nice, simple mechanism good for most normal applications), and one for SOAP (because, while it's a horrible, bloated, designed-by-comittee mechanism, it's also the most common one by far and the standard one for web services).

The GWSCoder base class provides support for decoding an XML document to a tree of GWSElement objects, and encoding a tree of GWSElement objects to form an XML document.

The GWSElement class represents an element in an XML document and provides a concise set of methods for locating and manipulating the elements within a tree representing the entire document.

The remaining classes in the library provide support for WSDL, allowing a WSDL document to be parsed, and SOAP calls to be made to a service described in the WSDL, with binding information from the WSDL used to build the calls from a minimal set of parameters.
|

features =
* Easy/simple ObjectiveC API for parsing/generating XML documents, XMLRPC and SOAP remote procedure call support, WSDL support, GNUstep and OSX|

maintainer = Richard Frith-Macdonald |

relatedlinks = |

category = [[Category:Networking Frameworks]]
}}