2020-11-03 09:27:49 +01:00
# Quick Emacs (QEmacs)
2020-10-24 23:59:54 +02:00
2020-10-26 07:55:07 +01:00
Welcome to QEmacs! A small but powerful UNIX editor with many features
that even big editors lack.
2020-10-24 23:59:54 +02:00
2020-11-03 09:27:49 +01:00
## Quick Description
2020-10-24 23:59:54 +02:00
2020-11-05 13:39:05 +01:00
QEmacs is a small text editor targeted at embedded systems or debugging.
2020-10-24 23:59:54 +02:00
Although it is very small, it has some very interesting features that
even big editors lack:
2020-11-05 13:39:05 +01:00
- Full screen editor with an Emacs look and feel with all common Emacs
2020-10-24 23:59:54 +02:00
features: multi-buffer, multi-window, command mode, universal argument,
2023-03-09 12:38:45 +01:00
keyboard macros, config file with C-like syntax, minibuffer with
2020-11-05 13:39:05 +01:00
completion and history.
2020-10-24 23:59:54 +02:00
- Can edit huge files (hundreds of megabytes) without delay, using a
2023-03-09 12:38:45 +01:00
highly optimized internal representation and memory mapping for large
files.
2020-10-24 23:59:54 +02:00
- Full Unicode support, including multi charset handling
2023-03-09 12:38:45 +01:00
(8859-x, UTF8, SJIS, EUC-JP, ...) and bidirectional editing respecting
the Unicode bidi algorithm. Arabic and Indic scripts handling (in
progress). Automatic end of line detection.
2020-10-24 23:59:54 +02:00
- C mode: coloring with immediate update, auto-indent, automatic tags.
2023-03-09 12:38:45 +01:00
- Shell mode: full color VT100 terminal emulation so your shell works
exactly as you expect. Compile mode with colorized error messages,
automatic error message parser jumps to next/previous error, works
with grep too. The shell buffer is a fully functional terminal: you
can run qemacs, vim or even emacs recursively!
2020-10-24 23:59:54 +02:00
- Input methods for most languages, including Chinese (input methods
2023-03-09 12:38:45 +01:00
descriptions come from the Yudit editor).
2020-10-24 23:59:54 +02:00
2023-03-09 12:38:45 +01:00
- Binary and hexadecimal in place editing mode with insertion and
block commands. Unicode hexa editing of UTF-8 files also supported.
Can patch binary files, preserving every byte outside the modified
areas.
2020-10-24 23:59:54 +02:00
2020-11-05 13:39:05 +01:00
- Works on any VT100 terminal without termcap. UTF-8 VT100 support
2020-10-24 23:59:54 +02:00
included with double width glyphs.
2020-11-05 13:39:05 +01:00
- X11 support. Supports multiple proportional fonts at the same time
(like XEmacs). X Input methods supported. Xft extension supported for
anti-aliased font display.
2020-10-24 23:59:54 +02:00
2025-02-10 07:38:19 +01:00
- Bitmap images are displayed on graphics displays and as colored text
2021-02-04 21:16:13 +01:00
on text terminals, which is handy when browsing files over an ssh connection.
2023-03-09 12:38:45 +01:00
(QEmacs uses the public domain [`stb_image` ](https://github.com/nothings/stb/blob/master/stb_image.h )
package for image parsing.
2020-10-26 07:55:07 +01:00
2020-11-03 09:27:49 +01:00
## Building QEmacs
2020-10-24 23:59:54 +02:00
2020-11-05 13:39:05 +01:00
* Launch the custom configuration script `./configure` . You can list the
2023-03-09 12:38:45 +01:00
available options by typing `./configure --help` .
2020-10-24 23:59:54 +02:00
* Type `make` to compile qemacs and its associated tools.
2020-11-05 13:39:05 +01:00
* Type `make install` as root to install it in * * /usr/local**.
2020-10-24 23:59:54 +02:00
2020-11-03 09:27:49 +01:00
## QEmacs Documentation
2020-10-24 23:59:54 +02:00
Read the file [qe-doc.html ](qe-doc.html ).
2020-11-03 09:27:49 +01:00
## Licensing
2020-10-24 23:59:54 +02:00
2023-03-05 02:04:02 +01:00
QEmacs is released under the MIT license.
2026-04-27 21:06:25 +08:00
(read the accompanying [LICENSE ](LICENSE ) file).
2020-10-24 23:59:54 +02:00
2020-11-03 09:27:49 +01:00
## Contributing to QEmacs
2020-10-24 23:59:54 +02:00
2025-02-10 07:38:19 +01:00
QEmacs official repository is available on [Github ](https://github.com/qemacs/qemacs ).
You are welcome to contribute by opening an issue or submitting a Pull Request. Older discussions are archived on the [qemacs-devel ](https://lists.nongnu.org/mailman/listinfo/qemacs-devel ) mailing list.
2020-10-24 23:59:54 +02:00
2020-11-03 09:27:49 +01:00
## Authors
2020-10-24 23:59:54 +02:00
QEmacs was started in 2000. The initial version was developped by
2020-10-26 07:55:07 +01:00
Fabrice Bellard and Charlie Gordon, who since then, has been maintaining
2020-10-24 23:59:54 +02:00
and extending it.