comparison hgext/bugzilla.py @ 13871:22d200e49b10

bugzilla: more documentation fixes

Correct formatting of the possible values of bugzilla.version.
Fix typo and polish XMLRPC/email mode description.

13870:ce066d424bba

in the configuration. Comments are added under that username. Since the
configuration must be readable by all Mercurial users, it is recommended
that the rights of that user are restricted in Bugzilla to the minimum
necessary to add comments.

Access via XMLRPC/email behaves uses XMLRPC to query Bugzilla, but sends
email to the Bugzilla email interface to submit comments to bugs.
The From: address in the email is set to the email address of the Mercurial
user, so the comment appears to come from the Mercurial user. In the event
that the Mercurial user email is not recognised by Bugzilla as a Bugzilla
user, the Bugzilla username and password used to log into Bugzilla are
used instead as the source of the comment.

Configuration items common to all access modes:

bugzilla.version
  This access type to use. Values recognised are:
  xmlrpc       Bugzilla XMLRPC interface.
  xmlrpc+email Bugzilla XMLRPC and email interfaces.
  3.0          MySQL access, Bugzilla 3.0 and later.
  2.18         MySQL access, Bugzilla 2.18 and up to but not including 3.0.
  2.16         MySQL access, Bugzilla 2.16 and up to but not including 2.18.

13871:22d200e49b10

in the configuration. Comments are added under that username. Since the
configuration must be readable by all Mercurial users, it is recommended
that the rights of that user are restricted in Bugzilla to the minimum
necessary to add comments.

Access via XMLRPC/email uses XMLRPC to query Bugzilla, but sends
email to the Bugzilla email interface to submit comments to bugs.
The From: address in the email is set to the email address of the Mercurial
user, so the comment appears to come from the Mercurial user. In the event
that the Mercurial user email is not recognised by Bugzilla as a Bugzilla
user, the email associated with the Bugzilla username used to log into
Bugzilla is used instead as the source of the comment.

Configuration items common to all access modes:

bugzilla.version
  This access type to use. Values recognised are::

  xmlrpc       Bugzilla XMLRPC interface.
  xmlrpc+email Bugzilla XMLRPC and email interfaces.
  3.0          MySQL access, Bugzilla 3.0 and later.
  2.18         MySQL access, Bugzilla 2.18 and up to but not including 3.0.
  2.16         MySQL access, Bugzilla 2.16 and up to but not including 2.18.