Bukkit/Bukkit — pull request #588 by ElgarL (2012-04-22 08:36:56+00:00)
Title: Superperm wildcard sub nodes.

It allows the use of wildcards in permission nodes to cover all possible sub nodes.
It allows for sub node tests without being forced to register every node, but also allows for easy negation.

This is mostly usefull where you need to test block id's as part of a permission.
Registering 4096 child nodes for each parent is cumbersome and also quickly brings bukkit to it's knees.

This allows you to assign a parent node to cover all sub nodes, yet still be able to negate specific child nodes.

Eg.
Grant the permission (true) 'towny.wild.build.*' (grants that specific node and all possible sub nodes of it).

Negate (set to false) the permission 'towny.wild.build.1'

All tests on sub nodes like 'towny.wild.build.52' would return true, where a test on 'towny.wild.build.1' would result in a false response.

/**
* Check this permission assignment including parent wildcards.
*

* If this permission has been assigned (true or false) it's value will be returned.
* If the permission is not directly assigned a node search for a parent wildcard will
* be performed, returning it's set value.
* If neither is found then the permissions default value will be returned.
*
* @Param inName
* @Return permissions set value if found, or the parents default value if using a wildcard.
*/