From: Anand Jain <anand.jain@oracle.com>
To: dsterba@suse.cz, Satoru Takeuchi <takeuchi_satoru@jp.fujitsu.com>,
linux-btrfs@vger.kernel.org, clm@fb.com
Subject: Re: [PATCH] Documentation: btrfs: remove usage specific information
Date: Thu, 10 Mar 2016 09:17:49 +0800 [thread overview]
Message-ID: <56E0CB3D.2030400@oracle.com> (raw)
In-Reply-To: <20160309171126.GB18908@suse.cz>
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
next prev parent reply other threads:[~2016-03-10 1:17 UTC|newest]
Thread overview: 6+ messages / expand[flat|nested] mbox.gz Atom feed top
2016-03-08 17:04 [PATCH] Documentation: btrfs: remove usage specific information David Sterba
2016-03-09 1:26 ` Satoru Takeuchi
2016-03-09 17:11 ` David Sterba
2016-03-10 1:17 ` Anand Jain [this message]
2016-03-10 12:58 ` David Sterba
2016-03-11 6:06 ` Anand Jain
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=56E0CB3D.2030400@oracle.com \
--to=anand.jain@oracle.com \
--cc=clm@fb.com \
--cc=dsterba@suse.cz \
--cc=linux-btrfs@vger.kernel.org \
--cc=takeuchi_satoru@jp.fujitsu.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.