[Dovecot] UIDL documentation

[Mark E. Mallett]

Hi,

I see this in the 1.0-beta7 dovecot-example.conf file:

  # If you want UIDL compatibility with other POP3 servers, use:
  #  UW's ipop3d         : %08Xv%08Xu
  #  Courier version 0   : %f
  #  Courier version 1   : %u
  #  Courier version 2   : %v-%u
  #  Cyrus (<= 2.1.3)    : %u
  #  Cyrus (>= 2.1.4)    : %v.%u
  #  Older Dovecots      : %v.%u
  #
  # Note that Outlook 2003 seems to have problems with %v.%u format which was
  # Dovecot's default, so if you're building a new server it would be a good
  # idea to change this. %08Xu%08Xv should be pretty fail-safe.
  #
  # NOTE: Nowadays this is required to be set explicitly, since the old
  # default was bad but it couldn't be changed without breaking existing
  # installations. %08Xu%08Xv will be the new default, so use it for new
  # installations.

and on the wiki at http://wiki.dovecot.org/Migration there is this:

  By default Dovecot generates POP3 UIDs differently than UW-IMAP. If
  you want to preserve them, with 0.99.x you'll have to patch Dovecot.
  With 1.0-tests you can use:

  pop3_uidl_format = %08Xv%08Xu

In the dovecot-example.conf file, it appears that the mentions of
"%08Xu%08Xv" as being fail-safe and being the new default may be typos,
since that format doesn't seem to come from anywhere.  Should they not
say "%08Xv%08Xu" ?  (It'll still provide the same sort of unique value,
only with the ends reversed; i.e. it should still work ok.  But
consistency and compatibility is nice.)

mm