diff share/man/man1/roundup-server.1 @ 8031:0f5d31be5418

issue2551219 - use of PEM file with roundup-server Document requirements of PEM file when using roundup-server in SSL/TLS mode in the config.ini generated by roundup-server --save-config. Trap errors produced by missing cert or key when reading a pem file and try to produce a more useful error. Man page already had correct documentation. However because man pages are justified, the marker lines get additional internal spacing. Use example macros to prevent this spacing in case somebody cuts/pastes the marker lines.
author John Rouillard <rouilj@ieee.org>
date Sat, 08 Jun 2024 04:52:59 -0400
parents 55238195033f
children 627c5d6a0551
line wrap: on
line diff
--- a/share/man/man1/roundup-server.1	Thu Jun 06 20:23:31 2024 -0400
+++ b/share/man/man1/roundup-server.1	Sat Jun 08 04:52:59 2024 -0400
@@ -59,9 +59,21 @@
 \fB-e\fP \fIfile\fP
 Sets a filename containing the PEM file to use for SSL. The PEM file
 must include both the private key and certificate with appropriate
-headers (e.g. "-----BEGIN PRIVATE KEY-----", "-----END PRIVATE
-KEY-----" and "-----BEGIN CERTIFICATE-----", "-----END
-CERTIFICATE-----". If no file is specified, a temporary self-signed
+header/trailer markers:
+
+.EX
+-----BEGIN PRIVATE KEY-----
+-----END PRIVATE KEY-----
+.EE
+
+and
+
+.EX
+-----BEGIN CERTIFICATE-----
+-----END CERTIFICATE-----
+.EE
+
+If no file is specified, a temporary self-signed
 certificate will be used.
 .TP
 \fB-N\fP

Roundup Issue Tracker: http://roundup-tracker.org/