mirror of
git://git.code.sf.net/p/cdesktopenv/code
synced 2025-02-13 11:42:21 +00:00
2940b3f536
This commit reboots ksh 93u+m development with a new fork based off the archived official AT&T ast repo, master branch. README: - Removed. Having two READMEs is a botch. README.md: - Imported and edited from the archived fork, https://github.com/modernish/ksh -- the newer instructions will become applicable as I cherry-pick all the changes from there :) - Copy-edits. - Added policy and rationale for this 93u+m fork. - Incorporated info from old README that is still relevant. .gitignore: - Added. bin/execrate: - Removed. This one keeps changing its license header, causing git to show an uncommitted file. It's always re-copied anyway, and not for direct invocation, so, exclude and add to .gitignore. The source file is: src/cmd/INIT/execrate.sh src/cmd/*, src/lib/*: - Remove historical baggage: everything except ksh93 and dependencies. This is the same stuff the ksh-community fork removed. I wouldn't mind keeping it, but some of this stuff causes build failures on macOS (and probably other systems), and I need to get on with fixing ksh93. Hopefully, we can figure out how to re-add stuff we can use later -- particularly the pty command (pseudo-terminal utility for scripting interactive sessions) which is needed for regression-testing the interactive shell.
78 lines
3.2 KiB
Markdown
78 lines
3.2 KiB
Markdown
# KornShell 93u+m
|
|
|
|
This repository is used to develop bugfixes
|
|
to the last stable release (93u+ 2012-08-01) of
|
|
[ksh93](http://www.kornshell.com/),
|
|
formerly developed by AT&T Software Technology (AST).
|
|
The sources in this repository were forked from the
|
|
Github [AST repository](https://github.com/att/ast)
|
|
which is no longer under active development.
|
|
|
|
To see what's fixed, see [NEWS](https://github.com/modernish/ast/blame/master/NEWS)
|
|
and click on commit messages for full details.
|
|
|
|
To see what's left to fix, see [TODO](./TODO).
|
|
|
|
## Policy
|
|
|
|
1. No new features. Bug fixes only.
|
|
2. No major rewrites. No refactoring code that is not fully understood.
|
|
3. No changes in documented behaviour, except if required for compliance with the
|
|
[POSIX shell language standard](https://pubs.opengroup.org/onlinepubs/9699919799/utilities/contents.html)
|
|
which David Korn [intended](http://www.kornshell.com/info/) for ksh to follow.
|
|
4. No 100% bug compatibility. Broken and undocumented behaviour gets fixed.
|
|
5. No bureaucracy, no formalities. Just fix it, or report it: create issues,
|
|
send pull requests. Every interested party is invited to contribute.
|
|
6. To help increase everyone's understanding of this code base, fixes and
|
|
significant changes should be fully documented in commit messages.
|
|
|
|
## Why?
|
|
|
|
Between 2017 and 2020 there was an ultimately unsuccessful
|
|
[attempt](https://github.com/att/ast/tree/2020.0.1)
|
|
to breathe new life into the KornShell by extensively refactoring the last
|
|
unstable AST beta version (93v-).
|
|
While that ksh2020 branch is now abandoned and still has many critical bugs,
|
|
it also had a lot of bugs fixed. More importantly, the AST issue tracker
|
|
now contains a lot of documentation on how to fix those bugs, which makes
|
|
it possible to backport many of them to the last stable release instead.
|
|
|
|
In February 2020, having concluded the AST 93v- beta was too broken to
|
|
base new work on, others decided to start a new fork based on the last stable
|
|
93u+ 2012-08-01 release. Unfortunately, as of June 2020, the new
|
|
[ksh-community](https://github.com/ksh-community/ksh/)
|
|
organisation is yet to see any significant activity four months after its
|
|
bootstrapping. I hope that will change; I am ready to join efforts with them
|
|
at any time, as well as anyone else who wants to contribute.
|
|
|
|
The last stable ksh93 release from 2012 is the least buggy release currently
|
|
available, but it still has many serious bugs. So it is well past time to
|
|
start fixing those bugs, leave the rest of the code alone, and get an
|
|
improved release out there.
|
|
|
|
## Build
|
|
|
|
After cloning this repo, cd to the top directory of it and run:
|
|
```sh
|
|
./bin/package make
|
|
```
|
|
If you have trouble or want to tune the binaries, you may pass additional
|
|
compiler and linker flags by appending it to the command shown above. E.g.:
|
|
```sh
|
|
./bin/package make \
|
|
SHELL=/bin/bash CCFLAGS="-xc99 -D_XPG6 -m64 -xO4" LDFLAGS="-m64"
|
|
```
|
|
For more information run
|
|
```sh
|
|
bin/package help
|
|
```
|
|
Many other commands in this repo self-document via the `--help`, `--man` and
|
|
`--html` options; those that do have no separate manual page.
|
|
|
|
## Test
|
|
|
|
After compiling, you can run the regression tests.
|
|
Start by reading the information printed by:
|
|
```sh
|
|
./bin/shtests --man
|
|
```
|