--- a/docs/man/man5/package-mapping.conf.rst	Mon Oct 07 16:33:28 2024 +0200
+++ b/docs/man/man5/package-mapping.conf.rst	Mon Oct 07 17:30:10 2024 +0200
@@ -21,6 +21,8 @@
 `installed-package-name`) should be checked against the original
 parent package (with name `original-package-name`) also.
 
+Empty lines and lines starting with ``#`` are treated as a comment.
+
 
 Examples
 --------
@@ -31,14 +33,9 @@
 
     my-forked-pack pack-orig
 
+    # my-commented-out-pack other-pack-orig
+
 
 See Also
 --------
 
-:manpage:`check-ports(8)`
-
-
-Bugs
-----
-
-Comments in the file are currently not allowed.