Bug#981171: [PATCH 02/13] Add a note about portability of environment variable

2021-01-29 Thread Bastien Roucariès
Le jeudi 28 janvier 2021, 08:38:33 UTC Michael Kerrisk (man-pages) a écrit :
> Hello Bastien,
> 
> On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote:
> > From: Bastien Roucariès 
> > 
> > Some variables are portable at least under UNIX
> > 
> > Signed-off-by: Bastien Roucariès 
> > ---
> > 
> >  man7/environ.7 | 11 +++
> >  1 file changed, 11 insertions(+)
> > 
> > diff --git a/man7/environ.7 b/man7/environ.7
> > index d889310d6..ec886d83d 100644
> > --- a/man7/environ.7
> > +++ b/man7/environ.7
> > @@ -242,6 +242,17 @@ tell applications about the window size, possibly
> > overriding the actual size.> 
> >  may specify the desired printer to use.
> >  See
> >  .BR lpr (1).
> > 
> > +.SH CONFORMING TO
> > +The variables
> > +.B HOME
> > +.B LOGNAME,
> > +.B PATH,
> > +.B PWD,
> > +and
> > +.B SHELL
> > +are specified by
> > +POSIX.1-1996
> > +and should be reasonably portable.
> 
> Why this particular version of the standard? You don't explain.
> 
> I don't have a copy of POSIX.1-1996; where did you find it?
> 
> I do have a copy of SUSv3, where I expect that much of the detail
> is the same as 1996, and there are many other environment variables
> specified in that standard, including TZ, LC_*, LINES, COLUMNS, and
> TMPDIR. If you start mentioning standards, but you list only
> HOME, LOGNAME, PATH, and PWD, I think it implies to the reader
> that those other variables are *not* specified in the standard.
Ok will try to reword this part.
> 
> If we're going to document which EVs are in the standards,
> (and I'm not sure it is something we want to do), then I think
> the information needs to be more consistently done, and also
> in the commit message I would want much more precise details
> about where the info about each variable was foind.
> 
> Thanks,
> 
> Michael
> 
> >  .SH NOTES
> >  The
> >  .BR prctl (2)



signature.asc
Description: This is a digitally signed message part.


Bug#981171: [PATCH 02/13] Add a note about portability of environment variable

2021-01-28 Thread Michael Kerrisk (man-pages)
Hello Bastien,

On 1/27/21 4:48 PM, roucaries.bast...@gmail.com wrote:
> From: Bastien Roucariès 
> 
> Some variables are portable at least under UNIX
> 
> Signed-off-by: Bastien Roucariès 
> ---
>  man7/environ.7 | 11 +++
>  1 file changed, 11 insertions(+)
> 
> diff --git a/man7/environ.7 b/man7/environ.7
> index d889310d6..ec886d83d 100644
> --- a/man7/environ.7
> +++ b/man7/environ.7
> @@ -242,6 +242,17 @@ tell applications about the window size, possibly 
> overriding the actual size.
>  may specify the desired printer to use.
>  See
>  .BR lpr (1).
> +.SH CONFORMING TO
> +The variables
> +.B HOME
> +.B LOGNAME,
> +.B PATH,
> +.B PWD,
> +and
> +.B SHELL
> +are specified by
> +POSIX.1-1996
> +and should be reasonably portable.

Why this particular version of the standard? You don't explain.

I don't have a copy of POSIX.1-1996; where did you find it?

I do have a copy of SUSv3, where I expect that much of the detail
is the same as 1996, and there are many other environment variables
specified in that standard, including TZ, LC_*, LINES, COLUMNS, and
TMPDIR. If you start mentioning standards, but you list only 
HOME, LOGNAME, PATH, and PWD, I think it implies to the reader
that those other variables are *not* specified in the standard.

If we're going to document which EVs are in the standards,
(and I'm not sure it is something we want to do), then I think
the information needs to be more consistently done, and also
in the commit message I would want much more precise details
about where the info about each variable was foind.

Thanks,

Michael


>  .SH NOTES
>  The
>  .BR prctl (2)
> 


-- 
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Linux/UNIX System Programming Training: http://man7.org/training/



Bug#981171: [PATCH 02/13] Add a note about portability of environment variable

2021-01-27 Thread roucaries . bastien
From: Bastien Roucariès 

Some variables are portable at least under UNIX

Signed-off-by: Bastien Roucariès 
---
 man7/environ.7 | 11 +++
 1 file changed, 11 insertions(+)

diff --git a/man7/environ.7 b/man7/environ.7
index d889310d6..ec886d83d 100644
--- a/man7/environ.7
+++ b/man7/environ.7
@@ -242,6 +242,17 @@ tell applications about the window size, possibly 
overriding the actual size.
 may specify the desired printer to use.
 See
 .BR lpr (1).
+.SH CONFORMING TO
+The variables
+.B HOME
+.B LOGNAME,
+.B PATH,
+.B PWD,
+and
+.B SHELL
+are specified by
+POSIX.1-1996
+and should be reasonably portable.
 .SH NOTES
 The
 .BR prctl (2)
-- 
2.29.2