Description of problem:
It should be documented how to properly use pathname patterns. It can be described similarly as in hadoop documentation.
Point of this is to inform reader, that using glusterfs:/ or glusterfs:// is different from each other and it expects different format of path to file.
: http://hadoop.apache.org/docs/r2.4.1/hadoop-project-dist/hadoop-hdfs/ViewFs.html (New World – Federation and ViewFs -> Pathname Usage Patterns)
Try to consider documenting other related special usages like just // (error) or using glusterfs:/// (or more slashes == same as one) etc.
I have added this information to the GA Administration Guide - https://mojo.redhat.com/docs/DOC-958040
Text added to documentation clarifies using glusterfs:// prefix well. I think that could be mentioned usage of glusterfs:/. Nothing complex, just few words about fact, that using glusterfs: prefix with one, or more than two slashes differs in behaviour from glusterfs:// -> volume name is not expected in path in that case.
If you agree that this behaviour could be confusing for some users and it is important enough to mention it, please add info about this to DOC. Otherwise, put this BZ again to MODIFIED.
This solution is no longer available from Red Hat.