From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from eggs.gnu.org (eggs.gnu.org [IPv6:2001:470:142:3::10]) by sourceware.org (Postfix) with ESMTPS id 429643858C2A for ; Tue, 5 Dec 2023 13:06:07 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 429643858C2A Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=gnu.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=gnu.org ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 429643858C2A Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2001:470:142:3::10 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701781577; cv=none; b=pJKfW1uYOM20A+mAoVMBeHDdA2lp9VWDoIogxXhtKRgrcneQEDeA++y9u2K4XEEBErg4HOtRnq6VhT9CNRrXR3diowKVeiEXWDiIkcV6O0hOUe03mK43VkiJm5i+SMERXiHGwibF0VqAAHCWYRaAuALtkMOh9VzWPWwrU/wEfFw= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701781577; c=relaxed/simple; bh=jHpEi1lra3Qspas4SU79N45+FXzOeBOMfsa/36R87bA=; h=DKIM-Signature:Date:Message-Id:From:To:Subject; b=xIxtTEgi7rvhtNjDIQLNmXvkI++avUKtt1do9ekCNunZHf+8tpvhfMpaElOyuCbUzKtT9MDNYCV9UAHQA6O4YVagg7oAuUOgcVUnIZjzA2TlGdDbao9mTSimbNgpAdeX+lscpzafbBYi5J4NtSIs7TdQ7udvRF3X8mRrde9KjUw= ARC-Authentication-Results: i=1; server2.sourceware.org Received: from fencepost.gnu.org ([2001:470:142:3::e]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1rAV7m-0002Y0-Dn; Tue, 05 Dec 2023 08:06:06 -0500 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org; s=fencepost-gnu-org; h=References:Subject:In-Reply-To:To:From:Date: mime-version; bh=4mBIVz1UvgKd85ZbebYsEy29P747nq7tdcDn5aMRAqA=; b=PoecAXct8yTo ShIYwFyaPJnRtp5C0X/WkelXwWFrhlMD8BUDYsryHhSQ8n28QCRvHV4IO8HXkbih+pynJIIchATif uFIYfCgCGQ9dd+xN9L1iaheW4KjrLoHsjHW5FF4npnFLIa6yBjS+uZ9TtWSkCyE/uW0IQqSQBAdwU wguoPShfnW2+LPYW2rbEj/2//Kak3MdjNS3z1RS+vqZz+sPjP6Gft8xzfwbWWNNMlWXpoxSox8ToM J3OUnDVUm97Ibx9oMuikdWbnQ+V8SmevS59Z2p6F79vTTaptO0nwCLAN4DYus7wiicK6q9EcYyXdq uNzCYGjssv9mFGxXbfPtLQ==; Date: Tue, 05 Dec 2023 15:06:13 +0200 Message-Id: <8334wg6bp6.fsf@gnu.org> From: Eli Zaretskii To: Andrew Burgess Cc: gdb-patches@sourceware.org In-Reply-To: <87cyvlgdhe.fsf@redhat.com> (message from Andrew Burgess on Tue, 05 Dec 2023 10:17:33 +0000) Subject: Re: [PATCH 2/3] gdbserver: allow the --debug command line option to take a value References: <83v8ad1hcv.fsf@gnu.org> <87bkbbnldv.fsf@redhat.com> <83h6l3avzv.fsf@gnu.org> <87il5egdut.fsf@redhat.com> <83o7f65471.fsf@gnu.org> <87cyvlgdhe.fsf@redhat.com> X-Spam-Status: No, score=0.5 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,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: > From: Andrew Burgess > Cc: gdb-patches@sourceware.org > Date: Tue, 05 Dec 2023 10:17:33 +0000 > > Eli Zaretskii writes: > > >> The man page is generated from gdb.texinfo using this magic in > >> gdb/doc/Makefile.in: > > > > And we must have two identical passages in the manual to do that? We > > cannot generate these man pages using a single copy of the text we are > > talking about? > > I 100% agree with you that it would be better if we could somehow > structure things so that we could remove the duplication. But I don't > know what the right way to do that would be, and I don't think it's > going to be a small task. > > Hopefully you're not suggesting that I need to do this in order to > document a new gdbserver command line option? No, if this is not trivial to fix, we might as well keep living with it. > I guess my question would be: Are the doc parts of this patch good > enough given the known idiosyncrasies of how the manual is structured? Yes, thanks.