Hello Padraig, Thank you for sharing those examples and for the clarification.
I understand the need to keep the man page concise while still providing useful examples. Including a small, well-chosen set directly in the man page sounds like a good approach. If helpful, I can revise the patch to align with this direction once the preferred structure is decided. Thanks again for your time and guidance. Best regards, Alisha Panda On Sun, 3 May 2026 at 15:14, Pádraig Brady <[email protected]> wrote: > On 02/05/2026 19:04, Pádraig Brady wrote: > > On 02/05/2026 11:48, Alisha Panda wrote: > >> Hello, > >> > >> This patch improves the chmod manual page by clarifying the > >> difference between numeric and symbolic modes and by adding > >> practical usage examples. > >> > >> These changes aim to make the documentation more accessible > >> for new users while preserving existing information. > >> > >> Thank you for your time. > > Examples are useful, though we have to be judicious with them. > > We're looking at supplying a couple of examples in all man pages. > > Note the full online manual has these chmod examples: > > # Change file permissions of FOO to be world readable > # and user writable, with no other permissions. > chmod 644 foo > chmod a=r,u+w foo > > # Add user and group execute permissions to FOO. > chmod +110 foo > chmod ug+x foo > > # Set file permissions of DIR and subsidiary files to > # be the umask default, assuming execute permissions for > # directories and for files already executable. > chmod -R a=,+rwX dir > > > We could link to examples from the man page, > but it's probably best to present examples directly in the man pages. > I need to think a bit about how best to do that. > > cheers, > Padraig >
