User Guide

Source revision: 0ac2641745c6a29eb06048ee95b58db8f22c3178. This is a development guide, not a versioned editor release. Visit the rur website for the product overview.

This guide documents the current rur source build. rur is in early development; the learning path distinguishes available editing workflows from unfinished product areas. Start with the first part when learning the editor, or enter an area directly when returning to a familiar task.

Start Here

Getting Started builds and launches rur on Linux, saves a first UTF-8 file, and introduces commands, prompts, candidates, Help, acceptance, and cancellation. Begin with Build and Launch rur.

Learning Path

• Getting Started: build the current Linux source composition, save a first file, and learn the command and cancellation grammar.
• Editing: move and retain text, repeat complete changes, compose linked edits, and recover unsaved work.
• Buffers and Panes: keep a live working set, arrange independent views, restore layouts, and resolve Save and exit decisions.
• Search and Navigation: search and replace text, inspect results, retain explicit named state, and search saved Project and Workspace files.
• Files, Projects, and Workspaces: open ordinary directories, promote explicit Projects, and retain ordered Workspace membership across restarts.
• Language Intelligence: use current Rust and Ruby syntax support and inspect the limited external-process transport available today.
• Structured Documents: current availability: structured document workflows are not implemented.
• Packages and Catalogs: review an independent signed catalog, install inactive content, enable exact authority, and maintain or recover package state.
• Interface: read and customize themes, pane status, logical gutters, transient detail, feedback, and progress.
• Customization: compose trusted Ruby configuration, recover a failed reload, and run finite processes through personal commands.
• Modal Interaction: use the optional modal profile, its six native states, and the editing controls supported by rur.

Current Availability

Rust and Ruby syntax support is available. Language-server initialization, completion, and diagnostics remain unavailable. Structured document workflows, interactive Git integration, persistent file-tree and editable-directory modules, and an integrated shell are not implemented in the current composition. Packages require an independently supplied catalog; the production official catalog is still pending. Availability notes in each part define its actual scope.

Direct Routes

• Complete the first editing session.
• Work with buffers and panes.
• Search Projects and Workspaces.
• Use Rust and Ruby syntax.
• Reload personal configuration.
• Recover unsaved work.
• Review a package catalog.
• Use the modal profile.

Supporting Documentation

The guide teaches workflows. Focused procedures remain in How-to Guides, exact commands and APIs in Reference, and rationale in Explanation. The command and keymap reference and its factory command corpus serve as the command appendix for this guide.