Received: by 2002:ac0:a5a7:0:0:0:0:0 with SMTP id m36-v6csp128400imm; Thu, 26 Jul 2018 15:21:09 -0700 (PDT) X-Google-Smtp-Source: AAOMgpeJvijzfxtS9202s53/PPAjq4Qgs6xLTkEIUhASBp4KX7LsgCn4dUv2A/Y234gjKVwBfBtp X-Received: by 2002:a17:902:1007:: with SMTP id b7-v6mr3505542pla.277.1532643669818; Thu, 26 Jul 2018 15:21:09 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1532643669; cv=none; d=google.com; s=arc-20160816; b=wH+M2qUy6ODvriF+bZna9L0mRaV61eKmD0RDhPc8Pk1Kp0gZWPt4Lxn74ZaZUvunFd he/xPvNNiY9HlpPG6v78xULrgU3JzquJfiUAvfgscLR1KSgZwJKOYxnPU77Q1jxhy9Tf 4i1sFUNQKvw1gmLj7TipuWwu4iInMPK2zFXOo1CJNGJR9IvYbPgGLSyNOf0xW/5CG41g OhUPZN0y/bZ4reIB2xeclfQlni8AldMM/y/7mNcTci71LMyYlGZjuTjLl0xqlbkRefI/ r9QwwmUBvd4yl1Jy3OLBXS447vuA/JOJFd9vD9Kusn7V8+kdmb7/C0E0v/TtnkTEj4eE rgXg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-transfer-encoding:mime-version :organization:references:in-reply-to:message-id:subject:cc:to:from :date:arc-authentication-results; bh=uO/sskbA7MnPvXco7PYsG/IDq3wafLAankdBf1nWmS0=; b=s4Kx3P6ZewcaDqUmEqtNdg066cPtGUkUoXcnhUzgXcG8YfMuqo7IHI8MqopHUstpms wEJuqZlOi2l8tsGxvI8PJWlT2+mk/Ro03SoqtBLl1QUJDTmzPw68vax7BJ53c1bW8c13 APELiep9obcCZcx9kPl1S4bb3zBh3LJ6eYb0MDn2E9PTtBjugDt2AwRWLDWVVfoZ7gL5 7nk1aDB8rwnrl0+P+Y0go1X78wGQHRfaMFrHqlCwnvnnxMqGpZhnjzEiGUlWLADW2wU0 Oqv57i5QMCnyF4oKEuiZ8rfxga3e9W1s/H5IfovY1JABp9wAVo+DlsKjuIUdVq04bQcG 3BsQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id z15-v6si2157796pgf.293.2018.07.26.15.20.54; Thu, 26 Jul 2018 15:21:09 -0700 (PDT) Received-SPF: pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) client-ip=209.132.180.67; Authentication-Results: mx.google.com; spf=pass (google.com: best guess record for domain of linux-kernel-owner@vger.kernel.org designates 209.132.180.67 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1731757AbeGZXiz (ORCPT + 99 others); Thu, 26 Jul 2018 19:38:55 -0400 Received: from ms.lwn.net ([45.79.88.28]:34474 "EHLO ms.lwn.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1730581AbeGZXiz (ORCPT ); Thu, 26 Jul 2018 19:38:55 -0400 Received: from lwn.net (localhost [127.0.0.1]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ms.lwn.net (Postfix) with ESMTPSA id B20B72D9; Thu, 26 Jul 2018 22:20:05 +0000 (UTC) Date: Thu, 26 Jul 2018 16:20:04 -0600 From: Jonathan Corbet To: Federico Vaga Cc: linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Alessia Mantegazza Subject: Re: [PATCH 1/2] doc:hacking: add labels Message-ID: <20180726162004.29004e4e@lwn.net> In-Reply-To: <20180706220517.28623-2-federico.vaga@vaga.pv.it> References: <20180706220517.28623-1-federico.vaga@vaga.pv.it> <20180706220517.28623-2-federico.vaga@vaga.pv.it> Organization: LWN.net MIME-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 8bit Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Sat, 7 Jul 2018 00:05:16 +0200 Federico Vaga wrote: > Apparently some local links are not properly generated in locking.rst. > This patch use the ':ref:' directive to add the link to the section label. > > Signed-off-by: Federico Vaga > --- > Documentation/kernel-hacking/locking.rst | 12 ++++++++++-- > 1 file changed, 10 insertions(+), 2 deletions(-) > > diff --git a/Documentation/kernel-hacking/locking.rst b/Documentation/kernel-hacking/locking.rst > index f937c0fd11aa..574fc92a6f20 100644 > --- a/Documentation/kernel-hacking/locking.rst > +++ b/Documentation/kernel-hacking/locking.rst > @@ -177,7 +177,7 @@ perfect world). > > Note that you can also use :c:func:`spin_lock_irq()` or > :c:func:`spin_lock_irqsave()` here, which stop hardware interrupts > -as well: see `Hard IRQ Context <#hardirq-context>`__. > +as well: see :ref:`Hard IRQ Context `. Actually, the real problem here was that the #tag was wrong. I've applied the following instead. Thanks, jon docs: Fix the reference labels in Locking.rst Two jump tags were misspelled, leading to non-working cross-reference links. Reported-by: Federico Vaga Signed-off-by: Jonathan Corbet --- Documentation/kernel-hacking/locking.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/kernel-hacking/locking.rst b/Documentation/kernel-hacking/locking.rst index f937c0fd11aa..9cc036ff57b9 100644 --- a/Documentation/kernel-hacking/locking.rst +++ b/Documentation/kernel-hacking/locking.rst @@ -177,7 +177,7 @@ perfect world). Note that you can also use :c:func:`spin_lock_irq()` or :c:func:`spin_lock_irqsave()` here, which stop hardware interrupts -as well: see `Hard IRQ Context <#hardirq-context>`__. +as well: see `Hard IRQ Context <#hard-irq-context>`__. This works perfectly for UP as well: the spin lock vanishes, and this macro simply becomes :c:func:`local_bh_disable()` @@ -228,7 +228,7 @@ The Same Softirq ~~~~~~~~~~~~~~~~ The same softirq can run on the other CPUs: you can use a per-CPU array -(see `Per-CPU Data <#per-cpu>`__) for better performance. If you're +(see `Per-CPU Data <#per-cpu-data>`__) for better performance. If you're going so far as to use a softirq, you probably care about scalable performance enough to justify the extra complexity. -- 2.17.1