syntax:
:

    ```xml
    <permission-tree android:icon="drawable resource"
                     android:label="string resource"
                     android:name="string" />
    ```

contained in:
:   [<manifest>](https://developer.android.com/guide/topics/manifest/manifest-element)

description:
:   Declares the base name for a tree of permissions. The application takes
    ownership of all names within the tree. It can dynamically add new permissions
    to the tree by calling [PackageManager.addPermission()](https://developer.android.com/reference/android/content/pm/PackageManager#addPermission(android.content.pm.PermissionInfo)).
    Names within the tree are separated by
    periods ('`.`'). For example, if the base name is
    `com.example.project.taxes`, permissions like the following might be
    added:

    `com.example.project.taxes.CALCULATE`

    `com.example.project.taxes.deductions.STORE_RECEIPTS`

    `com.example.project.taxes.deductions.ACCESS_RECORDS`


    This element doesn't declare a permission itself, only a
    namespace in which permissions can be placed. For more information about declaring permissions, see the
    [<permission>](https://developer.android.com/guide/topics/manifest/permission-element)
    element.

attributes:
:

    `android:icon`
    :   An icon representing all the permissions in the tree. This attribute
        must be set as a reference to a drawable resource containing the image
        definition.

    `android:label`
    :   A user-readable name for the group. As a convenience, the label
        can be directly set as a raw string during development. However,
        when the application is ready to be published, set it as a
        reference to a string resource, so that it can be localized like other
        strings in the user interface.

    `android:name`
    :   The name at the base of the permission tree. It serves as
        a prefix to all permission names in the tree. Use Java-style scoping
        so that the name is unique. The name must have more than
        two period-separated segments in its path. For example,
        `com.example.base` is OK, but `com.example` isn't.

introduced in:
:   API level 1

see also:
:   [<permission>](https://developer.android.com/guide/topics/manifest/permission-element)

    [<permission-group>](https://developer.android.com/guide/topics/manifest/permission-group-element)

    [<uses-permission>](https://developer.android.com/guide/topics/manifest/uses-permission-element)