On Sun, 13 Nov 2022, 09:11 Saifi Khan, <saifi.khan@xxxxxxxxx> wrote:
> 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'.
>
You can replace the * with the correct path, which is the
x86_64-pc-linux-gnu one for your case.
> 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'.
>
There is a doc-install-html target in the $target/libstdc++-v3 dir, but
that will also try to build the main manual as well as the doxygen pages.
> Is that how the online gcc docs are getting updated ?
>
A script that copies them to the web server directory after building them.
They are not "installed" by the makefile.
> warm regards
> Saifi.
>
