umask.1p: Can we add a table for octal and symbolic notation?

umask.1p: Can we add a table for octal and symbolic notation?

[Utkarsh Singh]

Hi,

The POSIX.1 standard man page for umask is a really well written
document but lacks some notes for beginners.

For example comparing umask.1p to <https://en.wikipedia.org/wiki/Umask>
I really liked how Wikipedia added table for showing octal digits in umask
command to their corresponding action.

Can we do a similar thing for umask.1p or how can I contact The Open
Group to make changes into their manual?
-- 
Utkarsh Singh

AW: umask.1p: Can we add a table for octal and symbolic notation?

[Walter Harms]

Hello everybody,
i did no see any answer. 

How is maintaining the posix-pages organized ? 

re,
 wh
________________________________________
Von: Utkarsh Singh <utkarsh190601@gmail.com>
Gesendet: Mittwoch, 24. März 2021 16:24
An: linux-man@vger.kernel.org; alx.manpages@gmail.com; mtk.manpages@gmail.com
Betreff: umask.1p: Can we add a table for octal and symbolic notation?

WARNUNG: Diese E-Mail kam von außerhalb der Organisation. Klicken Sie nicht auf Links oder öffnen Sie keine Anhänge, es sei denn, Sie kennen den/die Absender*in und wissen, dass der Inhalt sicher ist.


Hi,

The POSIX.1 standard man page for umask is a really well written
document but lacks some notes for beginners.

For example comparing umask.1p to <https://en.wikipedia.org/wiki/Umask>
I really liked how Wikipedia added table for showing octal digits in umask
command to their corresponding action.

Can we do a similar thing for umask.1p or how can I contact The Open
Group to make changes into their manual?
--
Utkarsh Singh

Re: AW: umask.1p: Can we add a table for octal and symbolic notation?

[Utkarsh Singh]

On 2021-04-16, 15:46 +0000, Walter Harms <wharms@bfs.de> wrote:

> Hello everybody,
> i did no see any answer. 
>
> How is maintaining the posix-pages organized ? 

There some misunderstanding from my side on how POSIX manual pages are
'distributed' with Linux man-page project.  Here is message posted on
this mailing list some time ago.

Message from Michael Kerrisk on Wed, 22 Jan 2014 16:56:48 +0100:

> In 2004, the IEEE and The Open Group decided to grant permission to the 
> Linux man-pages project to distribute parts of the then-current version
> of POSIX.1 in manual page format. That decision provided an extremely
> valuable resource for Linux programmers who wanted to write applications
> that are portable across UNIX systems. Evidence of that value has been
> demonstrated by regular requests in the last few years that the project
> should update its copy of the POSIX manual pages to the latest
> version provided by The Austin Group (the umbrella group that works
> on development of the POSIX.1 standard).

This means that Linux man-page project only distribute standards in
forms accessible offline using man command and doesn't edit them.

Confusion aside, you can always download Wikipedia pages or in fact any
HTML pages using wget or curl command.  For ex:

$ wget https://en.wikipedia.org/wiki/Umask

You can use a graphical browser like Firefox or a text browser like lynx
to view them.  For ex:

$ lynx Umask.html

-- 
Utkarsh Singh
http://utkarshsingh.xyz

Re: AW: umask.1p: Can we add a table for octal and symbolic notation?

[Alejandro Colomar (man-pages)]

Hello Walter, Utkarsh,

On 4/16/21 5:46 PM, Walter Harms wrote:
> Hello everybody,
> i did no see any answer. 
> 
> How is maintaining the posix-pages organized ? 
Thanks for the ping.

Well, we only have a script to transform the original HTML POSIX manual
pages into actual man pages.  We maintain the script, and apply minor
fixes to the resulting pages when the script fails, but other than that,
the Open Group is responsible for the content; I guess (but I don't know
for sure; Michael will know better) the permission to redistribute the
pages is to redistribute them without changes.

> 
> re,
>  wh
> ________________________________________
> Von: Utkarsh Singh <utkarsh190601@gmail.com>
> Gesendet: Mittwoch, 24. März 2021 16:24
> An: linux-man@vger.kernel.org; alx.manpages@gmail.com; mtk.manpages@gmail.com
> Betreff: umask.1p: Can we add a table for octal and symbolic notation?
> 
> WARNUNG: Diese E-Mail kam von außerhalb der Organisation. Klicken Sie nicht auf Links oder öffnen Sie keine Anhänge, es sei denn, Sie kennen den/die Absender*in und wissen, dass der Inhalt sicher ist.
> 
> 
> Hi,
> 
> The POSIX.1 standard man page for umask is a really well written
> document but lacks some notes for beginners.
> 
> For example comparing umask.1p to <https://en.wikipedia.org/wiki/Umask>
> I really liked how Wikipedia added table for showing octal digits in umask
> command to their corresponding action.
> 
> Can we do a similar thing for umask.1p or how can I contact The Open
> Group to make changes into their manual?

I don't know how to contact the Open Group.  Michael probably knows.  I
tried some time ago, but their website is a bit complicated for me and I
get lost.

Thanks,

Alex


-- 
Alejandro Colomar
Linux man-pages comaintainer; https://www.kernel.org/doc/man-pages/
http://www.alejandro-colomar.es/