From bca250b0b2a1df4ceb939b71a269f71501fda024 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Thu, 30 Jul 2026 03:21:52 +0000 Subject: Prepare for 2.10.0.0; remove pedantic posix; support loopwhilex -x "" --- doc/cd.html | 60 +++++++++++++++++++++++++++++++++++++++ doc/execline-cd.html | 55 ------------------------------------ doc/execline-umask.html | 51 ---------------------------------- doc/index.html | 10 +++---- doc/loopwhilex.html | 10 ++++--- doc/posix-cd.html | 66 ------------------------------------------- doc/posix-umask.html | 74 ------------------------------------------------- doc/umask.html | 61 ++++++++++++++++++++++++++++++++++++++++ doc/upgrade.html | 10 +++++++ 9 files changed, 141 insertions(+), 256 deletions(-) create mode 100644 doc/cd.html delete mode 100644 doc/execline-cd.html delete mode 100644 doc/execline-umask.html delete mode 100644 doc/posix-cd.html delete mode 100644 doc/posix-umask.html create mode 100644 doc/umask.html (limited to 'doc') diff --git a/doc/cd.html b/doc/cd.html new file mode 100644 index 0000000..fbd6687 --- /dev/null +++ b/doc/cd.html @@ -0,0 +1,60 @@ + + + + + + + execline: the cd command + + + + + + +

+execline
+Software
+skarnet.org +

+ +

The `cd` program

+ +

+cd changes the current working directory to a +given directory, then executes a program. +

+ +

Interface

+ +

+     cd dir prog...
+

+ +

+cd performs a +chdir() +system call on dir, then execs into prog.... +

+ +

Notes

+ +

This cd program will never be invoked by a shell, unless its full path +is explicitly given to the shell command line. So it is perfectly acceptable and valid +to have a cd binary in the filesystem. No confusion will be possible: shells +will invoke their builtin +cd +utility, and execline scripts will invoke the cd binary.
Previous versions of POSIX also required a conformant cd binary to exist +in the filesystem, for no reason at all. So, in previous execline versions, +a posix-cd binary was present, and cd could be installed as a symlink +to it when execline was configured with the --enable-pedantic-posix option. +This allowed distributions to make execline binaries, including cd, available +in PATH, while strictly conforming to POSIX. This requirement has now been relaxed by +POSIX, so the needlessly complex posix-cd program was replaced with this +simpler cd, that can now be made available in PATH without breaking strict +conformance.

+ + + diff --git a/doc/execline-cd.html b/doc/execline-cd.html deleted file mode 100644 index 6d55142..0000000 --- a/doc/execline-cd.html +++ /dev/null @@ -1,55 +0,0 @@ - - - - - - - execline: the execline-cd command - - - - - - -

-execline
-Software
-skarnet.org -

- -

The `execline-cd` program

- -

-execline-cd changes the current working directory to a -given directory, then executes a program. -

- -

Interface

- -

-     execline-cd dir prog...
-

- -

-execline-cd performs a -chdir() -system call on dir, then execs into prog.... -

- -

Notes

- -

By default, execline-cd can also be invoked as cd: -there is a cd program which is a symbolic link to execline-cd.
When execline has been configured with the --enable-pedantic-posix -option, the cd binary is a symbolic link to the -posix-cd binary instead, so a cd command -in an execline script will invoke posix-cd instead -of execline-cd.
Existing scripts that call cd will keep working no matter the -chosen configuration.

- - - - diff --git a/doc/execline-umask.html b/doc/execline-umask.html deleted file mode 100644 index e0aa76f..0000000 --- a/doc/execline-umask.html +++ /dev/null @@ -1,51 +0,0 @@ - - - - - - - execline: the execline-umask command - - - - - - -

-execline
-Software
-skarnet.org -

- -

The `execline-umask` program

- -

-execline-umask sets the umask (file creation mask), -then executes a program. -

- -

Interface

- -

-     execline-umask mask prog...
-

- -

-execline-umask sets the current umask to mask, -then execs into prog.... -

- -

Notes

- -

By default, at execline installation time, a umask -symbolic link is created, pointing to execline-umask. -
When execline has been configured with the --enable-pedantic-posix -option, the umask symbolic link points to the -posix-umask binary instead.
Existing execline scripts calling umask will keep working -no matter the chosen configuration.

- - - diff --git a/doc/index.html b/doc/index.html index e57e4af..075fcf9 100644 --- a/doc/index.html +++ b/doc/index.html @@ -78,8 +78,8 @@ want nsswitch-like functionality:

Download

The current released version of execline is 2.9.9.2. -You can access its checksum here.
The current released version of execline is 2.10.0.0. +You can access its checksum here.
Alternatively, you can checkout a copy of the execline git repository: @@ -128,10 +128,8 @@ the previous versions of execline and the current one.

The execline-cd program
The posix-cd program
The execline-umask program
The posix-umask program
The cd program
The umask program
The emptyenv program
The envfile program
The export program

Interface

-     loopwhilex [ -n ] [ -o okcodes | -x breakcodes ] prog...
+     loopwhilex [ -o okcodes | -x breakcodes ] prog...

prog

-x breakcodes : like the previous option, but with inverted meaning - the listed exit codes are codes that will break the loop and exit, and the unlisted exit codes will keep -the loop running.
-n : negate the test. This option is now redundant, -and may disappear soon.

-x ""

loopwhilex

If both -o and -x options are given -o +has priority and the list given by -x is ignored. If none of +these options is given, -o 0 is the default.

Notes

execline: the posix-cd command

-execline
-Software
-skarnet.org -

The `posix-cd` program

-posix-cd changes the current working directory to a -given directory, then executes a program. -

Interface

-     posix-cd [ -L | -P ] dir prog...
-

-posix-cd changes the current working directory to dir -according to the -POSIX -specification for a cd external utility. Then, if prog... is -not empty, it execs into it. -

Notes

When execline has been configured -with the --enable-pedantic-posix option, the cd -command is a symbolic link to it. So scripts calling cd -will use posix-cd. When this configuration option has not -been given, cd is a symbolic link to -execline-cd.
posix-cd fully conforms to the -POSIX -specification. When prog... is not empty, the behaviour of a -cd utility is not specified by POSIX, so posix-cd extends -the spec to be actually useful and usable in an execline program with the same -interface as the regular execline cd command.
Nobody ever executes or needs the external version (i.e. not a shell -builtin) of the POSIX cd command. Compared to execline's regular cd -binary, execline-cd, posix-cd is -uselessly bloated and slow. The only reason it exists is that some -distributions refuse to package execline correctly unless it is strictly -POSIX-compliant; the --enable-pedantic-posix configure option is -there to satisfy their requirements.

execline: the posix-umask command

-execline
-Software
-skarnet.org -

The `posix-umask` program

-posix-umask changes its file mode creation mask, then executes a program. -

Interface

-     posix-umask [ -S ] [ mask ] [ prog... ]
-

-When called with no argument, posix-umask prints the value of the -file mode creation mask of the invoking process, then exits 0. -

- When called with a mask argument, posix-umask changes -its file mode creation mask; then, if prog... is not empty, it execs -into it. -

- posix-umask interprets mask as specified by the -POSIX -specification for a umask external utility. -

Notes

When execline has been configured -with the --enable-pedantic-posix option, the umask -command is a symbolic link to it. So scripts calling umask -will use posix-umask. When this configuration option has not -been given, umask is a symbolic link to -execline-umask.
posix-umask fully conforms to the -POSIX -specification. When prog... is not empty, the behaviour of a -umask utility is not specified by POSIX, so posix-umask extends -the spec to be actually useful and usable in an execline program with the same -interface as the regular execline umask command.
Nobody ever executes or needs the external version (i.e. not a shell -builtin) of the POSIX umask command. Compared to execline's regular umask -binary, execline-umask, posix-umask is -uselessly bloated and slow. The only reason it exists is that some -distributions refuse to package execline correctly unless it is strictly -POSIX-compliant; the --enable-pedantic-posix configure option is -there to satisfy their requirements.

execline: the umask command

+execline
+Software
+skarnet.org +

The `umask` program

+umask changes its file mode creation mask, then executes a program. +Alternatively, it can print the current mask. +

Interface

+     umask [ -S ] [ mask ] [ prog... ]
+

+When called with no argument, umask prints the value of the +file mode creation mask of the invoking process, then exits 0. +

+ When called with a mask argument, umask changes +its file mode creation mask; then, if prog... is not empty, it execs +into it. +

+ umask interprets mask as specified by the +POSIX +specification for a umask external utility. +

Notes

umask fully conforms to the +POSIX +specification. When prog... is not empty, the behaviour of a +umask utility is not specified by POSIX, so umask extends +the spec to be actually useful and usable in an execline program.

What has changed in execline

in 2.10.0.0

The --enable-pedantic-posix configuration option has +been removed, due to POSIX relaxing requirements on intrinsic utilities.
The cd binary is now what was previously execline-cd.
The umask binary is now what was previously posix-umask, +(without locale support, not that it had much to start with)

in 2.9.9.2

-- cgit v1.3.1

The cd program

Interface

Notes

The execline-cd program

Interface

Notes

The execline-umask program

Interface

Notes

Download

Interface

Notes

The posix-cd program

Interface

Notes

The posix-umask program

Interface

Notes

The umask program

Interface

Notes

What has changed in execline

in 2.10.0.0

in 2.9.9.2

The `cd` program

The `execline-cd` program

The `execline-umask` program

The `posix-cd` program

The `posix-umask` program

The `umask` program