From patchwork Thu Nov 30 19:28:40 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tom Tromey X-Patchwork-Id: 81055 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id C9F9A38618D6 for ; Thu, 30 Nov 2023 19:29:02 +0000 (GMT) X-Original-To: gdb-patches@sourceware.org Delivered-To: gdb-patches@sourceware.org Received: from mail-il1-x130.google.com (mail-il1-x130.google.com [IPv6:2607:f8b0:4864:20::130]) by sourceware.org (Postfix) with ESMTPS id 0549A3858D37 for ; Thu, 30 Nov 2023 19:28:48 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 0549A3858D37 Authentication-Results: sourceware.org; dmarc=pass (p=none dis=none) header.from=adacore.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=adacore.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 0549A3858D37 Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2607:f8b0:4864:20::130 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701372530; cv=none; b=xH9p5p/bx97GZfYk4eLb+jvYxctXmQzvwzQFWkN9Yo7aj1X72RoyKoFNRr4LZ6HcqcZnbvuvPiBCVXdQn4V8Dyjxjc+7tGEDnBP1LXrIoN3qQVtMnrpH0uCJVJ8yRHygboFQVqrK7kZQj8vF9PED8+fpv0OjzJ+SW5yiQ6VYMew= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1701372530; c=relaxed/simple; bh=NhzCzeKU7rwxiBFmScReoXQUmmbLVKFup+vYuvb0BGk=; h=DKIM-Signature:From:To:Subject:Date:Message-ID:MIME-Version; b=kPJx6k9gE/kjKJCwdwOOU3ogwJPRLYzC3Fma0l1j044nyAJuz8q4UbSRyeCzmLEy26cbntOmd8miwUI8QAyBULs8zhtPuGnaPWfFbxoaSaW3z95Sn6Q7IpMLmhFbt7th+99CGtSl6yiNHFNyGsYFPgHh8dP61piuR0rbNg5Lghw= ARC-Authentication-Results: i=1; server2.sourceware.org Received: by mail-il1-x130.google.com with SMTP id e9e14a558f8ab-35cdbb68b58so4044705ab.0 for ; Thu, 30 Nov 2023 11:28:47 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=adacore.com; s=google; t=1701372527; x=1701977327; darn=sourceware.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=fQBufdzqjcWToTiHzpcXu5v4Sth85y47n1k6DNIeCUQ=; b=BEudRr9WQG11RjhaD+iQU97zzbrqqnYPmYiF3jqv3xpv3RVPzIiKyV2j5eIou546Wm TwDjGVouE4HUnEqQL4rAL/VaqX1B725ppZHCXA+ygoPZC2yt08HRKIIgscDvEGaN6c6u iFBWu0XkGEVZtn1c2fF6N4lgMZBkLnTc49IHCm0/JPCY84qxl8Dxw1c1MrBR0jASbseU wXpqdZTKKlABsY6PKvnHdsHnuaMm41WaG7DQ8Epxt8c9XVKCFuewtI5bbIHGJ6WmLBmd ZCcCHYDY0n6r787vdvslfUCSlBI82EfLMiBnx0/EG2GZhXc6NiHsCpDouVocw6YnbJ/b 1fJA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1701372527; x=1701977327; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=fQBufdzqjcWToTiHzpcXu5v4Sth85y47n1k6DNIeCUQ=; b=DT4YntUXpbHj1f85TBBXvv63MiK32sVLhIwOmPKOBueBZMG0ykONJ6uX6JXgdnlXTq e6nfgXhv5J8D7jXpeet/Y+AuTESDugW4X9l3dobYR4spLTcWS852R1WeYGBD4yVj3bv+ v1uEiNaJJ2NUnsfCPtsZ2hOroqOVdlExkN7PuFHHkGaOymkFojGjgL3Ku9Yv5Tzb2q5k WWz4xxQyrFefg9siGThvDDYpsdpw9WLYPbTGc3YOWKJ+Zw3rL1vSfbUHUaUgw3NwlELd nrcdvMHG31WNt7HFgyWH3dj9NGVck2VJ1dZgGujc8sebuc8eTnLZ5SARCdfw+6ymvbzV 8VYg== X-Gm-Message-State: AOJu0Yx6BkK5XfIviElGXCrvur842WRuzaZgFWBhX1v4/vtrlUfuclNN cs2Zs97ru8ks2CjPcviPnyIf3IJmmy66eCOfbR8= X-Google-Smtp-Source: AGHT+IG3H52sGNOjr+lkEgeZaYeSNC/NpzLLFSrAvU7ffY5zvP5QKguKVmR7PxOzD7dIZW8WZhdQYA== X-Received: by 2002:a05:6e02:1d83:b0:35d:3dba:989f with SMTP id h3-20020a056e021d8300b0035d3dba989fmr2813630ila.3.1701372527255; Thu, 30 Nov 2023 11:28:47 -0800 (PST) Received: from localhost.localdomain (97-122-77-73.hlrn.qwest.net. [97.122.77.73]) by smtp.gmail.com with ESMTPSA id r4-20020a92c504000000b0035b0aaa5b3esm548892ilg.29.2023.11.30.11.28.46 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 30 Nov 2023 11:28:46 -0800 (PST) From: Tom Tromey To: gdb-patches@sourceware.org Cc: Tom Tromey Subject: [PATCH] Add link to Debugger Adapter Protocol node in documentation Date: Thu, 30 Nov 2023 12:28:40 -0700 Message-ID: <20231130192840.2702303-1-tromey@adacore.com> X-Mailer: git-send-email 2.41.0 MIME-Version: 1.0 X-Spam-Status: No, score=-11.7 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, 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 X-BeenThere: gdb-patches@sourceware.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gdb-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gdb-patches-bounces+patchwork=sourceware.org@sourceware.org I noticed that the interpreters node in the docs links to the DAP protocol docs, but I thought the DAP node ought to as well. This patch adds a bit of introductory text there. --- gdb/doc/gdb.texinfo | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/gdb/doc/gdb.texinfo b/gdb/doc/gdb.texinfo index e4c00143fd1..15fa158a316 100644 --- a/gdb/doc/gdb.texinfo +++ b/gdb/doc/gdb.texinfo @@ -39487,6 +39487,10 @@ depend on the language). @node Debugger Adapter Protocol @chapter Debugger Adapter Protocol +The Debugger Adapter Protocol is a generic API that is used by some +IDEs to communicate with debuggers. It is documented at +@url{https://microsoft.github.io/debug-adapter-protocol/}. + Generally, @value{GDBN} implements the Debugger Adapter Protocol as written. However, in some cases, extensions are either needed or even expected.