~strahinja/strahinja.srht.site

fcf07b241fbbfd703091fba534234a3e6aa9e0be — Страхиња Радић 3 months ago 2530885
Add .do files for sled/ and poe/clean.do

Signed-off-by: Страхиња Радић <contact@strahinja.org>
7 files changed, 103 insertions(+), 1 deletions(-)

M .gitignore
M clean.do
A poe/clean.do
M sled/all.do
A sled/clean.do
A sled/default.gmi.do
A sled/index.gmi
M .gitignore => .gitignore +2 -0
@@ 15,6 15,8 @@
nohup.out
*.gz
index.html
sled/index.gmi
sled/index.html
slweb/index.html
slw2gmi/index.html
slw2gmi/index.gmi

M clean.do => clean.do +2 -0
@@ 1,4 1,6 @@
redo blog/clean
redo poe/clean
redo sled/clean
redo slweb/clean
redo slw2gmi/clean
redo table/clean

A poe/clean.do => poe/clean.do +1 -0
@@ 0,0 1,1 @@
rm -f index.html *~

M sled/all.do => sled/all.do +1 -1
@@ 1,1 1,1 @@
redo-ifchange index.html
redo-ifchange index.html index.gmi

A sled/clean.do => sled/clean.do +1 -0
@@ 0,0 1,1 @@
rm -f index.gmi index.html *~

A sled/default.gmi.do => sled/default.gmi.do +2 -0
@@ 0,0 1,2 @@
redo-ifchange $2.slw
../../slw2gmi/slw2gmi $2.slw >$3

A sled/index.gmi => sled/index.gmi +94 -0
@@ 0,0 1,94 @@
# sled



sled is a simple text editor with a terminal UI.

## Q&amp;A

Q: Why can't sled open the file &ldquo;read only&rdquo; even if modification is disallowed? A: A text editor's purpose should be to edit text files. For just viewing text files, there's less(1). This avoids the situation when opening a file one is not allowed to write to with an editor like vi(1), only to have write operation denied after making numerous edits.Of course, one could argue that screen editors like vi already double as text file viewers, but I think of displaying the contents of a writable file as being separate from displaying the contents of a non-writable file.If this bothers you, you can use something like the included shell script sledv.

Q: Is editing multiple files planned? A: No, and this is by design. You can edit multiple files at the same time by running multiple instances of sled. You can arrange them on screen through a terminal multiplexer like GNU screen(1) or tmux(1), or just open several terminal emulators like st(1) and have your window manager arrange their windows. Inter-process &ldquo;clipboard&rdquo; can be managed by a terminal multiplexer or X.Org itself.

Q: Is there a ~/.config/sled/config or ~/.sledrc? A: No, and never will be. sled is intended to be configured through editing config.h and recompilation, like suckless software.

Q: Are plugins planned? A: No. Like suckless software, sled is meant to be extended through patches.

Q: Why doesn't sled have feature X from text editor Y? A: Most likely because it is not essential to editing text files. However, you are free to offer a patch supporting the feature, which will be included in the repository, with credits to the author.

Q: How can I configure sled if I installed it (from AUR|through my distro's package manager)? A: You don't. If you want customization/configuration, clone the git repo, customize and compile it from source, just like with suckless software.

Q: Why am I getting a &ldquo;Permission denied&rdquo; when trying to edit a file? A: You either can't access the directory for writing (and haven't disabled the creation of backups), or the file itself.

## Prerequisites

* C compiler (GCC-compatible) - ${SLED_CC:-gcc} 

* gzip

## Install

```
$ git clone https://git.sr.ht/~strahinja/sled
$ cd sled
$ su
```

If you have djb redo:

```
# redo install
```

if you don't:

```
# ./do install
```

## Applying patches

To apply any patches, change the current directory to the one holding the sled repository, then:

```
$ git am path_to_patch/filename-of-patch.patch
```

and then call redo as above. Included patches are located inside the patch/ subdirectory.

## Contributing patches

See the file HACKING in the sled repository for details.

=> https://git.sr.ht/~strahinja/sled/blob/master/HACKING	HACKING

## Bugs and limitations

Bugs can be reported using the ticket tracker. See the manpage (man sled) after installing sled for more information.

=> https://todo.sr.ht/~strahinja/sled/	ticket tracker

## License

sled - Simple text editor
 Copyright (C) 2022 Страхиња Радић

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.

=> https://www.gnu.org/licenses	https://www.gnu.org/licenses/

————————————————————
This program includes code from the termbox2 TUI library,

The file LICENSE.termbox applies to the portion of this program which is from the termbox2 library. Currently, this includes only the file termbox.h.

=> https://github.com/termbox/termbox2	https://github.com/termbox/termbox2

Generated by slw2gmi © 2021 Strahinya Radich.