From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa2.mentor.iphmx.com (esa2.mentor.iphmx.com [68.232.141.98]) by sourceware.org (Postfix) with ESMTPS id 8A8BD385803B for ; Wed, 20 Dec 2023 00:24:11 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8A8BD385803B Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 8A8BD385803B Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=68.232.141.98 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1703031853; cv=none; b=qMwtE1SzCfwaGrZ82wcUzFUfgpY8pEgkc2pgPQVlp0/KDHB81RGAbzD/a7VC+x6WRcrQpUG8LoGmWTjJfNBxa3sk1lxDsxDyeccBWok4fLzRvTD+tMDNegMkr/ITSct51G8mgMq9sXuQ01Eym/3+HlijbKDG35Wj72fFzaD5EH0= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1703031853; c=relaxed/simple; bh=rOnYCOHfSs9IP2idv3PtjXKWGWuh33VYxzp0Uaka7iQ=; h=Date:From:To:Subject:Message-ID:MIME-Version; b=DwzCfNOpG4U/UbFfc/+qhOt472ZI4mZzy8rv9GttJgOsOZy37O8FvoDlKu/ppij7xPu0msC0OzMV6PVxwM1JO5eha+XrJ3cDyqWqAdp9Y4jUwT1akfKqYwKOAqMf1msV3YQLl/cE8TgBi2MLhBN+7rmwLhlJpOwwf44uSQtBtdA= ARC-Authentication-Results: i=1; server2.sourceware.org X-CSE-ConnectionGUID: kvOwlMcBQ16Dnf01oRLPow== X-CSE-MsgGUID: YGEnXWVaQl+LBGo5l237VQ== X-IronPort-AV: E=Sophos;i="6.04,289,1695715200"; d="scan'208";a="28821255" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa2.mentor.iphmx.com with ESMTP; 19 Dec 2023 16:24:09 -0800 IronPort-SDR: 5nuglznYr8f7CwraoU8jI68kOPzEpYMUkKiNocVZrzKPkHbYXMvDu69rjJXHj8wJAFSoZkw8ed BP2fc+eYbzfh32T25P5CpfpJSEjS/D763ZrsOaxcmDNPzCnvQ0H47RDYGNTeGt9hJzs6C/WIMl LWG30/92FS+y+erv+A1ilYrjl1grZTv0e0Vx5K/jd4qDZRfRviu01YIgcd0cIwdTmkaVXQCC+y X1of0WfTKIEyDr+fndACWuzEHyyy5RS1oFliyFfP2QLQNxx4WKEK6Gb96FyCxTs1OVjYhBh0DA /Gk= Date: Wed, 20 Dec 2023 00:24:05 +0000 From: Joseph Myers To: David Malcolm CC: Mark Wielaard , Tobias Burnus , gcc-patches Subject: Re: [PATCH 1/4; v3] options: add gcc/regenerate-opt-urls.py In-Reply-To: <20231214150143.3305661-2-dmalcolm@redhat.com> Message-ID: References: <20231210233506.GC14917@gnu.wildebeest.org> <20231214150143.3305661-1-dmalcolm@redhat.com> <20231214150143.3305661-2-dmalcolm@redhat.com> MIME-Version: 1.0 Content-Type: text/plain; charset="US-ASCII" X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: svr-ies-mbx-14.mgc.mentorg.com (139.181.222.14) To svr-ies-mbx-10.mgc.mentorg.com (139.181.222.10) X-Spam-Status: No, score=-3108.6 required=5.0 tests=BAYES_00,GIT_PATCH_0,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,SPF_HELO_PASS,SPF_PASS,TXREP,T_SCC_BODY_TEXT_LINE 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: On Thu, 14 Dec 2023, David Malcolm wrote: > diff --git a/gcc/doc/sourcebuild.texi b/gcc/doc/sourcebuild.texi > index 26a7e9c35070..9a394b3e2c77 100644 > --- a/gcc/doc/sourcebuild.texi > +++ b/gcc/doc/sourcebuild.texi > @@ -813,6 +813,10 @@ options supported by this target (@pxref{Run-time Target, , Run-time > Target Specification}). This means both entries in the summary table > of options and details of the individual options. > @item > +An entry in @file{gcc/regenerate-opt-urls.py}'s TARGET_SPECIFIC_PAGES > +dictionary mapping from target-specific HTML documentation pages > +to the target specific source directory. There should probably also be something under Front End to indicate when anything needs to be done (based on a front end having its own option index? one with options also present in other manuals?), outside the front end's own directory, for that front end's option URLs. > + def add_entry(self, matched_text, url_suffix, language, verbose=False): > + # TODO: use language This TODO seems out of date. > + #print(f'{url_suffix=} {index_text=}') Various commented-out or "if 0" debugging code like this should probably be removed (or made into an actual runtime conditional if desired). -- Joseph S. Myers joseph@codesourcery.com