From patchwork Thu Oct 5 21:05:54 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Miguel Ojeda X-Patchwork-Id: 149032 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:612c:2016:b0:403:3b70:6f57 with SMTP id fe22csp566866vqb; Thu, 5 Oct 2023 14:07:20 -0700 (PDT) X-Google-Smtp-Source: AGHT+IHXzTZ+pWSfhOkE0vLK2uboV+ksOMTmUYXmgf/WJsaCLW9RONbFwodW9RGJgFPOFSbfrM5K X-Received: by 2002:a05:6830:134e:b0:6b9:5734:135f with SMTP id r14-20020a056830134e00b006b95734135fmr6396166otq.28.1696540040548; Thu, 05 Oct 2023 14:07:20 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1696540040; cv=none; d=google.com; s=arc-20160816; b=oLA24pugHgdze6BEL7u3AYko8+DJyJY9I63LgqrXxqbcG2K2xcbf4xIOw4sAYQF1Mn ZCRShbTEIJs5vpueA8Ej5XsAlDT9ndCXIMpDYjvLJrJd1H8z/s1Ke09L6xGRg72rq0r1 KbuAqsystmuCWFjj4CW0bAZziH6QBAoRlyVuvFGUFovLxZd5btLspwl/8FSU9LDyJm5i IygTw5q+c9j+CSaRo0faUPYZeF0xhls+yDAltJW51rlz4CMFdwq/8D7KIto/BQM/thCE oby80kLgXY+cT9rhxh7zgJGGhxVBkCjMRIZ1El6uMCnQN78FMMpkUL+rKGouqtwpBlwg s9/w== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=Lz8aTxUWpZN6Rd7/GjcFCGrQPDqbA89Q0G6O9kSX0Yg=; fh=au7aoxhxwiGjd3un8PPv3AApc8jH8uW5iTGRpBKg8nc=; b=gvjPVGiqsASrVs8oKXMMJggzoqTCSw+EsCU+WbxTo5uhO9buFji28WuVNHaxBEkDPN xNmqD+wBq3te+vnQqRJJPNO0ZFToVRBHOvjHxxO4OFpZUZRSZ0DR5zj4+28pGwcUz6pn oc5bd1DXz+tZ3Rp8rN39ToKeJVk7CgVw49D9CE6i5QE+ApZIKGsV8xABC4Z6cIpYBWq0 Z4zUAvLlSWgFqI32FUdRBps/OrJxLM6dnUvg7WsEjgj6ozYQ1QcIGqUaPVacj9QA7fu5 WJMzCsuXuxab9FM+XEq7aTn8H+7e8nZm1ZHav2tGJsJB/EmggPAC4yXqtZsqOS4TihXg ZkQA== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=pTVigqeP; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from agentk.vger.email (agentk.vger.email. [23.128.96.32]) by mx.google.com with ESMTPS id m190-20020a6326c7000000b0056b024a4dd0si2237672pgm.614.2023.10.05.14.07.20 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Thu, 05 Oct 2023 14:07:20 -0700 (PDT) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) client-ip=23.128.96.32; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=pTVigqeP; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 23.128.96.32 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by agentk.vger.email (Postfix) with ESMTP id 19AD1830152F; Thu, 5 Oct 2023 14:07:18 -0700 (PDT) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.10 at agentk.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231859AbjJEVGf (ORCPT + 18 others); Thu, 5 Oct 2023 17:06:35 -0400 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:42204 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S231841AbjJEVGb (ORCPT ); Thu, 5 Oct 2023 17:06:31 -0400 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id B1FB3D9 for ; Thu, 5 Oct 2023 14:06:29 -0700 (PDT) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 8E193C433C7; Thu, 5 Oct 2023 21:06:26 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1696539989; bh=IgnQ6UponHD7jSbFHw/8nSE/0v3lOdZL01VrkmoEWNs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=pTVigqePQVgAUvofgawoF4pXU1khefVIcRhUaE6EHw8QVre55UrKUxmvtvPsRn0TN r9c2a1hZQXYcwB4kDn5MpFuqITHIE3m1mYZlVoOibIxq9ISrbWKLQhh7dJUh7djA2F XVUCTXYAei48w+IWUlhMZlcFUYNgSNFGAmv0U3AzaaVNSCnorI61XMEQuQfAPBjybZ jALxqZ2TsDrogKhpRykPUK1xLhxlxw3RlOTegKboVip5QMTJ0jjJM5GGfYxXzFKMTc /PQ6A7AWO099ZFZLraaIllvNOedS03hlmQAR35aDJT82Rh5+wFzkzFOS7Rajmvd4Bv jomQrL5ePPWhQ== From: Miguel Ojeda To: Miguel Ojeda , Wedson Almeida Filho , Alex Gaynor Cc: Boqun Feng , Gary Guo , =?utf-8?q?Bj=C3=B6rn_Roy_Baron?= , Benno Lossin , Andreas Hindborg , Alice Ryhl , rust-for-linux@vger.kernel.org, linux-kernel@vger.kernel.org, patches@lists.linux.dev Subject: [PATCH 2/3] rust: print: use explicit link in documentation Date: Thu, 5 Oct 2023 23:05:54 +0200 Message-ID: <20231005210556.466856-3-ojeda@kernel.org> In-Reply-To: <20231005210556.466856-1-ojeda@kernel.org> References: <20231005210556.466856-1-ojeda@kernel.org> MIME-Version: 1.0 X-Spam-Status: No, score=-1.2 required=5.0 tests=DKIMWL_WL_HIGH,DKIM_SIGNED, DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,MAILING_LIST_MULTI, SPF_HELO_NONE,SPF_PASS,URIBL_BLOCKED autolearn=unavailable autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on agentk.vger.email Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (agentk.vger.email [0.0.0.0]); Thu, 05 Oct 2023 14:07:18 -0700 (PDT) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1778951169347429020 X-GMAIL-MSGID: 1778951169347429020 The future `rustdoc` in the Rust 1.73.0 upgrade requires an explicit link for `pr_info!`: error: unresolved link to `pr_info` --> rust/kernel/print.rs:395:63 | 395 | /// Use only when continuing a previous `pr_*!` macro (e.g. [`pr_info!`]). | ^^^^^^^^ no item named `pr_info` in scope | = note: `macro_rules` named `pr_info` exists in this crate, but it is not in scope at this link's location = note: `-D rustdoc::broken-intra-doc-links` implied by `-D warnings` Thus do so to avoid a broken link while upgrading. Signed-off-by: Miguel Ojeda Reviewed-by: Martin Rodriguez Reboredo Reviewed-by: Finn Behrens Reviewed-by: Alice Ryhl Reviewed-by: Vincenzo Palazzo --- rust/kernel/print.rs | 1 + 1 file changed, 1 insertion(+) diff --git a/rust/kernel/print.rs b/rust/kernel/print.rs index 8009184bf6d7..f48926e3e9fe 100644 --- a/rust/kernel/print.rs +++ b/rust/kernel/print.rs @@ -399,6 +399,7 @@ macro_rules! pr_debug ( /// Mimics the interface of [`std::print!`]. See [`core::fmt`] and /// `alloc::format!` for information about the formatting syntax. /// +/// [`pr_info!`]: crate::pr_info! /// [`pr_cont`]: https://www.kernel.org/doc/html/latest/core-api/printk-basics.html#c.pr_cont /// [`std::print!`]: https://doc.rust-lang.org/std/macro.print.html ///