Questions about BTS SOAP interface "pending" attribute

Francesco Poli <[email protected]>
Newsgroups gmane.linux.debian.devel.debbugs
Message-ID <20120906231548.e311e60cf51066a5819f6218__11506.8255611279$1346967788$gmane$org@paranoici.org>
Hello Debbugs maintainers,
I am one of the co-maintainers of the apt-listbugs package.

During an attempt to improve apt-listbugs documentation with the help
of the Debian English l10n mailing list regulars (in Cc), it turned out
that some of the four bug status names are a bit misleading.
The four names I am referring to are: 'forwarded', 'done', 'pending',
and 'pending-fixed'.

Those names come directly from the BTS SOAP interface.
To be more precise, they come from the "pending" attribute returned by
the BTS SOAP interface.
Unfortunately I cannot find complete and updated documentation for this
SOAP interface (http://wiki.debian.org/DebbugsSoapInterface seems to be
incomplete, as it claims that the "pending" attribute may be either
'pending' or 'done').

Hence, I would like to ask for confirmation on some points.
Please Cc me and debian-l10n-english on replies, thanks.

First of all, my understanding of the meaning of those four statuses is:

 'forwarded'
  means that the bug is open and forwarded to upstream

 'done'
  means that the bug is marked as done

 'pending'
  means that the bug is open, but not forwarded nor tagged "pending"

 'pending-fixed'
  means that the bug is open, but tagged "pending"

Do you confirm this?

I believe that no other possible status may be returned by the BTS SOAP
interface.
Do you also confirm this?

If my understanding of the four statuses is correct, it seems to me
that their names are a bit misleading: while 'forwarded' and 'done'
look basically OK to me, 'pending' seems a bit of a misnomer to me
for a bug that is open, but not forwarded nor tagged "pending" (I would
call it 'unfixed' or something like that); finally, 'pending-fixed'
looks a bit awkward to me (I would simply call it 'pending', since it
corresponds to the "pending" tag for open bugs).

Since changing these names would break the SOAP interface, I am *not*
suggesting to alter those attribute values. I am just asking for
clarification on their meanings and on their names.


Please let us know.
Thanks for your time.  


-- 
 http://www.inventati.org/frx/frx-gpg-key-transition-2010.txt
 New GnuPG key, see the transition document!
..................................................... Francesco Poli .
 GnuPG key fpr == CA01 1147 9CD2 EFDF FB82  3925 3E1C 27E1 1F69 BFFE
signature.asc (application/pgp-signature, 836 B)
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.12 (GNU/Linux)

iQIcBAEBCAAGBQJQSRKEAAoJED4cJ+Efab/+NbwQAIjPqbSM/LyVDFFFEJXrFqwF
Zvlhspi372DdeGQx5G+B1SEUccMBHT9OzM9uJrMa1sbRPDxHLsEnhG6bxhzodNY1
yXM7Wyqtk6koVn7jr1ppWKF+Tc745beivDbNGkUTvb9gbej51Ll0ttKbIdI+lpC+
wAvDAIDTQJJAC15cF/y7qwLXuXbF/SJBqSec8vM0UZYZWEQGubH6om8GM2mFKCI7
xXCMg8prYxV9ulWUkXhxhL/cI7fiTTVFsSL4UqbfN3Bhfpa4GqPFENZ82j7t+UpP
0QzsBZkQWc5Df/s3BsR76TXSWo9qZ0J2aaaoekTazwWtVzb6t78sTnpeiBUDnGgk
uP52uVq32Z514Tp2D/LeEmw/nVY2kemOCXT6X/5peau7jzCHeICuiRpPAI9A+Xzc
5Kst3ic6zlJxlUNsNYZFCOtAzCW1jCV+wByInZ5ob0lWpUzHJSgrHjtZTgDrYrFD
K1CUQDq17RZNrkVUj2c63v3ENAvypCj/owTGg19ZFEwpQgPq1yF6puHF0IL/esE+
51FEkoj2NdAEq0kBztyvCKcZXUT1EZ85osIkfm+ArfsdodWvy57pMVyr72fEETsG
gmziQzofp9wNYy0xRsILWe31bhtnNZ1O5NOLZ8yFGLHXWM2l/FIzjy624Al5QPTY
ep/micCpQ7Vp7kveIMe3
=DyVd
-----END PGP SIGNATURE-----
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.