#358 Man page out of date

[paul]

The manual page has not been updated since 1.1.0

Please consider the following patch - or using the Debian version

--- minidlnad.8~    2023-05-31 09:25:59.000000000 +0100
+++ minidlnad.8 2023-08-19 21:43:36.051944449 +0100
@@ -24,26 +24,38 @@
 you can do this by running minidlna with the following command line switches.
 .fi

-.IP "\fB\-R\fR \fIRescan\fR"
-This forces minidlna to rescan all of the media_dir directories.
+.IP "\fB\-d\fR \fIdebug\fR"
+minidlna will run in the foreground with debug output.

 .IP "\fB\-f\fR \fIconfig_file\fR"
-Run minidlna with a different configuration file than the global default.
+Run minidlna with a different configuration file than the global default (/etc/minidlna.conf).

-.IP "\fB\-p\fR \fIport\fR"
-Allows to run minidlna on a different port.
+.IP "\fB\-h\fR \fIhelp\fR"
+Show basic switch options for running minidlna.

-.IP "\fB\-w\fR \fIpresentation_url\fR"
-Change the default presentation url address.
+.IP "\fB\-i\fR \fIinterface\fR"
+Network interface to listen on. Can be specified more than once.

-.IP "\fB\-d\fR \fIdebug\fR"
-minidlna will run in the foreground with debug output.
+.IP "\fB\-L\fR"
+Disable playlist handling
+
+.IP "\fB\-m\fR \fImodel\fR"
+Force minidlna to report a specific model number.

 .IP "\fB\-P\fR \fIpid_filename\fR"
 Specify a location for the PID file.

-.IP "\fB\-m\fR \fImodel\fR"
-Force minidlna to report a specific model number.
+.IP "\fB\-p\fR \fIport\fR"
+Allows to run minidlna on a different port.
+
+.IP "\fB\-R\fR \fIRebuild\fR"
+This forces minidlna to remove and rebuild its database.
+
+.IP "\fB\-r\fR \fIRescan\fR"
+This forces minidlna to rescan all of the media_dir directories.
+
+.IP "\fB\-S\fR"
+Stay in the foreground (used by systemd)

 .IP "\fB\-s\fR \fIserial\fR"
 Force minidlna to report a specific serial number.
@@ -51,15 +63,20 @@
 .IP "\fB\-t\fR \fInotify_interval\fR"
 Change the notify interval, in seconds. Defaults to 895 seconds.

-.IP "\fB\-h\fR \fIhelp\fR"
-Show basic switch options for running minidlna.
+.IP "\fB\-u\fR \fIuser\fR"
+Specify which user minidlnad should run as, instead of root; user can either be a numerical UID or a user name.

 .IP "\fB\-V\fR \fIVersion\fR"
 Shows the program version number and exits.

+.IP "\fB\-v\fR"
+Enables verbose output
+
+.IP "\fB\-w\fR \fIpresentation_url\fR"
+Change the default presentation url address.

 .SH VERSION
-This man page corresponds to minidlna version 1.1.0 
+This man page corresponds to minidlna version 1.3.3 

 .SH AUTHOR
 .nf

[Barak A. Pearlmutter]

If you file this against the Debian package with an attached patch to the Debian man page, in file debian/minidlnad.8, or do a pull request on salsa.debian.org, I'd be happy to yank it in. (I don't know how the man pages diverged instead of the Debian ones being kept as a patch against upstream. It's a bit hard to figure out from the git history.)

[paul]

It isn't specific to the Debian package though. The man page is out of date in main and in the tarballs.

[Barak A. Pearlmutter]

Right. I'll remove the manpage in debian/ and maintain it as a
debian/patch/ against the upstream manpage. This makes it easy to
unpack as a git patch against upstream that can be pulled, using
git-buildpackage pq import.