From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from userp1040.oracle.com ([156.151.31.81]:21778 "EHLO userp1040.oracle.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1754357AbcCJBR7 (ORCPT ); Wed, 9 Mar 2016 20:17:59 -0500 Subject: Re: [PATCH] Documentation: btrfs: remove usage specific information To: dsterba@suse.cz, Satoru Takeuchi , linux-btrfs@vger.kernel.org, clm@fb.com References: <1457456686-30474-1-git-send-email-dsterba@suse.com> <56DF7BDB.8000109@jp.fujitsu.com> <20160309171126.GB18908@suse.cz> From: Anand Jain Message-ID: <56E0CB3D.2030400@oracle.com> Date: Thu, 10 Mar 2016 09:17:49 +0800 MIME-Version: 1.0 In-Reply-To: <20160309171126.GB18908@suse.cz> Content-Type: text/plain; charset=windows-1252; format=flowed Sender: linux-btrfs-owner@vger.kernel.org List-ID: On 03/10/2016 01:11 AM, David Sterba wrote: > On Wed, Mar 09, 2016 at 10:26:51AM +0900, Satoru Takeuchi wrote: >>> +that maintains information about administration tasks, frequently asked >>> +questions, use cases, mount options, comprehensible changelogs, features, >>> +manual pages, source code repositories, contacts etc. >> >> About mount options, we also have "man 5 btrfs" and it's >> newer than wiki page's one. >> >> https://www.mail-archive.com/linux-btrfs%40vger.kernel.org/msg34545.html >> commit 26341f734d6d ("btrfs-progs: add mount options to btrfs-mount.5") >> >> Last update: >> - Btrfs wiki -> Mount options: Sep 19 2015 >> - btrfs-man5.asciidoc: Jan 11 2016 > > I'm consolidating the documentation to a single source if possible, at > the moment the wiki page for mount option still exists and lags behind > the manual page. Also the wiki page btrfs-mount hasn't been renamed to > btrfs-man5 and the contents. > > The conversion scripts are at https://github.com/kdave/btrfs-wiki > (/git2wiki) . They're not perfect and sometimes produces strange > artifacts, so this is where it gets stuck. > >> So, how about refer to "man 5 btrfs" from >> "Btrfs wiki -> Mount options -> List of options" >> and/or this document? > > I'd prefer to update the wiki. Which one would be the master copy ? So it will determine a process for the steady state production.. either update wiki and then - sync up to -> man or update man and then - sync up to -> wiki -Anand