diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index b180d6aa7b..78c861aaee 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,21 @@ +Sat Jul 31 17:20:22 2004 Matthias Clasen + + * gtk/gtk-sections.txt: Add some forgotten functions. + +Sat Jul 31 17:18:57 2004 Matthias Clasen + + * gtk/framebuffer.sgml: + * gtk/windows.sgml: + * gtk/x11.sgml: + * gtk/running.sgml: Reorganize backend-specific cmdline + arguments and environment variables, fill the Windows + sections, add XDG_DATA_HOME, XDG_DATA_DIRS. + +Sat Jul 31 14:06:32 2004 Matthias Clasen + + * gtk/running.sgml: We use GTK2_RC_FILES instead of + GTK_RC_FILES... + 2004-07-30 Matthias Clasen * gtk/gtk-sections.txt: Update to combo box api changes. diff --git a/docs/reference/gtk/framebuffer.sgml b/docs/reference/gtk/framebuffer.sgml index da3d0ee42f..6ad1cce2a9 100644 --- a/docs/reference/gtk/framebuffer.sgml +++ b/docs/reference/gtk/framebuffer.sgml @@ -92,7 +92,7 @@ virtual console in the current resolution and bit-depth. This can be changed by specifying environment variables: - + GDK_VT: unset means open on the current VT. diff --git a/docs/reference/gtk/gtk-sections.txt b/docs/reference/gtk/gtk-sections.txt index 6bce20a256..1cdabc4252 100644 --- a/docs/reference/gtk/gtk-sections.txt +++ b/docs/reference/gtk/gtk-sections.txt @@ -22,6 +22,8 @@ gtk_about_dialog_get_website_label gtk_about_dialog_set_website_label gtk_about_dialog_get_authors gtk_about_dialog_set_authors +gtk_about_dialog_get_artists +gtk_about_dialog_set_artists gtk_about_dialog_get_documenters gtk_about_dialog_set_documenters gtk_about_dialog_get_translator_credits diff --git a/docs/reference/gtk/running.sgml b/docs/reference/gtk/running.sgml index 40f2374645..e3624db65d 100644 --- a/docs/reference/gtk/running.sgml +++ b/docs/reference/gtk/running.sgml @@ -22,7 +22,9 @@ How to run and debug your GTK+ application All GTK+ applications support a number of standard commandline options. These are removed from argv by gtk_init(). Modules may parse and remove -further options. +further options. The X11 and +Windows GDK backends parse +some additional commandline options. @@ -77,7 +79,7 @@ list them here for completeness nevertheless. <systemitem>--class <replaceable>class</replaceable></systemitem> -Sets the program class; see gdk_set_program_class(). +Sets the program class; see gdk_set_program_class(). @@ -112,68 +114,6 @@ This option is only available if GTK+ has been configured with - -<systemitem>--display <replaceable>display</replaceable></systemitem> - - -The name of the X display to open instead of the one specified -in the DISPLAY environment variable. -This option is only available if GTK+ has been configured with -. - - - - -<systemitem>--screen <replaceable>screen_number</replaceable></systemitem> - - - The number of the screen within the default display. This overrides - any screen number specified in the display name specified by - by he --display command line option or - the DISPLAY environment variable. If this screen - cannot be opened, then GTK+ will fall back to the screen - specified in the display name. This option is not useful - interactively; the intended purposes is that when a program - registers its command line with a session - manager for later restarting, it can save the - screen it is on, without having to worry if it might be - restarted on a different display. - - - - -<systemitem>--sync</systemitem> - - -Makes all X requests synchronously. This is a useful option for -debugging, but it will slow down the performance considerably. -This option is only available if GTK+ has been configured with -. - - - - -<systemitem>--gxid-host <replaceable>host</replaceable></systemitem> - - -The host to contact the gxid daemon on; overrides -the GXID_HOST environment variable. -This option is only available if GTK+ has been configured with -. - - - - -<systemitem>--gxid-port <replaceable>port</replaceable></systemitem> - - -The port for the connection to gxid; overrides -the GXID_PORT environment variable. -This option is only available if GTK+ has been configured with -. - - - @@ -182,7 +122,11 @@ This option is only available if GTK+ has been configured with GTK+ inspects a number of environment variables in addition to standard variables like LANG, PATH, HOME -or DISPLAY; mostly to determine paths to look for certain files. +or DISPLAY; mostly to determine paths to look for certain +files. The X11, +Windows and +Framebuffer GDK backends use some +additional environment variables. @@ -285,7 +229,7 @@ or DISPLAY; mostly to determine paths to look for certain files. - <envar>GTK_RC_FILES</envar> + <envar>GTK2_RC_FILES</envar> Specifies a list of RC files to parse instead of the default ones; @@ -358,26 +302,15 @@ nevertheless. - - <envar>GXID_HOST</envar> and <envar>GXID_PORT</envar> - - - The host and port to contact the gxid daemon on. - gxid is only necessary on X servers which - don't support using the pointer and extension devices at once, and is - only built if GTK+ is configured with . - The XFree86 X servers don't have this - restriction. - - - - <envar>GDK_USE_XFT</envar> + <envar>XDG_DATA_HOME</envar>, <envar>XDG_DATA_DIRS</envar> - If this variable is set to 1, GTK+ will use the Pango Xft backend instead - of the X backend when possible (i.e. when the X server supports the XRender - extension and Pango has been built with Xft support). + GTK+ uses these environment variables to locate icon themes + and MIME information. For more information, see + Icon Theme Specification, + the Shared MIME-info Database + and the Base Directory Specification. diff --git a/docs/reference/gtk/windows.sgml b/docs/reference/gtk/windows.sgml index ef909a046b..756d2a6f7d 100644 --- a/docs/reference/gtk/windows.sgml +++ b/docs/reference/gtk/windows.sgml @@ -16,9 +16,110 @@ Windows-specific aspects of using GTK+ Using GTK+ on Windows - +The Windows port of GTK+ is an implementation of GDK (and therefore GTK+) +on top of the Win32 API. + + + +Windows-specific commandline options + + +The Windows GDK backend can be influenced with some +additional command line arguments. + + + +<systemitem>--sync</systemitem> + + +Don't batch GDI requests. This is a useful option for +debugging, but it will slow down the performance considerably. + + + + +<systemitem>--no-wintab</systemitem>, + <systemitem>--ignore-wintab</systemitem> + + +Don't use the Wintab API for tablet support. This is the default. + + + + +<systemitem>--use-wintab</systemitem> + + +Use the Wintab API for tablet support, if GTK+ has been compiled +with the option. + + + + +<systemitem>--max-colors <replaceable>number</replaceable></systemitem> + + +In 256 color mode, restrict the size of the color palette to +the specified number of colors. + + + + + + +Windows-specific environment variables + + +The Win32 GDK backend can be influenced with some +additional environment variables. + + + +<envar>GDK_IGNORE_WINTAB</envar> + + +If this variable is set, GTK+ doesn't use +the Wintab API for tablet support. This is the default. + + + + +<envar>GDK_USE_WINTAB</envar> + + +If this variable is set, GTK+ uses the Wintab API for +tablet support, if GTK+ has been compiled with the + option. + + + + +<envar>GDK_WIN32_MAX_COLORS</envar> + + +Specifies the size of the color palette used +in 256 color mode. + + + + +<envar>PRETEND_WIN9X</envar> + + +Only use the Windows 9x API. + + + + + diff --git a/docs/reference/gtk/x11.sgml b/docs/reference/gtk/x11.sgml index 9054e42a91..7431293a8a 100644 --- a/docs/reference/gtk/x11.sgml +++ b/docs/reference/gtk/x11.sgml @@ -27,6 +27,106 @@ see GDK X Window System interaction in the GDK manual. + +X11-specific commandline options + + +The X backend understands some additional command line +arguments. + + + +<systemitem>--display <replaceable>display</replaceable></systemitem> + + +The name of the X display to open instead of the one specified +in the DISPLAY environment variable. + + + + +<systemitem>--screen <replaceable>screen_number</replaceable></systemitem> + + + The number of the screen within the default display. This overrides + any screen number specified in the display name specified by + by he --display command line option or + the DISPLAY environment variable. If this screen + cannot be opened, then GTK+ will fall back to the screen + specified in the display name. This option is not useful + interactively; the intended purposes is that when a program + registers its command line with a session + manager for later restarting, it can save the + screen it is on, without having to worry if it might be + restarted on a different display. + + + + +<systemitem>--sync</systemitem> + + +Makes all X requests synchronously. This is a useful option for +debugging, but it will slow down the performance considerably. + + + + +<systemitem>--gxid-host <replaceable>host</replaceable></systemitem> + + +The host to contact the gxid daemon on; overrides +the GXID_HOST environment variable. + + + + +<systemitem>--gxid-port <replaceable>port</replaceable></systemitem> + + +The port for the connection to gxid; overrides +the GXID_PORT environment variable. +This option is only available if GTK+ has been configured with +. + + + + + + +X11-specific environment variables + + +The X backend can be influenced with some +additional environment variables. + + + + <envar>GXID_HOST</envar>, <envar>GXID_PORT</envar> + + + The host and port to contact the gxid daemon + on. gxid is only necessary on X servers which + don't support using the pointer and extension devices at once, and is + only built if GTK+ is configured with . + The XFree86 and Xorg + X servers don't have this + restriction. + + + + + <envar>GDK_USE_XFT</envar> + + + If this variable is set to 1, GTK+ will use the Pango Xft backend instead + of the X backend when possible (i.e. when the X server supports the XRender + extension and Pango has been built with Xft support). + + + + + @@ -96,6 +196,11 @@ window managers will ignore certain requests from time to time, in the interests of good user interface. + +