1. Codename Graphite

An attempt to make a definitive reference guide for users and developers.

1.1. Introduction

1. Who Should Read This Document
2. The GNOME Family

1.2. Platform Overview

1. Core Technologies
2. IPC and Networking
3. Desktop Technologies

   (All the above: http://developer.gnome.org/doc/guides/platform-overview/platform-overview.html )

1.3. Core Technologies

1. Basic Foundations
   1. glib

      • http://developer.gnome.org/doc/API/2.0/glib/index.html

2. Graphical Interfaces
   1. GTK+

      • http://developer.gnome.org/doc/GGAD/cha-gtk.html

      • http://developer.gnome.org/doc/API/2.0/gtk/index.html

   2. Libglade

      • http://developer.gnome.org/doc/API/2.0/libglade/index.html

   3. Pango

      • http://developer.gnome.org/doc/API/2.0/pango/

   4. GDK

      • http://developer.gnome.org/doc/API/2.0/gdk/index.html

   5. Cairo

      • http://www.cairographics.org/manual/

3. Virtual File System
   • Either gnome-vfs or the new gvfs getting integrated (?) into glib. Wait for glib stuff?
4. Configuration and Lockdown
5. Internationalization
6. Accessibility

   • http://developer.gnome.org/projects/gap/guide/gad/

   • http://developer.gnome.org/projects/gap/testing/index.html

   • http://developer.gnome.org/projects/gap/presentations/GUAD3C/making-apps-accessible/start.html

7. Multimedia

   • http://www.freedesktop.org/wiki/Standards_2ficon_2dtheme_2dspec

8. Printing
   1. GNOME Print

      • http://www.gnome.org/~alexl/presentations/guadec2006-printing.pdf

      • http://www.j5live.com/?p=204

      • http://developer.gnome.org/doc/API/2.0/gtk/Printing.html

   2. CUPS

      • http://www.cups.org/doc-1.1/sum.html (?)

      • http://www.cups.org/book/index.php

      • Is CUPS in scope here?

1.4. IPC and Networking

1. Clipboards and Drag and Drop

   • http://www.newplanetsoftware.com/xdnd/

   • http://www.freedesktop.org/wiki/Standards_2fclipboards_2dspec

2. D-BUS Messaging

   • http://dbus.freedesktop.org/doc/dbus-tutorial.html

3. Bonobo and CORBA

   • http://developer.gnome.org/doc/guides/corba/

   • http://www.djcbsoftware.nl/projecten/bonobo-controls/bonobo-controls.html

   • http://www-128.ibm.com/developerworks/webservices/library/co-bnbo1.html

   • http://www-128.ibm.com/developerworks/webservices/library/co-bnbo2.html

   • http://www-128.ibm.com/developerworks/webservices/library/co-bnbo3.html

4. Service Discovery

   • http://www.avahi.org/wiki/ProgrammingDocs

5. XML and Web Services
   1. SOAP

      • http://www.cs.fsu.edu/~engelen/soap.html

   2. XML Processing

      • http://xmlsoft.org/tutorial/index.html

      • http://xmlsoft.org/html/libxml-lib.html

      • http://www.jamesh.id.au/articles/libxml-sax/libxml-sax.html

   3. Transforming XML with XSLT

      • http://xmlsoft.org/XSLT/tutorial/libxslttutorial.html

1.5. Desktop Technologies

1. Application and File Type Registries

   • http://www.freedesktop.org/wiki/Standards_2fdesktop_2dentry_2dspec

   • http://www.freedesktop.org/wiki/Standards_2fmenu_2dspec

   • http://www.freedesktop.org/wiki/Standards_2fbasedir_2dspec

2. Panel Applets

   • Google Cache of ps file

   • http://live.gnome.org/GnomeLove/PanelAppletTutorial

3. Notification Area

   • http://developer.gnome.org/projects/gup/hig/2.0/desktop-notification-area.html

4. File Manager
   • Where / how does this fit in?
5. Window Manager

   • http://developer.gnome.org/doc/standards/wm/book1.html

   • http://www.freedesktop.org/wiki/Standards_2fwm_2dspec

   • http://developer.gnome.org/doc/tutorials/metacity/metacity-themes.html

6. Control Center
7. Storing Passwords
8. Session Management
9. Address Book and Calendar
10. Usability

    • http://developer.gnome.org/projects/gup/hig/

11. Documentation

    • http://live.gnome.org/GnomeDocUtilsCreateNew

    • http://live.gnome.org/GnomeDocUtilsMigrationHowTo

1.6. Language Bindings

• General: http://developer.gnome.org/doc/guides/wrapper-friendly-api-guidelines/

• C++

  • http://gtkmm.org/docs/gtkmm-2.4/docs/tutorial/html/index.html

• Java

  • http://java-gnome.sourceforge.net/docs/GNOME-tutorial/index.html

• Perl

  • http://live.gnome.org/data/GTK2(2d)Perl(2f)GladeXML(2f)Tutorial/attachments/glade-article.pdf

• Python

  • http://pygtk.org/pygtk2tutorial/index.html

• C#

  • http://pubcrawler.org/2002/12/12/my-first-cgtkglade-application/

• Other Languages
  • D

1.7. Quick Module Overview

1. Platform Modules
2. Desktop Modules

1.8. Other stuff

• GNOME programming guidelines: http://developer.gnome.org/doc/guides/programming-guidelines/book1.html

• Optimising GNOME programs: http://developer.gnome.org/doc/guides/optimisation/intro.html

• Disk seeks harmful: http://developer.gnome.org/doc/guides/optimisation/harmful.html

• Memory profiling: http://developer.gnome.org/doc/guides/optimisation/Massif.html

1.9. Comments

• GNOME Hispano have a similar book in a quite advanced state. Maybe you want to contact RodrigoMoya to see if translating ES->EN could save work in some chapters. In any case coordination would be useful. -- QuimGil

• I'd love to see the "bindings" section integrated with other material. That'd make everyone 1st class citizens. Either that or make it clear in the first part and provide equivalent samples for everything somewhere. I know what I mean, and that's the important part. Leave me alone.

CategoryDocumentationProject