diff options
| author | Stef Walter <stefw@gnome.org> | 2013-12-11 10:32:25 +0100 |
|---|---|---|
| committer | Stef Walter <stefw@gnome.org> | 2013-12-11 10:57:22 +0100 |
| commit | dd6fcf87bb1fd605e4350749dacfed52938e8bb0 (patch) | |
| tree | c35d7258b08bf0e49a993440b743fa51728b6804 /docs | |
| parent | 71e2791ea3f911d71396ff7bc5a85f214bbcb1ec (diff) | |
| download | libsecret-dd6fcf87bb1fd605e4350749dacfed52938e8bb0.tar.gz | |
Mark most of unstable API as stable
This is with the exception of the 'path' functions.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/reference/libsecret/libsecret-using.sgml | 32 |
1 files changed, 0 insertions, 32 deletions
diff --git a/docs/reference/libsecret/libsecret-using.sgml b/docs/reference/libsecret/libsecret-using.sgml index c531b15..0add7c9 100644 --- a/docs/reference/libsecret/libsecret-using.sgml +++ b/docs/reference/libsecret/libsecret-using.sgml @@ -64,22 +64,6 @@ var schema = new Secret.Schema.new("org.mock.Schema", Secret.SchemaFlags.NONE, { "name", Secret.SchemaAttributeType.STRING }); </programlisting></informalexample> -<para> -Some parts of the <application>libsecret</application> API are not yet stable. -It is <emphasis>not</emphasis> recommended that you use these unstable parts -from javascript. Your code <emphasis>will break</emphasis> when the unstable API -changes, and due to the lack of a compiler you will have no way of knowing when -it does. If you must use the unstable API, you would do it like this: -</para> - -<informalexample><programlisting language="javascript"> -// Warning: if you use the unstable API from javascript, your're going to have a bad time -const SecretUnstable = imports.gi.SecretUnstable; - -// ... and a here's sample line of code which uses the import -var collection = SecretUnstable.Collection.for_alias(null, "default", null); -</programlisting></informalexample> - </chapter> <chapter id="using-python"> @@ -98,22 +82,6 @@ schema = Secret.Schema.new("org.mock.Schema", Secret.SchemaFlags.NONE, { "name", Secret.SchemaAttributeType.STRING }) </programlisting></informalexample> -<para> -Some parts of the <application>libsecret</application> API are not yet stable. -It is <emphasis>not</emphasis> recommended that you use these unstable parts -from python. Your code <emphasis>will break</emphasis> when the unstable API -changes, and due to the lack of a compiler you will have no way of knowing when -it does. If you must use the unstable API, you would do it like this: -</para> - -<informalexample><programlisting language="py"> -# Warning: if you use the unstable API from python, your're going to have a bad time -from gi.repository import SecretUnstable - -# ... and a here's sample line of code which uses the import -collection = SecretUnstable.Collection.for_alias(None, "default", None); -</programlisting></informalexample> - </chapter> <chapter id="using-vala"> |