From: Max Kanat-Alexander <mkanat@bugzilla.org>
Date: Sat, 6 Mar 2010 03:19:29 +0000 (-0800)
Subject: Update the stability status of several WebService methods.
X-Git-Tag: bugzilla-3.6rc1~10
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=0284539a083ee87c53836d0756f58720b1ee4f6f;p=thirdparty%2Fbugzilla.git

Update the stability status of several WebService methods.
---

diff --git a/Bugzilla/WebService/Bug.pm b/Bugzilla/WebService/Bug.pm
index dc44b15f59..4d98d57872 100644
--- a/Bugzilla/WebService/Bug.pm
+++ b/Bugzilla/WebService/Bug.pm
@@ -1090,7 +1090,7 @@ private attachments.
 
 =item C<comments>
 
-B<UNSTABLE>
+B<STABLE>
 
 =over
 
@@ -1228,7 +1228,7 @@ that id.
 
 =item C<get> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1255,7 +1255,7 @@ Note that it's possible for aliases to be disabled in Bugzilla, in which
 case you will be told that you have specified an invalid bug_id if you
 try to specify an alias. (It will be error 100.)
 
-=item C<permissive> B<UNSTABLE>
+=item C<permissive> B<EXPERIMENTAL>
 
 C<boolean> Normally, if you request any inaccessible or invalid bug ids,
 Bug.get will throw an error. If this parameter is True, instead of throwing an
@@ -1304,12 +1304,14 @@ isn't a duplicate of any bug, this will be an empty int.
 
 C<int> The numeric bug_id of this bug.
 
-=item internals B<UNSTABLE>
+=item internals B<DEPRECATED>
 
 A hash. The internals of a L<Bugzilla::Bug> object. This is extremely
 unstable, and you should only rely on this if you absolutely have to. The
 structure of the hash may even change between point releases of Bugzilla.
 
+This will be disappearing in a future version of Bugzilla.
+
 =item is_open 
 
 C<boolean> Returns true (1) if this bug is open, false (0) if it is closed.
@@ -1344,7 +1346,7 @@ C<string> The summary of this bug.
 
 =back
 
-=item C<faults> B<UNSTABLE>
+=item C<faults> B<EXPERIMENTAL>
 
 An array of hashes that contains invalid bug ids with error messages
 returned for them. Each hash contains the following items:
@@ -1436,7 +1438,7 @@ in Bugzilla B<3.4>:
 
 =item C<history> 
 
-B<UNSTABLE>
+B<EXPERIMENTAL>
 
 =over
 
@@ -1736,7 +1738,7 @@ for that value.
 
 =item C<create> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1879,7 +1881,7 @@ B<Required>, due to a bug in Bugzilla.
 
 =item C<add_comment> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1957,7 +1959,7 @@ purposes if you wish.
 
 =item C<update_see_also>
 
-B<UNSTABLE>
+B<EXPERIMENTAL>
 
 =over
 
diff --git a/Bugzilla/WebService/Bugzilla.pm b/Bugzilla/WebService/Bugzilla.pm
index c7bbf7c046..c14cc7deab 100644
--- a/Bugzilla/WebService/Bugzilla.pm
+++ b/Bugzilla/WebService/Bugzilla.pm
@@ -191,7 +191,7 @@ string in (+/-)XXXX (RFC 2822) format.
 
 =item C<time>
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
diff --git a/Bugzilla/WebService/User.pm b/Bugzilla/WebService/User.pm
index 67a4720deb..76d4d3e376 100644
--- a/Bugzilla/WebService/User.pm
+++ b/Bugzilla/WebService/User.pm
@@ -370,7 +370,7 @@ An account with that email address already exists in Bugzilla.
 
 =item C<create> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -439,7 +439,7 @@ password is under three characters.)
 
 =item C<get> 
 
-B<UNSTABLE>
+B<STABLE>
 
 =over