summary refs log tree commit diff
path: root/contrib/README.md
diff options
context:
space:
mode:
authorAlexander Barton <alex@barton.de>2024-02-09 22:47:05 +0100
committerAlexander Barton <alex@barton.de>2024-02-10 00:22:33 +0100
commitb3513ee1590ba4aa88c5e760a48323c727bec45e (patch)
tree1c2da7733ac18abf26891146312c327d974b94fd /contrib/README.md
parent39eccffa32c36e55a2fd32f7a33aa929ba0b197b (diff)
downloadngircd-b3513ee1590ba4aa88c5e760a48323c727bec45e.tar.gz
ngircd-b3513ee1590ba4aa88c5e760a48323c727bec45e.zip
Convert contrib/README to Markdown
Diffstat (limited to 'contrib/README.md')
-rw-r--r--contrib/README.md35
1 files changed, 35 insertions, 0 deletions
diff --git a/contrib/README.md b/contrib/README.md
new file mode 100644
index 00000000..4f04dce6
--- /dev/null
+++ b/contrib/README.md
@@ -0,0 +1,35 @@
+# [ngIRCd](https://ngircd.barton.de) - Supplemental Files
+
+This `contrib/` directory contains the following sub-folders and files:
+
+- `Debian/` folder: This subfolder contains the _rules_ file and additional
+  assets for building Debian packages.
+
+- `de.barton.ngircd.metainfo.xml`: AppStream metadata file.
+
+- `de.barton.ngircd.plist[.tmpl]`: launchd(8) property list file.
+
+- `ngindent.sh`: Script to indent the code of ngIRCd in the "standard way".
+
+- `ngircd-bsd.sh`: Start/stop script for FreeBSD.
+
+- `ngircd-redhat.init`: Start/stop script for old(er) RedHat-based
+  distributions (like CentOS and Fedora), which did _not_ use systemd(8).
+
+- `ngIRCd-Logo.gif`: The ngIRCd logo as GIF file.
+
+- `ngircd.logcheck`: Sample rules for logcheck(8) to ignore "normal" log
+  messages of ngIRCd.
+
+- `ngircd.service`: systemd(8) service unit configuration file.
+
+- `ngircd.socket`: systemd(8) socket unit configuration file for "socket
+  activation".
+
+- `ngircd.spec`: RPM "spec" file.
+
+- `nglog.sh`: Script for colorizing the log messages of ngircd(8) according to
+  their log level. Example: `./src/ngircd/ngircd -n | ./contrib/nglog.sh`.
+
+- `platformtest.sh`: Build ngIRCd and output a "result line" suitable for
+  the `doc/Platforms.txt` file.