glib r7939 - in trunk: . docs/reference docs/reference/glib docs/reference/gobject gio gmodule gobject gthread po
- From: matthiasc svn gnome org
- To: svn-commits-list gnome org
- Subject: glib r7939 - in trunk: . docs/reference docs/reference/glib docs/reference/gobject gio gmodule gobject gthread po
- Date: Mon, 2 Mar 2009 05:49:44 +0000 (UTC)
Author: matthiasc
Date: Mon Mar 2 05:49:44 2009
New Revision: 7939
URL: http://svn.gnome.org/viewvc/glib?rev=7939&view=rev
Log:
2.19.9
Modified:
trunk/ChangeLog
trunk/INSTALL
trunk/README
trunk/docs/reference/ChangeLog
trunk/docs/reference/glib/gtester-report.1
trunk/docs/reference/glib/gtester.1
trunk/docs/reference/gobject/glib-genmarshal.1
trunk/docs/reference/gobject/glib-mkenums.1
trunk/docs/reference/gobject/gobject-query.1
trunk/gio/ChangeLog
trunk/gmodule/ChangeLog
trunk/gobject/ChangeLog
trunk/gthread/ChangeLog
trunk/po/ChangeLog
trunk/po/am.po
trunk/po/ar.po
trunk/po/as.po
trunk/po/az.po
trunk/po/be.po
trunk/po/be latin po
trunk/po/bg.po
trunk/po/bn.po
trunk/po/bn_IN.po
trunk/po/bs.po
trunk/po/ca.po
trunk/po/cs.po
trunk/po/cy.po
trunk/po/da.po
trunk/po/de.po
trunk/po/dz.po
trunk/po/el.po
trunk/po/en_CA.po
trunk/po/en_GB.po
trunk/po/eo.po
trunk/po/es.po
trunk/po/et.po
trunk/po/eu.po
trunk/po/fa.po
trunk/po/fi.po
trunk/po/fr.po
trunk/po/ga.po
trunk/po/gl.po
trunk/po/gu.po
trunk/po/he.po
trunk/po/hi.po
trunk/po/hr.po
trunk/po/hu.po
trunk/po/hy.po
trunk/po/id.po
trunk/po/is.po
trunk/po/it.po
trunk/po/ja.po
trunk/po/ka.po
trunk/po/kn.po
trunk/po/ko.po
trunk/po/ku.po
trunk/po/lt.po
trunk/po/lv.po
trunk/po/mai.po
trunk/po/mg.po
trunk/po/mk.po
trunk/po/ml.po
trunk/po/mn.po
trunk/po/mr.po
trunk/po/ms.po
trunk/po/nb.po
trunk/po/ne.po
trunk/po/nl.po
trunk/po/nn.po
trunk/po/oc.po
trunk/po/or.po
trunk/po/pa.po
trunk/po/pl.po
trunk/po/ps.po
trunk/po/pt.po
trunk/po/pt_BR.po
trunk/po/ro.po
trunk/po/ru.po
trunk/po/rw.po
trunk/po/si.po
trunk/po/sk.po
trunk/po/sl.po
trunk/po/sq.po
trunk/po/sr.po
trunk/po/sr ije po
trunk/po/sr latin po
trunk/po/sv.po
trunk/po/ta.po
trunk/po/te.po
trunk/po/th.po
trunk/po/tl.po
trunk/po/tr.po
trunk/po/tt.po
trunk/po/uk.po
trunk/po/vi.po
trunk/po/wa.po
trunk/po/xh.po
trunk/po/yi.po
trunk/po/zh_CN.po
trunk/po/zh_HK.po
trunk/po/zh_TW.po
Modified: trunk/INSTALL
==============================================================================
--- trunk/INSTALL (original)
+++ trunk/INSTALL Mon Mar 2 05:49:44 2009
@@ -1,8 +1,8 @@
Simple install procedure
========================
- % gzip -cd glib-2.19.8.tar.gz | tar xvf - # unpack the sources
- % cd glib-2.19.8 # change to the toplevel directory
+ % gzip -cd glib-2.19.9.tar.gz | tar xvf - # unpack the sources
+ % cd glib-2.19.9 # change to the toplevel directory
% ./configure # run the `configure' script
% make # build GLIB
Modified: trunk/README
==============================================================================
--- trunk/README (original)
+++ trunk/README Mon Mar 2 05:49:44 2009
@@ -1,7 +1,7 @@
General Information
===================
-This is GLib version 2.19.8. GLib is the low-level core
+This is GLib version 2.19.9. GLib is the low-level core
library that forms the basis for projects such as GTK+ and GNOME. It
provides data structure handling for C, portability wrappers, and
interfaces for such runtime functionality as an event loop, threads,
Modified: trunk/docs/reference/glib/gtester-report.1
==============================================================================
--- trunk/docs/reference/glib/gtester-report.1 (original)
+++ trunk/docs/reference/glib/gtester-report.1 Mon Mar 2 05:49:44 2009
@@ -1,161 +1,13 @@
+'\" t
.\" Title: gtester-report
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\" Date: 06/12/2008
+.\" Generator: DocBook XSL Stylesheets v1.74.2 <http://docbook.sf.net/>
+.\" Date: 03/02/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
-.TH "GTESTER\-REPORT" "1" "06/12/2008" "[FIXME: source]" "[FIXME: manual]"
-.\" -----------------------------------------------------------------
-.\" * (re)Define some macros
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" toupper - uppercase a string (locale-aware)
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de toupper
-.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
-\\$*
-.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SH-xref - format a cross-reference to an SH section
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de SH-xref
-.ie n \{\
-.\}
-.toupper \\$*
-.el \{\
-\\$*
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SH - level-one heading that works better for non-TTY output
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de1 SH
-.\" put an extra blank line of space above the head in non-TTY output
-.if t \{\
-.sp 1
-.\}
-.sp \\n[PD]u
-.nr an-level 1
-.set-an-margin
-.nr an-prevailing-indent \\n[IN]
-.fi
-.in \\n[an-margin]u
-.ti 0
-.HTML-TAG ".NH \\n[an-level]"
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-\." make the size of the head bigger
-.ps +3
-.ft B
-.ne (2v + 1u)
-.ie n \{\
-.\" if n (TTY output), use uppercase
-.toupper \\$*
-.\}
-.el \{\
-.nr an-break-flag 0
-.\" if not n (not TTY), use normal case (not uppercase)
-\\$1
-.in \\n[an-margin]u
-.ti 0
-.\" if not n (not TTY), put a border/line under subheading
-.sp -.6
-\l'\n(.lu'
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SS - level-two heading that works better for non-TTY output
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de1 SS
-.sp \\n[PD]u
-.nr an-level 1
-.set-an-margin
-.nr an-prevailing-indent \\n[IN]
-.fi
-.in \\n[IN]u
-.ti \\n[SN]u
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.ps \\n[PS-SS]u
-\." make the size of the head bigger
-.ps +2
-.ft B
-.ne (2v + 1u)
-.if \\n[.$] \&\\$*
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BB/BE - put background/screen (filled box) around block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BB
-.if t \{\
-.sp -.5
-.br
-.in +2n
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EB
-.if t \{\
-.if "\\$2"adjust-for-leading-newline" \{\
-.sp -1
-.\}
-.br
-.di
-.in
-.ll
-.gcolor
-.nr BW \\n(.lu-\\n(.i
-.nr BH \\n(dn+.5v
-.ne \\n(BHu+.5v
-.ie "\\$2"adjust-for-leading-newline" \{\
-\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.el \{\
-\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.in 0
-.sp -.5v
-.nf
-.BX
-.in
-.sp .5v
-.fi
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BM/EM - put colored marker in margin next to block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BM
-.if t \{\
-.br
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EM
-.if t \{\
-.br
-.di
-.ll
-.gcolor
-.nr BH \\n(dn
-.ne \\n(BHu
-\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
-.in 0
-.nf
-.BX
-.in
-.fi
-.\}
-..
+.TH "GTESTER\-REPORT" "1" "03/02/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@@ -166,14 +18,12 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
-.SH "Name"
+.SH "NAME"
gtester-report \- test report formatting utility
-.SH "Synopsis"
-.fam C
+.SH "SYNOPSIS"
.HP \w'\fBgtester\-report\fR\ 'u
\fBgtester\-report\fR [option...] [gtester\-log]
-.fam
-.SH "Description"
+.SH "DESCRIPTION"
.PP
\fBgtester\-report\fR
is a script which converts the XML output generated by gtester into HTML\&.
@@ -188,7 +38,7 @@
.RS 4
print version information and exit
.RE
-.SH "See also"
+.SH "SEE ALSO"
.PP
\fBgtester\fR(1)
Modified: trunk/docs/reference/glib/gtester.1
==============================================================================
--- trunk/docs/reference/glib/gtester.1 (original)
+++ trunk/docs/reference/glib/gtester.1 Mon Mar 2 05:49:44 2009
@@ -1,161 +1,13 @@
+'\" t
.\" Title: gtester
.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
-.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
-.\" Date: 06/12/2008
+.\" Generator: DocBook XSL Stylesheets v1.74.2 <http://docbook.sf.net/>
+.\" Date: 03/02/2009
.\" Manual: [FIXME: manual]
.\" Source: [FIXME: source]
.\" Language: English
.\"
-.TH "GTESTER" "1" "06/12/2008" "[FIXME: source]" "[FIXME: manual]"
-.\" -----------------------------------------------------------------
-.\" * (re)Define some macros
-.\" -----------------------------------------------------------------
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" toupper - uppercase a string (locale-aware)
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de toupper
-.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
-\\$*
-.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SH-xref - format a cross-reference to an SH section
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de SH-xref
-.ie n \{\
-.\}
-.toupper \\$*
-.el \{\
-\\$*
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SH - level-one heading that works better for non-TTY output
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de1 SH
-.\" put an extra blank line of space above the head in non-TTY output
-.if t \{\
-.sp 1
-.\}
-.sp \\n[PD]u
-.nr an-level 1
-.set-an-margin
-.nr an-prevailing-indent \\n[IN]
-.fi
-.in \\n[an-margin]u
-.ti 0
-.HTML-TAG ".NH \\n[an-level]"
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-\." make the size of the head bigger
-.ps +3
-.ft B
-.ne (2v + 1u)
-.ie n \{\
-.\" if n (TTY output), use uppercase
-.toupper \\$*
-.\}
-.el \{\
-.nr an-break-flag 0
-.\" if not n (not TTY), use normal case (not uppercase)
-\\$1
-.in \\n[an-margin]u
-.ti 0
-.\" if not n (not TTY), put a border/line under subheading
-.sp -.6
-\l'\n(.lu'
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" SS - level-two heading that works better for non-TTY output
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de1 SS
-.sp \\n[PD]u
-.nr an-level 1
-.set-an-margin
-.nr an-prevailing-indent \\n[IN]
-.fi
-.in \\n[IN]u
-.ti \\n[SN]u
-.it 1 an-trap
-.nr an-no-space-flag 1
-.nr an-break-flag 1
-.ps \\n[PS-SS]u
-\." make the size of the head bigger
-.ps +2
-.ft B
-.ne (2v + 1u)
-.if \\n[.$] \&\\$*
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BB/BE - put background/screen (filled box) around block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BB
-.if t \{\
-.sp -.5
-.br
-.in +2n
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EB
-.if t \{\
-.if "\\$2"adjust-for-leading-newline" \{\
-.sp -1
-.\}
-.br
-.di
-.in
-.ll
-.gcolor
-.nr BW \\n(.lu-\\n(.i
-.nr BH \\n(dn+.5v
-.ne \\n(BHu+.5v
-.ie "\\$2"adjust-for-leading-newline" \{\
-\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.el \{\
-\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
-.\}
-.in 0
-.sp -.5v
-.nf
-.BX
-.in
-.sp .5v
-.fi
-.\}
-..
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.\" BM/EM - put colored marker in margin next to block of text
-.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-.de BM
-.if t \{\
-.br
-.ll -2n
-.gcolor red
-.di BX
-.\}
-..
-.de EM
-.if t \{\
-.br
-.di
-.ll
-.gcolor
-.nr BH \\n(dn
-.ne \\n(BHu
-\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
-.in 0
-.nf
-.BX
-.in
-.fi
-.\}
-..
+.TH "GTESTER" "1" "03/02/2009" "[FIXME: source]" "[FIXME: manual]"
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
@@ -166,14 +18,12 @@
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
-.SH "Name"
+.SH "NAME"
gtester \- test running utility
-.SH "Synopsis"
-.fam C
+.SH "SYNOPSIS"
.HP \w'\fBgtester\fR\ 'u
\fBgtester\fR [option...] [testprogram]
-.fam
-.SH "Description"
+.SH "DESCRIPTION"
.PP
\fBgtester\fR
is a utility to run unit tests that have been written using the GLib test framework\&.
@@ -245,7 +95,7 @@
.RS 4
report success per testcase
.RE
-.SH "See also"
+.SH "SEE ALSO"
.PP
\fBgtester\-report\fR(1)
Modified: trunk/docs/reference/gobject/glib-genmarshal.1
==============================================================================
--- trunk/docs/reference/gobject/glib-genmarshal.1 (original)
+++ trunk/docs/reference/gobject/glib-genmarshal.1 Mon Mar 2 05:49:44 2009
@@ -1,150 +1,234 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.1).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GLIB\-GENMARSHAL" "1" "08/22/2005" "" ""
+'\" t
+.\" Title: glib-genmarshal
+.\" Author: [see the "Author" section]
+.\" Generator: DocBook XSL Stylesheets v1.74.2 <http://docbook.sf.net/>
+.\" Date: 03/02/2009
+.\" Manual: [FIXME: manual]
+.\" Source: [FIXME: source]
+.\" Language: English
+.\"
+.TH "GLIB\-GENMARSHAL" "1" "03/02/2009" "[FIXME: source]" "[FIXME: manual]"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
.SH "NAME"
-glib\-genmarshal \- C code marshaller generation utility for GLib closures
+glib-genmarshal \- C code marshaller generation utility for GLib closures
.SH "SYNOPSIS"
-.HP 16
+.HP \w'\fBglib\-genmarshal\fR\ 'u
\fBglib\-genmarshal\fR [options...] [files...]
.SH "DESCRIPTION"
.PP
\fBglib\-genmarshal\fR
-is a small utility that generates C code marshallers for callback functions of the GClosure mechanism in the GObject sublibrary of GLib. The marshaller functions have a standard signature, they get passed in the invoking closure, an array of value structures holding the callback function parameters and a value structure for the return value of the callback. The marshaller is then responsible to call the respective C code function of the closure with all the parameters on the stack and to collect its return value.
+is a small utility that generates C code marshallers for callback functions of the GClosure mechanism in the GObject sublibrary of GLib\&. The marshaller functions have a standard signature, they get passed in the invoking closure, an array of value structures holding the callback function parameters and a value structure for the return value of the callback\&. The marshaller is then responsible to call the respective C code function of the closure with all the parameters on the stack and to collect its return value\&.
.SH "INVOCATION"
.PP
\fBglib\-genmarshal\fR
-takes a list of marshallers to generate as input. The marshaller list is either read from standard input or from files passed as additional arguments on the command line.
+takes a list of marshallers to generate as input\&. The marshaller list is either read from standard input or from files passed as additional arguments on the command line\&.
.SS "Options"
-.TP
+.PP
\fB\-\-header\fR
-Generate header file contents of the marshallers.
-.TP
+.RS 4
+Generate header file contents of the marshallers\&.
+.RE
+.PP
\fB\-\-body\fR
-Generate C code file contents of the marshallers.
-.TP
+.RS 4
+Generate C code file contents of the marshallers\&.
+.RE
+.PP
\fB\-\-prefix=string\fR, \fB\-\-prefix string\fR
-Specify marshaller prefix. The default prefix is
-`g_cclosure_marshal'.
-.TP
+.RS 4
+Specify marshaller prefix\&. The default prefix is
+`g_cclosure_marshal\'\&.
+.RE
+.PP
\fB\-\-skip\-source\fR
-Skip source location remarks in generated comments.
-.TP
+.RS 4
+Skip source location remarks in generated comments\&.
+.RE
+.PP
\fB\-\-nostdinc\fR
+.RS 4
Do not use the standard marshallers of the GObject library, and skip
-\fIgmarshal.h\fR
-include directive in generated header files.
-.TP
+gmarshal\&.h
+include directive in generated header files\&.
+.RE
+.PP
\fB\-\-g\-fatal\-warnings\fR
-Make warnings fatal, that is, exit immediately once a warning occurs.
-.TP
+.RS 4
+Make warnings fatal, that is, exit immediately once a warning occurs\&.
+.RE
+.PP
\fB\-h\fR, \fB\-\-help\fR
-Print brief help and exit.
-.TP
+.RS 4
+Print brief help and exit\&.
+.RE
+.PP
\fB\-v\fR, \fB\-\-version\fR
-Print version and exit.
+.RS 4
+Print version and exit\&.
+.RE
.SS "Marshaller list format"
.PP
The marshaller lists are processed line by line, a line can contain a comment in the form of
.sp
+.if n \{\
+.RS 4
+.\}
.nf
# this is a comment
.fi
+.if n \{\
+.RE
+.\}
.sp
or a marshaller specification of the form
.sp
+.if n \{\
+.RS 4
+.\}
.nf
\fIRTYPE\fR:\fIPTYPE\fR
\fIRTYPE\fR:\fIPTYPE\fR,\fIPTYPE\fR
\fIRTYPE\fR:\fIPTYPE\fR,\fIPTYPE\fR,\fIPTYPE\fR
.fi
+.if n \{\
+.RE
+.\}
.sp
(up to 16
-\fIPTYPE\fRs may be present).
+\fIPTYPE\fRs may be present)\&.
.PP
The
\fIRTYPE\fR
-part specifies the callback's return type and the
-\fIPTYPE\fRs right to the colon specify the callback's parameter list, except for the first and the last arguments which are always pointers.
+part specifies the callback\'s return type and the
+\fIPTYPE\fRs right to the colon specify the callback\'s parameter list, except for the first and the last arguments which are always pointers\&.
.SS "Parameter types"
.PP
Currently, the following types are supported:
-.TP
+.PP
\fIVOID\fR
-indicates no return type, or no extra parameters. If
+.RS 4
+indicates no return type, or no extra parameters\&. If
\fIVOID\fR
-is used as the parameter list, no additional parameters may be present.
-.TP
+is used as the parameter list, no additional parameters may be present\&.
+.RE
+.PP
\fIBOOLEAN\fR
+.RS 4
for boolean types (gboolean)
-.TP
+.RE
+.PP
\fICHAR\fR
+.RS 4
for signed char types (gchar)
-.TP
+.RE
+.PP
\fIUCHAR\fR
+.RS 4
for unsigned char types (guchar)
-.TP
+.RE
+.PP
\fIINT\fR
+.RS 4
for signed integer types (gint)
-.TP
+.RE
+.PP
\fIUINT\fR
+.RS 4
for unsigned integer types (guint)
-.TP
+.RE
+.PP
\fILONG\fR
+.RS 4
for signed long integer types (glong)
-.TP
+.RE
+.PP
\fIULONG\fR
+.RS 4
for unsigned long integer types (gulong)
-.TP
+.RE
+.PP
\fIINT64\fR
+.RS 4
for signed 64bit integer types (gint64)
-.TP
+.RE
+.PP
\fIUINT64\fR
+.RS 4
for unsigned 64bit integer types (guint64)
-.TP
+.RE
+.PP
\fIENUM\fR
+.RS 4
for enumeration types (gint)
-.TP
+.RE
+.PP
\fIFLAGS\fR
+.RS 4
for flag enumeration types (guint)
-.TP
+.RE
+.PP
\fIFLOAT\fR
+.RS 4
for single\-precision float types (gfloat)
-.TP
+.RE
+.PP
\fIDOUBLE\fR
+.RS 4
for double\-precision float types (gdouble)
-.TP
+.RE
+.PP
\fISTRING\fR
+.RS 4
for string types (gchar*)
-.TP
+.RE
+.PP
\fIBOXED\fR
+.RS 4
for boxed (anonymous but reference counted) types (GBoxed*)
-.TP
+.RE
+.PP
\fIPARAM\fR
+.RS 4
for GParamSpec or derived types (GParamSpec*)
-.TP
+.RE
+.PP
\fIPOINTER\fR
+.RS 4
for anonymous pointer types (gpointer)
-.TP
+.RE
+.PP
\fIOBJECT\fR
+.RS 4
for GObject or derived types (GObject*)
-.TP
+.RE
+.PP
\fINONE\fR
+.RS 4
deprecated alias for
\fIVOID\fR
-.TP
+.RE
+.PP
\fIBOOL\fR
+.RS 4
deprecated alias for
\fIBOOLEAN\fR
+.RE
.SH "EXAMPLE"
.PP
To generate marshallers for the following callback functions:
.sp
+.if n \{\
+.RS 4
+.\}
.nf
void foo (gpointer data1,
gpointer data2);
@@ -156,25 +240,43 @@
guchar param2,
gpointer data2);
.fi
+.if n \{\
+.RE
+.\}
.PP
The marshaller list has to look like this:
.sp
+.if n \{\
+.RS 4
+.\}
.nf
VOID:VOID
VOID:INT
FLOAT:BOOLEAN,UCHAR
.fi
+.if n \{\
+.RE
+.\}
.PP
-The generated marshallers have the arguments encoded in their function name. For this particular list, they are
+The generated marshallers have the arguments encoded in their function name\&. For this particular list, they are
.sp
+.if n \{\
+.RS 4
+.\}
.nf
g_cclosure_marshal_VOID__VOID(),
g_cclosure_marshal_VOID__INT(),
-g_cclosure_marshal_FLOAT__BOOLEAN_UCHAR().
+g_cclosure_marshal_FLOAT__BOOLEAN_UCHAR()\&.
.fi
+.if n \{\
+.RE
+.\}
.PP
They can be used directly for GClosures or be passed in as the GSignalCMarshaller c_marshaller; argument upon creation of signals:
.sp
+.if n \{\
+.RS 4
+.\}
.nf
GClosure *cc_foo, *cc_bar, *cc_baz;
@@ -185,17 +287,21 @@
cc_baz = g_cclosure_new (NULL, baz, NULL);
g_closure_set_marshal (cc_baz, g_cclosure_marshal_FLOAT__BOOLEAN_UCHAR);
.fi
+.if n \{\
+.RE
+.\}
.SH "SEE ALSO"
.PP
+
\fBglib\-mkenums\fR(1)
.SH "BUGS"
.PP
-None known yet.
+None known yet\&.
.SH "AUTHOR"
.PP
\fBglib\-genmarshal\fR
has been written by Tim Janik
-<timj gtk org>.
+timj gtk\&.org\&.
.PP
This manual page was provided by Tim Janik
-<timj gtk org>.
+timj gtk\&.org\&.
Modified: trunk/docs/reference/gobject/glib-mkenums.1
==============================================================================
--- trunk/docs/reference/gobject/glib-mkenums.1 (original)
+++ trunk/docs/reference/gobject/glib-mkenums.1 Mon Mar 2 05:49:44 2009
@@ -1,152 +1,213 @@
-.\" ** You probably do not want to edit this file directly **
-.\" It was generated using the DocBook XSL Stylesheets (version 1.69.0).
-.\" Instead of manually editing it, you probably should edit the DocBook XML
-.\" source for it and then use the DocBook XSL Stylesheets to regenerate it.
-.TH "GLIB\-MKENUMS" "1" "08/15/2005" "" ""
+'\" t
+.\" Title: glib-mkenums
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.2 <http://docbook.sf.net/>
+.\" Date: 03/02/2009
+.\" Manual: [FIXME: manual]
+.\" Source: [FIXME: source]
+.\" Language: English
+.\"
+.TH "GLIB\-MKENUMS" "1" "03/02/2009" "[FIXME: source]" "[FIXME: manual]"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
.SH "NAME"
-glib\-mkenums \- C language enum description generation utility
+glib-mkenums \- C language enum description generation utility
.SH "SYNOPSIS"
-.HP 13
+.HP \w'\fBglib\-mkenums\fR\ 'u
\fBglib\-mkenums\fR [options...] [files...]
.SH "DESCRIPTION"
.PP
-\fBglib\-mkenums\fR
-is a small perl\-script utility that parses C code to extract enum definitions and produces enum descriptions based on text templates specified by the user. Most frequently this script is used to produce C code that contains enum values as strings so programs can provide value name strings for introspection.
+\fBglib\-mkenums\fR
+is a small perl\-script utility that parses C code to extract enum definitions and produces enum descriptions based on text templates specified by the user\&. Most frequently this script is used to produce C code that contains enum values as strings so programs can provide value name strings for introspection\&.
.SH "INVOCATION"
.PP
-\fBglib\-mkenums\fR
-takes a list of valid C code files as input. The options specified control the text that is output, certain substitutions are performed on the text templates for keywords enclosed in @ characters.
+\fBglib\-mkenums\fR
+takes a list of valid C code files as input\&. The options specified control the text that is output, certain substitutions are performed on the text templates for keywords enclosed in @ characters\&.
.SS "Options"
-.TP
+.PP
\fB\-\-fhead\fR \fItext\fR
-Put out
-\fItext\fR
-prior to processing input files.
-.TP
+.RS 4
+Put out
+\fItext\fR
+prior to processing input files\&.
+.RE
+.PP
\fB\-\-fprod\fR \fItext\fR
-Put out
-\fItext\fR
-everytime a new input file is being processed.
-.TP
+.RS 4
+Put out
+\fItext\fR
+everytime a new input file is being processed\&.
+.RE
+.PP
\fB\-\-ftail\fR \fItext\fR
-Put out
-\fItext\fR
-after all input files have been processed.
-.TP
+.RS 4
+Put out
+\fItext\fR
+after all input files have been processed\&.
+.RE
+.PP
\fB\-\-eprod\fR \fItext\fR
-Put out
-\fItext\fR
-everytime an enum is encountered in the input files.
-.TP
+.RS 4
+Put out
+\fItext\fR
+everytime an enum is encountered in the input files\&.
+.RE
+.PP
\fB\-\-vhead\fR \fItext\fR
-Put out
-\fItext\fR
-before iterating over the set of values of an enum.
-.TP
+.RS 4
+Put out
+\fItext\fR
+before iterating over the set of values of an enum\&.
+.RE
+.PP
\fB\-\-vprod\fR \fItext\fR
-Put out
-\fItext\fR
-for every value of an enum.
-.TP
+.RS 4
+Put out
+\fItext\fR
+for every value of an enum\&.
+.RE
+.PP
\fB\-\-vtail\fR \fItext\fR
-Put out
-\fItext\fR
-after iterating over all values of an enum.
-.TP
+.RS 4
+Put out
+\fItext\fR
+after iterating over all values of an enum\&.
+.RE
+.PP
\fB\-\-comments\fR \fItext\fR
-Template for auto\-generated comments, the default (for C code generations) is
-"/* @comment@ */".
-.TP
+.RS 4
+Template for auto\-generated comments, the default (for C code generations) is
+"/* @comment@ */"\&.
+.RE
+.PP
\fB\-\-template\fR \fIfile\fR
-Read templates from the given file. The templates are enclosed in specially\-formatted C comments
-
+.RS 4
+Read templates from the given file\&. The templates are enclosed in specially\-formatted C comments
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-
/*** BEGIN section ***/
/*** END section ***/
-
.fi
-
-where section may be
-file\-header,
-file\-production,
-file\-tail,
-enumeration\-production,
-value\-header,
-value\-production,
-value\-tail
-or
-comment.
-.TP
+.if n \{\
+.RE
+.\}
+.sp
+where section may be
+file\-header,
+file\-production,
+file\-tail,
+enumeration\-production,
+value\-header,
+value\-production,
+value\-tail
+or
+comment\&.
+.RE
+.PP
\fB\-\-help\fR
-Print brief help and exit.
-.TP
+.RS 4
+Print brief help and exit\&.
+.RE
+.PP
\fB\-\-version\fR
-Print version and exit.
+.RS 4
+Print version and exit\&.
+.RE
.SS "Production text substitutions"
.PP
-Certain keywords enclosed in @ characters will be substituted in the emitted text. For the substitution examples of the keywords below, the following example enum definition is assumed:
-
+Certain keywords enclosed in @ characters will be substituted in the emitted text\&. For the substitution examples of the keywords below, the following example enum definition is assumed:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-
typedef enum
{
PREFIX_THE_XVALUE = 1 << 3,
PREFIX_ANOTHER_VALUE = 1 << 4
} PrefixTheXEnum;
-
.fi
-
-.TP
+.if n \{\
+.RE
+.\}
+.PP
@EnumName@
-The name of the enum currently being processed, enum names are assumed to be properly namespaced and to use mixed capitalization to separate words (e.g. PrefixTheXEnum).
-.TP
+.RS 4
+The name of the enum currently being processed, enum names are assumed to be properly namespaced and to use mixed capitalization to separate words (e\&.g\&. PrefixTheXEnum)\&.
+.RE
+.PP
@enum_name@
-The enum name with words lowercase and word\-separated by underscores (e.g. prefix_the_xenum).
-.TP
+.RS 4
+The enum name with words lowercase and word\-separated by underscores (e\&.g\&. prefix_the_xenum)\&.
+.RE
+.PP
@ENUMNAME@
-The enum name with words uppercase and word\-separated by underscores (e.g. PREFIX_THE_XENUM).
-.TP
+.RS 4
+The enum name with words uppercase and word\-separated by underscores (e\&.g\&. PREFIX_THE_XENUM)\&.
+.RE
+.PP
@ENUMSHORT@
-The enum name with words uppercase and word\-separated by underscores, prefix stripped (e.g. THE_XENUM).
-.TP
+.RS 4
+The enum name with words uppercase and word\-separated by underscores, prefix stripped (e\&.g\&. THE_XENUM)\&.
+.RE
+.PP
@VALUENAME@
-The enum value name currently being processed with words uppercase and word\-separated by underscores, this is the assumed literal notation of enum values in the C sources (e.g. PREFIX_THE_XVALUE).
-.TP
+.RS 4
+The enum value name currently being processed with words uppercase and word\-separated by underscores, this is the assumed literal notation of enum values in the C sources (e\&.g\&. PREFIX_THE_XVALUE)\&.
+.RE
+.PP
@valuenick@
-A nick name for the enum value currently being processed, this is usually generated by stripping common prefix words of all the enum values of the current enum, the words are lowercase and underscores are substituted by a minus (e.g. the\-xvalue).
-.TP
+.RS 4
+A nick name for the enum value currently being processed, this is usually generated by stripping common prefix words of all the enum values of the current enum, the words are lowercase and underscores are substituted by a minus (e\&.g\&. the\-xvalue)\&.
+.RE
+.PP
@type@
-This is substituted either by "enum" or "flags", depending on whether the enum value definitions contained bit\-shift operators or not (e.g. flags).
-.TP
+.RS 4
+This is substituted either by "enum" or "flags", depending on whether the enum value definitions contained bit\-shift operators or not (e\&.g\&. flags)\&.
+.RE
+.PP
@Type@
-The same as
- type@
-with the first letter capitalized (e.g. Flags).
-.TP
+.RS 4
+The same as
+ type@
+with the first letter capitalized (e\&.g\&. Flags)\&.
+.RE
+.PP
@TYPE@
-The same as
- type@
-with all letters uppercased (e.g. FLAGS).
-.TP
+.RS 4
+The same as
+ type@
+with all letters uppercased (e\&.g\&. FLAGS)\&.
+.RE
+.PP
@filename@
-The name of the input file currently being processed (e.g. foo.h).
-
+.RS 4
+The name of the input file currently being processed (e\&.g\&. foo\&.h)\&.
+.RE
.SS "Trigraph extensions"
.PP
-Some C comments are treated specially in the parsed enum definitions, such comments start out with the trigraph sequence
-/*<
-and end with the trigraph sequence
->*/. Per enum definition, the options "skip" and "flags" can be specified, to indicate this enum definition to be skipped, or for it to be treated as a flags definition, or to specify the common prefix to be stripped from all values to generate value nicknames, respectively. The "lowercase_name" option can be used to specify the word separation used in the *_get_type() function. For instance, /*< lowercase_name=gnome_vfs_uri_hide_options >*/.
-.PP
-Per value definition, the options "skip" and "nick" are supported. The former causes the value to be skipped, and the latter can be used to specify the otherwise auto\-generated nickname. Examples:
-
+Some C comments are treated specially in the parsed enum definitions, such comments start out with the trigraph sequence
+/*<
+and end with the trigraph sequence
+>*/\&. Per enum definition, the options "skip" and "flags" can be specified, to indicate this enum definition to be skipped, or for it to be treated as a flags definition, or to specify the common prefix to be stripped from all values to generate value nicknames, respectively\&. The "lowercase_name" option can be used to specify the word separation used in the *_get_type() function\&. For instance, /*< lowercase_name=gnome_vfs_uri_hide_options >*/\&.
+.PP
+Per value definition, the options "skip" and "nick" are supported\&. The former causes the value to be skipped, and the latter can be used to specify the otherwise auto\-generated nickname\&. Examples:
+.sp
+.if n \{\
+.RS 4
+.\}
.nf
-
typedef enum /*< skip >*/
{
PREFIX_FOO
@@ -158,9 +219,11 @@
PREFIX_THE_SECOND_VALUE,
PREFIX_THE_THIRD_VALUE, /*< nick=the\-last\-value >*/
} PrefixTheFlagsEnum;
-
.fi
-
+.if n \{\
+.RE
+.\}
+.sp
.SH "SEE ALSO"
.PP
\fBglib\-genmarshal\fR(1)
Modified: trunk/docs/reference/gobject/gobject-query.1
==============================================================================
--- trunk/docs/reference/gobject/gobject-query.1 (original)
+++ trunk/docs/reference/gobject/gobject-query.1 Mon Mar 2 05:49:44 2009
@@ -1,80 +1,83 @@
-.\"Generated by db2man.xsl. Don't modify this, modify the source.
-.de Sh \" Subsection
-.br
-.if t .Sp
-.ne 5
-.PP
-\fB\\$1\fR
-.PP
-..
-.de Sp \" Vertical space (when we can't use .PP)
-.if t .sp .5v
-.if n .sp
-..
-.de Ip \" List item
-.br
-.ie \\n(.$>=3 .ne \\$3
-.el .ne 3
-.IP "\\$1" \\$2
-..
-.TH "GOBJECT-QUERY" 1 "" "" ""
-.SH NAME
+'\" t
+.\" Title: gobject-query
+.\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
+.\" Generator: DocBook XSL Stylesheets v1.74.2 <http://docbook.sf.net/>
+.\" Date: 03/02/2009
+.\" Manual: [FIXME: manual]
+.\" Source: [FIXME: source]
+.\" Language: English
+.\"
+.TH "GOBJECT\-QUERY" "1" "03/02/2009" "[FIXME: source]" "[FIXME: manual]"
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
gobject-query \- display a tree of types
.SH "SYNOPSIS"
-
-.nf
-\fBgobject-query\fR froots [options...]
-.fi
-
-.nf
-\fBgobject-query\fR tree [options...]
-.fi
-
+.HP \w'\fBgobject\-query\fR\ 'u
+\fBgobject\-query\fR froots [options...]
+.HP \w'\fBgobject\-query\fR\ 'u
+\fBgobject\-query\fR tree [options...]
.SH "DESCRIPTION"
-
.PP
- \fBgobject-query\fR is a small utility that draws a tree of types\&.
+\fBgobject\-query\fR
+is a small utility that draws a tree of types\&.
.SH "INVOCATION"
-
.PP
- \fBgobject-query\fR takes a mandatory argument that specifies whether it should iterate over the fundamental types or print a type tree\&.
+\fBgobject\-query\fR
+takes a mandatory argument that specifies whether it should iterate over the fundamental types or print a type tree\&.
.SS "Options"
-
-.TP
+.PP
\fBfroots\fR
+.RS 4
iterate over fundamental roots
-
-.TP
+.RE
+.PP
\fBtree\fR
+.RS 4
print type tree
-
-.TP
-\fB-r\fR \fItype\fR
+.RE
+.PP
+\fB\-r\fR \fItype\fR
+.RS 4
specify the root type
-
-.TP
-\fB-n\fR
-don't descend type tree
-
-.TP
-\fB-b\fR \fIstring\fR
+.RE
+.PP
+\fB\-n\fR
+.RS 4
+don\'t descend type tree
+.RE
+.PP
+\fB\-b\fR \fIstring\fR
+.RS 4
specify indent string
-
-.TP
-\fB-i\fR \fIstring\fR
+.RE
+.PP
+\fB\-i\fR \fIstring\fR
+.RS 4
specify incremental indent string
-
-.TP
-\fB-s\fR \fInumber\fR
+.RE
+.PP
+\fB\-s\fR \fInumber\fR
+.RS 4
specify line spacing
-
-.TP
-\fB-h\fR, \fB--help\fR
+.RE
+.PP
+\fB\-h\fR, \fB\-\-help\fR
+.RS 4
Print brief help and exit\&.
-
-.TP
-\fB-v\fR, \fB--version\fR
+.RE
+.PP
+\fB\-v\fR, \fB\-\-version\fR
+.RS 4
Print version and exit\&.
-
+.RE
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
