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

[Saifi Khan <saifi.khan@nishan.io>]

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'.

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.