diff options
| author | Gabriel Schneider <[email protected]> | 2026-11-06 19:14:11 -0300 |
|---|---|---|
| committer | Gabriel Schneider <[email protected]> | 2026-11-06 20:00:43 -0300 |
| commit | b22fa2638bca470bbd8c5ea4768eb0eaaa3e8195 (patch) | |
| tree | 08d0cc564bfe03861313f0acbf14f91f8dc94cc7 | |
| parent | 2ddd5bcbe8d470c00b045af5822418fe429357bc (diff) | |
| download | pardes-b22fa2638bca470bbd8c5ea4768eb0eaaa3e8195.tar.gz pardes-b22fa2638bca470bbd8c5ea4768eb0eaaa3e8195.zip | |
Build: a word that prints this build into a +Build pane (SPC h b): the version line, the commit, the jj change and the build time (stamped as the commit is: release builds and the ~/.local install, else "not stamped"), the zig that built it, its mode, target, platform and grammars, whether the addons are compiled in, the wire's semantics hash and the dependencies; build.zig stamps the change (jj log -r git_head()) and the time (date -u) through one command helper beside gitCommit; a T1 case reads the pane
Co-Authored-By: Claude Fable 5.1 <[email protected]>
Claude-Session: https://claude.ai/code/session_016Y9MNAtZenFv4weoMD3cge
| -rw-r--r-- | build.zig | 28 | ||||
| -rw-r--r-- | docs/typ/builtins-gui.json | 1 | ||||
| -rw-r--r-- | docs/typ/builtins-tui.json | 1 | ||||
| -rw-r--r-- | src/CHANGELOG.md | 4 | ||||
| -rw-r--r-- | src/Output.zig | 27 | ||||
| -rw-r--r-- | src/builtins.zig | 13 | ||||
| -rw-r--r-- | src/config.zig | 6 | ||||
| -rw-r--r-- | test/behaviour/builtins.zig | 16 | ||||
| -rw-r--r-- | test/snapshots/builtins.golden | 113 | ||||
| -rw-r--r-- | test/snapshots/builtins.snap | 4 | ||||
| -rw-r--r-- | test/snapshots/leader.golden | 85 |
11 files changed, 189 insertions, 109 deletions
@@ -284,6 +284,8 @@ pub fn build(b: *std.Build) void { .prebuilt_shaders = prebuilt_shaders, .embed_sources = embed_sources, .commit = if (stamp_commit) gitCommit(b) else null, + .change = if (stamp_commit) jjChange(b) else null, + .built = if (stamp_commit) command(b, &.{ "date", "-u", "+%Y-%m-%d %H:%M UTC" }) else null, }; const opts = shellOptions(b, shell_cfg, platform); const gui_opts: ?*std.Build.Step.Options = if (also_gui) shellOptions(b, shell_cfg, .gui) else null; @@ -1916,14 +1918,22 @@ fn installed(sub: []const u8) std.Build.LazyPath { } fn gitCommit(b: *std.Build) ?[]const u8 { - // HEAD is not a file the configure cache can track. + return command(b, &.{ "git", "rev-parse", "--short=12", "HEAD" }); +} + +/// The jj change git HEAD is in, by its commit (jj 0.46 has no revset for +/// git's HEAD), or null without jj. +fn jjChange(b: *std.Build) ?[]const u8 { + const head = command(b, &.{ "git", "rev-parse", "HEAD" }) orelse return null; + return command(b, &.{ "jj", "log", "-r", head, "--no-graph", "-T", "change_id.short()" }); +} + +/// One line a command prints, or null: HEAD, the change, the clock are not +/// files the configure cache can track, so the cache is poisoned. +fn command(b: *std.Build, argv: []const []const u8) ?[]const u8 { b.graph.poisonCache(); var code: u8 = 0; - const out = b.runAllowFail( - &.{ "git", "rev-parse", "--short=12", "HEAD" }, - &code, - .ignore, - ) catch return null; + const out = b.runAllowFail(argv, &code, .ignore) catch return null; const trimmed = std.mem.trim(u8, out, " \t\r\n"); return if (trimmed.len == 0) null else trimmed; } @@ -1937,6 +1947,10 @@ const ShellConfig = struct { prebuilt_shaders: bool, embed_sources: bool, commit: ?[]const u8, + /// The jj change git HEAD is in, and when this configure ran: the + /// `Build` word's, stamped with the commit (see `stamp_commit`). + change: ?[]const u8, + built: ?[]const u8, }; fn shellOptions(b: *std.Build, cfg: ShellConfig, platform: Platform) *std.Build.Step.Options { @@ -1953,6 +1967,8 @@ fn shellOptions(b: *std.Build, cfg: ShellConfig, platform: Platform) *std.Build. // ...and the commit it was built from, when there is one and the build // is stamped at all (see `stamp_commit`). Read at configure time. o.addOption(?[]const u8, "commit", cfg.commit); + o.addOption(?[]const u8, "change", cfg.change); + o.addOption(?[]const u8, "built", cfg.built); o.addOption([]const u8, "deps", deps_text); return o; } diff --git a/docs/typ/builtins-gui.json b/docs/typ/builtins-gui.json index d838b59d..87d98903 100644 --- a/docs/typ/builtins-gui.json +++ b/docs/typ/builtins-gui.json @@ -3,6 +3,7 @@ {"name": "Adopt", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Take in the shells of a session that died holding them, each as a terminal pane here: the pardes daemon kept their terminals open."}, {"name": "Ascii", "leader": "SPC t a", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "add the printable ASCII bitmaps to the matcher's glyph set"}, {"name": "Back", "leader": "SPC j o", "also": ["C-o"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-o: one step back into the history."}, + {"name": "Build", "leader": "SPC h b", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build: its version, commit, jj change and build time (a stamped build's: a release or the ~/.local install), the zig that built it, its optimize mode, target, platform, grammars, whether the addons are compiled in, and its dependencies, printed into an output buffer."}, {"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."}, {"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."}, {"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."}, diff --git a/docs/typ/builtins-tui.json b/docs/typ/builtins-tui.json index 9579a031..c1879798 100644 --- a/docs/typ/builtins-tui.json +++ b/docs/typ/builtins-tui.json @@ -3,6 +3,7 @@ {"name": "Adopt", "leader": null, "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Take in the shells of a session that died holding them, each as a terminal pane here: the pardes daemon kept their terminals open."}, {"name": "Ascii", "leader": "SPC t a", "also": [], "arg": true, "scope": "pane", "setting": false, "choices": null, "doc": "add the printable ASCII bitmaps to the matcher's glyph set"}, {"name": "Back", "leader": "SPC j o", "also": ["C-o"], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "Ctrl-o: one step back into the history."}, + {"name": "Build", "leader": "SPC h b", "also": [], "arg": false, "scope": "root", "setting": false, "choices": null, "doc": "This build: its version, commit, jj change and build time (a stamped build's: a release or the ~/.local install), the zig that built it, its optimize mode, target, platform, grammars, whether the addons are compiled in, and its dependencies, printed into an output buffer."}, {"name": "Callees", "leader": "SPC l C", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the functions the function under the cursor calls."}, {"name": "Callers", "leader": "SPC l c", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "List the callers of the function under the cursor."}, {"name": "Callstack", "leader": "SPC l b", "also": [], "arg": false, "scope": "pane", "setting": false, "choices": null, "doc": "Show outermost callers first, with signatures and call sites (gc)."}, diff --git a/src/CHANGELOG.md b/src/CHANGELOG.md index a6922a07..b5568686 100644 --- a/src/CHANGELOG.md +++ b/src/CHANGELOG.md @@ -2,6 +2,10 @@ ## Unreleased +- `Build` prints this build into a `+Build` pane: version, commit, jj change + and build time (stamped builds), the zig, mode, target, platform, grammars, + whether the addons are compiled in, and the dependencies. + - Addons speak ABI 3 (2.x ones are refused): a kind's state is stepped once by `tick`, which now also gives the tag's prefix, however many views show it; each view (a window, a terminal) is told to the kind by diff --git a/src/Output.zig b/src/Output.zig index 384bb500..c719f909 100644 --- a/src/Output.zig +++ b/src/Output.zig @@ -1029,6 +1029,33 @@ pub fn openMessages(p: *Pardes, id: usize) !void { /// The version banner plus the embedded CHANGELOG, so an installed binary can /// say what it is and what changed without a repository beside it. +/// The `Build` word's pane: what this binary is, one fact a line. +pub fn openBuild(p: *Pardes, id: usize) !void { + const builtin = @import("builtin"); + var out: std.Io.Writer.Allocating = .init(p.gpa); + errdefer out.deinit(); + const w = &out.writer; + try w.print("{s}\n", .{@import("upgrade.zig").version_line}); + try w.print("commit {s}\nchange {s}\nbuilt {s}\n", .{ + build_options.commit orelse "not stamped (a Debug build with -Dplatform or --prefix)", + build_options.change orelse "not stamped", + build_options.built orelse "not stamped", + }); + try w.print("zig {s}\nmode {s}\ntarget {s}-{s}-{s}\nplatform {s}\n", .{ + builtin.zig_version_string, @tagName(builtin.mode), + @tagName(builtin.cpu.arch), @tagName(builtin.os.tag), + @tagName(builtin.abi), @tagName(build_options.platform), + }); + try w.print("grammars {s}\naddons {s}\nsemantics {x:0>16}\n\ndependencies\n{s}", .{ + if (build_options.syntax_full_grammars) "full" else if (build_options.syntax_minimal_grammars) "minimal" else "none", + if (@import("builtin_addons").on) "compiled in" else "loaded from <prefix>/lib/pardes/addons", + @import("wire.zig").semantics, + build_options.deps, + }); + const content = try out.toOwnedSlice(); + return openRead(p, id, .{ .cmd = .Build }, "", content); +} + pub fn openChangelog(p: *Pardes, id: usize) !void { var out: std.Io.Writer.Allocating = .init(p.gpa); errdefer out.deinit(); diff --git a/src/builtins.zig b/src/builtins.zig index 4712a67a..15319d6e 100644 --- a/src/builtins.zig +++ b/src/builtins.zig @@ -108,7 +108,6 @@ fn isEnabled(comptime T: type) bool { return !@hasDecl(T, "enabled") or T.enabled; } - /// Why `word`, a builtin some build has, is none in this one: `GUI-only` /// for the GUI's own (`gui_only`), else `not in this build`; null for a /// word that is one here, or in no build. @@ -1618,6 +1617,18 @@ pub const Messages = struct { } }; +/// This build: its version, commit, jj change and build time (a stamped +/// build's: a release or the ~/.local install), the zig that built it, its +/// optimize mode, target, platform, grammars, whether the addons are compiled +/// in, and its dependencies, printed into an output buffer. +pub const Build = struct { + pub const scope: Scope = .session; + pub const output: OutputTraits = .{ .name = config.build_buffer }; + pub fn run(c: Ctx) void { + panes.Output.openBuild(c.p, c.id) catch |err| c.p.reportError(c.id, "build", err); + } +}; + /// This build's version and what changed to reach it, printed into an output /// buffer the same way Config prints the live settings. pub const Changelog = struct { diff --git a/src/config.zig b/src/config.zig index 98dd1ae3..a2aed287 100644 --- a/src/config.zig +++ b/src/config.zig @@ -109,6 +109,7 @@ pub const leader_path = paths: { .LocationsConfig = null, .Tutor = "ht", .Changelog = "hc", + .Build = "hb", .Messages = "hm", .Newcol = "cn", .Delcol = "cd", @@ -496,6 +497,7 @@ pub const diff_buffer = "+Diff"; pub const hover_buffer = "+Hover"; pub const lsp_buffer = "+Lsp"; pub const changelog_buffer = "+Changelog"; +pub const build_buffer = "+Build"; pub const messages_buffer = "+Messages"; pub const scratch_buffer = "+New"; pub const errors_buffer = "+Errors"; @@ -1247,8 +1249,8 @@ pub const Runtime = struct { const values = [_][2][]const u8{ .{ "TaglineSize", "73" }, .{ "WindowOpacity", "85" }, .{ "MessageLinger", "1500" }, .{ "DumpDir", "~/dumps" }, - .{ "GripWidth", "200" }, .{ "InactiveDim", "35" }, .{ "CallstackDepth", "16" }, - .{ "Tab", "8" }, + .{ "GripWidth", "200" }, .{ "InactiveDim", "35" }, + .{ "CallstackDepth", "16" }, .{ "Tab", "8" }, }; for (values) |v| try std.testing.expect(apply(&state, find(v[0]).?, v[1])); try std.testing.expect(state.font.requested_name.set("Wanted Mono")); diff --git a/test/behaviour/builtins.zig b/test/behaviour/builtins.zig index 3c16a4a2..86ee6ca9 100644 --- a/test/behaviour/builtins.zig +++ b/test/behaviour/builtins.zig @@ -34,3 +34,19 @@ test "builtins: Mini maps a file of the pane's directory over pardes's own sourc try std.testing.expect(std.mem.indexOf(u8, try s.read("/log"), s.at("ask {d} save path\n", .{mini})) != null); try std.testing.expectEqual(@as(usize, 0), s.saved); } + +test "builtins: Build prints this build into a +Build pane" { + var s = try Session.initFile(std.testing.allocator, "x\n"); + defer s.deinit(); + try s.write(s.at("/pane/{d}/exec", .{try s.focused()}), "Build\n"); + const index = try s.read("/index"); + var serial: ?u32 = null; + var lines = std.mem.splitScalar(u8, index, '\n'); + while (lines.next()) |line| if (std.mem.indexOf(u8, line, "+Build") != null) { + serial = try std.fmt.parseInt(u32, line[0..std.mem.indexOfScalar(u8, line, ' ').?], 10); + }; + const body = try s.read(s.at("/pane/{d}/body", .{serial orelse return error.NoBuildPane})); + try std.testing.expect(std.mem.startsWith(u8, body, "pardes ")); + for ([_][]const u8{ "\ncommit ", "\nchange ", "\nbuilt ", "\nzig 0.17", "\nmode ", "\nplatform ", "\ndependencies\n" }) |want| + try std.testing.expect(std.mem.indexOf(u8, body, want) != null); +} diff --git a/test/snapshots/builtins.golden b/test/snapshots/builtins.golden index 95fa5f33..fd60bc74 100644 --- a/test/snapshots/builtins.golden +++ b/test/snapshots/builtins.golden @@ -19,60 +19,61 @@ |15: 6 == snap docs-group grid=120x67 cursor=7,10 |10: 1 pardes builtins under SPC h -|12: 3 SPC h c Changelog topbar -|13: 4 SPC h m Messages -|14: 5 SPC h t Tutor topbar -== snap tutor-from-index grid=120x67 cursor=7,16 +|12: 3 SPC h b Build +|13: 4 SPC h c Changelog topbar +|14: 5 SPC h m Messages +|15: 6 SPC h t Tutor topbar +|16: 7 +== snap tutor-from-index grid=120x67 cursor=7,17 |10: 1 pardes builtins under SPC h Tutor -|15: /tmp/pardes-snap/builtins/cwd/+Tutor Save Term Collapse Del -|16: 1 -|17: 2 PARDES TUTOR -|18: 3 -|19: 4 This pane is +Tutor, a copy: edit it freely; there is no need to -|20: 5 Save it (a bare Save asks for a path to write a copy to). -|21: 6 `Del` in its tag closes it; once you have edited it, `Del` refuses -|22: 7 once and the second `Del` discards. `Tutor` or SPC h t opens a -|23: 8 fresh copy. -|24: 9 -|25: 10 The guide (docs/typ/guide.typ) explains; this is the hands-on part. -|26: 11 Each lesson is a few things to do, then names its guide section. -|27: 12 Words in backticks, like `Save`, are builtins. -|28: 13 `Exec` (B2) runs the builtin a word names, or else runs it as a -|29: 14 shell line; `Look` (B3) opens what the text names, or else finds -|30: 15 it. Type a builtin in any tag and `Exec` it. Lines starting with -|31: 16 "| " are tags. -|32: 17 -|33: 18 Press j until you reach part 1. -|34: 19 -|35: 20 -|36: 21 ================================================================= -|37: 22 = PART 1 — MODES = -|38: 23 ================================================================= -|39: 24 -|40: 25 1. The box left of this pane's tag is blank, so you are in -|41: 26 NORMAL mode. Press i: it shows ^ (INSERT). Type a word, then -|42: 27 Esc: blank again. -|43: 28 2. Press Esc once more, in NORMAL: the keyboard goes back to the -|44: 29 pane you were in before (not what helix does). Come back with -|45: 30 Esc again. -|46: 31 3. Press Alt-n: a terminal opens, in NORMAL mode, and pardes types -|47: 32 ls at its first prompt. Press Ctrl-b: its box shows $ (RAW), and -|48: 33 keys go to the shell. Esc brings you back here; the terminal stays -|49: 34 $. Shift-Esc sends the shell an Esc. -|50: 35 -|51: 36 -> Guide: Modes -|52: 37 -|53: 38 -|54: 39 ================================================================= -|55: 40 = PART 2 — THE MOUSE = -|56: 41 ================================================================= -|57: 42 -|58: 43 1. `Look` (B3) the word mouse in this sentence: the next mouse is -|59: 44 selected. -|60: 45 2. `Exec` (B2) the word `Help` here: the list of keys opens. -|61: 46 Close it with `Del` in its tag. -|62: 47 3. Select a word with B1, keep B1 down, click B2: it is cut. Still -|63: 48 holding B1, click B3: it comes back. That pair is a copy. -|64: 49 4. Put the cursor on `Help` and press Tab: `Exec`, as B2. Enter -|65: 50 is `Look`, as B3. -|66: 51 +|16: /tmp/pardes-snap/builtins/cwd/+Tutor Save Term Collapse Del +|17: 1 +|18: 2 PARDES TUTOR +|19: 3 +|20: 4 This pane is +Tutor, a copy: edit it freely; there is no need to +|21: 5 Save it (a bare Save asks for a path to write a copy to). +|22: 6 `Del` in its tag closes it; once you have edited it, `Del` refuses +|23: 7 once and the second `Del` discards. `Tutor` or SPC h t opens a +|24: 8 fresh copy. +|25: 9 +|26: 10 The guide (docs/typ/guide.typ) explains; this is the hands-on part. +|27: 11 Each lesson is a few things to do, then names its guide section. +|28: 12 Words in backticks, like `Save`, are builtins. +|29: 13 `Exec` (B2) runs the builtin a word names, or else runs it as a +|30: 14 shell line; `Look` (B3) opens what the text names, or else finds +|31: 15 it. Type a builtin in any tag and `Exec` it. Lines starting with +|32: 16 "| " are tags. +|33: 17 +|34: 18 Press j until you reach part 1. +|35: 19 +|36: 20 +|37: 21 ================================================================= +|38: 22 = PART 1 — MODES = +|39: 23 ================================================================= +|40: 24 +|41: 25 1. The box left of this pane's tag is blank, so you are in +|42: 26 NORMAL mode. Press i: it shows ^ (INSERT). Type a word, then +|43: 27 Esc: blank again. +|44: 28 2. Press Esc once more, in NORMAL: the keyboard goes back to the +|45: 29 pane you were in before (not what helix does). Come back with +|46: 30 Esc again. +|47: 31 3. Press Alt-n: a terminal opens, in NORMAL mode, and pardes types +|48: 32 ls at its first prompt. Press Ctrl-b: its box shows $ (RAW), and +|49: 33 keys go to the shell. Esc brings you back here; the terminal stays +|50: 34 $. Shift-Esc sends the shell an Esc. +|51: 35 +|52: 36 -> Guide: Modes +|53: 37 +|54: 38 +|55: 39 ================================================================= +|56: 40 = PART 2 — THE MOUSE = +|57: 41 ================================================================= +|58: 42 +|59: 43 1. `Look` (B3) the word mouse in this sentence: the next mouse is +|60: 44 selected. +|61: 45 2. `Exec` (B2) the word `Help` here: the list of keys opens. +|62: 46 Close it with `Del` in its tag. +|63: 47 3. Select a word with B1, keep B1 down, click B2: it is cut. Still +|64: 48 holding B1, click B3: it comes back. That pair is a copy. +|65: 49 4. Put the cursor on `Help` and press Tab: `Exec`, as B2. Enter +|66: 50 is `Look`, as B3. diff --git a/test/snapshots/builtins.snap b/test/snapshots/builtins.snap index 320d4360..14dd2bcf 100644 --- a/test/snapshots/builtins.snap +++ b/test/snapshots/builtins.snap @@ -80,8 +80,8 @@ key space h ? wait 10000 Tutor stable 700 15000 snap docs-group -press middle @Tutor 15 -release middle @Tutor 15 +press middle @Tutor 16 +release middle @Tutor 16 wait 10000 PARDES TUTOR stable 700 15000 snap tutor-from-index diff --git a/test/snapshots/leader.golden b/test/snapshots/leader.golden index 884a28b1..932e8a95 100644 --- a/test/snapshots/leader.golden +++ b/test/snapshots/leader.golden @@ -12,42 +12,42 @@ |5: /tmp/pardes-snap/leader/cwd/+Help Save Term Collapse Del |6: 1 pardes builtins under SPC h |7: 2 -|8: 3 SPC h c Changelog topbar -|9: 4 SPC h m Messages -|10: 5 SPC h t Tutor topbar -|11: 6 -== snap tutor grid=100x41 cursor=7,12 +|8: 3 SPC h b Build +|9: 4 SPC h c Changelog topbar +|10: 5 SPC h m Messages +|11: 6 SPC h t Tutor topbar +|12: 7 +== snap tutor grid=100x41 cursor=7,13 |6: 1 pardes builtins under SPC h Tutor -|11: /tmp/pardes-snap/leader/cwd/+Tutor Save Term Collapse Del -|12: 1 -|13: 2 PARDES TUTOR -|14: 3 -|15: 4 This pane is +Tutor, a copy: edit it freely; there is no need to -|16: 5 Save it (a bare Save asks for a path to write a copy to). -|17: 6 `Del` in its tag closes it; once you have edited it, `Del` refuses -|18: 7 once and the second `Del` discards. `Tutor` or SPC h t opens a -|19: 8 fresh copy. -|20: 9 -|21: 10 The guide (docs/typ/guide.typ) explains; this is the hands-on part. -|22: 11 Each lesson is a few things to do, then names its guide section. -|23: 12 Words in backticks, like `Save`, are builtins. -|24: 13 `Exec` (B2) runs the builtin a word names, or else runs it as a -|25: 14 shell line; `Look` (B3) opens what the text names, or else finds -|26: 15 it. Type a builtin in any tag and `Exec` it. Lines starting with -|27: 16 "| " are tags. -|28: 17 -|29: 18 Press j until you reach part 1. -|30: 19 -|31: 20 -|32: 21 ================================================================= -|33: 22 = PART 1 — MODES = -|34: 23 ================================================================= -|35: 24 -|36: 25 1. The box left of this pane's tag is blank, so you are in -|37: 26 NORMAL mode. Press i: it shows ^ (INSERT). Type a word, then -|38: 27 Esc: blank again. -|39: 28 2. Press Esc once more, in NORMAL: the keyboard goes back to the -|40: 29 pane you were in before (not what helix does). Come back with +|12: /tmp/pardes-snap/leader/cwd/+Tutor Save Term Collapse Del +|13: 1 +|14: 2 PARDES TUTOR +|15: 3 +|16: 4 This pane is +Tutor, a copy: edit it freely; there is no need to +|17: 5 Save it (a bare Save asks for a path to write a copy to). +|18: 6 `Del` in its tag closes it; once you have edited it, `Del` refuses +|19: 7 once and the second `Del` discards. `Tutor` or SPC h t opens a +|20: 8 fresh copy. +|21: 9 +|22: 10 The guide (docs/typ/guide.typ) explains; this is the hands-on part. +|23: 11 Each lesson is a few things to do, then names its guide section. +|24: 12 Words in backticks, like `Save`, are builtins. +|25: 13 `Exec` (B2) runs the builtin a word names, or else runs it as a +|26: 14 shell line; `Look` (B3) opens what the text names, or else finds +|27: 15 it. Type a builtin in any tag and `Exec` it. Lines starting with +|28: 16 "| " are tags. +|29: 17 +|30: 18 Press j until you reach part 1. +|31: 19 +|32: 20 +|33: 21 ================================================================= +|34: 22 = PART 1 — MODES = +|35: 23 ================================================================= +|36: 24 +|37: 25 1. The box left of this pane's tag is blank, so you are in +|38: 26 NORMAL mode. Press i: it shows ^ (INSERT). Type a word, then +|39: 27 Esc: blank again. +|40: 28 2. Press Esc once more, in NORMAL: the keyboard goes back to the == snap deleted grid=100x41 cursor=7,3 |5: |6: @@ -78,13 +78,13 @@ |31: |32: |33: -|34: -|35: /tmp/pardes-snap/leader/cwd/+Help Save Term Collapse Del -|36: 1 pardes builtins under SPC h -|37: 2 -|38: 3 SPC h c Changelog topbar -|39: 4 SPC h m Messages -|40: 5 SPC h t Tutor topbar +|34: /tmp/pardes-snap/leader/cwd/+Help Save Term Collapse Del +|35: 1 pardes builtins under SPC h +|36: 2 +|37: 3 SPC h b Build +|38: 4 SPC h c Changelog topbar +|39: 5 SPC h m Messages +|40: 6 SPC h t Tutor topbar == snap help-column grid=100x41 cursor=7,6 |5: /tmp/pardes-snap/leader/cwd/+Help Save Term Collapse Del |6: 1 pardes builtins under SPC c @@ -93,6 +93,7 @@ |9: 4 SPC c j Joincol topbar |10: 5 SPC c n Newcol topbar |11: 6 +|34: |35: |36: |37: |
