From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from list by lists.gnu.org with archive (Exim 4.90_1) id 1qJGqK-0007Ph-BD for mharc-grub-devel@gnu.org; Tue, 11 Jul 2023 13:08:04 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]) by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.90_1) (envelope-from ) id 1qJGqI-0007P0-10 for grub-devel@gnu.org; Tue, 11 Jul 2023 13:08:02 -0400 Received: from mail-vs1-xe2a.google.com ([2607:f8b0:4864:20::e2a]) by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128) (Exim 4.90_1) (envelope-from ) id 1qJGqC-0002gB-Kt for grub-devel@gnu.org; Tue, 11 Jul 2023 13:08:01 -0400 Received: by mail-vs1-xe2a.google.com with SMTP id ada2fe7eead31-440db8e60c8so1930341137.0 for ; Tue, 11 Jul 2023 10:07:44 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=efficientek-com.20221208.gappssmtp.com; s=20221208; t=1689095263; x=1691687263; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=H0CfKADdYCnLuGGWY0AEKx78wmJ86xFZHWjHLn+sGYw=; b=yxOnhzOhN2IOB31K5QkxJP72bgfp19/mz7u1JLVvv7qGa20BCNKGmaxzLnFS0ac0Q5 SLIZoNpvBrk2SLJOcMINymWk4L+zAaQ/L7r6pJtJ/eVZ+ooVEe/7i4gIxlnZcxqzTkMc k6PuCdjOVsXsLfPUJhmg9aUclqIzHyOlqGwuhP3mZ6xoFrhKJsCog2ApI+dvfeKteKwq BPifGQItcLiTsqEcFQx+SGfyoFpcB2miRe/CTTQsxHB334tEiT9Y06zSEdx7dyA+Qdp7 sSJma2a/VtZZkAomA1uSZTEyElrYKYyQ1WgPkZrd6/E9ZNPs4EClmBxgmd+j+69AwEqM uQ/w== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20221208; t=1689095263; x=1691687263; 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=H0CfKADdYCnLuGGWY0AEKx78wmJ86xFZHWjHLn+sGYw=; b=T40vsgENBidmQxQPGyU3dSSBQpvVrxLIqKwPB9yj30JVRqo3EmJc4ef8i5y4+rpVTb tLQXK7h+HhBFSFR8fwbouqboYwd7uVYnmkNhuado64GLkh8V1uytue/zSGx3jf9ciYXS zqREX+5C70X7GRgL5XmPquxQPBT47dyAPNAgiZ9IZEQMQyymOV0UREbSV+uMux0ANXWz +ToOZlBlVpDqpfywcrYVd4Zx2cFECX4ZPlqsBoevE4FjGf8mMoqrnOIR70uw7svifKVF t5Q46dQnfY3ULOZEsotDb/1QNNIeKKydxqpcwGCmPT9vmBwAq0kEa5WZT6/Cpfx55G7c hUGQ== X-Gm-Message-State: ABy/qLadcGQVjUCIvMob0oW7uu5sPntnUa1mjfr+FjuVSR9DSAfyaMo7 z5Yxdvtnv3XxPCZ7IBIVVS4TnJgsj0mXHT+lawQ= X-Google-Smtp-Source: APBJJlFZ2KF/OBOky899tqbRHv8shlL5SNf1OcWYuJN3CD+vekyedg8VBeDDflKGaZaIezYGMp0PPQ== X-Received: by 2002:a05:6102:247:b0:443:5f6e:c1b5 with SMTP id a7-20020a056102024700b004435f6ec1b5mr7900722vsq.18.1689095263731; Tue, 11 Jul 2023 10:07:43 -0700 (PDT) Received: from localhost.localdomain ([37.218.244.249]) by smtp.gmail.com with ESMTPSA id t1-20020a9f3881000000b00786fd01f05bsm268130uaf.24.2023.07.11.10.07.41 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 11 Jul 2023 10:07:42 -0700 (PDT) From: Glenn Washburn To: grub-devel@gnu.org, Daniel Kiper Cc: Oskari Pirhonen , Glenn Washburn Subject: [PATCH v4] docs: Add missing assumption Date: Tue, 11 Jul 2023 12:07:29 -0500 Message-Id: <20230711170729.1497818-1-development@efficientek.com> X-Mailer: git-send-email 2.34.1 MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Received-SPF: pass client-ip=2607:f8b0:4864:20::e2a; envelope-from=development@efficientek.com; helo=mail-vs1-xe2a.google.com X-Spam_score_int: -18 X-Spam_score: -1.9 X-Spam_bar: - X-Spam_report: (-1.9 / 5.0 requ) BAYES_00=-1.9, DKIM_SIGNED=0.1, DKIM_VALID=-0.1, RCVD_IN_DNSWL_NONE=-0.0001, SPF_HELO_NONE=0.001, SPF_PASS=-0.001, T_SCC_BODY_TEXT_LINE=-0.01 autolearn=ham autolearn_force=no X-Spam_action: no action X-BeenThere: grub-devel@gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: The development of GNU GRUB List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 11 Jul 2023 17:08:02 -0000 Also reword a prior sentence to be more clear. Fixes: 5a3d2b4742df (docs: Add debugging chapter to development documentation) Signed-off-by: Glenn Washburn --- Range-diff against v3: 1: 437c408b31cb ! 1: c228e0412720 docs: Add missing assumption @@ docs/grub-dev.texi: GDB is started from the @file{grub-core} directory in the GR -If not building GRUB, the distribution may have a package which installs +When using a pre-built GRUB, the distribution may have a package which installs this GDB script along with debug symbol binaries, such as Debian's --@samp{grub-pc-dbg} package. The GDB script is intended to be used + @samp{grub-pc-dbg} package. The GDB script is intended to be used -like so, assuming: -+@samp{grub-pc-dbg} package. The GDB script is intended to by used +like so, assuming that @samp{/path/to/script} is the path to the directory +containing the gdb_grub script and debug symbol files: docs/grub-dev.texi | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/grub-dev.texi b/docs/grub-dev.texi index 0834ca562ad6..a695b02f06df 100644 --- a/docs/grub-dev.texi +++ b/docs/grub-dev.texi @@ -660,10 +660,11 @@ GDB is started from the @file{grub-core} directory in the GRUB2 build directory. GRUB2 developers have made this more simple by including a GDB script which does much of the setup. This file is at @file{grub-core/gdb_grub} in the build directory and is also installed via @command{make install}. -If not building GRUB, the distribution may have a package which installs +When using a pre-built GRUB, the distribution may have a package which installs this GDB script along with debug symbol binaries, such as Debian's @samp{grub-pc-dbg} package. The GDB script is intended to be used -like so, assuming: +like so, assuming that @samp{/path/to/script} is the path to the directory +containing the gdb_grub script and debug symbol files: @example cd $(dirname /path/to/script/gdb_grub) -- 2.34.1