From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1754133AbbL3DPL (ORCPT ); Tue, 29 Dec 2015 22:15:11 -0500 Received: from mail.linuxfoundation.org ([140.211.169.12]:55593 "EHLO mail.linuxfoundation.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752158AbbL3DPI (ORCPT ); Tue, 29 Dec 2015 22:15:08 -0500 Date: Tue, 29 Dec 2015 19:14:55 -0800 From: Andrew Morton To: "Gang He" Cc: , "Mark Fasheh" , , Subject: Re: [PATCH v3 0/4] Add online file check feature Message-Id: <20151229191455.562f5f42.akpm@linux-foundation.org> In-Reply-To: <5683B938020000F900023B48@relay2.provo.novell.com> References: <1451027779-6849-1-git-send-email-ghe@suse.com> <20151229134111.6e0817e4b540c1fdf42d0475@linux-foundation.org> <5683B938020000F900023B48@relay2.provo.novell.com> X-Mailer: Sylpheed 2.7.1 (GTK+ 2.18.9; x86_64-redhat-linux-gnu) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: linux-kernel-owner@vger.kernel.org List-ID: X-Mailing-List: linux-kernel@vger.kernel.org On Tue, 29 Dec 2015 20:00:08 -0700 "Gang He" wrote: > > This feature should be documented, please. That means all pseudo-file > > locations, all inputs, all outputs, expected behaviour etc etc. Enough > > info so that our users can usefully and fully use this feature in the > > minimum time. Documentation/filesystems/ocfs2.txt is the place for that. > I ever sent out a document which describes this feature, I will modify that document sightly since sysfs interfaces have been adjusted, > then send out to the list as a separated patch. Is it OK for you? Sounds good, thanks. The documentation is important because it permits reviewers to understand the proposed interfaces, which need to be nailed down before there's any point in looking at the implementation.