1 -# sbbs.el
2 -`sbbs` is a SchemeBBS client in Emacs. It implements browsing the thread list, threads and creating responses.
1 +# sbbs.el #
2 +
3 +`sbbs.el` is a SchemeBBS client in Emacs. It implements browsing the thread list, threads and creating responses.
4 +
5 +All development (version control, issue tracking, documentation, etc.) is done in this [Fossil][fossil] repository.
6 +
7 +`sbbs.el` is in the Public Domain, published under the ["CC0 1.0 Universal (CC0 1.0) Public Domain Dedication"][cc0] license.
8 +
9 +# Quick Intro
10 +
11 +`sbbs.el` is currently not part of any package repository (that we know of),
12 +so it must be installed manually. The steps for this are:
3 13
4 -Any bugs, patches or questions can be submitted to my public inbox.
14 +1. Download the [sources][tarball] or [clone][fossil:clone]+[open][fossil:open] the repo.
15 +2. Open `sbbs.el` and run `package-install-from-buffer`.
16 +3. Run `M-x sbbs` or `M-x sbbs-browse` (these two do the same), choose a board and start reading.
5 17
6 -## Usage
7 -Make sure `sbbs.el` is your load path (if necessary adjust the load-path variable), and then run `M-x sbbs`. This will prompt you what board to load, and then open a buffer while asynchronously fetching the thread list.
8 -
9 -To start a new thread, press `c (sbbs-view-compose)`, or open a thread by pressing enter. When in a thread, respond by pressing `r (sbbs-read-reply)`. Create a thread or response by pressing `C-c C-c (sbbs-compose-create)`.
18 +# See also
10 19
11 -## Issues and Improvments
12 -Due to issues with url.el, some versions of Emacs take quite long to load threads/thread lists.
13 -No highlighting in response buffers.
14 -Spoilers aren't shown unless manually highlighted.
15 -Remember already opened threads and highlight updates.
16 -Add auto-quoting support when responding (e.g. with a C-u C-u prefix)
17 -Add quote-region support when responding
18 -Fix encoding issues
19 -Improve inter-thread navigation (eg. using M-n/M-p to go to next (opened) thread)
20 -Add filter support
21 -Add support for VIP replies
22 -Add open in browser command
23 -Add support for ranged and list references
24 -Be more intelligent when reloading a thread
20 +- Built-in [Ticket List](/rptview?rn=1) (feel free to contribute, you can log in anonymously)
21 +- [How to Use?](wiki:usage)
22 +- [How to Contribute?](wiki:contribute)
25 23
26 -## Download
27 -[sbbs.tar.gz](/tarball/sbbs.tar.gz)
28 -## Copying
29 -`sbbs.el` is distributed under the [CC0 1.0 Universal (CC0 1.0) Public Domain Dedication](https://creativecommons.org/publicdomain/zero/1.0/deed) license.
24 +[cc0]: https://creativecommons.org/publicdomain/zero/1.0/deed
25 +[fossil]: https://fossil-scm.org/home/doc/trunk/www/index.wiki
26 +[fossil:clone]: https://fossil-scm.org/home/help/clone
27 +[fossil:open]: https://fossil-scm.org/home/help/open
28 +[tarball]: /tarball/sbbs.tar.gz