This file is indexed.

/usr/share/doc/php-horde-mail/UPGRADING is in php-horde-mail 2.1.4-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
======================
 Upgrading Horde_Mail
======================

:Contact: dev@lists.horde.org

.. contents:: Contents
.. section-numbering::


This lists the API changes between releases of the package.


Upgrading to 2.1
================

  - Horde_Mail_Rfc822_Address

    Added the 'bare_address_idn' property.

  - Horde_Mail_Rfc822_List

    Added the 'bare_addresses_idn' property.

  - Horde_Mail_Transport_Smtphorde

    This Transport driver has been added.


Upgrading to 2.0
================

  - Horde_Mail

    This class has been removed (no more Horde_Mail#factory()). Directly
    instantiate a transport driver instead.

  - Horde_Mail_Rfc822

    The 'num_groups' property has been removed.
    The validateMailbox() method has been removed.
    parseAddressList() now returns a Horde_Mail_Rfc822_List object.
    The 'group' parameter to parseAddressList() has been added.
    The 'nest_groups' parameter to parseAddressList() has been removed.
    parseAddressList() does not validate by default.

  - Horde_Mail_Rfc822_Address

    The object can no longer be accessed as an array.
    Removed the 'adl', 'route', and 'personal_decoded' properties.
    The 'personal' property now always returns the MIME decoded personal part.
    The 'host' property now always returns the IDN decoded host.
    The 'encode' and 'idn' parameters to writeAddress() have changed behavior.
    Added the 'host_idn' and 'valid' properties.
    Renamed the 'full_address' property to 'bare_address'.

  - Horde_Mail_Rfc822_Group

    The object can no longer be accessed as an array.
    Removed the 'groupname_decoded' property.
    The 'groupname' property now always returns the MIME decoded groupname.
    The 'encode' and 'idn' parameters to writeAddress() have changed behavior.
    Added the 'valid' property.

  - Horde_Mail_Rfc822_Object

    Added a match() method.
    Passing boolean true to writeAddress() now defaults to full encoding of
    the address.


Upgrading To 1.2
================

Method API additions
--------------------

  - Horde_Mail_Rfc822#parseAddressList()

    The first argument can now be a Horde_Mail_Rfc822_Object or an array of
    address strings and/or Horde_Mail_Rfc822_Objects.

  - Horde_Mail_Rfc822_Address#__construct()

    The constructor now takes 1 optional argument: address.

  - Horde_Mail_Rfc822_Group#__construct()

    The constructor now takes 2 optional arguments: groupname and group
    addresses.


New Methods
-----------

  - Horde_Mail_Rfc822#encode()
  - Horde_Mail_Rfc822#trimAddress()


New Objects
-----------

  - Horde_Mail_Rfc822_Object

    Horde_Mail_Rfc822_Address and Horde_Mail_Rfc822_Group now extend this
    class.  Allows for easier determination if an object contains RFC 822
    element information.


Upgrading To 1.1
================

New Objects
-----------

Horde_Mail_Rfc822::parseAddressList() now returns an array of
Horde_Mail_Rfc822_Address objects (and Horde_Mail_Rfc822_Group objects, if
nest_groups is true).

These objects are backward compatible with the former array representation.
They also include additional functionality.

  - Horde_Mail_Rfc822_Address

    Anything other than accessing these properties is a new feature available
    only since 1.1.0:

    - adl
    - comment
    - host
    - mailbox
    - personal

  - Horde_Mail_Rfc822_Group

    Anything other than accessing these properties is a new feature available
    only since 1.1.0:

    - addresses
    - groupname