Improve user-friendliness of default config

diff --git a/cmd/mobius-hotline-server/mobius/config/config.yaml b/cmd/mobius-hotline-server/mobius/config/config.yaml
index 380c39a4a1632f9586cc44ee0f5b48d39503433d..50c3fa35341570fca9fe6ad24f8127707d04e82b 100644 (file)
--- a/cmd/mobius-hotline-server/mobius/config/config.yaml
+++ b/cmd/mobius-hotline-server/mobius/config/config.yaml
@@ -1,14 +1,40 @@
+# Name of the server as it appears on the Tracker
 Name: My Hotline server
+
+# Description of the server as it appears on the tracker
 Description: A default configured Hotline server running Mobius
+
+# Server banner ID; currently implemented
 BannerID: 0
-FileRoot: Files/
+
+# Path to the Files directory, by default in a subdirectory of the config root named Files
+FileRoot: Files
+
+# Enable tracker registration.  Must be "true" or "false".
 EnableTrackerRegistration: false
+
+# List of trackers to register with
 Trackers:
 - hltracker.com:5499
 - tracker.preterhuman.net:5499
-NewsDelimiter: ""
+
+# Preserve resource forks and file type/creator codes for files uploaded by Macintosh clients.
+# This comes with trade-offs.  For more details, see:
+# https://github.com/jhalter/mobius/wiki/Resource-fork-support-in-Mobius
+# Must be "true" or "false".
+PreserveResourceForks: false
+
+# Optional custom date format for flat news postings
 NewsDateFormat: ""
+
+# Optional custom delimiter between flat news postings
+NewsDelimiter: ""
+
+# Maximum simultaneous downloads; currently unimplemented
 MaxDownloads: 0
+
+# Maximum simultaneous downloads per client; currently unimplemented
 MaxDownloadsPerClient: 0
+
+# Maximum simultaneous connections/IP; currently unimplemented
 MaxConnectionsPerIP: 0
-PreserveResourceForks: true