From b786f20bbab5a59046aa78a2c6c2a11536497202 Mon Sep 17 00:00:00 2001 From: bhgv Date: Thu, 1 Mar 2018 16:54:45 +0200 Subject: inferno-os tree was separated from the inferno-os-android (separated from the Android driver) --- acme/acid/guide | 2 ++ acme/acid/readme | 12 ++++++++++++ acme/bin/guide | 5 +++++ acme/bin/readme | 25 +++++++++++++++++++++++++ acme/edit/guide | 4 ++++ acme/edit/readme | 31 +++++++++++++++++++++++++++++++ acme/mail/guide | 5 +++++ acme/mail/readme | 29 +++++++++++++++++++++++++++++ 8 files changed, 113 insertions(+) create mode 100644 acme/acid/guide create mode 100644 acme/acid/readme create mode 100644 acme/bin/guide create mode 100644 acme/bin/readme create mode 100644 acme/edit/guide create mode 100644 acme/edit/readme create mode 100644 acme/mail/guide create mode 100644 acme/mail/readme (limited to 'acme') 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. -- cgit v1.2.3