From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mail-ej1-x62c.google.com (mail-ej1-x62c.google.com [IPv6:2a00:1450:4864:20::62c]) by sourceware.org (Postfix) with ESMTPS id 50FA8385842E for ; Sun, 13 Nov 2022 09:30:06 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 50FA8385842E Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gmail.com Received: by mail-ej1-x62c.google.com with SMTP id k2so21806398ejr.2 for ; Sun, 13 Nov 2022 01:30:06 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:from:to:cc:subject:date:message-id:reply-to; bh=QapIzgzToJyuPoxBh99a5cT0zmcOYCoynBjK2njEt90=; b=VZJrozcq3JtEYLlokOObFE8GFHR0Ov/emBOxUKsbN53M77JDBEkdh8A6xyu5CsEaPt GcOdjE8Gyk+e2JPoHyc/F3DjOE+FU9CJfud3A/2YC4+DfTi23+7QO4PWT6zo2jsjNap7 UBqWKxh8YthvDffUhX69AMpgv6qjLq7dYLBg2jDb7FrePmjxtduoKV/BThui2sDUrn6j l8oOLAYBhqmB4PMeCuKqNg7KYpNm5dKtTPRkVwbBEwU236Z2c+wdU/APahePc+z7mM4i x7auXcjVXS/EK6+MQbbItZjtCBSJdwzEeM96GEoMooHWU6zU52suFCWQKeEhxtzjV3by 4/PA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20210112; h=cc:to:subject:message-id:date:from:in-reply-to:references :mime-version:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=QapIzgzToJyuPoxBh99a5cT0zmcOYCoynBjK2njEt90=; b=DEqGEiXrWVHbY5fC6Im4Qy8B/GrKqRxUPqsKKOW8pCz9Tnuj+lEH8PBZuRxoQItuOw yTeX79waitZYjG2EQ/PVFEHeS9oy6GDEoUD53CMOU0XJYGVlReTebwDRsofexks1Grli Peb39M9PhWfHL5YNdoAxgVFY06upMJO99U88q5mbSxpM/HJC8kcRRw3l0dTbdg5Q5X+Y wzIwiCQfFuQiU4uli/sYXP97lySEqjqVCvN1VTo6tCi8VGyywy3nfTvf9Xwa9JTLS6+i CGWOIE1wvKtHchyqnsklSWYZDcnfPI4N0/9mcM/BBWV2FXkT4cJYRx/ApPZoWagj1Qc6 513g== X-Gm-Message-State: ANoB5pn1r6OAkbQTAZf9HigNDiMnU6JYb+tqhozvnV0SOmGXLr/hNC2C DrucfHG8LDI78LMyM16HqZpUA+O2ARb44K7HlRI= X-Google-Smtp-Source: AA0mqf4U2xgLyzRUAJtA+xEzQHtCCXcvPTyG0SDEavKFx905t2fWKfAAMmiVkct71PMfbq7HKGfdjCNn2wt/s2Er/QU= X-Received: by 2002:a17:906:1597:b0:7ad:ba48:7e7f with SMTP id k23-20020a170906159700b007adba487e7fmr7030894ejd.215.1668331804498; Sun, 13 Nov 2022 01:30:04 -0800 (PST) MIME-Version: 1.0 References: <0c19c7b6ff9e933532c5ed5630d2527a@nishan.io> In-Reply-To: <0c19c7b6ff9e933532c5ed5630d2527a@nishan.io> From: Jonathan Wakely Date: Sun, 13 Nov 2022 09:29:51 +0000 Message-ID: Subject: Re: top-level build target that triggers 'make doc-html-doxygen' To: saifi.khan@nishan.io Cc: gcc-help Content-Type: multipart/alternative; boundary="000000000000931fbe05ed56c44c" X-Spam-Status: No, score=0.7 required=5.0 tests=BAYES_00,BODY_8BITS,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,FREEMAIL_FROM,HTML_MESSAGE,RCVD_IN_DNSWL_NONE,SPF_HELO_NONE,SPF_PASS,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --000000000000931fbe05ed56c44c Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable On Sun, 13 Nov 2022, 09:11 Saifi Khan, wrote: > On 2022-11-13 08:29, Jonathan Wakely via Gcc-help wrote: > > On Sun, 13 Nov 2022 at 07:29, Saifi Khan 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 > =E2=94=9C=E2=94=80=E2=94=80 build > =E2=94=94=E2=94=80=E2=94=80 src > > Given the layout, the build/b02.sh (configure script) is as follows > > DIR_SRC=3D/opt/gcc/src > DIR_DST=3D/opt/gcc > DIR_ISL=3D/opt/isl > CFLAGS=3D"-O2 -pipe" > CXXFLAGS=3D"${CFLAGS}" > > ${DIR_SRC}/configure \ > --prefix=3D${DIR_DST} \ > --exec-prefix=3D${DIR_DST} \ > --datarootdir=3D${DIR_DST}/doc/share \ > --datadir=3D${DIR_DST}/doc \ > --docdir=3D${DIR_DST}/doc \ > --htmldir=3D${DIR_DST}/doc \ > --mandir=3D${DIR_DST}/doc/man \ > --infodir=3D${DIR_DST}/doc/info \ > --with-isl=3D${DIR_ISL} \ > --enable-languages=3Dc,jit,c++ \ > --enable-bootstrap \ > > > 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. > --000000000000931fbe05ed56c44c--