Add man pages

1 files changed, 319 insertions, 0 deletions

diff --git a/doc/aerc-config.5.scd b/doc/aerc-config.5.scd
new file mode 100644
index 00000000..a2217231
--- /dev/null
+++ b/doc/aerc-config.5.scd
@@ -0,0 +1,319 @@
+aerc-config(5)
+
+# NAME
+
+aerc-config - configuration file formats for *aerc*(1)
+
+# CONFIGURATION
+
+There are three aerc config files: *aerc.conf*, *binds.conf*, and
+*accounts.conf*. The last one must be kept secret, as it may include your
+account credentials. We look for these files in your XDG config home plus
+"aerc", which defaults to ~/.config/aerc.
+
+Examples of these config files are typically included with your installation of
+aerc and are usually installed in /usr/share/aerc.
+
+Each file uses the _ini_ format, and consists of sections with keys and values.
+A line beginning with # is considered a comment and ignored, as are empty lines.
+New sections begin with [section-name] on a single line, and keys and values are
+separated with "=".
+
+# AERC.CONF
+
+This file is used for configuring the general appearance and behavior of aerc.
+
+## UI OPTIONS
+
+These options are configured in the *[ui]* section of aerc.conf.
+
+*index-format*
+	Describes the format for each row in a mailbox view. This field is
+	compatible with mutt's printf-like syntax. TODO: document properly
+
+	Default: %4C %Z %D %-17.17n %s
+
+*timestamp-format*
+	See strftime(3)
+
+	Default: %F %l:%M %p (ISO 8501 + 12 hour time)
+
+*sidebar-width*
+	Width of the sidebar, including the border. Set to zero to disable the
+	sidebar.
+
+	Default: 20
+
+*empty-message*
+	Message to display when viewing an empty folder.
+
+	Default: (no messages)
+
+## VIEWER
+
+These options are configured in the *[viewer]* section of aerc.conf.
+
+*pager*
+	Specifies the pager to use when displaying emails. Note that some filters
+	may add ANSI escape sequences to add color to rendered emails, so you may
+	want to use a pager which supports ANSI.
+
+	Default: less -R
+
+*alternatives*
+	If an email offers several versions (multipart), you can configure which
+	mimetype to prefer. For example, this can be used to prefer plaintext over
+	HTML emails.
+
+	Default: text/plain,text/html
+
+## COMPOSE
+
+These options are configured in the *[viewer]* section of aerc.conf.
+
+*editor*
+	Specifies the command to run the editor with. It will be shown in an
+	embedded terminal, though it may also launch a graphical window if the
+	environment supports it. Defaults to *$EDITOR*, or *vi*(1).
+
+## FILTERS
+
+Filters allow you to pipe an email body through a shell command to render
+certain emails differently, e.g. highlighting them with ANSI escape codes.
+They are configured in the *[filters]* section of aerc.conf.
+
+The first filter which matches the email's mimetype will be used, so order
+them from most to least specific.
+
+You can also match on non-mimetypes, by prefixing with the header to match
+against (non-case-sensitive) and a comma, e.g. subject,text will match a
+subject which contains "text". Use header,~regex to match against a regex.
+
+Most aerc installations come with some useful filters, typically installed in
+/usr/share/aerc/filters. Here is an example config which uses these filters:
+
+```
+subject,~^\[PATCH=/usr/share/aerc/filters/hldiff.py
+text/html=/usr/share/aerc/filters/html
+text/*=/usr/share/aerc/filters/plaintext.py
+```
+
+Note that the filters which are installed with aerc have additional
+dependencies, such as Python, sockify, and w3m.
+
+# ACCOUNTS.CONF
+
+This file is used for configuring each mail account used for aerc. Each section
+is the name of an account you want to configure, and the keys & values in that
+section specify details of that account's configuration. In addition to the
+options documented here, specific transports for incoming and outgoing emails
+may have additional configuration parameters, documented on their respective man
+pages.
+
+Note that many of these configuration options are written for you, such as
+*source* and *outgoing*, when you run the account configuration wizard
+(*:new-account*).
+
+*copy-to*
+	Specifies a folder to copy sent mails to, usually "Sent".
+
+	Default: none
+
+*default*
+	Specifies the default folder to open in the message list when aerc
+	configures this account.
+
+	Default: INBOX
+
+*folders*
+	Specifies the list of folders to display in the sidebar.
+
+	Default: all folders
+
+*from*
+	The default value to use for the From header in new emails. This should be
+	an RFC 5322-compatible string, such as "Your Name <you@example.org>".
+
+	Default: none
+
+*outgoing*
+	Specifies the transport for sending outgoing emails on this account.  It
+	should be a connection string, and the specific meaning of each component
+	varies depending on the protocol in use.  See each protocol's man page for
+	more details:
+
+	- *aerc-smtp*(5)
+
+*source*
+	Specifies the source for reading incoming emails on this account. This key
+	is required for all accounts. It should be a connection string, and the
+	specific meaning of each component varies depending on the protocol in use.
+	See each protocol's man page for more details:
+
+	- *aerc-imap*(5)
+
+	Default: none
+
+# BINDS.CONF
+
+This file is used for configuring keybindings used in the aerc interactive
+client. You may configure different keybindings for different contexts by
+writing them into different *[sections]* of the ini file. The available contexts
+are:
+
+*[messages]*
+	keybindings for the message list
+
+*[view]*
+	keybindings for the message viewer
+
+*[compose]*
+	keybindings for the message composer
+
+*[compose::editor]*
+	keybindings for the composer, when the editor is focused
+
+*[compose::review]*
+	keybindings for the composer, when reviewing the email before it's sent
+
+*[terminal]*
+	keybindings for terminal tabs
+
+You may also configure global keybindings by placing them at the beginning of
+the file, before specifying any context-specific sections. For each *key=value*
+option specified, the _key_ is the keystrokes pressed (in order) to invoke this
+keybinding, and _value_ specifies keystrokes that aerc will simulate when the
+keybinding is invoked. Generally this is used to execute commands, for example:
+
+	rq = :reply -q<Enter>
+
+Pressing r, then q, will simulate typing in ":reply -q<Enter>", and execute
+:reply -q accordingly. It is also possible to invoke keybindings recursively in
+a similar fashion. Additionally, the following special options are available in
+each binding context:
+
+*$noinherit*
+	If set to "true", global keybindings will not be effective in this context.
+
+	Default: false
+
+*$ex*
+	This can be set to a keystroke which will bring up the command input in this
+	context.
+	
+	Default: <semicolon>
+
+In addition to letters, special keys may be specified in <angle brackets>. The
+following special keys are supported:
+
+[[ *Name*
+:- *Description*
+|  space
+:  " "
+|  semicolon
+:  ;
+|  tab
+:  
+|  enter
+:  
+|  up
+:  
+|  down
+:  
+|  right
+:  
+|  left
+:  
+|  pgup
+:  
+|  pgdn
+:  
+|  home
+:  
+|  end
+:  
+|  insert
+:  
+|  delete
+:  
+|  exit
+:  
+|  cancel
+:  
+|  print
+:  
+|  pause
+:  
+|  backtab
+|  c-space
+:  Ctrl+Space
+|  c-a
+:  Ctrl+a
+|  c-b
+:  Ctrl+b
+|  c-c
+:  Ctrl+c
+|  c-d
+:  Ctrl+d
+|  c-e
+:  Ctrl+e
+|  c-f
+:  Ctrl+f
+|  c-g
+:  Ctrl+g
+|  c-h
+:  Ctrl+h
+|  c-i
+:  Ctrl+i
+|  c-j
+:  Ctrl+j
+|  c-k
+:  Ctrl+k
+|  c-l
+:  Ctrl+l
+|  c-m
+:  Ctrl+m
+|  c-n
+:  Ctrl+n
+|  c-o
+:  Ctrl+o
+|  c-p
+:  Ctrl+p
+|  c-q
+:  Ctrl+q
+|  c-r
+:  Ctrl+r
+|  c-s
+:  Ctrl+s
+|  c-t
+:  Ctrl+t
+|  c-u
+:  Ctrl+u
+|  c-v
+:  Ctrl+v
+|  c-w
+:  Ctrl+w
+|  c-x
+:  Ctrl+x
+|  c-y
+:  Ctrl+y
+|  c-z
+:  Ctrl+z
+|  c-]
+:  Ctrl+]
+|  c-[
+:  Ctrl+[
+|  c-^
+:  Ctrl+^
+|  c-_
+:  Ctrl+_
+
+# SEE ALSO
+
+*aerc*(1) *aerc-imap*(5) *aerc-smtp*(5)
+
+# AUTHORS
+
+Maintained by Drew DeVault <sir@cmpwn.com>, who is assisted by other open
+source contributors. For more information about aerc development, see
+https://git.sr.ht/~sircmpwn/aerc.