changeset 8075:08fcbdfe670b

docs: set max width for man page paragraphs to 65ch The man pages aren't displayed using the css for the rest of the site. The man pages lines are too long to read comfortably. Limit line length.
author John Rouillard <rouilj@ieee.org>
date Sat, 13 Jul 2024 00:10:18 -0400
parents e1c477c5d63f
children 9ffb6cff2859
files doc/Makefile doc/html_extra/man_pages/roundup-admin.1.html doc/html_extra/man_pages/roundup-demo.1.html doc/html_extra/man_pages/roundup-mailgw.1.html doc/html_extra/man_pages/roundup-server.1.html
diffstat 5 files changed, 10 insertions(+), 8 deletions(-) [+]
line wrap: on
line diff
--- a/doc/Makefile	Fri Jul 12 23:41:21 2024 -0400
+++ b/doc/Makefile	Sat Jul 13 00:10:18 2024 -0400
@@ -19,6 +19,8 @@
 
 html_extra/man_pages/%.1.html: ../share/man/man1/%.1
 	man --html=cat $< > $@
+	# set max width for paragraphs
+	sed -i '/<style/,/<\/style/s/\(p\s* { \)margin/\1max-width: 65ch; margin/' $@
 	#man2html $< > $@
 
 clean:
--- a/doc/html_extra/man_pages/roundup-admin.1.html	Fri Jul 12 23:41:21 2024 -0400
+++ b/doc/html_extra/man_pages/roundup-admin.1.html	Sat Jul 13 00:10:18 2024 -0400
@@ -1,5 +1,5 @@
 <!-- Creator     : groff version 1.22.4 -->
-<!-- CreationDate: Sun May 26 03:41:33 2024 -->
+<!-- CreationDate: Sat Jul 13 04:05:30 2024 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>
@@ -8,7 +8,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">
 <style type="text/css">
-       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
+       p       { max-width: 65ch; margin-top: 0; margin-bottom: 0; vertical-align: top }
        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
        h1      { text-align: center }
--- a/doc/html_extra/man_pages/roundup-demo.1.html	Fri Jul 12 23:41:21 2024 -0400
+++ b/doc/html_extra/man_pages/roundup-demo.1.html	Sat Jul 13 00:10:18 2024 -0400
@@ -1,5 +1,5 @@
 <!-- Creator     : groff version 1.22.4 -->
-<!-- CreationDate: Sun May 26 03:41:33 2024 -->
+<!-- CreationDate: Sat Jul 13 04:05:31 2024 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>
@@ -8,7 +8,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">
 <style type="text/css">
-       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
+       p       { max-width: 65ch; margin-top: 0; margin-bottom: 0; vertical-align: top }
        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
        h1      { text-align: center }
--- a/doc/html_extra/man_pages/roundup-mailgw.1.html	Fri Jul 12 23:41:21 2024 -0400
+++ b/doc/html_extra/man_pages/roundup-mailgw.1.html	Sat Jul 13 00:10:18 2024 -0400
@@ -1,5 +1,5 @@
 <!-- Creator     : groff version 1.22.4 -->
-<!-- CreationDate: Sun May 26 03:41:33 2024 -->
+<!-- CreationDate: Sat Jul 13 04:05:30 2024 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>
@@ -8,7 +8,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">
 <style type="text/css">
-       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
+       p       { max-width: 65ch; margin-top: 0; margin-bottom: 0; vertical-align: top }
        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
        h1      { text-align: center }
--- a/doc/html_extra/man_pages/roundup-server.1.html	Fri Jul 12 23:41:21 2024 -0400
+++ b/doc/html_extra/man_pages/roundup-server.1.html	Sat Jul 13 00:10:18 2024 -0400
@@ -1,5 +1,5 @@
 <!-- Creator     : groff version 1.22.4 -->
-<!-- CreationDate: Tue Jun 18 02:08:18 2024 -->
+<!-- CreationDate: Sat Jul 13 04:05:30 2024 -->
 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
 "http://www.w3.org/TR/html4/loose.dtd">
 <html>
@@ -8,7 +8,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 <meta name="Content-Style" content="text/css">
 <style type="text/css">
-       p       { margin-top: 0; margin-bottom: 0; vertical-align: top }
+       p       { max-width: 65ch; margin-top: 0; margin-bottom: 0; vertical-align: top }
        pre     { margin-top: 0; margin-bottom: 0; vertical-align: top }
        table   { margin-top: 0; margin-bottom: 0; vertical-align: top }
        h1      { text-align: center }

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