[Popcon-developers] Bug#341144: documentation about http submission is out of date

[Joey Hess]

Package: popularity-contest
Version: 1.31
Severity: normal

Various documentation about submission via http is not up-to-date. This
can be confusing to people considering rolling out popcon accross a
company, where email submission is known not to work very well. Here are
the places I found that were confusingly out of date:

FAQ:

A) Each popularity-contest host is identified by a random 128bit uuid
   (MY_HOSTID in /etc/popularity-contest.conf). This uuid is used to track
   submission issued by the same host. It should be kept secret.  The reports
   are sent by email to the popcon server. The server automatically extract
   the report from the email
...
   The emails are readable only by the server admins.
...
   1) Your email submission might be intercepted.

No mention of http in the above..

  An alternative is to use the new experimental http submission support.
  This can be enabled using this command:

    dpkg-reconfigure popularity-contest

Whereas http is really the default, with a fallback to mail on error.
Also, I don't think the http is experimental anymore.

popularity-contest(8):

       Normally,    popularity-contest    is   run   from   a   cron(8)   job,
       /etc/cron.weekly/popularity-contest,  which  automatically  emails  the
       results  to  Debian  package  maintainers  according to the settings in
       /etc/popularity-contest.conf.

Should mention http use and the fallback, or just s/emails/submits/ to
keep it simple.

-- 
see shy jo
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 189 bytes
Desc: Digital signature
Url : http://lists.alioth.debian.org/pipermail/popcon-developers/attachments/20051128/0c5867db/attachment.pgp