Commit Graph

1357 Commits

Author SHA1 Message Date
Matthias Clasen
8db946fdfb Clean up man page handling
Remove all formatted man pages from git, and use the same
Makefile fragment in all doc dirs.
2010-05-21 22:28:42 -04:00
Christian Persch
41b3f6885d Add g_dc[p]gettext, and use it in gsettings
Avoid using LC_MESSAGES, and just call g_d[c]gettext directly.

Bug #617004.
2010-05-20 21:16:29 +02:00
Javier Jardón
3b8d0a4ac2 Add G_TYPE_CLASS_GET_PRIVATE macro to docs 2010-05-20 01:59:17 +02:00
Ryan Lortie
b59a5551ec Bug 619038 - increase gsettings.m4 power
handle schema checking, installation, uninstallation, cleaning
2010-05-19 08:55:57 -04:00
Ryan Lortie
8eb377b6f6 glib-compile-schemas rename missed in docs
change a mention of gschema_compile in the docs
2010-05-18 18:24:04 -04:00
Matthias Clasen
4b0fd52e52 Expand information about schema translation
I have added some hints on how to use intltool for translation
of summary and description elements, taken from comments in bug #618523.
2010-05-15 18:25:46 -04:00
Matthias Clasen
c6f01b329c Fix a typo 2010-05-14 00:59:42 -04:00
Matthias Clasen
4e7764fb2d Documentation cleanups 2010-05-14 00:21:39 -04:00
Matthias Clasen
6223341cac Merge branch 'gdbus-merge'
Conflicts:
	docs/reference/gio/gio-docs.xml
	docs/reference/gio/gio-sections.txt
	gio/tests/Makefile.am
2010-05-13 23:08:34 -04:00
Matthias Clasen
a7c4c7de58 Remove a reference to Pango 2010-05-13 22:34:32 -04:00
Ryan Lortie
62c0454b34 documentation for glib-mkenums @valuenum@ 2010-05-14 01:55:46 +02:00
David Zeuthen
dd3551e7c3 GDBus: update gdbus(1) man page 2010-05-13 18:19:16 -04:00
David Zeuthen
1fd55b8bbf GDBus: Remove g_dbus_is_activated()
It's generally hard to get this right so don't attempt to do so.
2010-05-13 17:44:42 -04:00
David Zeuthen
cb753dfd49 GDBus: Rename ::deny-authentication-peer to ::authorize-authenticated-peer 2010-05-13 16:20:31 -04:00
Matthias Clasen
2d75583fb2 Fill out the export section of the migration guide 2010-05-13 01:04:29 -04:00
David Zeuthen
ea1e0496b0 GDBus: add 'monitor' verb to gdbus(1)
This uncovered a bug in name watching if the name wasn't activatable.

Also provoked the need for on_connection variants of g_bus_watch_name
(added g_bus_watch_proxy's variant as well).
2010-05-12 23:12:14 -04:00
David Zeuthen
f909cb5b27 GDBusProxy: Remove error in get_cached_property() and add set_cached_property()
This makes it possible to use the cached properties mechanism even if
constructing the proxy with the DO_NOT_LOAD_PROPERTIES flag.

This is useful for cases where you obtain the and track object
properties out-of-band. For example, in udisks, the plan is to have
something like this

 Manager.GetObjects    (out ao paths, out aa{sa{sv}} all_properties);
 Manager.ObjectAdded   (o path, a{sa{sv}} all_properties);
 Manager.ObjectChanged (o path, a{sa{sv}} all_properties);
 Manager.ObjectRemoved (o path, a{sa{sv}} all_properties);

E.g. the first GetObjects() call will return *all* data about *all*
exported objects. Further, this way a client will only need to listen
these three signals (three AddMatch) on the Manager object and it will
never need to do GetAll() etc (e.g. can use DO_NOT_LOAD_PROPERTIES).

(Of course this only works if the client is interested in all
objects... while this is true for udisks it is generally not true for
other D-Bus services).

Also use expected_interface to check for programming errors.
2010-05-12 20:51:06 -04:00
Matthias Clasen
b690e637d4 Add some more verbiage 2010-05-12 17:56:56 -04:00
David Zeuthen
d40767fc62 GDBus: Add an example of a GDBusProxy subclass 2010-05-12 15:52:08 -04:00
Matthias Clasen
371a3373bb Correct env var names
and add a note about priority
2010-05-12 13:01:02 -04:00
Matthias Clasen
af3afc8040 placeholder for more migration docs 2010-05-12 12:13:57 -04:00
Matthias Clasen
d7095dd470 Document DBUS address env vars 2010-05-11 22:35:59 -04:00
Matthias Clasen
84a6475b6e Trivial: tweak section heading 2010-05-11 22:03:40 -04:00
Matthias Clasen
9c128ca835 Trivial formatting fix 2010-05-11 22:00:54 -04:00
Matthias Clasen
fdfd3d5e75 Fill out the proxy section of the migration guide 2010-05-11 22:00:06 -04:00
Matthias Clasen
1af277f167 Fix a typo 2010-05-11 21:32:29 -04:00
Matthias Clasen
9b05e0bc3e Complete the name owning section of the migration guide 2010-05-11 21:30:53 -04:00
Matthias Clasen
e4b1e48fca Match up parameter names
and similar cleanups to make gtk-doc happy.
2010-05-11 20:57:44 -04:00
Matthias Clasen
8d66ede1ab More gdbus migration stuff 2010-05-11 17:15:11 -04:00
Matthias Clasen
9a2422b216 Trivial: rename a file 2010-05-11 15:42:15 -04:00
David Zeuthen
869b4c6833 GDBus: Use call() instead of invoke_method()
Lots of people been suggesting this. We still use MethodInvocation /
method_invocation for handling incoming method calls so use call()
instead of invoke_method() helps to separate the client and server
facilities. Which is a good thing(tm).
2010-05-10 11:47:08 -04:00
Matthias Clasen
b96c3b6d60 Mention multithreading as a reason for not using libdbus 2010-05-09 12:24:56 -04:00
David Zeuthen
c148cafdd1 GDBus: Rework GCredentials type
These changes are is related to

 https://bugzilla.gnome.org/show_bug.cgi?id=617483

and IRC discussions with danw.
2010-05-09 10:03:56 -04:00
Matthias Clasen
bb7106c5df Add some conceptual changes 2010-05-09 02:27:09 -04:00
Matthias Clasen
8315eb77d5 Some documentation tweaks
Add links to the D-Bus docs in some places, and various
other additions.
2010-05-09 01:44:11 -04:00
Matthias Clasen
7ca2e00054 Doc improvements
Make sure all unix-specific apis are marked as such.
2010-05-08 23:28:17 -04:00
Simon McVittie
6bea235c8b Support 64bit integers in GKeyFile 2010-05-08 21:30:27 -04:00
David Zeuthen
5134a1d151 GDBus: Document environment variables in "Running GIO applications" 2010-05-07 14:36:07 -04:00
Matthias Clasen
1ddda12d64 A quick cheat sheet 2010-05-06 20:54:04 -04:00
David Zeuthen
f309334bc6 GDBus: add a man page for gdbus(1) 2010-05-06 19:42:46 -04:00
Matthias Clasen
f14e30818c Mention D-Bus functionality in the overview 2010-05-06 18:15:00 -04:00
Matthias Clasen
133f66538d Add a migration chapter for dbus bits
Also split migration.xml into separate files per chapter, it was
getting unwieldy.
2010-05-06 17:58:29 -04:00
David Zeuthen
46ce134d51 GDBus: Add new symbols to gio.symbols 2010-05-06 17:31:51 -04:00
David Zeuthen
0fd6498cd8 Add "Since: 2.26" to all new GDBus API 2010-05-06 16:02:08 -04:00
David Zeuthen
c490c14f4e Set up gtk-doc for GDBus
Also move send_credentials() and receive_credentials() to
GUnixConnection. This code might change, discussion is still ongoing
in

 https://bugzilla.gnome.org/show_bug.cgi?id=617483.
2010-05-06 15:31:45 -04:00
Xan Lopez
b3c9c17956 Fix typo in limits documentation 2010-05-04 18:10:56 +02:00
Torsten Schönfeld
f39a49b036 gio: Add a boxed type for GFileAttributeMatcher
https://bugzilla.gnome.org/show_bug.cgi?id=616892
2010-05-03 20:13:35 +02:00
Christian Persch
4c10cad661 Add API to get the compile and match flags from a GRegex
Bug #616967.
2010-05-01 13:57:11 +02:00
Shaun McCance
3d5ce40624 [gvariant-varargs.xml] Fix some outdated documentation 2010-04-29 19:27:56 -05:00
Dan Winship
9ba690b386 .gitignore updates for gsettings stuff 2010-04-27 17:04:57 -04:00
Ryan Lortie
cd062e841f docs and glib.symbols update 2010-04-25 20:08:59 -05:00
Matthias Clasen
ec664445a9 Rename gschema-compile to glib-compile-schemas
And clean up the autofoo a bit: use an uppercase variable,
check for pkg-config, check for presence of glib-compile-schemas.
2010-04-23 17:27:26 -04:00
Matthias Clasen
e6e7015bbd Fix up man page handling
Turns out the formatted man pages did not end up in the tarballs. Doh.
2010-04-23 15:03:35 -04:00
Dan Winship
29f3e3f766 GSocket: add support for timeouts
Also add options for testing timeouts to socket test programs

https://bugzilla.gnome.org/show_bug.cgi?id=587898
2010-04-23 12:31:31 -04:00
David Zeuthen
3baff96b37 Make sure G_TYPE_ERROR shows up in the docs
This is related to bug 614541.

Signed-off-by: David Zeuthen <davidz@redhat.com>
2010-04-23 12:14:37 -04:00
Javier Jardón
f68dc4d97d [gsettings] Change AM_GSETTINGS macro to GLIB_GSETTINGS
So we don't use Automake's macro namespace

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=616648
2010-04-23 17:36:35 +02:00
Matthias Clasen
25725345fb Fix up distcheck 2010-04-22 22:01:19 -04:00
Matthias Clasen
b2ee97d00d Fix up g_variant_compare addition 2010-04-22 20:49:20 -04:00
Matthias Clasen
4a62a00c4c Document --dry-run option of gschema-compile 2010-04-22 20:03:53 -04:00
Dan Winship
19d8cc3375 GUnixSocketAddress: handle abstract sockets with non-0-padded names
There are apparently two incompatible ways of naming abstract sockets:
pad the sockaddr with 0s and use the entire thing as the name, or else
don't, and just pass a shorter length value to the relevant functions.
We previously only supported the former method. Add support for the
latter.

Also correctly handle "anonymous" unix sockaddrs (eg, the client side
of a connection, or a socketpair() socket), and add unix domain socket
support to the socket-client and socket-server test programs to make
sure this all works.

https://bugzilla.gnome.org/show_bug.cgi?id=615960
2010-04-22 11:54:41 -04:00
Matthias Clasen
f3e04973e7 Rename gsettings-tool to gsettings
And make it verb-based.
2010-04-22 01:17:02 -04:00
Matthias Clasen
03a0f05058 Add a note about requiring a new enough GConf 2010-04-21 12:37:38 -04:00
Matthias Clasen
3bfd739154 Rename gsettingsschemaupdatecache to the more sane gschema_compile
To follow existing glib pc variables for binaries.
2010-04-21 11:55:00 -04:00
Bastien Nocera
662f97fefb Update GSettings porting guide for new m4 macro 2010-04-21 16:49:00 +01:00
Matthias Clasen
12b801cab4 Nuke the gsettingsschemadir pc variable
Not really useful, just use $(prefix)/glib-2.0/schemas. We are getting
m4 sugar to coat this over, anyway.
2010-04-21 10:59:17 -04:00
Bastien Nocera
9176175fc8 Add mention of GConfBridge in conversion docs
https://bugzilla.gnome.org/show_bug.cgi?id=616384
2010-04-21 14:37:16 +01:00
Matthias Clasen
463203ee0a Add gettext-domain when required, and allow to specify it on the cmdline
Bug 616309
2010-04-20 22:55:15 -04:00
Matthias Clasen
bedf4c3259 Add documentation and translation for gsettings-tool 2010-04-20 22:55:15 -04:00
Matthias Clasen
31a5342784 Refer to the right directory 2010-04-20 19:51:28 -04:00
Matthias Clasen
1b61680abb Flesh out the porting guide some more 2010-04-20 19:40:26 -04:00
Matthias Clasen
3277b77769 Document g_settings_bind_writable 2010-04-20 19:40:26 -04:00
Javier Jardón
bed462046a [docs] Fix G_VALUE_COLLECT_INIT documentation
Add the documentation to the corresponding section

This macro was introduced in
commit 546fc0ca33
2010-04-20 02:12:02 +02:00
Matthias Clasen
cd9b8b563f 2.25.0 2010-04-19 17:30:42 -04:00
Matthias Clasen
1064097504 Add a bit about autofoo for schemas
Always a good idea to have copiable snipplets in a porting guide...
2010-04-19 08:57:19 -04:00
Matthias Clasen
32de7d6905 Fix up docs for backend setup functions 2010-04-18 15:57:11 -04:00
Matthias Clasen
b7afff0033 Add a man page for gio-querymodules 2010-04-18 15:54:54 -04:00
Matthias Clasen
eaae8f6578 Whitespace fix 2010-04-18 15:35:22 -04:00
Matthias Clasen
a6bd74a08d Update the gschema-compile docs
Correct the schema file extension, mention the usual locations
for schemas and add a reference to gsettings-schema-convert.
2010-04-18 14:58:50 -04:00
David King
9023ac0934 [docs] Remove unused sgml template from GObject documentation
https://bugzilla.gnome.org/show_bug.cgi?id=589351

Signed-off-by: Javier Jardón <jjardon@gnome.org>
2010-04-18 20:21:10 +02:00
Matthias Clasen
87e68c75bc Distcheck fixes 2010-04-17 20:13:59 -04:00
Matthias Clasen
3db0f554e4 Some build fixes 2010-04-17 16:57:28 -04:00
Matthias Clasen
0d7fbae04c Remove garbage 2010-04-17 00:36:14 -04:00
Matthias Clasen
bd273f9e09 Merge the GSettings docs 2010-04-17 00:31:41 -04:00
Matthias Clasen
61a5692fa1 Man page tweaks
Add enough info to keep the docbook stylesheets from embedding
FIXMEs in the formatted output.
2010-04-16 20:43:53 -04:00
Matthias Clasen
51d40405de Man page tweaks 2010-04-16 20:40:02 -04:00
Matthias Clasen
4c90d4cd45 Add indices for 2.26 api additions 2010-04-16 19:13:51 -04:00
Ryan Lortie
18ba085d0a merge GSettingsBackend 2010-04-15 14:59:41 -04:00
Ryan Lortie
8d6492ed15 Remove accidental checkins 2010-04-15 14:44:59 -04:00
Javier Jardón
c3f1025c33 Remove g_type_class_get_private() public documentation
This is a internal function needed for the documented
G_TYPE_CLASS_GET_PRIVATE() macro

This was introduced by error in
commit 81e2aa941b
2010-03-29 18:23:48 +02:00
Matthias Clasen
5ba8043f12 Third try to get this right... 2010-03-26 11:15:49 -04:00
Matthias Clasen
6cce575a25 Fix a typo 2010-03-26 10:24:06 -04:00
Matthias Clasen
81e2aa941b Some more doc cleanups 2010-03-26 10:11:46 -04:00
Matthias Clasen
431840a44e Add g_io_module_query to docs 2010-03-26 09:22:58 -04:00
Ryan Lortie
816990a011 GVariant: Removing mentions of &a from docs
This isn't supported anymore (for the time being...)

Partial fix for bug 613618.
2010-03-23 09:18:14 -05:00
Christian Dywan
35059f2c04 Correct typo of libray/ library in GObject tutorial
Fixes bug #613667
2010-03-23 11:59:43 +01:00
Ryan Lortie
0afc140712 2.23.6 2010-03-21 20:06:39 -05:00
Ryan Lortie
6f33038397 gtk-doc fixups 2010-03-21 14:12:48 -05:00
Ryan Lortie
bf4dbdbf0e merge GVariant parser 2010-03-21 12:55:30 -05:00
Ryan Lortie
9dea0253a3 GVariant: add loading, byteswapping, normalisation 2010-03-14 15:56:18 -04:00
Colin Walters
f552689058 [GDesktopAppInfo] New function g_desktop_app_info_get_filename
This allows access to the full file path, where possible.

https://bugzilla.gnome.org/show_bug.cgi?id=612832
2010-03-14 15:45:46 -04:00
Javier Jardón
62a133f55d Improve the documentation about single include exceptions
Also, reenable the compiling Glib application section
Fixes https://bugzilla.gnome.org/show_bug.cgi?id=612736
2010-03-13 01:33:09 +01:00
Ryan Lortie
f9d8d70396 gtk-doc: ignore gvariant-internal.h 2010-03-08 11:29:27 -05:00
Ryan Lortie
929a2e1ae1 Add gvariant-varargs.xml to the distribution 2010-03-08 11:25:37 -05:00
Ryan Lortie
75f761bcaa GVariant variable arguments, tests, cleanups
Merge GVariant variable arguments support and put it under tests.

Also, remove the hack of the test case directly '#include'ing .c files
from glib/.  Instead, create a non-installed gvariant-internal.h that
the tests can include and make the symbols in it visible on the symbol
table of the shared library.  These symbols (as they are present in no
installed header files) are not part of the API of GLib.

Increase test coverage in a few other areas.
2010-03-08 10:31:19 -05:00
Ryan Lortie
dfcee5865b gtk-doc: ignore GBuffer 2010-03-07 02:15:37 -05:00
Stefan Kost
fa32ee5610 docs: exchange "Subversion" with "source code repository"
Fixes the outdated reference.
2010-03-06 13:36:38 +02:00
Claudio Saavedra
766183c079 Remove GUtf8InputStream leftover in docs
Fixes build.
2010-03-04 19:18:12 +02:00
Behdad Esfahbod
343cbf25c7 Bug 608196 - Overflow-safe g_new family
New public API:

g_malloc_n
g_malloc0_n
g_realloc_n
g_try_malloc_n
g_try_malloc0_n
g_try_realloc_n
2010-03-03 17:54:49 -05:00
Felix Riemann
373f3d8b52 Fix API docs for GZlibCompressor and GZlibDecompressor
Corrects the general descriptions and makes the signals and implemented
interfaces appear.
2010-03-03 17:44:28 +01:00
Ryan Lortie
fe6e278a87 GVariantBuilder: allow for stack allocation 2010-03-03 03:38:02 -05:00
Paolo Borelli
277b9717da Remove utf8inputstream leftovers in a few other places 2010-03-01 10:24:43 +01:00
Ryan Lortie
515434bdcb GVariantIter, GVariantBuilder 2010-02-22 00:39:01 -05:00
Matthias Clasen
3983418c25 Fix up GFileDescriptorBased docs 2010-02-21 19:55:02 -05:00
Matthias Clasen
03fc92784d Add indices for 2.24 additions 2010-02-21 19:48:22 -05:00
Matthias Clasen
80a160c7c6 Small doc fixes 2010-02-21 19:46:57 -05:00
Matthias Clasen
de6914a46a Add a pointer to G_DEFINE_INTERFACE 2010-02-21 15:32:08 -05:00
Ryan Lortie
ed3c914cdb Merge the main public API of GVariant 2010-02-19 10:52:03 -05:00
Ryan Lortie
1e655eb02c merge GVariant 2010-02-10 11:35:01 -05:00
Matthias Clasen
f570cf99b3 Doc cleanups 2010-02-09 09:16:23 -05:00
Ryan Lortie
3443f47ddf G{Byte,Ptr,}Array: move docs from tmpl to .c 2010-02-01 12:39:29 -05:00
Ryan Lortie
501a2906d3 GList, GSList: move docs from tmpl to .c 2010-02-01 12:39:24 -05:00
Ryan Lortie
c8c5c5a991 remove trailing whitespace breaking .gitignore 2010-02-01 10:28:39 -05:00
Ryan Lortie
4bdf7d12a8 GIOChannel: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
4353151449 GTree, GNode: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
d81506a154 GThreadPool: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
c471468ca4 GRelation: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
21a6b69f4f GCache: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
fa7cafae5c GChecksum: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
5ee096636b GCompletion: move docs from tmpl to .c 2010-02-01 10:28:39 -05:00
Ryan Lortie
6d52d34dff data{list,sets}, quarks: move docs from tmpl to .c 2010-01-30 23:34:19 -05:00
Ryan Lortie
c7000fcfec GPattern: move docs from tmpl to .c 2010-01-30 23:10:34 -05:00
Ryan Lortie
84572f81bf String chunks: move docs from tmpl to .c 2010-01-30 23:04:52 -05:00
Ryan Lortie
4431ac5dda Move allocator and memchunk docs from tmpl to .c 2010-01-30 22:58:43 -05:00
Ryan Lortie
3a161ee8f3 GSequence: move docs from tmpl to .c 2010-01-30 22:19:29 -05:00
Ryan Lortie
0ab7bb4b18 GShell: move docs from tmpl to .c 2010-01-30 22:15:50 -05:00
Ryan Lortie
f6482a1eaa GTimer: move docs from tmpl to .c 2010-01-30 22:12:22 -05:00
Ryan Lortie
4c58a85dd1 Revert accidental commit "dirt"
This reverts commit c46bc6ba1f.
2010-01-30 16:00:51 -05:00
Ryan Lortie
c46bc6ba1f dirt 2010-01-30 13:30:00 -05:00
Ryan Lortie
6857767b86 move threads docs to .c 2010-01-30 13:30:00 -05:00
Ryan Lortie
4234481855 GIOChannel: fill in missing docs 2010-01-30 13:30:00 -05:00
Ryan Lortie
d51b6c471a GRand: move docs from tmpl to inline comments 2010-01-30 12:32:37 -05:00
Ryan Lortie
c73d281843 GHash: move docs from tmpl to inline comments 2010-01-28 22:36:48 -05:00
Ryan Lortie
669b0f2d6b Bug 548967 - 1 bit mutex lock
Add support for a mutex lock that consumes only one bit of storage
inside of an integer on systems that support futexes.  Futex is emulated
(at a higher cost) on systems that don't have it -- but only in the
contended case.
2010-01-28 12:40:46 -05:00
Ryan Lortie
595cad2531 glib docs: Delete and ignore empty .tmpl files 2010-01-28 12:40:45 -05:00
Behdad Esfahbod
082ff883b6 Improve type documentation 2010-01-26 16:12:20 -05:00
Matthias Clasen
f13804f68e Minor docs update 2010-01-25 12:46:35 -05:00
Ryan Lortie
0ccb288da1 merge GVariantType
GVariantType is the type system for GVariant
2010-01-25 11:27:28 -05:00
Alexander Larsson
fa2bced1f3 Enable threads in g_type_init()
This means threads will be supported for all gobject libraries/applications
and initialized early enough to not cause any problems.

This solves the problem of libraries needing threadsafety. Previosly
they just called g_threads_init() anyway, which often works but sometimes
breaks in unexpected ways.

See this thread for more details:
http://mail.gnome.org/archives/gtk-devel-list/2009-November/msg00208.html

https://bugzilla.gnome.org/show_bug.cgi?id=606775
2010-01-12 21:37:29 +01:00
Alexander Larsson
0df3ca8f9b Relax g_thread_init() requirements
We now allow g_thread_init(NULL) to be called after other glib calls (with
some minor limitations). This is mainly a documentation change as this
really was already possible.

We also allow g_thread_init() to be called multiple times. Only the
first call actually initializes the threading system, further calls
are ignored (but print a warning if the argument is not NULL).

https://bugzilla.gnome.org/show_bug.cgi?id=606775
2010-01-12 21:37:20 +01:00
Stefan Kost
7211f7f8eb docs: switch to xi:inbclude for the content to save some more seconds 2010-01-07 11:34:01 +02:00