Bug 798795

Summary:	Confusing docs for auth.allow and auth.reject
Product:	[Community] Gluster-Documentation	Reporter:	Andrew Bogott <andrewbogott>
Component:	Release Notes	Assignee:	Anjana Suparna Sriram <asriram>
Status:	ASSIGNED ---	QA Contact:
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	unspecified	CC:	bugs
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:		Doc Type:	Bug Fix
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:		Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Andrew Bogott 2012-02-29 21:40:25 UTC

Description of problem:

Docs in the Tuning Volume Options are unclear w/respect to the arguments that can be passed to some commands.  For example, in under auth.allow, there are these phrases:

"IP addresses/Host name of the clients"
"Valid IP address which includes"

The latter suggests that only one IP can be set.  The former changes its mind mid-sentence about whether one or more hosts can be specified.  This should be reconciled, and the text should specify that the command takes a comma-separated list of one or more hosts.

The auth.reject explanation has the same problem.


ALSO:  There should be a 'documentation' component in this bugbase :)

Comment 1 Divya 2012-04-03 11:14:21 UTC

The updated Red Hat Storage 2.0 User Guide is published 
http://docs.redhat.com/docs/en-US/Red_Hat_Storage/2/html/User_Guide/chap-User_Guide-Managing_Volumes.html#sect-User_Guide-Managing_Volumes-Tuning