From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S932070AbbJ0VVs (ORCPT ); Tue, 27 Oct 2015 17:21:48 -0400 Received: from fieldses.org ([173.255.197.46]:37901 "EHLO fieldses.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1750877AbbJ0VVq (ORCPT ); Tue, 27 Oct 2015 17:21:46 -0400 Date: Tue, 27 Oct 2015 17:21:45 -0400 From: "J. Bruce Fields" To: Neil Brown Cc: Jonathan Corbet , Randy Dunlap , Al Viro , lkml , linux-doc@vger.kernel.org Subject: Re: [PATCHv2] Documentation: add new description of path-name lookup. Message-ID: <20151027212145.GF14022@fieldses.org> References: <20150725102825.335e9d9a@noble> <55B5A880.8040500@infradead.org> <20150806125435.694d9ee3@noble> <20150806040105.3177d28e@lwn.net> <87eggidtmd.fsf@notabene.neil.brown.name> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <87eggidtmd.fsf@notabene.neil.brown.name> User-Agent: Mutt/1.5.21 (2010-09-15) Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Mon, Oct 26, 2015 at 03:35:54PM +0900, Neil Brown wrote: > From c38784b876a181eda9a5687e618749157dc96a0e Mon Sep 17 00:00:00 2001 > From: NeilBrown > Date: Sat, 25 Jul 2015 10:24:41 +1000 > Subject: [PATCH] Documentation: add new description of path-name lookup. > > This document is based on three recent lwn.net articles. > Some of the introductory material and linkage between articles > has been removed, and some time-based descriptions have been > revised. Thanks for doing this! Nit: > +End of the road > +--------------- > + > +Despite its complexity, all this pathname lookup code appears to be > +in good shape - various parts are certainly easier to understand now > +than even a couple of releases ago. But that doesn't mean it is > +"finished". As already mentioned, RCU-walk currently only follows > +symlinks that are stored in the inode so, while it handles many ext4 > +symlinks, it doesn't help with NFS, XFS, or Btrfs. That support > +is not likely to be long delayed. This looks likely to go stale quickly. Maybe just drop it? I'd personally also probably drop the introduction. (I think of Documetation/ as reference material with less of a need to tell a "story".) But, I could be wrong. --b.