Re: top-level build target that triggers 'make doc-html-doxygen'

[Jonathan Wakely <jwakely.gcc@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 2698 bytes --]

On Sun, 13 Nov 2022, 09:11 Saifi Khan, <saifi.khan@nishan.io> 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@nishan.io> 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.
>