From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from simark.ca by simark.ca with LMTP id h80uN5A2xGMFphcAWB0awg (envelope-from ) for ; Sun, 15 Jan 2023 12:23:28 -0500 Received: by simark.ca (Postfix, from userid 112) id D6C8C1E128; Sun, 15 Jan 2023 12:23:28 -0500 (EST) Authentication-Results: simark.ca; dkim=pass (1024-bit key; secure) header.d=sourceware.org header.i=@sourceware.org header.a=rsa-sha256 header.s=default header.b=KjF3CtjJ; dkim-atps=neutral X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on simark.ca X-Spam-Level: X-Spam-Status: No, score=-6.3 required=5.0 tests=BAYES_00,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,MAILING_LIST_MULTI,NICE_REPLY_A, RCVD_IN_DNSWL_MED,URIBL_BLOCKED autolearn=ham autolearn_force=no version=3.4.6 Received: from sourceware.org (server2.sourceware.org [8.43.85.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256) (No client certificate requested) by simark.ca (Postfix) with ESMTPS id 85DFB1E0D3 for ; Sun, 15 Jan 2023 12:23:28 -0500 (EST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 761D43858C53 for ; Sun, 15 Jan 2023 17:23:25 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 761D43858C53 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=sourceware.org; s=default; t=1673803405; bh=gAYa2pwlvHIdlBC+n9VX9Rq29TtWsF3rvHNVLLiO9k4=; h=Date:Subject:To:CC:References:In-Reply-To:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From:Reply-To:From; b=KjF3CtjJC2fDeBYQd0fFep9M24ddTf0wamQka9zBlA3xqJw6QqCMP/sjdVR455R1c 9uP/etV+ojLiUqL8GfQfjSwdrWxMh6iHvNOy4Bf/CTTtqMygkFoAZUTtmbDJc8v8AP CQMFg8mGgc3eq/p5cRc0weAxF0/oT532KaTdTV6g= Received: from mx07-00178001.pphosted.com (mx08-00178001.pphosted.com [91.207.212.93]) by sourceware.org (Postfix) with ESMTPS id 5DF1A3858D32 for ; Sun, 15 Jan 2023 17:23:04 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 5DF1A3858D32 Received: from pps.filterd (m0046660.ppops.net [127.0.0.1]) by mx07-00178001.pphosted.com (8.17.1.19/8.17.1.19) with ESMTP id 30F4Xs0I003635; Sun, 15 Jan 2023 18:22:57 +0100 Received: from beta.dmz-eu.st.com (beta.dmz-eu.st.com [164.129.1.35]) by mx07-00178001.pphosted.com (PPS) with ESMTPS id 3n3jdewrcf-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NOT); Sun, 15 Jan 2023 18:22:57 +0100 Received: from euls16034.sgp.st.com (euls16034.sgp.st.com [10.75.44.20]) by beta.dmz-eu.st.com (STMicroelectronics) with ESMTP id BDEA710002A; Sun, 15 Jan 2023 18:22:55 +0100 (CET) Received: from Webmail-eu.st.com (shfdag1node3.st.com [10.75.129.71]) by euls16034.sgp.st.com (STMicroelectronics) with ESMTP id 9FCA621ADC3; Sun, 15 Jan 2023 18:22:55 +0100 (CET) Received: from [10.252.29.48] (10.252.29.48) by SHFDAG1NODE3.st.com (10.75.129.71) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.2507.13; Sun, 15 Jan 2023 18:22:55 +0100 Message-ID: Date: Sun, 15 Jan 2023 18:22:54 +0100 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101 Thunderbird/102.6.1 Subject: Re: Generated GDB documentation have colliding files on a case insensitive files system Content-Language: en-US To: Eli Zaretskii CC: References: <831qo6u1m0.fsf@gnu.org> <778ba370-2304-bc7f-c160-9adb24c05f9b@foss.st.com> <83y1qesjys.fsf@gnu.org> <83sfgmsit3.fsf@gnu.org> <64679b6c-e318-0b7a-2dad-9a1f716f9ba8@foss.st.com> <83a62rq4jg.fsf@gnu.org> In-Reply-To: <83a62rq4jg.fsf@gnu.org> Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: 8bit X-Originating-IP: [10.252.29.48] X-ClientProxiedBy: SHFCAS1NODE1.st.com (10.75.129.72) To SHFDAG1NODE3.st.com (10.75.129.71) X-Proofpoint-Virus-Version: vendor=baseguard engine=ICAP:2.0.219,Aquarius:18.0.923,Hydra:6.0.562,FMLib:17.11.122.1 definitions=2023-01-15_13,2023-01-13_02,2022-06-22_01 X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , From: Torbjorn SVENSSON via Gdb-patches Reply-To: Torbjorn SVENSSON Errors-To: gdb-patches-bounces+public-inbox=simark.ca@sourceware.org Sender: "Gdb-patches" On 2023-01-09 13:24, Eli Zaretskii wrote: >> Date: Mon, 9 Jan 2023 07:51:17 +0100 >> CC: >> From: Torbjorn SVENSSON >> >>>> I was considering if the redirect files could simply be removed from the >>>> GDB documentation tree or if they are actually used for inter components >>>> references. >>> >>> They are produced by makeinfo, and they are produced for a reason, no? >> >> According to the other thread, they are generated to easy cross linking >> the documentation. There is nothing in the documentation that will >> generate a link to any of these files, so hence the question if they are >> needed by GDB. > > Maybe I'm confused, but don't you above answer your own question? > "Easy cross linking" is the reason. Well, cross linking from other manuals. Does this requirement jump the need to actually have all the content? :) > >>>> Even if we get a solution merged in texinfo, it will take years for it >>>> to get activity used, and in the mean while, we are stuck with this >>>> issue in GDB. >>> >>> I still don't want to make any conclusions until the Texinfo >>> discussion is completed. How do you know there's no solution with the >>> existing Texinfo versions? >> >> As I understood it, it was proved that the redirect pages were colliding >> and no way around that in current implementation, but maybe I >> misunderstood the reply... > > AFAIU, it's a bug in Texinfo. I hope they will solve it at some > point. > > But now let me turn the table and ask you why we as a project should > care about HTML version of the manual being installed on MS-Windows? I'm just seeing that there are toolchains out there that contains a prebuilt GCC and GDB and that they contain documentation in the form of HTML files. I suppose these packages could be seen as the bad part here, but is it really so. Can't GDB improve the way the HTML manuals are constructed in a way that would work regardless of where they end up? > Having said that, I have no serious objections to changing the name of > the anchor if it will solve the problem for you. Looks like there will a warning emitted now when generating the HTML files if there are more than one anchor/node with a unique name on case insensitive files systems as long as the CASE_INSENSITIVE_FILENAMES option is set with the next version of Texinfo. As I see it, there are 3 different options for the documentation in GDB: 1. Leave everything as is and forget about all users extracting a cross built GDB with documentation and let the users deal with duplicated files... 2. Set the CASE_INSENSITIVE_FILENAMES option and also change one of the anchors to have unique files. This will require Texinfo >7.0.1 that is not yet released. 3. Generate one single big HTML file. This should be supported with existing versions of Texinfo, although I haven't tested this option. What would be needed in GDB sources is to replace the command line option --split-size with --no-split to avoid generating more than one file. What option would you prefer? Kind regards, Torbjörn