How to build the GCC HTML documentation from source into a single page?












3















I had asked a similar thing for GDB at: How to build the GDB documentation from source? , and it changed my life, now I want the same for GCC!



I managed to build the docs on Ubuntu 16.04 and gcc 6.4.0 source tree (to match my host) with:



./contrib/download_prerequisites
./configure
make
host-x86_64-pc-linux-gnu/gcc
make html
xdg-open HTML/gcc-6.4.0/gcc/index.html


But I could not make it put everything into a single page, I tried:



make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'


but it does not work as for binutils.



If I don't build GCC itself first, and do just make html directly, it fails with:



checking for x86_64-pc-linux-gnu-gcc... /data/git/gcc/host-x86_64-pc-linux-gnu/gcc/xgcc -B/data/git/gcc/host-x86_64-pc-linux-gnu/gcc/ -B/usr/local/x86_64-pc-linux-gnu/bin/ -B/usr/local/x86_64-pc-linux-gnu/lib/ -isystem /usr/local/x86_64-pc-linux-gnu/include -isystem /usr/
local/x86_64-pc-linux-gnu/sys-include
checking for C compiler default output file name...
configure: error: in `/data/git/gcc/x86_64-pc-linux-gnu/libgomp':
configure: error: C compiler cannot create executables
See `config.log' for more details.
Makefile:24442: recipe for target 'configure-target-libgomp' failed
make[1]: *** [configure-target-libgomp] Error 1
make[1]: Leaving directory '/data/git/gcc'
Makefile:1268: recipe for target 'do-html' failed
make: *** [do-html] Error 2


The problem is that the file:



host-x86_64-pc-linux-gnu/gcc/xgcc


does not exist, I wonder why it is needed since all I want is to build the docs.



I would like to obtain the docs available at: https://gcc.gnu.org/onlinedocs/gcc-6.4.0/gcc/ and hopefully other manuals listed at https://gcc.gnu.org/onlinedocs/ such as CPP manual, each of them as a single HTML page that I can Ctrl + F easily on.










share|improve this question





























    3















    I had asked a similar thing for GDB at: How to build the GDB documentation from source? , and it changed my life, now I want the same for GCC!



    I managed to build the docs on Ubuntu 16.04 and gcc 6.4.0 source tree (to match my host) with:



    ./contrib/download_prerequisites
    ./configure
    make
    host-x86_64-pc-linux-gnu/gcc
    make html
    xdg-open HTML/gcc-6.4.0/gcc/index.html


    But I could not make it put everything into a single page, I tried:



    make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'


    but it does not work as for binutils.



    If I don't build GCC itself first, and do just make html directly, it fails with:



    checking for x86_64-pc-linux-gnu-gcc... /data/git/gcc/host-x86_64-pc-linux-gnu/gcc/xgcc -B/data/git/gcc/host-x86_64-pc-linux-gnu/gcc/ -B/usr/local/x86_64-pc-linux-gnu/bin/ -B/usr/local/x86_64-pc-linux-gnu/lib/ -isystem /usr/local/x86_64-pc-linux-gnu/include -isystem /usr/
    local/x86_64-pc-linux-gnu/sys-include
    checking for C compiler default output file name...
    configure: error: in `/data/git/gcc/x86_64-pc-linux-gnu/libgomp':
    configure: error: C compiler cannot create executables
    See `config.log' for more details.
    Makefile:24442: recipe for target 'configure-target-libgomp' failed
    make[1]: *** [configure-target-libgomp] Error 1
    make[1]: Leaving directory '/data/git/gcc'
    Makefile:1268: recipe for target 'do-html' failed
    make: *** [do-html] Error 2


    The problem is that the file:



    host-x86_64-pc-linux-gnu/gcc/xgcc


    does not exist, I wonder why it is needed since all I want is to build the docs.



    I would like to obtain the docs available at: https://gcc.gnu.org/onlinedocs/gcc-6.4.0/gcc/ and hopefully other manuals listed at https://gcc.gnu.org/onlinedocs/ such as CPP manual, each of them as a single HTML page that I can Ctrl + F easily on.










    share|improve this question



























      3












      3








      3








      I had asked a similar thing for GDB at: How to build the GDB documentation from source? , and it changed my life, now I want the same for GCC!



      I managed to build the docs on Ubuntu 16.04 and gcc 6.4.0 source tree (to match my host) with:



      ./contrib/download_prerequisites
      ./configure
      make
      host-x86_64-pc-linux-gnu/gcc
      make html
      xdg-open HTML/gcc-6.4.0/gcc/index.html


      But I could not make it put everything into a single page, I tried:



      make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'


      but it does not work as for binutils.



      If I don't build GCC itself first, and do just make html directly, it fails with:



      checking for x86_64-pc-linux-gnu-gcc... /data/git/gcc/host-x86_64-pc-linux-gnu/gcc/xgcc -B/data/git/gcc/host-x86_64-pc-linux-gnu/gcc/ -B/usr/local/x86_64-pc-linux-gnu/bin/ -B/usr/local/x86_64-pc-linux-gnu/lib/ -isystem /usr/local/x86_64-pc-linux-gnu/include -isystem /usr/
      local/x86_64-pc-linux-gnu/sys-include
      checking for C compiler default output file name...
      configure: error: in `/data/git/gcc/x86_64-pc-linux-gnu/libgomp':
      configure: error: C compiler cannot create executables
      See `config.log' for more details.
      Makefile:24442: recipe for target 'configure-target-libgomp' failed
      make[1]: *** [configure-target-libgomp] Error 1
      make[1]: Leaving directory '/data/git/gcc'
      Makefile:1268: recipe for target 'do-html' failed
      make: *** [do-html] Error 2


      The problem is that the file:



      host-x86_64-pc-linux-gnu/gcc/xgcc


      does not exist, I wonder why it is needed since all I want is to build the docs.



      I would like to obtain the docs available at: https://gcc.gnu.org/onlinedocs/gcc-6.4.0/gcc/ and hopefully other manuals listed at https://gcc.gnu.org/onlinedocs/ such as CPP manual, each of them as a single HTML page that I can Ctrl + F easily on.










      share|improve this question
















      I had asked a similar thing for GDB at: How to build the GDB documentation from source? , and it changed my life, now I want the same for GCC!



      I managed to build the docs on Ubuntu 16.04 and gcc 6.4.0 source tree (to match my host) with:



      ./contrib/download_prerequisites
      ./configure
      make
      host-x86_64-pc-linux-gnu/gcc
      make html
      xdg-open HTML/gcc-6.4.0/gcc/index.html


      But I could not make it put everything into a single page, I tried:



      make html MAKEINFO=makeinfo MAKEINFOFLAGS='--no-split'


      but it does not work as for binutils.



      If I don't build GCC itself first, and do just make html directly, it fails with:



      checking for x86_64-pc-linux-gnu-gcc... /data/git/gcc/host-x86_64-pc-linux-gnu/gcc/xgcc -B/data/git/gcc/host-x86_64-pc-linux-gnu/gcc/ -B/usr/local/x86_64-pc-linux-gnu/bin/ -B/usr/local/x86_64-pc-linux-gnu/lib/ -isystem /usr/local/x86_64-pc-linux-gnu/include -isystem /usr/
      local/x86_64-pc-linux-gnu/sys-include
      checking for C compiler default output file name...
      configure: error: in `/data/git/gcc/x86_64-pc-linux-gnu/libgomp':
      configure: error: C compiler cannot create executables
      See `config.log' for more details.
      Makefile:24442: recipe for target 'configure-target-libgomp' failed
      make[1]: *** [configure-target-libgomp] Error 1
      make[1]: Leaving directory '/data/git/gcc'
      Makefile:1268: recipe for target 'do-html' failed
      make: *** [do-html] Error 2


      The problem is that the file:



      host-x86_64-pc-linux-gnu/gcc/xgcc


      does not exist, I wonder why it is needed since all I want is to build the docs.



      I would like to obtain the docs available at: https://gcc.gnu.org/onlinedocs/gcc-6.4.0/gcc/ and hopefully other manuals listed at https://gcc.gnu.org/onlinedocs/ such as CPP manual, each of them as a single HTML page that I can Ctrl + F easily on.







      gcc






      share|improve this question















      share|improve this question













      share|improve this question




      share|improve this question








      edited Jan 7 at 15:55







      Ciro Santilli 新疆改造中心 六四事件 法轮功

















      asked Jan 7 at 14:54









      Ciro Santilli 新疆改造中心 六四事件 法轮功Ciro Santilli 新疆改造中心 六四事件 法轮功

      4,98124041




      4,98124041






















          1 Answer
          1






          active

          oldest

          votes


















          1














          this worked for me:



          cd /path/to/gcc-8.2.0/gcc
          ./configure
          make gcc-vers.texi
          mkdir HTML
          makeinfo --html --no-split -Idoc -Idoc/include -o HTML doc/gcc.texi


          Same for gccint.html, cpp.html, etc. gcc's makefiles ignore the MAKEINFOFLAGS variable.






          share|improve this answer


























          • Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

            – Ciro Santilli 新疆改造中心 六四事件 法轮功
            Jan 8 at 11:45








          • 1





            It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

            – mosvy
            Jan 8 at 17:50











          Your Answer








          StackExchange.ready(function() {
          var channelOptions = {
          tags: "".split(" "),
          id: "106"
          };
          initTagRenderer("".split(" "), "".split(" "), channelOptions);

          StackExchange.using("externalEditor", function() {
          // Have to fire editor after snippets, if snippets enabled
          if (StackExchange.settings.snippets.snippetsEnabled) {
          StackExchange.using("snippets", function() {
          createEditor();
          });
          }
          else {
          createEditor();
          }
          });

          function createEditor() {
          StackExchange.prepareEditor({
          heartbeatType: 'answer',
          autoActivateHeartbeat: false,
          convertImagesToLinks: false,
          noModals: true,
          showLowRepImageUploadWarning: true,
          reputationToPostImages: null,
          bindNavPrevention: true,
          postfix: "",
          imageUploader: {
          brandingHtml: "Powered by u003ca class="icon-imgur-white" href="https://imgur.com/"u003eu003c/au003e",
          contentPolicyHtml: "User contributions licensed under u003ca href="https://creativecommons.org/licenses/by-sa/3.0/"u003ecc by-sa 3.0 with attribution requiredu003c/au003e u003ca href="https://stackoverflow.com/legal/content-policy"u003e(content policy)u003c/au003e",
          allowUrls: true
          },
          onDemand: true,
          discardSelector: ".discard-answer"
          ,immediatelyShowMarkdownHelp:true
          });


          }
          });














          draft saved

          draft discarded


















          StackExchange.ready(
          function () {
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2funix.stackexchange.com%2fquestions%2f493013%2fhow-to-build-the-gcc-html-documentation-from-source-into-a-single-page%23new-answer', 'question_page');
          }
          );

          Post as a guest















          Required, but never shown

























          1 Answer
          1






          active

          oldest

          votes








          1 Answer
          1






          active

          oldest

          votes









          active

          oldest

          votes






          active

          oldest

          votes









          1














          this worked for me:



          cd /path/to/gcc-8.2.0/gcc
          ./configure
          make gcc-vers.texi
          mkdir HTML
          makeinfo --html --no-split -Idoc -Idoc/include -o HTML doc/gcc.texi


          Same for gccint.html, cpp.html, etc. gcc's makefiles ignore the MAKEINFOFLAGS variable.






          share|improve this answer


























          • Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

            – Ciro Santilli 新疆改造中心 六四事件 法轮功
            Jan 8 at 11:45








          • 1





            It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

            – mosvy
            Jan 8 at 17:50
















          1














          this worked for me:



          cd /path/to/gcc-8.2.0/gcc
          ./configure
          make gcc-vers.texi
          mkdir HTML
          makeinfo --html --no-split -Idoc -Idoc/include -o HTML doc/gcc.texi


          Same for gccint.html, cpp.html, etc. gcc's makefiles ignore the MAKEINFOFLAGS variable.






          share|improve this answer


























          • Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

            – Ciro Santilli 新疆改造中心 六四事件 法轮功
            Jan 8 at 11:45








          • 1





            It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

            – mosvy
            Jan 8 at 17:50














          1












          1








          1







          this worked for me:



          cd /path/to/gcc-8.2.0/gcc
          ./configure
          make gcc-vers.texi
          mkdir HTML
          makeinfo --html --no-split -Idoc -Idoc/include -o HTML doc/gcc.texi


          Same for gccint.html, cpp.html, etc. gcc's makefiles ignore the MAKEINFOFLAGS variable.






          share|improve this answer















          this worked for me:



          cd /path/to/gcc-8.2.0/gcc
          ./configure
          make gcc-vers.texi
          mkdir HTML
          makeinfo --html --no-split -Idoc -Idoc/include -o HTML doc/gcc.texi


          Same for gccint.html, cpp.html, etc. gcc's makefiles ignore the MAKEINFOFLAGS variable.







          share|improve this answer














          share|improve this answer



          share|improve this answer








          edited Jan 7 at 18:22

























          answered Jan 7 at 18:02









          mosvymosvy

          6,2711425




          6,2711425













          • Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

            – Ciro Santilli 新疆改造中心 六四事件 法轮功
            Jan 8 at 11:45








          • 1





            It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

            – mosvy
            Jan 8 at 17:50



















          • Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

            – Ciro Santilli 新疆改造中心 六四事件 法轮功
            Jan 8 at 11:45








          • 1





            It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

            – mosvy
            Jan 8 at 17:50

















          Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

          – Ciro Santilli 新疆改造中心 六四事件 法轮功
          Jan 8 at 11:45







          Thanks, this worked for gcc. I couldn't get it to work for libstdc++-v3 though, but it is already a big progress.

          – Ciro Santilli 新疆改造中心 六四事件 法轮功
          Jan 8 at 11:45






          1




          1





          It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

          – mosvy
          Jan 8 at 17:50





          It seems that libstdc++ docs aren't built from Texinfo at all, but from DocBook via XSLT which is a completely different problem. (probably installing docbook-utils and then using docbook2html -u should do it, but I haven't tried it).

          – mosvy
          Jan 8 at 17:50


















          draft saved

          draft discarded




















































          Thanks for contributing an answer to Unix & Linux Stack Exchange!


          • Please be sure to answer the question. Provide details and share your research!

          But avoid



          • Asking for help, clarification, or responding to other answers.

          • Making statements based on opinion; back them up with references or personal experience.


          To learn more, see our tips on writing great answers.




          draft saved


          draft discarded














          StackExchange.ready(
          function () {
          StackExchange.openid.initPostLogin('.new-post-login', 'https%3a%2f%2funix.stackexchange.com%2fquestions%2f493013%2fhow-to-build-the-gcc-html-documentation-from-source-into-a-single-page%23new-answer', 'question_page');
          }
          );

          Post as a guest















          Required, but never shown





















































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown

































          Required, but never shown














          Required, but never shown












          Required, but never shown







          Required, but never shown







          Popular posts from this blog

          List directoties down one level, excluding some named directories and files

          list processes belonging to a network namespace

          list systemd RuntimeDirectory mounts