From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.133.124]) by sourceware.org (Postfix) with ESMTPS id 40161385B513 for ; Tue, 5 Dec 2023 10:17:38 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 40161385B513 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=redhat.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 40161385B513 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=170.10.133.124 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701771466; cv=none; b=cUutDZTgHoZJhn/zRU8v1QdyAn+vXFFQGNL6zdcuxk5gJlAeZNO55ARKjV2jv3oLuQoQKXOovGS3dI0LuumNg2CG8MYckgpm1bTX3kibOmX5cfTyTj0zrlmqmCV6WBT/UY0XGjMEjb62+W7cCVOBbbkczrEQkYM17+HEYUWsgD4= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701771466; c=relaxed/simple; bh=ewylRfOU6xl8ooCIdHkKLDFdf8V69VxEQy9x97MbE2c=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=U+smF281EkI3BT6EDqjnfeYGaWkprK1H/6/EbTeDQUcbIrydlbNhnauBn/AyC/HrrE1Rd7+YrEOTRFvriSUkM0y2/Pw3wKjH7/fnpPFqNENfCJZmlvFKdCQNknt7ruqxelUrfNNQ3INfvVnozzBkP1ZgKz6zIMhIVWJQtKyo4wQ= ARC-Authentication-Results: i=1; server2.sourceware.org DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1701771457; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:cc:mime-version:mime-version:content-type:content-type: in-reply-to:in-reply-to:references:references; bh=kxhxLvG/0KF7ej8bo1c3zvSn4rnMjr5x7KCoRK8cMMA=; b=QnTirzmW6SkhiK8vtDs5g5jl9iICScQlXthjKsMQI75k95IYHeCotaxSuHqGbSovdd52lm 3nX9Ztiuc04pmOp6pS8CD4Dc5STZwJLeYQoCDZXVeS55+iJC4LOFbYWFVhNRdZUxflkYd8 eIRbKUtAxZeUHKhmcGN2pdy76RJXvWc= Received: from mail-wr1-f70.google.com (mail-wr1-f70.google.com [209.85.221.70]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-502-4k-GLJg2OxGqTrQ19dwkPg-1; Tue, 05 Dec 2023 05:17:36 -0500 X-MC-Unique: 4k-GLJg2OxGqTrQ19dwkPg-1 Received: by mail-wr1-f70.google.com with SMTP id ffacd0b85a97d-33342e25313so2073909f8f.3 for ; Tue, 05 Dec 2023 02:17:36 -0800 (PST) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701771455; x=1702376255; h=mime-version:message-id:date:references:in-reply-to:subject:cc:to :from:x-gm-message-state:from:to:cc:subject:date:message-id:reply-to; bh=kxhxLvG/0KF7ej8bo1c3zvSn4rnMjr5x7KCoRK8cMMA=; b=vGrv+GM9+PH3HjHpShTGb0TRDvZjgpKDIRUrHKTEk4dLHEGO3uKB2v6ByzYL1gn5zw Yv4jsLtRT5sEr79zBYA9ZJVYaxEr1V/FsOQJFxMw9r9ChjMjEnfIELE1uscI3cZHWoQk 4Sym128BcW3U+5Gj4tHqEmHSFTqBLr1eoSixqMTJUlWser+fs4aUPpa20zPSa7GukKep 9XDjYVvxRcGCkhiuxe7XDE0UA6+ESrqe8Q557F5Looz6Ewx+H3kVEXSWLFIwnQgiZWPG ycrhN8ub7FRvCSIUWXvOF8GT7iuUCVkgQtkppGXEeUnUwqpNppur0pWLC4n6EA/gqA9p tImg== X-Gm-Message-State: AOJu0YxWnu+WaAkOx/HbmGYSymF/V+YPAwm76q4IbKPxrgswiRlkLFBs KMgLogjLuh1FTrP+yLskCOf/MbyfhY8OZQ8Hd7hmOIngUyERnfwFPm8ed/M+cc/nyuCCW2kLQBG 2Kt7Wy80dRa45ZjD0nNtmpnQt/Kkwcw== X-Received: by 2002:adf:a319:0:b0:333:2fd2:5210 with SMTP id c25-20020adfa319000000b003332fd25210mr4086977wrb.137.1701771455526; Tue, 05 Dec 2023 02:17:35 -0800 (PST) X-Google-Smtp-Source: AGHT+IG8mYdEpR2ISQgjF3QrIzmOkPnbSuZuq/XF6ZeS5VLlBw/2RQCchVqXsY+gcAO5FyKfqnOSvQ== X-Received: by 2002:adf:a319:0:b0:333:2fd2:5210 with SMTP id c25-20020adfa319000000b003332fd25210mr4086970wrb.137.1701771455234; Tue, 05 Dec 2023 02:17:35 -0800 (PST) Received: from localhost (105.226.159.143.dyn.plus.net. [143.159.226.105]) by smtp.gmail.com with ESMTPSA id j10-20020a5d604a000000b003333fd29854sm7522650wrt.45.2023.12.05.02.17.34 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 05 Dec 2023 02:17:34 -0800 (PST) From: Andrew Burgess To: Eli Zaretskii Cc: gdb-patches@sourceware.org Subject: Re: [PATCH 2/3] gdbserver: allow the --debug command line option to take a value In-Reply-To: <83o7f65471.fsf@gnu.org> References: <83v8ad1hcv.fsf@gnu.org> <87bkbbnldv.fsf@redhat.com> <83h6l3avzv.fsf@gnu.org> <87il5egdut.fsf@redhat.com> <83o7f65471.fsf@gnu.org> Date: Tue, 05 Dec 2023 10:17:33 +0000 Message-ID: <87cyvlgdhe.fsf@redhat.com> MIME-Version: 1.0 X-Mimecast-Spam-Score: 0 X-Mimecast-Originator: redhat.com Content-Type: text/plain X-Spam-Status: No, score=-5.7 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,RCVD_IN_DNSWL_NONE,RCVD_IN_MSPIKE_H3,RCVD_IN_MSPIKE_WL,SPF_HELO_NONE,SPF_NONE,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: Eli Zaretskii writes: >> From: Andrew Burgess >> Cc: gdb-patches@sourceware.org >> Date: Mon, 04 Dec 2023 15:57:14 +0000 >> >> Eli Zaretskii writes: >> >> >> > Why do we need this duplicate description? I'd prefer to have a short >> >> > sentence with a cross-reference to the previous description, so that >> >> > we could have only one of them, not two. >> >> >> >> This is unfortunate. One of these instances is the general gdb info >> >> manual, while the second of these is the gdbserver man page. >> > >> > The above is from the manual, and in Texinfo, not from the man page. >> > How is the man page relevant? >> >> 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? 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? Thanks, Andrew