maddy/docs/man
fox.cpp f931cbfe45
Rewrite build scripts
New script build.sh is much more suitable for downstream packaging
(e.g. ./build.sh package) than hacked together package.sh wrapper for
get.sh while still being usable for "effort-less" installation.

Additionally, hostname setting in get.sh is flawed in many ways and is
not reimplemented in build.sh.

build.sh has proper command line options that allow to customize build
configuration and installation prefixes.
Documentation page get.sh is removed since all applicable environment
variables and flags are documented in ./build.sh --help.

build.sh can be called from the source directory to build maddy from
*this* source instead of forced 'go get' that was used in get.sh.
However, if build.sh is called not from the source directory, it clones
the repo and (optionally) uses the specified commit. This keeps build.sh
usable in curl|bash commands.

Due to the way source code is fetched, build.sh uses Git tags instead of
Go module versions as get.sh did.
2020-02-07 20:33:58 +03:00
..
.gitignore docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
maddy-auth.5.scd Unbreak PAM/shadow authentication support 2020-02-04 19:03:24 +03:00
maddy-config.5.scd pkg/cfgparser: Rework environment expansion syntax 2020-02-04 20:03:19 +03:00
maddy-filters.5.scd check/dnsbl: Implement a simple scoring system 2019-12-13 21:11:03 +03:00
maddy-imap.5.scd docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
maddy-smtp.5.scd docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
maddy-storage.5.scd docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
maddy-targets.5.scd target/remote: Implement STARTTLS Everywhere list support 2019-12-28 18:41:55 +03:00
maddy-tls.5.scd docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
maddy.1.scd docs: Document handled signals in maddy(1) 2020-01-02 19:12:10 +03:00
prepare_md.py docs: Move the project documentation from GitHub Wiki 2019-12-06 22:56:47 +03:00
README.md Rewrite build scripts 2020-02-07 20:33:58 +03:00

maddy manual pages

The reference documentation is maintained in the scdoc format and is compiled into a set of Unix man pages viewable using the standard man utility.

See https://git.sr.ht/~sircmpwn/scdoc for information about the tool used to build pages. It can be used as follows:

scdoc < maddy-filters.5.scd > maddy-filters.5
man ./maddy-filters.5

build.sh script in the repo root compiles and installs man pages if the scdoc utility is installed in the system.