//! \name Two-part object construction:
//@{
/// <summary>
/// A container of AcPermission objects that define AccuRev
/// <a href="https://www.microfocus.com/documentation/accurev/72/WebHelp/wwhelp/wwhimpl/js/html/wwhelp.htm#href=AccuRev_User_CLI/cli_ref_setacl.html">access control list (ACL) entries</a>.
/// </summary>
/*! \code
* // get the list of permissions for all depots
* AcPermissions permissions = new AcPermissions(PermKind.depot);
* if (!(await permissions.initAsync())) return false;
*
* // show permissions on depots JUPITER and NEPTUNE
* IEnumerable<AcPermission> filter = permissions.Where(n => n.Name.Equals("NEPTUNE") || n.Name.Equals("JUPITER"));
* foreach (AcPermission permission in filter.OrderBy(n => n)) // use default comparer
* Console.WriteLine(permission);
* ...
* Permission on JUPITER depot applies to group Admin {all, inherit}
* Permission on JUPITER depot applies to anyuser {all, no inherit}
* Permission on JUPITER depot applies to group IT-Reporting {none, no inherit}
* Permission on JUPITER depot applies to group PAT {all, inherit}
* Permission on JUPITER depot applies to user robert {all, no inherit}
* Permission on NEPTUNE depot applies to group Admin {all, inherit}
* Permission on NEPTUNE depot applies to user barnyrd {all, inherit}
* Permission on NEPTUNE depot applies to group IT-Reporting {none, no inherit}
* Permission on NEPTUNE depot applies to group Omnipotent {none, inherit}
* Permission on NEPTUNE depot applies to group PAT {all, inherit}
* \endcode */
/*! \sa initAsync, [default comparer](@ref AcPermission#CompareTo), [AcDepots.canViewAsync](@ref AcDepots#canViewAsync),
* <a href="_show_permissions_8cs-example.html">ShowPermissions.cs</a> */
public AcPermissions(PermKind kind)
{
_kind = kind;
}
/// <summary>
/// Constructor used during AcPermissions list construction. It is called internally and not by user code.
/// </summary>
internal AcPermission(PermKind kind)
{
_kind = kind;
}