How to build the GCC HTML documentation from source into a single page?
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
add a comment |
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
add a comment |
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
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
gcc
edited Jan 7 at 15:55
Ciro Santilli 新疆改造中心 六四事件 法轮功
asked Jan 7 at 14:54
Ciro Santilli 新疆改造中心 六四事件 法轮功Ciro Santilli 新疆改造中心 六四事件 法轮功
4,98124041
4,98124041
add a comment |
add a comment |
1 Answer
1
active
oldest
votes
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.
Thanks, this worked forgcc. I couldn't get it to work forlibstdc++-v3though, but it is already a big progress.
– Ciro Santilli 新疆改造中心 六四事件 法轮功
Jan 8 at 11:45
1
It seems thatlibstdc++docs aren't built from Texinfo at all, but from DocBook viaXSLTwhich is a completely different problem. (probably installingdocbook-utilsand then usingdocbook2html -ushould do it, but I haven't tried it).
– mosvy
Jan 8 at 17:50
add a comment |
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
});
}
});
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
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
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.
Thanks, this worked forgcc. I couldn't get it to work forlibstdc++-v3though, but it is already a big progress.
– Ciro Santilli 新疆改造中心 六四事件 法轮功
Jan 8 at 11:45
1
It seems thatlibstdc++docs aren't built from Texinfo at all, but from DocBook viaXSLTwhich is a completely different problem. (probably installingdocbook-utilsand then usingdocbook2html -ushould do it, but I haven't tried it).
– mosvy
Jan 8 at 17:50
add a comment |
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.
Thanks, this worked forgcc. I couldn't get it to work forlibstdc++-v3though, but it is already a big progress.
– Ciro Santilli 新疆改造中心 六四事件 法轮功
Jan 8 at 11:45
1
It seems thatlibstdc++docs aren't built from Texinfo at all, but from DocBook viaXSLTwhich is a completely different problem. (probably installingdocbook-utilsand then usingdocbook2html -ushould do it, but I haven't tried it).
– mosvy
Jan 8 at 17:50
add a comment |
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.
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.
edited Jan 7 at 18:22
answered Jan 7 at 18:02
mosvymosvy
6,2711425
6,2711425
Thanks, this worked forgcc. I couldn't get it to work forlibstdc++-v3though, but it is already a big progress.
– Ciro Santilli 新疆改造中心 六四事件 法轮功
Jan 8 at 11:45
1
It seems thatlibstdc++docs aren't built from Texinfo at all, but from DocBook viaXSLTwhich is a completely different problem. (probably installingdocbook-utilsand then usingdocbook2html -ushould do it, but I haven't tried it).
– mosvy
Jan 8 at 17:50
add a comment |
Thanks, this worked forgcc. I couldn't get it to work forlibstdc++-v3though, but it is already a big progress.
– Ciro Santilli 新疆改造中心 六四事件 法轮功
Jan 8 at 11:45
1
It seems thatlibstdc++docs aren't built from Texinfo at all, but from DocBook viaXSLTwhich is a completely different problem. (probably installingdocbook-utilsand then usingdocbook2html -ushould 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
add a comment |
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.
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
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
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Post as a guest
Required, but never shown
Sign up or log in
StackExchange.ready(function () {
StackExchange.helpers.onClickDraftSave('#login-link');
});
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
Sign up using Google
Sign up using Facebook
Sign up using Email and Password
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