Mirror of the Common Desktop Environment
Martijn Dekker b16c91f012 Release 1.0.3 | 1 år sedan | |
---|---|---|
.github | 1 år sedan | |
bin | 1 år sedan | |
docs | 2 år sedan | |
src | 1 år sedan | |
.gitignore | 2 år sedan | |
ANNOUNCE | 1 år sedan | |
COPYRIGHT | 1 år sedan | |
LICENSE.md | 1 år sedan | |
NEWS | 1 år sedan | |
README.md | 1 år sedan | |
TODO | 1 år sedan |
This is version 1.0.x of the 93u+m fork of the KornShell, including a sizeable number of enhancements and roughly a thousand bugfixes compared to the last stable release (93u+ 2012-08-01) of ksh93, formerly developed by AT&T Software Technology (AST). The sources in this repository were forked from the GitHub AST repository which is no longer under active development.
For information on the shell, see
src/cmd/ksh93/README
and other files in the same directory.
For user-visible fixes, see NEWS
and click on commit messages for full details.
For all fixes, see the commit log.
For known issues in the current release, see TODO.
To build ksh with a custom configuration of features, edit
src/cmd/ksh93/SHOPT.sh
.
Then cd
to the top directory and run:
bin/package make
The compiled binaries are stored in the arch
directory, in a subdirectory
that corresponds to your architecture. The command bin/package host type
outputs the name of this subdirectory.
If you have trouble or want to tune the binaries, you may pass additional
compiler and linker flags. It is usually best to export these as environment
variables before running bin/package
as they could change the name of
the build subdirectory of the arch
directory, so exporting them is a
convenient way to keep them consistent between build and test commands.
Note that this system uses CCFLAGS
instead of the usual CFLAGS
.
An example that makes Solaris Studio cc produce a 64-bit binary:
export CCFLAGS="-m64 -O" LDFLAGS="-m64"
bin/package make
Alternatively you can append these to the command, and they will only be used for that command. You can also specify an alternative shell in which to run the build scripts this way. For example:
bin/package make SHELL=/bin/bash CCFLAGS="-O2 -I/opt/local/include" LDFLAGS="-L/opt/local/lib"
Note: Do not add compiler flags that cause the compiler to emit terminal
escape codes, such as -fdiagnostics-color=always
; this will cause the
build to fail as the probing code greps compiler diagnostics.
For more information run
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.
The autoloadable man
function in
src/cmd/ksh93/fun/man
integrates this self-documentation into your regular man
command.
After compiling, you can run the regression tests. To run the default test sets for ksh and the build system, use:
bin/package test
For ksh, use the shtests
command directly to control the regression test runs.
Start by reading the information printed by:
bin/shtests --man
Usage: bin/package install
destination_directory [ command ... ]
Any command from the arch
directory can be installed. If no command is
specified, ksh
and shcomp
are assumed.
The destination_directory is created if it does not exist. Commands are
installed in its bin
subdirectory and each command's manual page, if
available, is installed in share/man
.
Destination directories with whitespace or shell pattern characters in their pathnames are not yet supported.
The following is the official AT&T description from 1993 that came with the ast-open distribution. The text is original, but hyperlinks were added here.
KSH-93 is the most recent version of the KornShell Language described in "The KornShell Command and Programming Language," by Morris Bolsky and David Korn of AT&T Bell Laboratories, ISBN 0-13-182700-6. The KornShell is a shell programming language, which is upward compatible with "sh" (the Bourne Shell), and is intended to conform to the IEEE P1003.2/ISO 9945.2 Shell and Utilities standard. KSH-93 provides an enhanced programming environment in addition to the major command-entry features of the BSD shell "csh". With KSH-93, medium-sized programming tasks can be performed at shell-level without a significant loss in performance. In addition, "sh" scripts can be run on KSH-93 without modification.
The code should conform to the IEEE POSIX 1003.1 standard and to the proposed ANSI C standard so that it should be portable to all such systems. Like the previous version, KSH-88, it is designed to accept eight bit character sets transparently, thereby making it internationally compatible. It can support multi-byte characters sets with some characteristics of the character set given at run time.
KSH-93 provides the following features, many of which were also inherent in KSH-88:
Documentation for KSH-93 consists of an "Introduction to KSH-93", "Compatibility with the Bourne Shell" and a manual page and a README file. In addition, the "New KornShell Command and Programming Language" book is available from Prentice Hall.