On 12/09/17 12:59, Niels de Vos wrote:
On Tue, Sep 12, 2017 at 10:01:14AM +0100, lejeczek wrote:
@devel
hi, I wonder who takes care of man pages when it comes to rpms?
I'd like to file a bugzilla report and would like to make sure it's packages
mainainer(s) are responsible for incomplete man pages.
Often man pages are neglected by authors, too often, and man is, should
always be "the place", we users/admins should not have to sroogle for info
almost every time.
Please file a bug against the "doc" component in Bugzilla:
https://bugzilla.redhat.com/enter_bug.cgi?product=GlusterFS&component=doc
It helps a lot if you explain in detail what is missing or incorrect,
and what you expect to read instead.
Suffice to do quick comparison(@10.5.x) of gluster help vs
man gluster, which reveals that subcommands like: reset,
sync, clear-locks and maybe more are missing in man pages.
This stuff must be there it's vital, man pages must always
be complete, then an admin/user life gets so much better.
thanks, L.
The man-pages themselves are under the doc/ directory in the GlusterFS
sources, the *.8 files:
https://github.com/gluster/glusterfs/tree/master/doc
If you want to send patches to address the changes you like to see,
please follow the "Simplified development workflow":
http://gluster.readthedocs.io/en/latest/Developer-guide/Simplified-Development-Workflow/
In case you run into difficulties with sending patches, don't hesitate
to email gluster-devel@xxxxxxxxxxx or ask in #gluster-devel on Freenode
IRC.
Thanks,
Niels
.
_______________________________________________
Gluster-users mailing list
Gluster-users@xxxxxxxxxxx
http://lists.gluster.org/mailman/listinfo/gluster-users
