From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mout-p-202.mailbox.org (mout-p-202.mailbox.org [IPv6:2001:67c:2050:0:465::202]) by sourceware.org (Postfix) with ESMTPS id 2F40E3858D1E for ; Sun, 12 Nov 2023 10:57:04 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 2F40E3858D1E Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=gdcproject.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gdcproject.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 2F40E3858D1E Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:67c:2050:0:465::202 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1699786627; cv=none; b=ju8bJ5n9w56emZGyJ4s4mRYhbwEODlxx72xopA4NzxHWdJX4IlqTVRIhlQiCMO/I5FAay80zSyORXqOgk6l67SQ1GW/98Jq/7hW/J1N6/LXIt5nfqq2UqVNdqa6vDdus6v9L9sBkHJn+CqapG0EzIPsgBQXWGMu0GA38WUJIzMg= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1699786627; c=relaxed/simple; bh=HR6Xo7zGGT8GOgGFjpyxO+SeslZt7UdaaC3FxUk5LAQ=; h=DKIM-Signature:Date:From:Subject:To:MIME-Version:Message-Id; b=hCc45I03SLaQBvmLzrcZGpjKyh2tzsNXYXr2lxHX7NrYPTHSCoAQZh+hVUiOuMFAZvy9saeYMlhwd814aOIzcSV5eyJRxO+mfylRFQt7lxKHHZTpSyOUzUJrFVbiYJJ1Hpi6W509oz01FxBCfPVxwZ6Xz8L/odV8TLLAXCmBIE0= ARC-Authentication-Results: i=1; server2.sourceware.org Received: from smtp202.mailbox.org (smtp202.mailbox.org [10.196.197.202]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by mout-p-202.mailbox.org (Postfix) with ESMTPS id 4SSqJG0bjpz9spq; Sun, 12 Nov 2023 11:57:02 +0100 (CET) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gdcproject.org; s=MBO0001; t=1699786622; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=f9AdEoScsz1hlpvdpdkYmvyt81pvNeMPB75ArRFOVzQ=; b=Jsvmmmji3ufO6FHsgmyq9AojMf5NNCiZHH0ZlrhykXYjNizQbsAB71NQ8+kBKvP2Dka7B2 EMUA9Xs3CcJ3XU2BypdwUrHS71O+r4P2L3iBA2DKJDYIpUIGfH915/rFOL1G8ZalUxqjv/ fCfaKBLvpkqp/eaEwYtKYsF06Z+T6rXwC/JISsyl1opZyh4t4Pz0D0Erv5UnduuQtnhdR2 JuI77/WJ0/+U+weAEDF3B8iFcO5iah4Hig+x5Wi+W5t57p1u9eTZtM+NK8eVQ3kEGRhEpH 9K2oXDLJXIKOWxAPxMilbYa/jUzHt/WEQJkAaRhjEeIyedtA4OHNpxFt8DiSpw== Date: Sun, 12 Nov 2023 11:56:58 +0100 From: Iain Buclaw Subject: Re: [PATCH 2/3] Add generated .opt.urls files To: David Malcolm , gcc-patches@gcc.gnu.org, Joseph Myers References: <20231110214246.3087291-1-dmalcolm@redhat.com> <20231110214246.3087291-3-dmalcolm@redhat.com> In-Reply-To: <20231110214246.3087291-3-dmalcolm@redhat.com> MIME-Version: 1.0 Message-Id: <1699786557.1kaz2qy7oc.astroid@pulse.none> Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Spam-Status: No, score=-13.2 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,GIT_PATCH_0,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,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: Excerpts from David Malcolm's message of November 10, 2023 10:42 pm: > gcc/d/ChangeLog: > * lang.opt.urls: New file, autogenerated by > regenerate-opt-urls.py. > --- > gcc/d/lang.opt.urls | 95 + > create mode 100644 gcc/d/lang.opt.urls >=20 [abridged view of patch] > diff --git a/gcc/d/lang.opt.urls b/gcc/d/lang.opt.urls > new file mode 100644 > index 000000000000..57c14ecc459a > --- /dev/null > +++ b/gcc/d/lang.opt.urls > @@ -0,0 +1,95 @@ > +; Autogenerated by regenerate-opt-urls.py from gcc/d/lang.opt and genera= ted HTML > + > +H > +UrlSuffix(gcc/Preprocessor-Options.html#index-H) > + > +I > +UrlSuffix(gcc/Directory-Options.html#index-I) > + > +M > +UrlSuffix(gcc/Preprocessor-Options.html#index-M) > + > +MD > +UrlSuffix(gcc/Preprocessor-Options.html#index-MD) > + > +MF > +UrlSuffix(gcc/Preprocessor-Options.html#index-MF) > + > +MG > +UrlSuffix(gcc/Preprocessor-Options.html#index-MG) > + > +MM > +UrlSuffix(gcc/Preprocessor-Options.html#index-MM) > + > +MMD > +UrlSuffix(gcc/Preprocessor-Options.html#index-MMD) > + > +MP > +UrlSuffix(gcc/Preprocessor-Options.html#index-MP) > + > +MT > +UrlSuffix(gcc/Preprocessor-Options.html#index-MT) > + > +MQ > +UrlSuffix(gcc/Preprocessor-Options.html#index-MQ) > + > +Waddress > +UrlSuffix(gcc/Warning-Options.html#index-Waddress) > + > +; skipping 'Wall' due to multiple URLs: > +; duplicate: 'gcc/Standard-Libraries.html#index-Wall-1' > +; duplicate: 'gcc/Warning-Options.html#index-Wall' > + > +Walloca > +UrlSuffix(gcc/Warning-Options.html#index-Walloca) > + > +Walloca-larger-than=3D > +UrlSuffix(gcc/Warning-Options.html#index-Walloca-larger-than_003d) > + > +Wbuiltin-declaration-mismatch > +UrlSuffix(gcc/Warning-Options.html#index-Wbuiltin-declaration-mismatch) > + > +Wdeprecated > +UrlSuffix(gcc/Warning-Options.html#index-Wdeprecated) > + > +Werror > +UrlSuffix(gcc/Warning-Options.html#index-Werror) > + > +Wextra > +UrlSuffix(gcc/Warning-Options.html#index-Wextra) > + > +Wunknown-pragmas > +UrlSuffix(gcc/Warning-Options.html#index-Wno-unknown-pragmas) > + > +Wvarargs > +UrlSuffix(gcc/Warning-Options.html#index-Wno-varargs) > + > +; skipping 'fbuiltin' due to multiple URLs: > +; duplicate: 'gcc/C-Dialect-Options.html#index-fbuiltin' > +; duplicate: 'gcc/Other-Builtins.html#index-fno-builtin-3' > +; duplicate: 'gcc/Warning-Options.html#index-fno-builtin-1' > + > +fexceptions > +UrlSuffix(gcc/Code-Gen-Options.html#index-fexceptions) > + > +frtti > +UrlSuffix(gcc/C_002b_002b-Dialect-Options.html#index-fno-rtti) > + > +imultilib > +UrlSuffix(gcc/Directory-Options.html#index-imultilib) > + > +iprefix > +UrlSuffix(gcc/Directory-Options.html#index-iprefix) > + > +isysroot > +UrlSuffix(gcc/Directory-Options.html#index-isysroot) > + > +isystem > +UrlSuffix(gcc/Directory-Options.html#index-isystem) > + > +nostdinc > +UrlSuffix(gcc/Directory-Options.html#index-nostdinc) > + > +v > +UrlSuffix(gcc/Overall-Options.html#index-v) > + > --=20 > 2.26.3 >=20 >=20 So I see this focuses on only adding URLs for common options, or options that relate to C/C++ family, but may be handled by other front-ends too? To pick out one, you have: frtti UrlSuffix(gcc/C_002b_002b-Dialect-Options.html#index-fno-rtti) It looks like it could could alternatively be frtti UrlSuffix(gdc/Runtime-Options.html#index-frtti) Or are other front-ends having URLs to their language-specific documentation pages not supported for the same reason as why they can't add self-documentation to their own options if another front-end (typically C/C++) also makes claim to the option? frtti D=20 ; Documented in C I'm OK with the D parts regardless of this observation. Thanks, Iain.