inferno-os tree was separated from the inferno-os-android (separated from the Android driver)

8 files changed, 113 insertions, 0 deletions

diff --git a/acme/acid/guide b/acme/acid/guide
new file mode 100644
index 0000000..0fc9951
--- /dev/null
+++ b/acme/acid/guide
@@ -0,0 +1,2 @@
+Acid pid
+Acid -l alef -l symsfile pid
diff --git a/acme/acid/readme b/acme/acid/readme
new file mode 100644
index 0000000..fcf343b
--- /dev/null
+++ b/acme/acid/readme
@@ -0,0 +1,12 @@
+Capital A Acid is a rudimentary acme interface to the debugger acid.
+It uses a win to provide an interactive window for acid.  In that window,
+a couple of extra acme-specific features are enabled:
+
+w(command)
+	runs the command and places its output in a new window.
+	e.g. w(lstk()) places the stack trace in a distinct window.
+
+Also, in any such window, text executed with button 2 is
+presented as input to acid in the main Acid window.  Thus, for
+example, one may evaluate variables presented in a stack trace
+by `executing' it with button 2.
diff --git a/acme/bin/guide b/acme/bin/guide
new file mode 100644
index 0000000..31cea12
--- /dev/null
+++ b/acme/bin/guide
@@ -0,0 +1,5 @@
+win
+new command ...
+aspell file
+adiff file1 file2
+adict -d oed
diff --git a/acme/bin/readme b/acme/bin/readme
new file mode 100644
index 0000000..941099e
--- /dev/null
+++ b/acme/bin/readme
@@ -0,0 +1,25 @@
+This directory and its subdirectory $cputype are always mounted at
+the end of /bin for programs run from acme.  They hold a collection
+of small acme-specific applications:
+
+win [command]
+	Create an acme window to serve as a terminal, analogous
+	to xterm.  By default, it runs the shell, rc, but it works with
+	any interactive program, e.g. hoc.  Within the window,
+	commands executed with button 2 are 'executed' by sending
+	their text to the standard input of the command, appending
+	a newline if necessary.
+new command
+	Run the non-interactive command, placing its standard and
+	diagnostic output in a new window.
+aspell file
+	Run spell on the file, labeling the output with addresses so
+	misspelled words can be found in context using button 3.
+adiff file1 file2
+	Run diff on the files, labeling the output with addresses so
+	changes can be found in context using button 3.
+adict
+	Interactive version of dict(1).  Button 3 looks up words and
+	may be applied to any word in any adict window.
+	When a word has multiple definitions, indicate the number
+	(as in acme Mail) to disambiguate.
diff --git a/acme/edit/guide b/acme/edit/guide
new file mode 100644
index 0000000..5beced2
--- /dev/null
+++ b/acme/edit/guide
@@ -0,0 +1,4 @@
+e file | x '/regexp/' | c 'replacement'
+e 'file:0,$' | x '/.*word.*\n/' | p -n
+e file | pipe command args ...
+New /absolute/file/name
diff --git a/acme/edit/readme b/acme/edit/readme
new file mode 100644
index 0000000..e4d2957
--- /dev/null
+++ b/acme/edit/readme
@@ -0,0 +1,31 @@
+The programs collected in /acme/edit offer a sam-like command interface
+to acme windows.  The guide file
+	/acme/edit/guide
+holds templates for several editing operations implemented
+by external programs.  These programs, composed in
+a pipeline, refine the sections of a file to be modified.
+Thus in sam when one says
+	x/.*\n/ g/foo/ p
+in /acme/edit one runs
+	x '/.*\n/' | g '/foo/' | p
+The e command, unrelated to e in sam, disambiguates file names, collects
+lists of names, etc., and produces input suitable for the other tools.
+For example:
+	e '/usr/rob/acme:0,$' | x /oldname/ | c /newname/
+changes oldname to newname in all the files loaded in acme whose names match
+the literal text /usr/rob/acme.
+
+The commands in /acme/edit are
+	e
+	x
+	g
+	c
+	d
+	p
+	pipe	(like sam's | , which can't be used for syntactic reasons)
+
+p takes a -n flag analogous to grep's -n.  There is no s command.
+e has a -l flag to produce line numbers instead of the default character numbers.
+Its implementation is poor but sufficient for the mundane job of recreating
+the occasional line number for tools like acid; its use with the other commands
+in this directory is discouraged.
diff --git a/acme/mail/guide b/acme/mail/guide
new file mode 100644
index 0000000..2e23b9e
--- /dev/null
+++ b/acme/mail/guide
@@ -0,0 +1,5 @@
+Mail /mail/box/$user/stored
+Mail
+Mailpop3
+mkbox /mail/box/$user/new_box
+mail -'x' someaddress
diff --git a/acme/mail/readme b/acme/mail/readme
new file mode 100644
index 0000000..9442f57
--- /dev/null
+++ b/acme/mail/readme
@@ -0,0 +1,29 @@
+Mail is the single program in this directory.  Its argument specifies
+the mail box to read, default /mail/box/$user/mbox.
+For example, running
+	Mail /mail/box/$user/stored
+(a line in the guide file) looks at saved mail.
+
+Mail maintains a window containing headers for all the
+messages in the mailbox and monitors the mailbox for new messages.
+Using button 3 to indicate a message number opens
+a window on that message.   commands in the mailbox window are
+	Put		Write the mailbox back to the file (never done automatically)
+	Mail		Make a new message window ready to mail someone.
+			Takes argument names analogously to acme's New.
+	Del		Exit Mail, after checking that mailbox isn't modified.
+New messages appear at the top of the window and are highlighted upon arrival.
+(The messages are numbered oldest to newest, the opposite of regular mail.)
+
+Message windows have a simple format: the first line, up to the first tab or newline,
+holds the sender or, when sending, the addressee.  Edit the line to change who the
+message goes to.  Message windows contain the commands
+	Reply	Make a new window to compose a reply to this message
+	Delmesg	Delete the message from the screen and from the mailbox
+	Del		Delete the window, leaving the message in the mailbox
+	Post		Send the message to the addressee
+	Save		Save to the named mailbox, default/mail/box/$user/stored
+Save takes a full file name; if that name has no slashes, the file is taken
+to be in /mail/box/$user and must already exist. Use mkbox in the guide to
+create target mailboxes in /mail/box/$user.
+Reply and mail windows contain an obvious subset of the commands.