Gnome Developers' Information

Horacio Peña

<horape@compendium.com.ar>

Table of Contents

1. Introduction..

Feedback..
What is GNOME..
This document.

2. Non (very) technical issues.

Programming languages that can be used in GNOME.
How to start hacking GNOME.
What to hack.
Obtaining a CVS account.
Policy on hacking another people's code.
When adding yourself to AUTHORS file.
Coding Standards.

3. GNOME Developer's Tutorial.

Starting with GNOME

Adding menus

Internationalization.

Parsing parameters.

Session Management

Session Management in general
GNOME Session Management implementation
Continuing the tutorial

Help and documentation.

4. Architecture notes.

5. GNOME library.

gnome-config

Author(s)
Description
Glossary
gnome_config_*get_* - routines to retrieve information for a specified config path.
gnome_config_set_* - routines to store information for a specified config path.
gnome_config_has_section - Checks whether a config section exists
gnome_config_init_iterator - Setup an iterator to get a listing of items in a specified config section.
gnome_config_init_iterator - Setup an iterator to get a listing of sections in a specified config section.
gnome_config_iterator_next - get the next item from an iterator
gnome_config_drop_all - drops all the cached config data from the in-memory cache
gnome_config_sync - writes all unwritten config entries to the config database
gnome_config_*clean_* - routines for removing a configuration database entry or subtree altogether
gnome_config_*get_real_path

gnome-defs

Description

gnome-dentry

Description

gnome-fileconvert

Description

gnome-help

Description

gnome-history

Description

gnome-hook

Description

gnome-i18n

Description

gnome-mime

Description

gnome-score

Description

gnome-string

Description

gnome-triggers

Description

gnome-util

Description

libgnome

Description

6. GNOME User Interface library.

gnome-about - "About..." Widget

Author(s)
Description
gnome_about_new - Main routine that creates the widget

gnome-actionarea

Description

gnome-app

Description

gnome-client

Description

gnome-color-selector

Description

gnome-dns

Description

gnome-font-selector

Description
FontInfo - struct is defined in gnome-fontsel.c
gnome_font_selector_get_selected - You should free this retval up after you're done with it
gnome_font_select

gnome-ice

Description
gnome_ice_init

gnome-messagebox

Description

gnome-net

Description

gnome-pixmap

Description

gnome-properties

Description

gnome-scores - "High Scores" Widget

Author(s)
Description
Usage
gnome_scores_display - Does all the work of displaying the best scores.
gnome_scores_new - Creates the high-scores window.
gnome_scores_set_logo_label - Creates a label to be the logo
gnome_scores_set_logo_pixmap - Creates a pixmap to be the logo
gnome_scores_set_logo_widget - Set an arbitrary widget to be the logo.
gnome_scores_set_color - Set the color of one entry.
gnome_scores_set_def_color - Set the default color of the entries.
gnome_scores_set_colors - Set the color of all the entries.
gnome_scores_set_logo_label_title - Creates a label to be the logo
gnome_scores_set_current_player - Set the index of the current player in top ten.

gnome-session

Description

gnome-startup

Description

gnome-stock-imlib

Description
imlib_new - toolbar pixmaps
imlib_ok - button pixmaps
imlib_menu_new - menu pixmaps

gnome-stock-xpm - XPM

Description
gnome_stock_cancel_xpm - XPM
gnome_stock_menu_about_xpm - XPM
gnome_stock_menu_exit_xpm - XPM
gnome_stock_menu_new_xpm - XPM
menu_cut_xpm - XPM
menu_copy_xpm - XPM
menu_paste_xpm - XPM
menu_prop_xpm - XPM
menu_open_xpm - XPM
menu_save_xpm - XPM
menu_blank_xpm - XPM

gnome-stock

Description
GnomeStockPixmapEntryAny - some internal definitions
GnomeStockPixmapWidget - the GnomeStockPixmapWidget
gnome_stock_pixmap - just fetch a pixmap
gnome_stock_pixmap_widget - just fetch a GnomeStockPixmapWidget
gnome_stock_pixmap_register - register a pixmap. returns non-zero, if successful
gnome_stock_pixmap_change - change an existing entry. returns non-zero on success
gnome_stock_pixmap_checkfor
gnome_stock_button - returns a default button widget for dialogs
gnome_stock_menu_item - returns a GtkMenuItem with an stock icon and text

gtk-clock

Description

gtk-ted

Description

libgnomeui

Description

7. Automatic menu and toolbar creation with GnomeAppHelper

Introduction

A quick example of using GnomeAppHelper

The GnomeUIInfo structure

Convenience macros to fill GnomeUIInfo structures

Format information for the configuration of keybindings for standard mens

Functions provided by GnomeAppHelper

gnome_app_find_menu_pos - return position of a menu item
gnome_app_remove_menus - remove a number of menu items
gnome_app_insert_menus - insert menu structure in a GnomeApp's menubar

8. The GnomeCanvas widget

Introduction

Organization of items

Stacking order
Behavior and events

Coordinates

Zooming and scale

Attributes and object arguments

Getting started with the canvas

9. Talking to the user: GnomeDialog, GnomeMessageBox, GnomeAppBar, and utility functions.

Introduction

Using GnomeAppBar directly

Creating an AppBar
Using a GnomeAppBar to display status
Using an AppBar to query the user

The abstract message utility functions

Utility functions if a GnomeApp is available

Using GnomeDialog directly

Creating a dialog
Closing the dialog
Dialog options
Modal dialogs

10. Basic X concepts

Drawables
Visuals
Graphics contexts
Event-driven programming

11. LibGnorba Documentation

GOAD (Gnome Object Activation Directory)

Author(s)
Description
goad_server_list_get - get a listing of objects which we know how to bootstrap
goad_server_activate - get a specified server
goad_server_activate_with_repo_id - get a server that offers a specified interface.

ORBit-Gtk

Author(s)
Description
gnome_CORBA_init initialize ORBit and GNOME for use in a program.
gnome_name_service_get - retrieves an object reference to the root name service context for the current GNOME session

gnome-plugins

12. Gnome-MDI (Gnome Multi Document Interface)

Authors

Description

gnome_mdi_new - create a new GnomeMDI object
gnome_mdi_set_mode - set GnomeMDI mode
gnome_mdi_set_tab_pos - set the position of the MDI notebook tabs
gnome_mdi_set_menu_template - set the template for MDI menus
gnome_mdi_set_toolbar_template - set the template for MDI toolbar
gnome_mdi_set_child_menu_path - sets the path for child-specific menus
gnome_mdi_set_child_list_path - sets the menu path for the list of children
gnome_mdi_add_view - adds a new view to the MDI
gnome_mdi_add_toplevel_view - adds a new view to the MDI in a new toplevel window
gnome_mdi_remove_view - removes an existing view from the MDI
gnome_mdi_active_view - returns a pointer to the last active view
gnome_mdi_set_active_view - sets the active view
gnome_mdi_add_child - adds a new child to an MDI
gnome_mdi_remove_child - removes a child from the MDI
gnome_mdi_remove_all - removes all children from the MDI
gnome_mdi_update_child - updates a child when its name changes
gnome_mdi_active_child - returns the active child
gnome_mdi_find_child - returns a named child
gnome_mdi_open_toplevel - opens a new toplevel window
gnome_mdi_register - registers a GtkObject with MDI
gnome_mdi_unregister - removes a GtkObject from the list of registered objects
gnome_mdi_get_app_from_view - retrieves a view's toplevel window
gnome_mdi_get_child_from_view - retrieves a view's child
gnome_mdi_get_view_from_window - retrieves a view from a certain window

		Next
		Introduction..