@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. m. thanks, L. .
Thanks for the feedback. On 12-Sep-2017 4:51 PM, "lejeczek" <peljasz at yahoo.co.uk> 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. I know many options are not upto date in man page, what exact things are you looking at? Like is it man page of mount.glusterfs? gluster cli? -Amar m. thanks, L. . _______________________________________________ Gluster-users mailing list Gluster-users at gluster.org http://lists.gluster.org/mailman/listinfo/gluster-users -------------- next part -------------- An HTML attachment was scrubbed... URL: <http://lists.gluster.org/pipermail/gluster-users/attachments/20170912/07c11629/attachment.html>
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. 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 at gluster.org or ask in #gluster-devel on Freenode IRC. Thanks, Niels -------------- next part -------------- A non-text attachment was scrubbed... Name: signature.asc Type: application/pgp-signature Size: 801 bytes Desc: not available URL: <http://lists.gluster.org/pipermail/gluster-users/attachments/20170912/6c972beb/attachment.sig>
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 at gluster.org or ask in #gluster-devel on Freenode > IRC. > > Thanks, > Niels.