diff options
author | Arsen Arsenović <arsen@aarsen.me> | 2023-03-09 21:44:29 +0100 |
---|---|---|
committer | Arsen Arsenović <arsen@aarsen.me> | 2023-03-21 09:47:34 +0100 |
commit | 0395e1364dd969e5845d4b9198e6f8c28b297d36 (patch) | |
tree | 93415e7121dd22a64e1d83cf9c2db7642e28ecf7 | |
parent | e54b01a101a54bd6f91abc49424cfc5ac0f904ed (diff) | |
download | gcc-0395e1364dd969e5845d4b9198e6f8c28b297d36.zip gcc-0395e1364dd969e5845d4b9198e6f8c28b297d36.tar.gz gcc-0395e1364dd969e5845d4b9198e6f8c28b297d36.tar.bz2 |
html: Set CONTENTS_OUTPUT_LOCATION=inline if makeinfo supports it
This flag allows us to restore old (pre-6.8) behavior of the
@{summary,}content commands, so that texi2any continues to emit
summarycontents first.
maintainer-scripts/ChangeLog:
* update_web_docs_git: Set CONTENTS_OUTPUT_LOCATION=inline in
order to put @shortcontents above contents.
gcc/ChangeLog:
* configure.ac: Add check for the Texinfo 6.8
CONTENTS_OUTPUT_LOCATION customization variable and set it if
supported.
* configure: Regenerate.
* Makefile.in (MAKEINFO_TOC_INLINE_FLAG): New variable. Set by
configure.ac to -c CONTENTS_OUTPUT_LOCATION=inline if
CONTENTS_OUTPUT_LOCATION support is detected, empty otherwise.
($(build_htmldir)/%/index.html): Pass MAKEINFO_TOC_INLINE_FLAG.
-rw-r--r-- | gcc/Makefile.in | 6 | ||||
-rwxr-xr-x | gcc/configure | 35 | ||||
-rw-r--r-- | gcc/configure.ac | 21 | ||||
-rwxr-xr-x | maintainer-scripts/update_web_docs_git | 2 |
4 files changed, 60 insertions, 4 deletions
diff --git a/gcc/Makefile.in b/gcc/Makefile.in index 6001c9e..d8b76d8 100644 --- a/gcc/Makefile.in +++ b/gcc/Makefile.in @@ -787,6 +787,9 @@ INSTALL_HEADERS=install-headers install-mkheaders # Control whether Info documentation is built and installed. BUILD_INFO = @BUILD_INFO@ +# Control flags for @contents placement in HTML output +MAKEINFO_TOC_INLINE_FLAG = @MAKEINFO_TOC_INLINE_FLAG@ + # Control whether manpages generated by texi2pod.pl can be rebuilt. GENERATED_MANPAGES = @GENERATED_MANPAGES@ @@ -3461,7 +3464,8 @@ html:: $(HTMLS_BUILD) $(build_htmldir)/%/index.html: %.texi $(mkinstalldirs) $(@D) rm -f $(@D)/* - $(TEXI2HTML) -I $(abs_docdir) -I $(abs_docdir)/include -o $(@D) $< + $(TEXI2HTML) $(MAKEINFO_TOC_INLINE_FLAG) \ + -I $(abs_docdir) -I $(abs_docdir)/include -o $(@D) $< # Duplicate entry to handle renaming of gccinstall $(build_htmldir)/gccinstall/index.html: $(TEXI_GCCINSTALL_FILES) diff --git a/gcc/configure b/gcc/configure index 254f9b6..20d3142 100755 --- a/gcc/configure +++ b/gcc/configure @@ -810,6 +810,7 @@ PYTHON BISON FLEX GENERATED_MANPAGES +MAKEINFO_TOC_INLINE_FLAG BUILD_INFO MAKEINFO have_mktemp_command @@ -8795,6 +8796,36 @@ else fi +# Determine whether makeinfo supports the CONTENTS_OUTPUT_LOCATION variable. +# If it does, we want to pass it to makeinfo in order to restore the old +# behaviour of @{summary,}contents placement. +MAKEINFO_TOC_INLINE_FLAG= +if test x"$MAKEINFO" != x; then : + + { $as_echo "$as_me:${as_lineno-$LINENO}: checking for CONTENTS_OUTPUT_LOCATION support in $MAKEINFO" >&5 +$as_echo_n "checking for CONTENTS_OUTPUT_LOCATION support in $MAKEINFO... " >&6; } +if ${gcc_cv_texi_add_toc_inline_flags+:} false; then : + $as_echo_n "(cached) " >&6 +else + + # Detect the unknown variable CONTENTS_OUTPUT_LOCATION warning + if "$MAKEINFO" -c CONTENTS_OUTPUT_LOCATION=inline </dev/null 2>&1 \ + | grep CONTENTS_OUTPUT_LOCATION >/dev/null; then + gcc_cv_texi_add_toc_inline_flags=no + else + gcc_cv_texi_add_toc_inline_flags=yes + fi + +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $gcc_cv_texi_add_toc_inline_flags" >&5 +$as_echo "$gcc_cv_texi_add_toc_inline_flags" >&6; } + if test x"$gcc_cv_texi_add_toc_inline_flags" = xyes; then + MAKEINFO_TOC_INLINE_FLAG='-c CONTENTS_OUTPUT_LOCATION=inline' + fi + +fi + + # Is pod2man recent enough to regenerate manpages? { $as_echo "$as_me:${as_lineno-$LINENO}: checking for recent Pod::Man" >&5 $as_echo_n "checking for recent Pod::Man... " >&6; } @@ -19792,7 +19823,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<_LT_EOF -#line 19795 "configure" +#line 19826 "configure" #include "confdefs.h" #if HAVE_DLFCN_H @@ -19898,7 +19929,7 @@ else lt_dlunknown=0; lt_dlno_uscore=1; lt_dlneed_uscore=2 lt_status=$lt_dlunknown cat > conftest.$ac_ext <<_LT_EOF -#line 19901 "configure" +#line 19932 "configure" #include "confdefs.h" #if HAVE_DLFCN_H diff --git a/gcc/configure.ac b/gcc/configure.ac index 62bc908..120151c 100644 --- a/gcc/configure.ac +++ b/gcc/configure.ac @@ -1242,6 +1242,27 @@ else fi AC_SUBST(BUILD_INFO) +# Determine whether makeinfo supports the CONTENTS_OUTPUT_LOCATION variable. +# If it does, we want to pass it to makeinfo in order to restore the old +# behavior of @{summary,}contents placement. +MAKEINFO_TOC_INLINE_FLAG= +AS_IF([test x"$MAKEINFO" != x], [ + AC_CACHE_CHECK([for CONTENTS_OUTPUT_LOCATION support in $MAKEINFO], + [gcc_cv_texi_add_toc_inline_flags], [ + # Detect the unknown variable CONTENTS_OUTPUT_LOCATION warning + if "$MAKEINFO" -c CONTENTS_OUTPUT_LOCATION=inline </dev/null 2>&1 \ + | grep CONTENTS_OUTPUT_LOCATION >/dev/null; then + gcc_cv_texi_add_toc_inline_flags=no + else + gcc_cv_texi_add_toc_inline_flags=yes + fi + ]) + if test x"$gcc_cv_texi_add_toc_inline_flags" = xyes; then + MAKEINFO_TOC_INLINE_FLAG='-c CONTENTS_OUTPUT_LOCATION=inline' + fi +]) +AC_SUBST([MAKEINFO_TOC_INLINE_FLAG]) + # Is pod2man recent enough to regenerate manpages? AC_MSG_CHECKING([for recent Pod::Man]) if (perl -e 'use 1.10 Pod::Man') >/dev/null 2>&1; then diff --git a/maintainer-scripts/update_web_docs_git b/maintainer-scripts/update_web_docs_git index 084f09f..d44ab27 100755 --- a/maintainer-scripts/update_web_docs_git +++ b/maintainer-scripts/update_web_docs_git @@ -174,7 +174,7 @@ for file in $MANUALS; do elif [ "$file" = "gnat_ugn" ]; then includes="$includes -I gcc/gcc/ada -I gcc/gcc/ada/doc/gnat_ugn" fi - makeinfo --html --css-ref $CSS $includes -o ${file} ${filename} + makeinfo --html -c CONTENTS_OUTPUT_LOCATION=inline --css-ref $CSS $includes -o ${file} ${filename} tar cf ${file}-html.tar ${file}/*.html texi2dvi $includes -o ${file}.dvi ${filename} </dev/null >/dev/null && dvips -o ${file}.ps ${file}.dvi texi2pdf $includes -o ${file}.pdf ${filename} </dev/null |