On 2022-11-13 08:29, Jonathan Wakely via Gcc-help wrote:
On Sun, 13 Nov 2022 at 07:29, Saifi Khan <saifi.khan@xxxxxxxxx> wrote:
Does anyone know what is the top-level Makefile build target that
triggers 'make doc-html-doxygen' in libstdc++ ?
make -C */libstdc++-v3 doc-html-doxygen will work
Thanks for your reply Jonathan.
Since, i am doing a 'out-of-source-tree' build, the layout looks like
this
/opt/gcc
├── build
└── src
Given the layout, the build/b02.sh (configure script) is as follows
DIR_SRC=/opt/gcc/src
DIR_DST=/opt/gcc
DIR_ISL=/opt/isl
CFLAGS="-O2 -pipe"
CXXFLAGS="${CFLAGS}"
${DIR_SRC}/configure \
--prefix=${DIR_DST} \
--exec-prefix=${DIR_DST} \
--datarootdir=${DIR_DST}/doc/share \
--datadir=${DIR_DST}/doc \
--docdir=${DIR_DST}/doc \
--htmldir=${DIR_DST}/doc \
--mandir=${DIR_DST}/doc/man \
--infodir=${DIR_DST}/doc/info \
--with-isl=${DIR_ISL} \
--enable-languages=c,jit,c++ \
--enable-bootstrap \
<snipped>
Post build/b04.sh ie. 'make -j4', there is one directory created for
libstdc++
build/x86_64-pc-linux-gnu/libstdc++-v3
Now, if i execute the command that you suggested, the doxygen html build
goes through (which is what i was did prior to posting on gcc-help).
Unfortunately, on executing build/b08.sh script file ie. 'make install'
errors out !
That leaves only one option and that first perform 'make install' and
then 'make -C */libstdc++-v3 doc-html-doxygen'.
Does that seem like a sensible thing to do ?
In addition, i observed that the html documentation for the various lib*
also doesn't get copied as part of 'make install', wich means that a
custom script will be required to recursively copy the 'html'
directories from all 'lib*' including 'libstdc++-v3'.
Is that how the online gcc docs are getting updated ?
warm regards
Saifi.
