import "9fans.net/go/acme"
Package acme is a simple interface for interacting with acme windows.
Many of the functions in this package take a format string and optional parameters. In the documentation, the notation format, ... denotes the result of formatting the string and arguments using fmt.Sprintf.
AutoExit sets whether to call os.Exit the next time the last managed acme window is deleted. If there are no acme windows at the time of the call, the exit does not happen until one is created and then deleted.
func DeleteAll()
DeleteAll deletes all windows.
Err finds or creates a window appropriate for showing errors related to a window titled src and then prints msg to that window. It adds a final newline to msg if needed.
Errf is like Err but accepts a printf-style formatting.
type Event struct {
// The two event characters, indicating origin and type of action
C1, C2 rune
// The character addresses of the action.
// If the original event had an empty selection (OrigQ0=OrigQ1)
// and was accompanied by an expansion (the 2 bit is set in Flag),
// then Q0 and Q1 will indicate the expansion rather than the
// original event.
Q0, Q1 int
// The Q0 and Q1 of the original event, even if it was expanded.
// If there was no expansion, OrigQ0=Q0 and OrigQ1=Q1.
OrigQ0, OrigQ1 int
// The flag bits.
Flag int
// The number of bytes in the optional text.
Nb int
// The number of characters (UTF-8 sequences) in the optional text.
Nr int
// The optional text itself, encoded in UTF-8.
Text []byte
// The chorded argument, if present (the 8 bit is set in the flag).
Arg []byte
// The chorded location, if present (the 8 bit is set in the flag).
Loc []byte
}An Event represents an event originating in a particular window. The fields correspond to the fields in acme's event messages. See http://swtch.com/plan9port/man/man4/acme.html for details.
A LogEvent is a single event in the acme log file.
type LogReader struct {
// contains filtered or unexported fields
}A LogReader provides read access to the acme log file.
Log returns a reader reading the acme/log file.
Read reads an event from the acme log file.
type Win struct {
// contains filtered or unexported fields
}A Win represents a single acme window and its control files.
New creates a new window.
Open connects to the existing window with the given id. If ctl is non-nil, Open uses it as the window's control file and takes ownership of it.
Show looks and causes acme to show the window with the given name, returning that window. If this process has not created a window with the given name (or if any such window has since been deleted), Show returns nil.
Addr writes format, ... to the window's addr file.
Blink starts the window tag blinking and returns a function that stops it. When stop returns, the blinking is over and the window state is clean.
Clear clears the window body.
CloseFiles closes all the open files associated with the window w. (These file descriptors are cached across calls to Ctl, etc.)
Ctl writes the command format, ... to the window's ctl file.
Winctl deletes the window, writing `del' (or, if sure is true, `delete') to the ctl file.
Err finds or creates a window appropriate for showing errors related to w and then prints msg to that window. It adds a final newline to msg if needed.
EventChan returns a channel on which events can be read. The first call to EventChan allocates a channel and starts a new goroutine that loops calling ReadEvent and sending the result into the channel. Subsequent calls return the same channel. Clients should not call ReadEvent after calling EventChan.
func (w *Win) EventLoop(h EventHandler)
Font returns the window's current tab width (in zeros) and font.
PrintTabbed prints tab-separated columnated text to body, replacing single tabs with runs of tabs as needed to align columns.
ReadAll
ReadEvent reads the next event from the window's event file.
Sort sorts the lines in the current address range according to the comparison function.
WriteEvent writes an event back to the window's event file, indicating to acme that the event should be handled internally.
Windows returns a list of the existing acme windows.
| Path | Synopsis |
|---|---|
| acmego | Acmego watches acme for .go files being written. |
| Dict | |
| editinacme | Editinacme can be used as $EDITOR in a Unix environment. |
| Watch | Watch runs a command each time files in the current directory change. |
Package acme imports 17 packages (graph) and is imported by 62 packages. Updated 2019-06-27. Refresh now. Tools for package owners.