From 72dd49d7dd07ba4cae13ee1249fd58550991c188 Mon Sep 17 00:00:00 2001 From: Laurent Bercot Date: Mon, 30 Dec 2019 20:31:24 +0000 Subject: Rename cd/umask to execline-cd/execline-umask, make symlinks, etc. --- doc/cd.html | 50 --------------------------------------------- doc/execline-cd.html | 54 +++++++++++++++++++++++++++++++++++++++++++++++++ doc/execline-umask.html | 50 +++++++++++++++++++++++++++++++++++++++++++++ doc/index.html | 4 ++-- doc/posix-cd.html | 23 ++++++++++++--------- doc/posix-umask.html | 22 +++++++++++--------- doc/umask.html | 48 ------------------------------------------- doc/upgrade.html | 6 ++++++ 8 files changed, 138 insertions(+), 119 deletions(-) delete mode 100644 doc/cd.html create mode 100644 doc/execline-cd.html create mode 100644 doc/execline-umask.html delete mode 100644 doc/umask.html (limited to 'doc') diff --git a/doc/cd.html b/doc/cd.html deleted file mode 100644 index fe64c19..0000000 --- a/doc/cd.html +++ /dev/null @@ -1,50 +0,0 @@ - - - - - - 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

- -

cd is a standard shell builtin. Be careful if you want to -use the cd command outside of an execline script
When execline has been configured with the --enable-pedantic-posix -option, the cd binary is actually a symbolic link to the -posix-cd binary.

- - - - diff --git a/doc/execline-cd.html b/doc/execline-cd.html new file mode 100644 index 0000000..911eb2a --- /dev/null +++ b/doc/execline-cd.html @@ -0,0 +1,54 @@ + + + + + + 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 new file mode 100644 index 0000000..f01343d --- /dev/null +++ b/doc/execline-umask.html @@ -0,0 +1,50 @@ + + + + + + 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 d93f704..498bb13 100644 --- a/doc/index.html +++ b/doc/index.html @@ -125,9 +125,9 @@ to your installation: the shebang lines for your system might be something like (Process state control)

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

Notes

posix-cd is only available when execline has been configured -with the --enable-pedantic-posix option, and in this case, the -cd binary is a symbolic link to it.
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 the regular 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 appease them.

cd

execline-cd

posix-cd

--enable-pedantic-posix

umask

Notes

posix-umask is only available when execline has been configured -with the --enable-pedantic-posix option, and in this case, the -cd binary is a symbolic link to it.
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.

umask

Nobody ever executes or needs the external version (i.e. not a shell -builtin) of the POSIX umask command. Compared to the regular 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 appease them.

umask

execline-umask

posix-umask

--enable-pedantic-posix

execline: the umask command

-execline
-Software
-skarnet.org -

The `umask` program

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

Interface

-     umask mask prog...
-

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

Notes

umask is a standard shell builtin. Be careful if you want to -use the umask command outside of an execline script.
When execline has been configured with the --enable-pedantic-posix -option, the umask binary is actually a symbolic link to the -posix-umask binary.

dollarat now has its -0 and -d priority unified. (Rightmost priority.)
New binary: posix-umask.
cd has been renamed execline-cd.
umask has been renamed execline-umask.
At installation time, cd and umask symbolic links are created, +pointing to either the posix- or execline- -prefixed version of the +commands, depending on whether the --enable-pedantic-posix option +was given or not.

in 2.5.3.0

-- cgit v1.3.1

The cd program

Interface

Notes

The execline-cd program

Interface

Notes

The execline-umask program

Interface

Notes

Notes

Notes

The umask program

Interface

Notes

in 2.5.3.0

The `cd` program

The `execline-cd` program

The `execline-umask` program

The `umask` program