Item8879: Document setting ALLOW VIEW on groups

git-svn-id: http://svn.foswiki.org/trunk@17775 0b4bb1d4-4e5a-0410-9cc4-b2b747904278

UnitTestContrib/test/unit/AccessControlTests.pm

@@ -60,6 +60,7 @@ sub set_up {
       Foswiki::Func::readTopic( $this->{users_web}, "ReservoirDogsGroup" );
     $topicObject->text(<<"THIS");
    * Set GROUP = MrWhite, $this->{users_web}.MrBlue
+   * Set ALLOWTOPICVIEW = $this->{users_web}.ReservoirDogsGroup
 THIS
     $topicObject->save();
     $topicObject->finish();

core/data/System/AccessControl.txt

@@ -1,4 +1,4 @@
-%META:TOPICINFO{author="ProjectContributor" date="1399280257" format="1.1" version="1"}%
+%META:TOPICINFO{author="ProjectContributor" date="1403053504" format="1.1" version="1"}%
 %META:TOPICPARENT{name="UserDocumentationCategory"}%
 %STARTINCLUDE%
 ---+ Access Control
@@ -65,6 +65,11 @@ The =ALLOWTOPICCHANGE= setting defines who is allowed to change the group topic;
    * ==Set <nop>ALLOWTOPICCHANGE = %USERSWEB%.<nop>KasabianGroup==
       * *Caution* This is set in the "Topic Settings" and not inline in the topic text!
 
+%T% If you want to hide a group and its list of members, you can set =ALLOWTOPICVIEW= on the group. For example:
+   * ==Set <nop>ALLOWTOPICVIEW = %USERSWEB%.<nop>SecretGroup==
+      * This group will be usable in the ACL of any topic,  but is only visible to members of the group.
+      * *Caution* As with the the prior example, this is set in the "Topic Settings" and not inline in the topic text!
+
 <blockquote class="foswikiHelp">
 %X% Foswiki has strict formatting rules. Settings *must* be entered as a bullet point.
    * With the WikiText edttor, or in the Settings editor, make sure you have three spaces, an asterisk, and an extra space in front of any access control rule.