From 6d47df31e962e1e5b9bc3e6b5a3a5a3f9c3b4997 Mon Sep 17 00:00:00 2001 From: Curtis McEnroe Date: Mon, 14 Jan 2019 15:58:35 -0500 Subject: Add cash.7 README --- bin/cash/Makefile | 3 +++ bin/cash/README | 28 +++++++++++++++++++++++++ bin/cash/cash.1 | 2 +- bin/cash/cash.7 | 63 +++++++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 95 insertions(+), 1 deletion(-) create mode 100644 bin/cash/README create mode 100644 bin/cash/cash.7 diff --git a/bin/cash/Makefile b/bin/cash/Makefile index f1f026f0..4a9ec599 100644 --- a/bin/cash/Makefile +++ b/bin/cash/Makefile @@ -82,3 +82,6 @@ install: cash $(MAN1) uninstall: rm -f $(PREFIX)/bin/cash $(MAN1:%=$(MANDIR)/man1/%) + +README: cash.7 + mandoc cash.7 | col -bx > README diff --git a/bin/cash/README b/bin/cash/README new file mode 100644 index 00000000..dac1cec5 --- /dev/null +++ b/bin/cash/README @@ -0,0 +1,28 @@ +CASH(7) FreeBSD Miscellaneous Information Manual CASH(7) + +NAME + cash – the Causal Agency shell + +DESCRIPTION + cash is a shell derived from FreeBSD sh(1), which is in turn derived from + Almquist shell. It includes editline(3) from NetBSD. + + Differences from sh(1) + • ENV defaults to ‘${XDG_CONFIG_HOME:-${HOME}/.config}/cash/env.sh’. + + • PS0 is printed before each prompt, allowing multi-line prompts. + + • Right-aligned prompts can be set with RPS1 and RPS2. + + • PSlit can be used to embed terminal escape sequences in prompts, as + in NetBSD sh(1). + + • HOME is shortened to ‘~’ in prompt expansion. + + • fc -s =new allows prefixing commands with new. + +HISTORY + sh(1) sources were imported from FreeBSD 12.0. editline(3) sources were + imported from NetBSD 8.0. + +Causal Agency January 14, 2019 Causal Agency diff --git a/bin/cash/cash.1 b/bin/cash/cash.1 index 7cd96c3a..e152d625 100644 --- a/bin/cash/cash.1 +++ b/bin/cash/cash.1 @@ -2512,7 +2512,7 @@ nor .It Fl s Re-execute the command without invoking an editor. . -.It Ar old Ns = Ns new +.It Ar old Ns = Ns Ar new Replace the first occurrence of .Ar old in the command with diff --git a/bin/cash/cash.7 b/bin/cash/cash.7 new file mode 100644 index 00000000..35f9fc4f --- /dev/null +++ b/bin/cash/cash.7 @@ -0,0 +1,63 @@ +.Dd January 14, 2019 +.Dt CASH 7 +.Os "Causal Agency" +. +.Sh NAME +.Nm cash +.Nd the Causal Agency shell +. +.Sh DESCRIPTION +.Nm +is a shell derived from +.Fx +.Xr sh 1 , +which is in turn derived from Almquist shell. +It includes +.Xr editline 3 +from +.Nx . +. +.Ss Differences from Xr sh 1 +.Bl -bullet +.It +.Va ENV +defaults to +.Ql ${XDG_CONFIG_HOME:-${HOME}/.config}/cash/env.sh . +. +.It +.Va PS0 +is printed before each prompt, +allowing multi-line prompts. +. +.It +Right-aligned prompts can be set with +.Va RPS1 +and +.Va RPS2 . +. +.It +.Va PSlit +can be used to embed terminal escape sequences in prompts, +as in +.Nx +.Xr sh 1 . +. +.It +.Va HOME +is shortened to +.Sq ~ +in prompt expansion. +. +.It +.Ic fc Fl s Ar = Ns Ar new +allows prefixing commands with +.Ar new . +.El +. +.Sh HISTORY +.Xr sh 1 +sources were imported from +.Fx 12.0 . +.Xr editline 3 +sources were imported from +.Nx 8.0 . -- cgit 1.4.1 >Add xmodmap configurationJune McEnroe 2021-02-06Add initial OpenBSD X configurationJune McEnroe cwm still needs a lot more rebinding, and I need to actually look at its other options. xterm definitely still needs some configuration, but I at least managed to get it to use a decent looking font. Very happy that OpenBSD includes Luxi Mono, which is what my usual font, Go Mono, is based on anyway. Still missing is xmodmap and such. 2021-02-06Add xterm output to schemeJune McEnroe&follow=1'>Use hi -o anchor in upJune McEnroe 2019-02-18Don't match nested parentheses in Tag for CJune McEnroe Fixes mistaken highlight of: pngWrite(file, (uint8_t []) { 0, 0, 0 }, 3); 2019-02-18Match whitespace between * [] {}June McEnroe 2019-02-18Fix function-like #define regexJune McEnroe A define like #define FOO (1) is not function-like. 2019-02-18Match Tag in RustJune McEnroe 2019-02-18Match sh functions as TagJune McEnroe 2019-02-18Match Sh and Ss as Tag in mdocJune McEnroe 2019-02-18Match statics and typedefs as TagJune McEnroe 2019-02-18Clean up htmlHeaderJune McEnroe 2019-02-18Remove hi line numberingJune McEnroe Tags are much better for referring to specific parts of a file and line numbering is better done by a post-processing tool such as cat -n or producing a two-column HTML <table>. 2019-02-18Add Tag class to hiJune McEnroe 2019-02-17Generate HTML with hi -n -f html -o anchorJune McEnroe Running hi twice to insert stuff between the head and the content is a bit of a hack but oh well. 2019-02-17Add hi -f html -o anchor for line number linksJune McEnroe 2019-02-17Simplify temp trap in upJune McEnroe 2019-02-17Add line numbers to hiJune McEnroe Renames previous -n option to -m to stay consistent with cat -n. Prefixing lines with line numbers affects where the first tab indent ends up relative to the text above it. Not sure if it's worth fixing somehow. 2019-02-17Always split spans after newlinesJune McEnroe Simplifies ANSI and IRC output code, and prepares for line numbered output. 2019-02-15Color format specifiers light cyan in vimJune McEnroe 2019-02-15Highlight Interp as yellowJune McEnroe 2019-02-15Highlight strings in sh command substitutionsJune McEnroe 2019-02-15Add nmap gpJune McEnroe 2019-02-14Avoid newline when copying URL to pasteboardJune McEnroe 2019-02-13Add forgotten "sixth" book of H2G2June McEnroe