From 491be3601de2fd229011828feadfd3d8c6d83d20 Mon Sep 17 00:00:00 2001 From: Matthias Clasen Date: Sun, 6 Jul 2008 04:17:36 +0000 Subject: [PATCH] Mention Vala svn path=/trunk/; revision=7165 --- docs/reference/ChangeLog | 7 +++++ docs/reference/gobject/tut_tools.xml | 53 ++++++++++++++++++++++++++---------- 2 files changed, 46 insertions(+), 14 deletions(-) diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 6877e43..74b57e5 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,5 +1,12 @@ 2008-07-05 Matthias Clasen + Bug 521589 – [RFC] gobject documentation should mention Vala + + * gobject/tut_tools.xml: Add a reference to Vala. + Patch by Marc-Andre Lureau. + +2008-07-05 Matthias Clasen + * glib/glib-sections.txt: Move g_strcmp0 to a more appropriate place in the docs. diff --git a/docs/reference/gobject/tut_tools.xml b/docs/reference/gobject/tut_tools.xml index 1da3c08..7b3a41d 100644 --- a/docs/reference/gobject/tut_tools.xml +++ b/docs/reference/gobject/tut_tools.xml @@ -1,25 +1,51 @@ - Several useful developer tools have been build around GObject technology. - The next sections briefly introduce them and link to the respective project pages. + Several useful developer tools have been build around GObject + technology. The next sections briefly introduce them and link to + the respective project pages. + + + + For example, writing GObjects is often seen as a tedious task. It + requires a lot of typing and just doing a copy/paste requires a + great deal of care. A lot of projects and scripts have been + written to generate GObject skeleton form boilerplate code, or + even translating higher-level language into plain C. + + Vala + + From the Vala + homepage itself: Vala is a new programming language + that aims to bring modern programming language features to GNOME + developers without imposing any additional runtime requirements + and without using a different ABI compared to applications and + libraries written in C. + + + + The syntax of Vala is similar to C#. The available compiler + translates Vala into GObject C code. It can also compile + non-GObject C, using plain C API. + + + GObject builder - Writing GObjects can be a tedious task. It requires a lot of typing and just - doing a copy/paste requires a great deal of care. - One obvious idea is to use some sort of templates for the class skeletons. - and then run them through a special tool to generate the real C files. - GOB/ (or GOB2) is such - a tool. It is a preprocessor which can be used to build GObjects - with inline C code so that there is no need to edit the generated C code. - The syntax is inspired by Java and Yacc or Lex. The implementation is - intentionally kept simple: the inline C code provided by the user - is not parsed. + In order to help a GObject class developper, one obvious idea is + to use some sort of templates for the skeletons. and then run + them through a special tool to generate the real C files. GOB (or GOB2) is + such a tool. It is a preprocessor which can be used to build + GObjects with inline C code so that there is no need to edit the + generated C code. The syntax is inspired by Java and Yacc or + Lex. The implementation is intentionally kept simple: the inline C + code provided by the user is not parsed. @@ -34,7 +60,6 @@ - Debugging reference count problems @@ -43,7 +68,7 @@ a few memory management problems but also introduces new sources of bugs. In large applications, finding the exact spot where the reference count of an Object is not properly handled can be very difficult. Hopefully, - there exist a tool named refdbg/ + there exist a tool named refdbg which can be used to automate the task of tracking down the location of invalid code with regard to reference counting. This application intercepts the reference counting calls and tries to detect invalid behavior. -- 2.7.4