commit 8481121e378fbe8512b892dc83f63e1656f83aef
parent 25bc76cc1e058e31d20dfb834ed46db18d457f74
Author: Toby Goodwin <toby@paccrat.org>
Date: Sun, 17 May 2015 20:29:26 +0100
tidy up READMEs
Diffstat:
| M | README | | | 48 | ++++++++++++++++++------------------------------ |
| D | README.md | | | 4 | ---- |
2 files changed, 18 insertions(+), 34 deletions(-)
diff --git 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
diff --git a/README.md b/README.md
@@ -1,4 +0,0 @@
-rc - a shell
-============
-
-This is rc, the Plan 9 shell, reimplemented for Unix by Byron Rakitzis.
