diff options
| author | Federico Mena Quintero <federico@ximian.com> | 2004-04-16 00:45:21 +0000 |
|---|---|---|
| committer | Federico Mena Quintero <federico@src.gnome.org> | 2004-04-16 00:45:21 +0000 |
| commit | df84bd5f573e50e54b877e1d2e41f2b8f9c9fe8b (patch) | |
| tree | b133003dbc17df42add1f8969a091eabe26a87d7 /docs | |
| parent | a1632f174c9f46333ad8e8cc01d81d33c3928f3b (diff) | |
| download | gtk+-df84bd5f573e50e54b877e1d2e41f2b8f9c9fe8b.tar.gz | |
Added a section explaining character encoding for filenames.
2004-04-15 Federico Mena Quintero <federico@ximian.com>
* gtk/tmpl/gtkfilechooser.sgml: Added a section explaining
character encoding for filenames.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/reference/ChangeLog | 5 | ||||
| -rw-r--r-- | docs/reference/gtk/tmpl/gtkfilechooser.sgml | 29 |
2 files changed, 34 insertions, 0 deletions
diff --git a/docs/reference/ChangeLog b/docs/reference/ChangeLog index 8bbf232b57..90246a2f3e 100644 --- a/docs/reference/ChangeLog +++ b/docs/reference/ChangeLog @@ -1,3 +1,8 @@ +2004-04-15 Federico Mena Quintero <federico@ximian.com> + + * gtk/tmpl/gtkfilechooser.sgml: Added a section explaining + character encoding for filenames. + 2004-04-13 Matthias Clasen <mclasen@redhat.com> * gtk/tmpl/gtkuimanager.sgml: Some corrections. diff --git a/docs/reference/gtk/tmpl/gtkfilechooser.sgml b/docs/reference/gtk/tmpl/gtkfilechooser.sgml index 8d88ae5324..f8a003f9c3 100644 --- a/docs/reference/gtk/tmpl/gtkfilechooser.sgml +++ b/docs/reference/gtk/tmpl/gtkfilechooser.sgml @@ -15,6 +15,35 @@ File chooser interface used by #GtkFileChooserWidget and #GtkFileChooserDialog. programming interface. </para> + <refsect2 id="gtkfilechooser-encodings"> + <title>File Names and Encodings</title> + + <para> + When the user is finished selecting files in a + #GtkFileChooser, your program can get the selected names + either as filenames or as URIs. For URIs, the normal escaping + rules are applied if the URI contains non-ASCII characters. + However, filenames are <emphasis>always</emphasis> returned in + the character set specified by the + <envar>G_FILENAME_ENCODING</envar> environment variable. + Please see the Glib documentation for more details about this + variable. + </para> + + <important> + <para> + This means that while you can pass the result of + gtk_file_chooser_get_filename() to + <function>open(2)</function> or + <function>fopen(3)</function>, you may not be able to + directly set it as the text of a #GtkLabel widget unless you + convert it first to UTF-8, which all GTK+ widgets expect. + You should use g_filename_to_utf8() to convert filenames + into strings that can be passed to GTK+ widgets. + </para> + </important> + </refsect2> + <refsect2 id="gtkfilechooser-preview"> <title>Adding a Preview Widget</title> |