summaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorToby Goodwin <toby@paccrat.org>2015-05-17 20:29:26 +0100
committerToby Goodwin <toby@paccrat.org>2015-05-17 20:29:26 +0100
commit8481121e378fbe8512b892dc83f63e1656f83aef (patch)
tree078ca1e7372735ef08ac35afd863066574f2f8bb /README
parent25bc76cc1e058e31d20dfb834ed46db18d457f74 (diff)
tidy up READMEs
Diffstat (limited to 'README')
-rw-r--r--README48
1 files changed, 18 insertions, 30 deletions
diff --git a/README b/README
index 1431b04..004d5e2 100644
--- a/README
+++ b/README
@@ -1,38 +1,26 @@
-This is release rc-1.7.4.
+rc - a shell
+============
-See COPYING for copying information. All files are
-
- Copyright 1991, 1999, 2001-2003, 2014, 2015 Byron Rakitzis.
-
-See INSTALL for build and installation information.
-
-
-BUGS
+This is rc, the Plan 9 shell, reimplemented for Unix by Byron Rakitzis.
-Send bug reports to <toby@paccrat.org>. If a core dump is generated,
-sending a backtrace will help a great deal. You can get a backtrace
-like this.
+The original rc was designed and implemented by Tom Duff at Bell Labs.
+It has a small feature set similar to a traditional Bourne shell, but
+with a much cleaner and simpler syntax. Among other things, this makes
+rc much better than Bourne-compatible shells at handling filenames which
+contain spaces. Thus, writing rc scripts is less error-prone than
+writing sh scripts.
- ; gdb rc core
- (gdb) where
- <<<BACKTRACE INFO>>>
- (gdb)
+This reimplementation of rc can be linked with GNU readline, BSD
+libedit, or similar line editing libraries, to make a pleasant
+interactive shell.
-Also, always report the machine, OS (`uname -a'), and compiler used to
-make rc; this information is extremely valuable.
-
-
-FEEPING CREATURISM
-
-See the end of the man page, under "INCOMPATIBILITIES" for (known?)
-differences from the "real" rc. Most of these changes were necessary
-to get rc to work in a reasonable fashion on a real (i.e. commercial,
-non-Labs) Unix system; a few were changes motivated by concern about
-some inadequacies in the original design.
+See COPYING for copying information. All files are
+ Copyright 1991, 1999, 2001-2003, 2014, 2015 Byron Rakitzis.
-WWW
+See INSTALL for build and installation information.
-More information on releases of rc can be found at this web page.
+The current maintainer is Toby Goodwin[1]. Please contact him with any
+problems, questions, bug reports, or suggestions.
- http://tobold.org/article/rc
+[1] mailto:toby@paccrat.org