Received: by 2002:a25:4158:0:0:0:0:0 with SMTP id o85csp4337347yba; Tue, 9 Apr 2019 16:53:15 -0700 (PDT) X-Google-Smtp-Source: APXvYqzTr39RgLWkpEZ69LZFfdnB1x1vGao3OzpVIoLoQip13xb+3ikfngl2BJRc+kJp1VT22Sk2 X-Received: by 2002:a62:ed16:: with SMTP id u22mr39998708pfh.47.1554853994898; Tue, 09 Apr 2019 16:53:14 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1554853994; cv=none; d=google.com; s=arc-20160816; b=qP6ye4levYyZeAEb1T/ZL7+/M/Rmvaa/WDo1vTB9C1+TPXkvtHSBAfCj17HxWtWWNf +TIyj71o0b2wnnfHB6DVtXRmKCg8ufyaYh/Ne35IlGifKkTKC7MEsxVj9OINq/KP6ub5 n7OcZLGQ5SZ2BOATbtWPX1mbj8cKV5PbHBdZDr+WJNh5ILmDMFXuAJIjKsm7LU6IRm3+ ag9tIkui6jbYEm5LO/eDeXsmBuHForVuBbe01zRV3A20Mu76UZK+AvQN+abrU/fs/a3x EjR8vdu+bNIFaw9afH2g9s8LSq/zAUdQLmUK9Y3ZqgOTkxENuBRfgI2nDbASP0/9+U/m sniA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:user-agent:in-reply-to :content-disposition:mime-version:references:message-id:subject:cc :to:from:date:dkim-signature:dkim-signature; bh=vl/fyFA1uDMvpYRDqKzKG8y9NC6DobbF4tLswqG+uik=; b=l382TrnNWjD06YmXokVh5kSxGSLX78+cCDgyfRlwKg2zoWORoAC593FQHzVukxGi++ cm09JSQdoeHP133YbFhzKgSnyYV8SB6GtEQyM5gOfoADafWMyLFJDe62GCWIpL0sRt2x ceM74dwh5lsUNY7TgMtVPSFYAKGZTHf4GpzG75NbocCTgPhqOWz5kIdi0QmSf/fU5zWD 1FkVOWjrru0CP+QQDyxp7ECY1xf83HsIhUY5xtHmlr03oYGVTArhFz1xPCrxMhKnDMZl t9QA9hPJcCxaVZ/3TYJM9Kxc0OKhZDOO12pTo1JuWLXbYizfIx3VcuVMMCIQTsyhY1sF tX0A== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@tobin.cc header.s=fm2 header.b=SzwSoUAI; dkim=pass header.i=@messagingengine.com header.s=fm2 header.b=UXmB7b2Q; 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 p6si30703843pgs.407.2019.04.09.16.52.48; Tue, 09 Apr 2019 16:53:14 -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; dkim=pass header.i=@tobin.cc header.s=fm2 header.b=SzwSoUAI; dkim=pass header.i=@messagingengine.com header.s=fm2 header.b=UXmB7b2Q; 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 S1726778AbfDIXWL (ORCPT + 99 others); Tue, 9 Apr 2019 19:22:11 -0400 Received: from out3-smtp.messagingengine.com ([66.111.4.27]:46401 "EHLO out3-smtp.messagingengine.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726573AbfDIXWK (ORCPT ); Tue, 9 Apr 2019 19:22:10 -0400 Received: from compute5.internal (compute5.nyi.internal [10.202.2.45]) by mailout.nyi.internal (Postfix) with ESMTP id 7BF0825EE9; Tue, 9 Apr 2019 19:22:09 -0400 (EDT) Received: from mailfrontend1 ([10.202.2.162]) by compute5.internal (MEProxy); Tue, 09 Apr 2019 19:22:09 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tobin.cc; h=date :from:to:cc:subject:message-id:references:mime-version :content-type:in-reply-to; s=fm2; bh=vl/fyFA1uDMvpYRDqKzKG8y9NC6 DobbF4tLswqG+uik=; b=SzwSoUAICMIlFOtpJZnWvYPesegsK6TfR/bFAkRJnXJ Wv/jnGgDmahg++3ZP5OmDL4S12aAGyCD7QXkY6Z2PZkdJ5FBuP5dJXqYKT2/6up3 gik80K/znNjSjV3tFvcSfXw/UUaTKXJ4tx4V1NuepoHLpvKGkWdzm/njT/uSsUQJ Th8v/QGIQOKKMG2gSXJMOtMe/htPxcXICXi6WkDUmCpbEaTsQ2+aWGL0APuQ48A1 nKLXGFiEinKuTtASdZ/VeKKg+MDMw5HueY260Bgeqr2Wrh8jpDcavLA702iJIAN4 ln7aqgSafvkIVoj7zLRPvRlFGaDKw7QauCHxJKxRXfw== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-type:date:from:in-reply-to :message-id:mime-version:references:subject:to:x-me-proxy :x-me-proxy:x-me-sender:x-me-sender:x-sasl-enc; s=fm2; bh=vl/fyF A1uDMvpYRDqKzKG8y9NC6DobbF4tLswqG+uik=; b=UXmB7b2QSCR3dGUb86WuTY Ts6hdHXO3+jM7oIaWurEJsB4apajCOSqFXOZdgUN3FFnANDCQSHrDVM44IS5sHEJ 1IMCZo6cwUaokzcFuwNb7NCuhf59gRb/FAoaHKfAu3XmnZZ/MJTPYbQkw2EX7sTZ aObH2rZ3f82f21hT1n4dE5BzPZUI1D6P0WMIwlNcyMMFIxjkzwmVKkZw2RrGNDF4 C43mWiZ8qWYUzCkH1YySys49YHE4yKlmQcxEMtvN3QuvKXHVJHnXvUBBYPnPVM/g 5blTzCanFDG6P9glFwZNU0mZw6VNyasOEBBGKDyF8NqI/oKOxDWmitJkM39ryubg == X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduuddrudeigddvudcutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenfg hrlhcuvffnffculdduhedmnecujfgurhepfffhvffukfhfgggtuggjofgfsehttdertdfo redvnecuhfhrohhmpedfvfhosghinhcuvedrucfjrghrughinhhgfdcuoehmvgesthhosg hinhdrtggtqeenucfkphepuddvgedrudejuddrudelrdduleegnecurfgrrhgrmhepmhgr ihhlfhhrohhmpehmvgesthhosghinhdrtggtnecuvehluhhsthgvrhfuihiivgeptd X-ME-Proxy: Received: from localhost (124-171-19-194.dyn.iinet.net.au [124.171.19.194]) by mail.messagingengine.com (Postfix) with ESMTPA id 5AD05E407B; Tue, 9 Apr 2019 19:22:08 -0400 (EDT) Date: Wed, 10 Apr 2019 09:21:36 +1000 From: "Tobin C. Harding" To: Jonathan Corbet Cc: "Tobin C. Harding" , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: Re: [PATCH v2 3/4] docs: Remove unnecessary reference link title Message-ID: <20190409232136.GA23698@eros.localdomain> References: <20190409004359.29668-1-tobin@kernel.org> <20190409004359.29668-4-tobin@kernel.org> <20190409152030.2ed66e86@lwn.net> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20190409152030.2ed66e86@lwn.net> X-Mailer: Mutt 1.11.4 (2019-03-13) User-Agent: Mutt/1.11.4 (2019-03-13) Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, Apr 09, 2019 at 03:20:30PM -0600, Jonathan Corbet wrote: > On Tue, 9 Apr 2019 10:43:58 +1000 > "Tobin C. Harding" wrote: > > > Labels that precede a heading use the heading as the link title. > > Explicitly adding the link title is redundant and makes the reference > > slightly less maintainable. > > > > Remove unnecessary reference link title. > > So I agree with the objective, but... > > > - As mentioned above in :ref:`VMA policies ` section, > > + As mentioned above in :ref:`vma_policy` section, > > ...this one generates a warning that highlights a flaw in the reasoning > here: > > Documentation/admin-guide/mm/numa_memory_policy.rst:144: WARNING: > undefined label: vma-policy (if the link has no caption the label > must precede a section header) > > Said label does not precede a section header, so it can't be used bare in > this way. That's weird, I did a clean build before and after applying the set and diffed the stderr outputs, I wonder how I missed this. > I'll apply the other three, but this one needs some repairs :) thanks, Tobin.