From a5f14d89b7a5c9f40dac7326cef58909c88e3403 Mon Sep 17 00:00:00 2001
From: Max Kanat-Alexander <mkanat@bugzilla.org>
Date: Fri, 5 Mar 2010 19:16:52 -0800
Subject: Update the stability status of several WebService methods.

---
 Bugzilla/WebService/Bug.pm      | 20 +++++++++++---------
 Bugzilla/WebService/Bugzilla.pm |  2 +-
 Bugzilla/WebService/User.pm     |  4 ++--
 3 files changed, 14 insertions(+), 12 deletions(-)

(limited to 'Bugzilla')

diff --git a/Bugzilla/WebService/Bug.pm b/Bugzilla/WebService/Bug.pm
index b38168602..da6f22c87 100644
--- a/Bugzilla/WebService/Bug.pm
+++ b/Bugzilla/WebService/Bug.pm
@@ -1087,7 +1087,7 @@ private attachments.
 
 =item C<comments>
 
-B<UNSTABLE>
+B<STABLE>
 
 =over
 
@@ -1225,7 +1225,7 @@ that id.
 
 =item C<get> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1252,7 +1252,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
@@ -1301,12 +1301,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.
@@ -1341,7 +1343,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:
@@ -1433,7 +1435,7 @@ in Bugzilla B<3.4>:
 
 =item C<history> 
 
-B<UNSTABLE>
+B<EXPERIMENTAL>
 
 =over
 
@@ -1730,7 +1732,7 @@ for that value.
 
 =item C<create> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1886,7 +1888,7 @@ method.
 
 =item C<add_comment> 
 
-B<EXPERIMENTAL>
+B<STABLE>
 
 =over
 
@@ -1964,7 +1966,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 c7bbf7c04..c14cc7dea 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 67a4720de..76d4d3e37 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
 
-- 
cgit v1.2.3-24-g4f1b