esc

Externally Scriptable Editor

commit 811fc0683d28f6af18e0472b97f0944c65ddfd45
parent c3721b0d69b193b892ff2f78dfe20905adfd3693
Author: Marc Coquand <marc@coquand.email>
Date:   Tue, 24 Feb 2026 10:13:54 +0100

*

Diffstat:
A esc-history.7  | 29 +++++++++++++++++++++++++++++

1 file changed, 29 insertions(+), 0 deletions(-)
diff --git a/esc-history.7 b/esc-history.7
@@ -0,0 +1,29 @@
+.TH esc-history 7
+
+.SH NAME
+esc-history - Esc editor revision history management system
+
+.SH DESCRIPTION
+
+.PP
+.B esc(1) 
+features an automatic revision history. 
+.B esc(1)
+automatically takes temporary snapshots of the file unless explicitily
+disabled by providing the  
+.B disable-snapshots-flag
+flag to the program. If the partition where the file resides is a CoW
+partition, such as
+.B btrfs(5)
+, then a reflink is created instead of a regular file copy. 
+
+.PP
+Snapshots are taken every time the file is saved, and are stored in the
+same directory as the file being edited, with the format
+.B .esc-file name-version number~
+where the version number is numerical up to 10. More copies than that are
+automatically deleted. 
+
+.SH SEE ALSO
+.B btrfs(5)
+.B cp(1)