From 50fb0d56a1d663ac990204c4346ef72b9d32b72a Mon Sep 17 00:00:00 2001
From: "James K. Lowden" <jklowden@symas.com>
Date: Wed, 5 Feb 2025 07:48:30 -0500
Subject: [PATCH] publish generated cobol documentation
---
gcc/cobol/Make-lang.in | 2 +-
gcc/cobol/gcobol.1 | 2 +-
maintainer-scripts/update_web_docs_git | 29 ++++++++++++++++++++++++++
3 files changed, 31 insertions(+), 2 deletions(-)
diff --git a/gcc/cobol/Make-lang.in b/gcc/cobol/Make-lang.in
index 80dba2c1099e..358a793a50ce 100644
--- a/gcc/cobol/Make-lang.in
+++ b/gcc/cobol/Make-lang.in
@@ -276,7 +276,7 @@ cobol.install-info:
cobol.install-pdf: installdirs gcobol.pdf gcobol-io.pdf
mkdir -p $(DESTDIR)$(datadir)/gcobol/pdf
- $(INSTALL_DATA) gcobol.pdf gcobol-io.pdf $(DESTDIR)$(datadir)/gcobol/pdf/
+ $(INSTALL_DATA) gcobol.pdf gcobol-io.pdf $(DESTDIR)$(pdfdir)/
cobol.install-plugin:
diff --git a/gcc/cobol/gcobol.1 b/gcc/cobol/gcobol.1
index 5bd8dcfab7f7..0d3898818c7b 100644
--- a/gcc/cobol/gcobol.1
+++ b/gcc/cobol/gcobol.1
@@ -98,7 +98,7 @@ to have the value of
.Ar expr .
.It Fl E
Write the CDF-processed \*[lang] input to standard output in free-form
-reference format. Certain non-Cobol markers are included in the
+reference format. Certain non-\*[lang] markers are included in the
output to indicate where copybook files were included. For
line-number consistency with the input, blank lines are retained.
.Pp
diff --git a/maintainer-scripts/update_web_docs_git b/maintainer-scripts/update_web_docs_git
index 8ff34f86f65d..8b3f9ba9ae85 100755
--- a/maintainer-scripts/update_web_docs_git
+++ b/maintainer-scripts/update_web_docs_git
@@ -143,6 +143,7 @@ rm -rf gcc/.git
# not .texi files (Makefile, .rst and .png), and the jit docs use
# include directives to pull in content from jit/jit-common.h and
# Similar considerations apply for libgdiagnostics.
+# Preserve the cobol man pages, which are converted to HTML and PDF.
find gcc -type f \( -name '*.texi' \
-o -path gcc/gcc/doc/install.texi2html \
-o -path gcc/gcc/doc/include/texinfo.tex \
@@ -155,6 +156,7 @@ find gcc -type f \( -name '*.texi' \
-o -path "gcc/gcc/testsuite/jit.dg/*" \
-o -path "gcc/gcc/doc/libgdiagnostics/*" \
-o -path "gcc/gcc/testsuite/libgdiagnostics.dg/*" \
+ -o -path "gcc/gcc/cobol/gcobol*[13]" \
-o -print0 \) | xargs -0 rm -f
# Build a tarball of the sources.
@@ -200,6 +202,33 @@ for file in $MANUALS; do
fi
done
+#
+# The COBOL FE maintains man pages. Convert them to HTML and PDF.
+#
+mdoc2pdf_html() {
+ input="$1"
+ d="${input%/*}"
+ pdf="$d/$2"
+ html="$d/$3"
+ groff -mdoc -T pdf "$input" > "${pdf}~"
+ mv "${pdf}~" "${pdf}"
+ mandoc -T html "$filename" > "${html}~"
+ mv "${html}~" "${html}"
+}
+
+find . -name gcobol.[13] |
+ while read filename
+ do
+ case ${filename##*.} in
+ 1)
+ mdoc2pdf_html "$filename" gcobol.pdf gcobol.html
+ ;;
+ 3)
+ mdoc2pdf_html "$filename" gcobol_io.pdf gcobol_io.html
+ ;;
+ esac
+ done
+
# jit and libgdiagnostics are a special-case, using Sphinx rather than texinfo.
# Specifically, they need Sphinx 3.0 or later.
#
--
GitLab