Initial import.
[apt-sources-list.git] / README.md
1 # `apt-sources-list`
2
3 This Emacs package contains a major mode for editing APT’s `.list` files.
4
5 The `/etc/apt/sources.list` file and other files in
6 `/etc/apt/sources.list.d` tell APT, found on Debian-based systems and
7 others, where to find packages for installation.
8
9 This format specifies a package source with a single line, e.g.:
10
11 deb http://deb.debian.org/debian stable main contrib
12
13 For more information about the format you can read the manual
14 pages [apt(8)][] and [sources.list(5)][].
15
16 This mode is derived from `apt-sources-mode` distributed in the
17 `debian-el` Debian package, but has many differences. Among them:
18
19 - The load hook has been removed. Use `with-eval-after-load`.
20 - What is properly called a “suite” is no longer called a “distribution.”
21 - Most keys have changed. This is for better mnemonics (`C-c C-s` to
22 change the suite), or for better Emacs integration (`C-M-n` or your
23 `forward-list` equivalent to move between source lines).
24 - Editing functions may be called more easily from Emacs Lisp.
25
26
27 ## License
28
29 This program is free software; you can redistribute it and/or modify
30 it under the terms of the GNU General Public License as published by
31 the Free Software Foundation, either version 3 of the License, or (at
32 your option) any later version.
33
34
35 [apt(8)]: https://manpages.debian.org/stable/apt/sources.list.5.en.html
36 [sources.list(5)]: https://manpages.debian.org/stable/apt/sources.list.5.en.html