Skip to content

User Guide

Open a file, make a change and save it. Start there; no configuration is needed.

If rev is not installed yet, follow Install rev. These chapters cover rev 0.6.0, using default key bindings and small files you create yourself. The default path uses Emacs direct entry; later chapters offer startup-selected modal editing, optional language servers, external reload, optional Pi editing, local shell text filters and integrated terminals.

  1. Edit Your First File: write, save, quit and reopen.
  2. Move and Edit Text: select, copy, move and undo text.
  3. Use Buffers and Panes: keep two files open and arrange their views.
  4. Search and Run Commands: find text, use M-x and keep named locations.
  5. Browse Files: expand the tree and open a neighboring file.
  6. Set Your Preferences: change indentation at startup and line numbers during a session.
  7. Complete Names: choose an observed name near the cursor and undo its insertion.
  8. Choose Modal Editing: select the optional modal profile, compose edits and use shared commands.
  9. Set Up Language Servers: select or acquire a server, complete unsaved text and manage its lifecycle.
  1. Follow External File Changes: observe a replacement, keep unsaved text and explicitly reload.
  2. Edit with Pi: inspect and accept a proposal, undo it and reuse an instruction.
  3. Run Shell Commands: sort unsaved text, inspect output and undo a checked filter.
  4. Use an Integrated Terminal: open shells, move a running tool, inspect output and close owned sessions.

Read in order when learning, or return directly to a chapter you need. Each chapter links to the next one and to its supporting reference.

Git

The Git learning path uses a small local repository to teach saved changes, selected commits and history. It is independent of Org and the everyday path above.

Org mode

The Org mode guide has its own path for outlines, tasks, agendas and tables. Start there when you want those features; the everyday editor path above does not depend on them.

See all documentation for task guides, exact controls and explanations. The key binding reference lists the core keyboard interface; Org bindings cover the additional Org contexts.