mirror of
https://gitlab.gnome.org/GNOME/glib.git
synced 2024-12-25 15:06:14 +01:00
fa0f51ddf8
This is meant for opaque, non-POSIX-like backends to indicate that the URI is not persistent. Applications should look at G_FILE_ATTRIBUTE_STANDARD_SYMLINK_TARGET for the persistent URI. Examples of such backends could be a portal for letting sandboxed applications access the file-system, or a database-backed storage like Google Drive. In these cases, the user visible file and folder names are different from the real identifiers, used by the backend. So, a request to create google-drive://user@gmail.com/foo/New\ File, would actually lead to google-drive://user@gmail.com/foo/bar on the server even though the user visible name is still "New File". Since the server-defined URI is persistent and sanity-checked by the backend, it is recommended that applications switch to it as soon as possible. Backends will try to keep a mapping from "fake" to "real" URIs, but those are only on a best effort basis. They might not be persistent or have the same guarantees as the "real" URIs. https://bugzilla.gnome.org/show_bug.cgi?id=741602 |
||
---|---|---|
.. | ||
gio | ||
glib | ||
gobject | ||
.gitignore | ||
AUTHORS | ||
ChangeLog | ||
COPYING | ||
Makefile.am | ||
NEWS | ||
README |
This package contains the reference documentation for GLib. For more information about Glib, see: http://www.gtk.org For information about contributing to the GLib/GTK+ reference documentation project, see: http://www.gtk.org/rdp/ The GLib reference documentation is freely redistributable, see the file COPYING for details. REQUIREMENTS ============ To build the documentation, you must have the gtk-doc package installed. To rebuild the template files, you must have the current version of the GLib header files installed. BUILD ===== First, run configure to generate the makefiles for this module. There is one option specific to this package --with-html-dir=DIR top of installed HTML documentation tree The Makefiles for this module define three targets: templates: Scan the headers and merge the results with the current template files sgml: Generate SGML files using the DocBook DTD from the template files html: Generate HTML from the SGML files. To build the documentation, do: make sgml make html You should only run the 'make templates' step if you need to regenerate the templates for a more recent version of the GLib sources. INSTALLATION ============ make install