[OpenAFS-Doc] pts_membership man page

[Jason Edgecombe]

I just submitted bug #124151to RT to add the system:ptsviewers verbage
to the man page.

I read the whole pts_membership man page, and the PRIVILIGES section
reads like bad stereo instructions. It's not very clear. I think that
part could be much clearer, but I don't understand the privacy flags
enough to rewrite it. I think a table would better communicate the info.

Any comments?

Thanks,
Jason

[Russ Allbery]

I just submitted bug #124151to RT to add the system:ptsviewers verbage to
the man page.

Thanks for letting me know. Committed.

I read the whole pts_membership man page, and the PRIVILIGES section
reads like bad stereo instructions. It's not very clear. I think that
part could be much clearer, but I don't understand the privacy flags
enough to rewrite it. I think a table would better communicate the info.

I took a shot at rewriting it, trying to make it shorter and more direct.
Take a look at current CVS and see what you think. Most of the bullet
points were just repeating the same thing.

[Jason Edgecombe]

Post by Russ Allbery

I just submitted bug #124151to RT to add the system:ptsviewers verbage to
the man page.

Thanks for letting me know. Committed.

I read the whole pts_membership man page, and the PRIVILIGES section
reads like bad stereo instructions. It's not very clear. I think that
part could be much clearer, but I don't understand the privacy flags
enough to rewrite it. I think a table would better communicate the info.

I took a shot at rewriting it, trying to make it shorter and more direct.
Take a look at current CVS and see what you think. Most of the bullet
points were just repeating the same thing.

Looks much better and clearer. I submitted RT #124157 with some minor
edits.


Jason

[Russ Allbery]

Post by Jason Edgecombe
Looks much better and clearer. I submitted RT #124157 with some minor
edits.

If it is lowercase C<m> and the B<-nameorid> argument specifies a group,
-members of that group can also list the other members. A privacy flag of
-C<m> only changes the permissions when set for a group. Setting this flag
-for a user or a machine has no effect.
+then members of that group can also list the other members. A privacy
+flag of C<m> only changes the permissions when set for a group. Setting
+this flag for a user or a machine has no effect.

This sounds more natural to me without the "then". Dialect difference
between us, maybe?

Thanks, I committed this as-is.