Commit Graph

107 Commits

Author SHA1 Message Date
Matthias Clasen
f67ab808fd doc fixes 2011-01-30 23:35:25 -05:00
Matthias Clasen
f6cd9c1553 Documentation tweaks 2011-01-29 22:47:33 -05:00
Matthias Clasen
1915a19503 Add deprecation notes 2010-12-04 15:39:46 +01:00
Javier Jardón
36c669aaca [docs] Fix missing comma in gtkrc docs
Reported by Alexander Saprykin in bug
https://bugzilla.gnome.org/show_bug.cgi?id=621775
2010-06-16 19:51:04 +02:00
Bastien Nocera
4551509af1 Make it easy for apps to have dark themes
Some types of applications would benefit from having "dark" themes,
usually black backgrounds, such as:
* Movie players
* Photo management and display applications

To make it easy for those applications to prefer a dark theme,
we're adding the "gtk-application-prefer-dark-theme" GtkSetting, which
will make the theme loading code automatically look for a "gtkrc-dark"
file in the same directory you would usually find a gtkrc file.
the same name and a "-dark" suffix.

If no "-dark" gtkrc variant is available, the normal gtkrc will
be used.

https://bugzilla.gnome.org/show_bug.cgi?id=617955
2010-05-10 01:15:14 +01:00
Matthias Clasen
7447ef0fc2 Make 3.0 parallel-installable to 2.x
In particular, rename

  - libraries to lib*-3.0.so
  - pc files to *-3.0.pc
  - include paths to /usr/include/gtk-3.0/*
  - module paths to /usr/lib/gtk-3.0/*
  - rc files names to gtk-3.0/gtkrc
  - commandline utilities to *-3.0
  - adjust documentation

Also change the install location for unix-print headers to
/usr/include/gtk-3.0/unix-print/gtk.
2010-05-08 01:18:53 -04:00
Matthias Clasen
10e3a68267 More of the same
svn path=/trunk/; revision=21822
2008-11-29 07:56:32 +00:00
Matthias Clasen
a8fc5b41a4 2.11.3
svn path=/trunk/; revision=18154
2007-06-16 02:02:37 +00:00
Matthias Clasen
08cc834061 Update docs Deprecate gtk_widget_{ref,unref}
2007-06-09  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkwidget.c:
        * gtk/gtkscrolledwindow.c: Update docs
        * gtk/gtkwidget.h: Deprecate gtk_widget_{ref,unref}

        * gtk/tmpl/gtkbindings.sgml:
        * gtk/tmpl/gtkrc.sgml:
        * gtk/tmpl/gtkwidget.sgml:
        * gtk/tmpl/gtkrecentmanager.sgml:
        * gtk/*.sgml:
        * gtk/tmpl/gtkstock.sgml:
        * gtk/gtk-sections.txt: Updates



svn path=/trunk/; revision=18090
2007-06-10 06:52:51 +00:00
Matthias Clasen
98e2295efc Add deprecation guards for gtk_rc_style_ref/unref and the old file
2007-01-27  Matthias Clasen  <mclasen@redhat.com>

        * gtk/gtkfilesel.h:
        * gtk/gtkrc.h:
        * gtk/gtk.symbols: Add deprecation guards for gtk_rc_style_ref/unref
        and the old file selector.  (#348256)



svn path=/trunk/; revision=17223
2007-01-27 05:34:05 +00:00
Tim Janik
f58c280d21 document gtk_binding_entry_skip().
Wed Oct 11 14:31:30 2006  Tim Janik  <timj@imendio.com>

        * docs/reference/gtk/gtk-sections.txt:
        * gtk/gtkbindings.c: document gtk_binding_entry_skip().
2006-10-11 12:32:26 +00:00
Tim Janik
f02fda90b7 documented GtkBinding*, #358329.
Tue Oct 10 15:29:15 2006  Tim Janik  <timj@imendio.com>

        * gtk/tmpl/gtkbindings.sgml: documented GtkBinding*, #358329.
2006-10-10 13:30:55 +00:00
Matthias Clasen
2fba613b4d 2.9.0 2006-05-05 16:21:19 +00:00
Matthias Clasen
b435c6b967 Syntax fixes.
2006-03-28  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkcellrendereraccel.sgml:
	* gtk/tmpl/gtkrc.sgml:
	* gtk/directfb.sgml: Syntax fixes.
2006-03-28 18:47:43 +00:00
Matthias Clasen
997470889e Document <classname> in paths.
2006-03-23  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkrc.sgml: Document <classname> in paths.
2006-03-23 23:35:24 +00:00
Matthias Clasen
a271dfe0fd More updates 2006-02-12 06:14:35 +00:00
Matthias Clasen
06e52eee43 Updates 2006-02-12 06:11:02 +00:00
Matthias Clasen
9856c1b25a Document symbolic colors and color expressions.
2005-11-23  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkrc.sgml: Document symbolic colors and
	color expressions.
2005-11-23 17:11:36 +00:00
Tim Janik
aecc12a9b2 added anchor. complexity doesn't get worse than O(n^2) with recent glib.
Tue Sep 20 17:16:50 2005  Tim Janik  <timj@imendio.com>

        * gtk/tmpl/gtkrc.sgml: added anchor. complexity doesn't get worse
        than O(n^2) with recent glib.
2005-09-20 15:18:13 +00:00
Tim Janik
fbd3568e4c fixed wording and typos in some places. added a new section "Optimizing RC
Tue Sep 13 14:16:27 2005  Tim Janik  <timj@imendio.com>

        * gtk/tmpl/gtkrc.sgml: fixed wording and typos in some places.
        added a new section "Optimizing RC Style Matches".
2005-09-13 12:19:07 +00:00
Matthias Clasen
58a1af804c 2.7.0 2005-06-20 22:06:27 +00:00
Matthias Clasen
69b1611e59 Add a "ref and sink" question. (#156865, Philip Langdale, text based on a
2004-11-01  Matthias Clasen  <mclasen@redhat.com>

	* gtk/question_index.sgml: Add a "ref and sink" question.
	(#156865, Philip Langdale, text based on a comment by Owen
	Taylor)

	* gtk/tmpl/gtkrc.sgml: Document im_module_file and settings
	assignments as toplevel statements.
2004-11-01 19:19:06 +00:00
Matthias Clasen
f543bef062 Document im_module_file and settings assignments as toplevel statements.
2004-11-01  Matthias Clasen  <mclasen@redhat.com>

	* gtk/tmpl/gtkrc.sgml: Document im_module_file and settings
	assignments as toplevel statements.
2004-11-01 18:22:33 +00:00
Matthias Clasen
6c021548e4 Fix a typo 2004-08-07 13:16:55 +00:00
Matthias Clasen
d8f5db0fe3 Document that [xy]thickness can be specified in a style.
Sat Mar  6 23:50:37 2004  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkrc.sgml: Document that [xy]thickness can
	be specified in a style.
2004-03-06 22:46:44 +00:00
Jonathan Blandford
d40eda7e87 Add two more folder modes to the enum.
Thu Feb 26 18:25:57 2004  Jonathan Blandford  <jrb@gnome.org>

        * gtk/gtkfilechooser.h (GtkFileChooserAction): Add two more folder
        modes to the enum.

        * gtk/gtkfilechooser.c (gtk_file_chooser_set_folder_mode): Remove.
        (gtk_file_chooser_get_folder_mode): Remove
2004-02-26 23:35:05 +00:00
Owen Taylor
9e3f0c6f5f Document named icon system.
Wed Jul  2 18:15:21 2003  Owen Taylor  <otaylor@redhat.com>

        * gtk/Makefile.am gtk/gtk-docs.sgml gtk/gtksections.txt
        gtk/tmpl/gtkicontheme.sgml: Document named icon system.

        * gtk/tmpl/gtkrc.sgml: Mention specifying named icons
        as @"icon-name".

        * gtk/tmpl/gtkimage.sgml: Add a cross-reference to stock
        icons.
2003-07-02 22:45:30 +00:00
Matthias Clasen
43d0d79cc0 Document that font and fontset declarations are ignored.
2003-02-11  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkrc.sgml: Document that font and fontset declarations
	are ignored.
2003-02-11 00:32:28 +00:00
Matthias Clasen
1f71780c75 Fix integer color range. (#103992)
2003-01-21  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkrc.sgml: Fix integer color range.  (#103992)
2003-01-20 23:11:18 +00:00
Matthias Clasen
1b3f21e870 Update description of priorities for styles and bindings. (#98054)
2003-01-03  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkrc.sgml: Update description of priorities for styles
	and bindings.  (#98054)
2003-01-03 22:50:40 +00:00
Matthias Clasen
01fbc3b649 Add a note about gtkrc-2.0 being parsed by all 2.x versions.
2002-12-31  Matthias Clasen  <maclas@gmx.de>

	* gtk/tmpl/gtkrc.sgml: Add a note about gtkrc-2.0 being parsed by
	all 2.x versions.
2002-12-31 00:25:04 +00:00
Matthias Clasen
27e0fcf195 Link to style properties.
* gtk/tmpl/gtkrc.sgml: Link to style properties.
2002-12-17 18:38:35 +00:00
Matthias Clasen
5d347cad8e Fix a few doc comments. Link to style properties.
2002-12-17  Matthias Clasen  <maclas@gmx.de>

	* gtk/gtkcontainer.c: Fix a few doc comments.
	* gtk/tmpl/gtkrc.sgml: Link to style properties.

	* gtk/tmpl/gtkcontainer.sgml: Add bits about child properties.

	* gtk/tmpl/gtkwidget.sgml: Add bits about style properties.

	* gdk/tmpl/pixmaps.sgml:
	* gdk/tmpl/windows.sgml:
	* gdk/tmpl/drawing.sgml:
	* gdk/tmpl/gcs.sgml:
	* gtk/tmpl/gtktextview.sgml:
	* gtk/tmpl/gtkrc.sgml:
	* gtk/tmpl/gtkiconfactory.sgml:
	* gtk/tmpl/gtkaccelgroup.sgml: Remove ids which are now
	generated by gtk-doc.
2002-12-17 02:07:57 +00:00
Matthias Clasen
1489222cab The label is "Folders" now, not "Directories". (#97224, Vitaly Tishkov)
* gtk/tmpl/gtkfilesel.sgml: The label is "Folders" now, not
	"Directories".  (#97224, Vitaly Tishkov)
	* gtk/tmpl/gtkrc.sgml: Fix a link. Add (minimal) docs for setting
	style properties from rc files. More needed !!
2002-11-01 00:02:05 +00:00
Matthias Clasen
a9b71314ee Lots of trivial doc fixes. 2002-10-11 20:36:21 +00:00
Owen Taylor
279951fe46 Don't use GTK_RC_FILES, since it causes problems with what KDE (etc.) does
Wed Jul 24 16:43:49 2002  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtkrc.c docs/references/tmpl/gtkrc.sgml: Don't use
        GTK_RC_FILES, since it causes problems with what KDE (etc.)
        does to customize GTK+ themes, use GTK2_RC_FILES instead. (#88987)
2002-07-24 20:54:34 +00:00
Matthias Clasen
96937b32e4 Replace homegrown "nbsp", "hash" and "percent" entities by standard ISO
* gtk/tmpl/gtkprogress.sgml:
	* gtk/tmpl/gtkscale.sgml:
	* gtk/tmpl/gtktreemodel.sgml:
	* gtk/tmpl/gtkimage.sgml:
	* gtk/tmpl/gtksignal.sgml:
	* gtk/tmpl/gtkrc.sgml:
	* gtk/gtk-docs.sgml:
	* gdk/gdk-docs.sgml:
	* gdk/tmpl/threads.sgml:
	* gdk/tmpl/cursors.sgml:
	* gdk/tmpl/rgb.sgml: Replace homegrown "nbsp", "hash" and
	"percent" entities by standard ISO entities "nbsp", "num" and
	"percnt".

	* gtk/text_widget.sgml: Fix a link.
2002-06-03 17:47:31 +00:00
Matthias Clasen
2aaf3c0e19 Markup fixes
* gtk/gtkwindow.c (gtk_window_move): Markup fixes

	* gtk/gtkrc.c (gtk_rc_get_module_dir): Markup fixes.

	* gdk/x11/gdkcursor-x11.c (gdk_cursor_new_for_screen): Update docs
	for Docbook XML.

	* gtk/*, gdk/*, gdk-pixbuf/*: Create XML, not SGML.

	* gtk/tmpl/*: Remove property documentation which comes from the
	source now.

	* gtk/building.sgml: Remove traces of gxi.
2002-05-28 22:23:55 +00:00
Owen Taylor
11aed263b7 Set the width of the layout to the actual wrap width (our requisition) not
Tue May 14 16:44:09 2002  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtklabel.c (gtk_label_ensure_layout): Set
        the width of the layout to the actual wrap width
        (our requisition) not the width we set when calculating
        the width. This results in the lines being justified
        within the correct area. (#79157, Anders Carlsson)

        * gtk/gtkaccelgroup.c gtk/gtkmarshelers.list: Corrected
        registered parameter types of "accel_activate" and
        "accel_changed" signals. (Patch from Murray Cumming, #78798)

        * gtk/gtkrc.c (gtk_rc_make_default_dir): Switch
        binary-version and type to correspond to the
        current ordering in _gtk_get_module_path.
        (#78746, Sergey Kuzminov)

        * gtk/gtkrc.c (gtk_rc_get_module_dir): Add docs
        pointing to the GTK_PATH documentation.

        * gtk/Makefile.am (uninstall-local): Delete
        key themes as well. (#81286, Kristian Rietveld.)
2002-05-14 20:55:22 +00:00
Jonathan Blandford
60a1fa69d0 add example to docs, as people are seeming to have trouble with this
Fri Mar 15 12:51:42 2002  Jonathan Blandford  <jrb@redhat.com>

	* gtk/gtktreeviewcolumn.c
	(gtk_tree_view_column_new_with_attributes): add example to docs,
	as people are seeming to have trouble with this function.

Remake docs as well.
2002-03-15 21:47:52 +00:00
Matthias Clasen
85a8b59044 Add some ids which are referenced from the object hierarchy.
* gdk-pixbuf/tmpl/animation.sgml, gdk-pixbuf/tmpl/gdk-pixbuf.sgml,
	gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtktextview.sgml, gtk/tmpl/gtkiconfactory.sgml,
	gtk/tmpl/gtkaccelgroup.sgml: Add some ids which are referenced
	from the object hierarchy.

	* gtk/gtk-docs.sgml: Use parts as top-level division (#61575),
	include gtkaccessible docs.
2002-03-07 23:20:16 +00:00
Owen Taylor
a255d9cd01 Add routines _gtk_find_module(), _gtk_get_module_path() to look up a
Mon Feb 18 23:16:16 2002  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtkmain.[ch]: Add routines _gtk_find_module(),
        _gtk_get_module_path() to look up a module of an arbitrary type in
        a standard fashion. (#68474)

        * gtk/gtkrc.c: Make module_path keyword warn and do
        nothing. Remove the im_module_path keyword.

        * gtk/gtkrc.c (gtk_rc_get_im_module_path): Fix
        to return the standard path instead of one determined
        from im_module_path and GTK_IM_MODULE_PATH.

        * gtk+-2.0.pc.in: Add gtk_host to go along with gtk_binary_version.
2002-02-19 05:33:34 +00:00
Matthias Clasen
6370cf3b8e Remove a (now) misleading comment.
* gtk/gtkrc.c (gtk_rc_parse_file): Remove a (now) misleading comment.

	* gtk/tmpl/gtkrc.sgml: Update the description of RC file loading
	to match recent code changes. Also document font_name and engine.
2002-02-05 22:50:31 +00:00
Matthias Clasen
dee0596686 Documentation.
* gtk/gtkitemfactory.c: Documentation.

        * gtk/tmpl/gtkrc.sgml: Minor fixes.
2002-01-14 00:41:20 +00:00
Matthias Clasen
c1808baa01 Doc typo fix. (#68172)
* gtk/gtksocket.c (gtk_socket_get_id): Doc typo fix. (#68172)

        * gtk/gtktreemodel.c (gtk_tree_path_is_descendant): Fix docs.

        * gtk/gtktreemodel.c (gtk_tree_model_rows_reordered): Document.

        * gtk/gtkwindow.c (gtk_window_remove_accel_group): Fix docs.

        * gtk/gtkrc.c (gtk_rc_get_style_by_paths),
        gtk/gtkwidget.c (gtk_widget_get_toplevel,
        gtk_widget_push_composite_child), gtk/gtkdialog.c
        (gtk_dialog_new_with_buttons, gtk_dialog_run): Keep gtk-doc
        from messing up the indentation of inline examples.

        * gtk/gtkmain.c, gtk/gtkrc.c: Consistently call g_getenv()
        instead of getenv().

        * gtk/gtktreemodel.c, gtk/gtkaccelgroup.c, gtk/gtkclipboard.c,
        gtk/gtkdnd.c, gtk/gtkiconfactory.c, gtk/gtkrc.c,
        gtk/gtkstyle.c, gtk/gtkselection.c: Doc fixes.

        * gtk/gtkaccelmap.c (gtk_accel_map_add_filter,
        gtk_accel_map_foreach_unfiltered, gtk_accel_map_load_scanner):
        Document.

        * gtk/tmpl/gtksocket.sgml: Mention gtk_socket_get_id()
        instead of GTK_WINDOW_XWINDOW().  (#68172)

        * gtk/gtk-sections.txt: Move functions which are documented
        as "private" or "internal" into Private subsections.

        * gtk/tmpl/gtkdnd.sgml, gtk/tmpl/gtkobject.sgml,
        gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtktooltips.sgml,
        gtk/tmpl/gtkwidget.sgml, gtk/tmpl/gtkclipboard.sgml,
        gtk/tmpl/gtkstyle.sgml, gtk/tmpl/gtkselection.sgml,
        gtk/tmpl/gtkfeatures.sgml: Minor markup fixes.

        * gtk/tmpl/gtksignal.sgml: Add link to GLib signal docs.

        * gtk/tmpl/gtkpreview.sgml, gtk/tmpl/gtktext.sgml,
        gtk/tmpl/gtktree.sgml: Remove "deprecated" from short desc.

        * gtk/tmpl/gtkrc.sgml: Correct names of default RC files.
2002-01-08 00:04:57 +00:00
Matthias Clasen
317ba5b267 Small additions.
* gtk/tmpl/gtktextview.sgml: Small additions.

        * gtk/tmpl/gtksignal.sgml: Explain what to use instead.

        * gtk/question_index.sgml, gtk/text_widget.sgml, gtk/tree_widget.sgml,
        gtk/changes-1.2.sgml, gtk/changes-2.0.sgml,
        gtk/framebuffer.sgml: SGML fixes and additions.

        * gtk/tmpl/gtksignal.sgml, gtk/tmpl/gtkdialog.sgml,
        gtk/tmpl/gtkeditable.sgml, gtk/tmpl/gtkfilesel.sgml,
        gtk/tmpl/gtkmain.sgml, gtk/tmpl/gtkmenu.sgml,
        gtk/tmpl/gtkmessagedialog.sgml, gtk/tmpl/gtkrc.sgml,
        gtk/tmpl/gtktogglebutton.sgml, gtk/tmpl/gtkspinbutton.sgml,
        gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkwindow.sgml:
        Replace references to deprecated functions.
2002-01-03 23:04:44 +00:00
Owen Taylor
856a93cb85 Add gtktextutil.h
Sat Dec 22 18:18:07 2001  Owen Taylor  <otaylor@redhat.com>

        * gtk/Makefile.am (IGNORE_HFILES): Add gtktextutil.h

        * gtk/text_widget.sgml (linkend): SGML fixes.

        * gtk/gtk-sections.txt: Update

        * gdk/gdk-sections.txt: Update.

        * gdk/tmpl/cursors.sgml: SGML fix.

        * gdk/gdk-docs.sgml: Add PNG handling magic.
2001-12-23 22:55:17 +00:00
Matthias Clasen
fc4a6b955d Markup fixes.
* gtk/gtkdialog.c, gtk/gtkrc.c, gtk/gtkwidget.c: Markup fixes.

        * gdk-pixbuf-io.c: Markup fixes.

        * gdk-pixbuf/tmpl/scaling.sgml, gdk/tmpl/fonts.sgml,
        gdk/tmpl/general.sgml, gdk/tmpl/rgb.sgml, gdk/tmpl/visuals.sgml,
        gdk/tmpl/windows.sgml, gtk/gtk-docs.sgml, gtk/tmpl/gtkaccellabel.sgml,
        gtk/tmpl/gtkcombo.sgml, gtk/tmpl/gtkdialog.sgml,
        gtk/tmpl/gtkdrawingarea.sgml, gtk/tmpl/gtkeditable.sgml,
        gtk/tmpl/gtkfilesel.sgml, gtk/tmpl/gtkfontseldlg.sgml,
        gtk/tmpl/gtkimage.sgml, gtk/tmpl/gtkmain.sgml, gtk/tmpl/gtkmenu.sgml,
        gtk/tmpl/gtkmessagedialog.sgml, gtk/tmpl/gtkobject.sgml,
        gtk/tmpl/gtkpaned.sgml, gtk/tmpl/gtkradiobutton.sgml,
        gtk/tmpl/gtkrc.sgml, gtk/tmpl/gtkscale.sgml, gtk/tmpl/gtksignal.sgml,
        gtk/tmpl/gtksocket.sgml, gtk/tmpl/gtkspinbutton.sgml,
        gtk/tmpl/gtktogglebutton.sgml, gtk/tmpl/gtksignal.sgml,
        gtk/tmpl/gtktooltips.sgml, gtk/tmpl/gtkwindow.sgml,
        gdk/tmpl/regions.sgml, gtk/tmpl/gtkfontsel.sgml,
        gtk/tmpl/gtkpixmap.sgml, gtk/tmpl/gtkprogress.sgml,
        gtk/tmpl/gtkselection.sgml, gtk/tmpl/gtktable.sgml,
        gtk/tmpl/gtktipsquery.sgml: Markup fixes (mainly examples).
2001-12-13 19:51:24 +00:00
Owen Taylor
b56118cf13 Updates
Wed Nov 21 15:57:29 2001  Owen Taylor  <otaylor@redhat.com>

        * gtk/gtk-sections.txt: Updates

        * gtk/tmpl/gtkstock.sgml: Close end tags.

        * gtk/gtk.types: Remove interface types which gtk-doc
        can't handle currently.

        * gtk/tmpl/gtknotebook.sgml: Fix some garbage in file.

        * gdk/tmpl/x_interaction.sgml: Fix SGML errors.

        * gdk/gdk-overrides.txt gdk/gdk-sections.txt: Updates.
2001-11-21 21:43:47 +00:00
Matthias Clasen
5b10c877c1 Typo fix. Updates. Document the special values <none> and <parent> for
* gdk/x11/gdkinput.c: Typo fix.
        * gdk/tmpl/input_devices.sgml: Updates.
        * gtk/tmpl/gtkrc.sgml: Document the special values <none> and
        <parent> for bg_pixmap.
2001-10-27 20:41:05 +00:00