Received: by 2002:a25:8b91:0:0:0:0:0 with SMTP id j17csp2163747ybl; Thu, 19 Dec 2019 09:03:31 -0800 (PST) X-Google-Smtp-Source: APXvYqyGpTB3GWXypU0BfbYNMy/0QJpx1bqMa0TgNRsGap1xw2M+eEeIFCZnmyF2DZI3XRLWqfs2 X-Received: by 2002:a05:6808:98d:: with SMTP id a13mr2661947oic.7.1576775011168; Thu, 19 Dec 2019 09:03:31 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1576775011; cv=none; d=google.com; s=arc-20160816; b=m9vpT4Z8jwHdcnz+ByiFS9ccYUxyJ+n9AIjmqTtbNnxaxDkllXmqI/egwF60V6kcSg sxelhDh/heQ049Hp7Hoz1Tzs/djD69NVQrxthnbr5DZ0TM4rhzmWoH92B+nt4cAOxkLY VJy5ccDepkuUNb2Pq16pkNjhd88N2H7YM8mP/BTXIlZGQy5kP+dWOL4ZX7mLiZLsJ+u9 csOH5JZqaSR46DdUuQvL4MVMv0+JMVgva9ypp6PwPTqr0lY07+qEkQ2cd3MR9QCeRFFP KbMp6S4nX6fG7547NkUyc5cZHzOw8uZSvx657eEqH0VFXjP82kREVjfotPSMj/BBJNCC BIsw== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:sender:content-language :content-transfer-encoding:in-reply-to:mime-version:user-agent:date :message-id:from:references:cc:to:subject:dkim-signature; bh=QmZHBv3VTqpxW/+akPp/0Up5TSxjNx51R37o6VFJo/8=; b=MlzYbBhkRs3hBXWprhsGEItPhGlJXpPv6vgJAHeXKmwz6eTqV8Tb4ssJYKZp9PIJnp fVVYHKbPICfqBSRzTWEPhMM7barSuf0zB18u9xLW2D3wxJLDl9jVuNMXOHTkcpNzdC6g 1ZUtBSj4WtwVjEMyZl9LhQW4kxwUp7jsS8EvkQuZGFRltnw5dd89ogtRyo8xJIFclh25 B7CljexDQ9HyMgLm0p9krpq92w+OyfKhPYFY1TMCjuyV9I7SZSo1vzv+tVpPMEFqY22n n10WrxunXD/nHsB+zSjW2JlAFNiM6zEib8pkE81f6BG2vKIgECfqHoUi2PJ3mbBc0Rpw OTNw== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@gmail.com header.s=20161025 header.b=Rxe+ElQQ; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Return-Path: Received: from vger.kernel.org (vger.kernel.org. [209.132.180.67]) by mx.google.com with ESMTP id v20si3357098oia.159.2019.12.19.09.03.08; Thu, 19 Dec 2019 09:03:31 -0800 (PST) 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=@gmail.com header.s=20161025 header.b=Rxe+ElQQ; 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; dmarc=pass (p=NONE sp=QUARANTINE dis=NONE) header.from=gmail.com Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1726996AbfLSRCF (ORCPT + 99 others); Thu, 19 Dec 2019 12:02:05 -0500 Received: from mail-pg1-f193.google.com ([209.85.215.193]:39463 "EHLO mail-pg1-f193.google.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1726760AbfLSRCE (ORCPT ); Thu, 19 Dec 2019 12:02:04 -0500 Received: by mail-pg1-f193.google.com with SMTP id b137so3432298pga.6; Thu, 19 Dec 2019 09:02:04 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=subject:to:cc:references:from:message-id:date:user-agent :mime-version:in-reply-to:content-transfer-encoding:content-language; bh=QmZHBv3VTqpxW/+akPp/0Up5TSxjNx51R37o6VFJo/8=; b=Rxe+ElQQdLHhw9LCWF1MT+SEbUVbP6UBVHaNYlY8Y655lU5jeO2JXQ4vuSKHpar2Bx evQIWX3uKVu1nLpE4Jpk4DbtISWARtGqBhJBxoQdPqsuP2KxYFNEhRiR0qcKOs4mXRjM YESOA+egwGyNcxg9KwICjh6RlwcuqTtPs32YF4w529lg8+J1FsqORTNH0Crom2oKc2nO 2yWTE8Q54pbpzcrogjN7XTiM7UecKzIWaZttpMXY2M0c32z6CYiYTol+CkQNjEIx9wc1 +aEOGC8noMRzk9kkCrgW6dSsIJ4GCYMGwVvQc01ronCGari5RXeHqUw7o9VTlRs1PWtA sv5Q== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:subject:to:cc:references:from:message-id:date :user-agent:mime-version:in-reply-to:content-transfer-encoding :content-language; bh=QmZHBv3VTqpxW/+akPp/0Up5TSxjNx51R37o6VFJo/8=; b=BxVoafVSWrxDH7drp6eYwN8zaMRgibT/17YhuvDMQhOJgyafTYQdGHHnGEZzpV12av asbU+orKXLIQGD4tZARBSZyG9QZ5tzURRdIcUtMblbHSwKnpqT2m/w2/MtnurVQUMEZx 6ocVkSXC/S6rYll152lI54grt6cHSD13HkS/Vz8e+nabxz3CidYksBjFWe9cO4iJfId4 OyYAkS/19wtSJTX4VvvxTZ4iHAK3l+sVo5CmDZ/IDfoxOY4vd0/EHXOdKiquxg529R1h 5Qs+RmzE+72+PNGD5U7J+zWdYHtiMglq+u3Sq3uJyOHmsSfbbmkxguMp8zpa0BXOhFO6 BuYg== X-Gm-Message-State: APjAAAVQUajvqh0xmQSrku59UJnwpBh2jAufO6Gr8XgV8JNrVUX5J1Nc WHwbfm+R0OglDEQTPAdNORqtFeXy5VM= X-Received: by 2002:a63:e042:: with SMTP id n2mr10338201pgj.308.1576774923465; Thu, 19 Dec 2019 09:02:03 -0800 (PST) Received: from ?IPv6:2804:14d:72b1:8920:a2ce:f815:f14d:bfac? ([2804:14d:72b1:8920:a2ce:f815:f14d:bfac]) by smtp.gmail.com with ESMTPSA id v4sm9038094pgo.63.2019.12.19.09.02.00 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Thu, 19 Dec 2019 09:02:03 -0800 (PST) Subject: Re: [PATCH v2] Documentation: filesystems: convert fuse to RST To: Jonathan Corbet Cc: miklos@szeredi.hu, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, skhan@linuxfoundation.org, linux-kernel-mentees@lists.linuxfoundation.org, linux-fsdevel@vger.kernel.org References: <20191120192655.33709-1-dwlsalmeida@gmail.com> <20191219095356.4a3ad965@lwn.net> From: "Daniel W. S. Almeida" Message-ID: <2eba770a-f566-d704-35b3-7c00995bbc76@gmail.com> Date: Thu, 19 Dec 2019 14:01:58 -0300 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.3.0 MIME-Version: 1.0 In-Reply-To: <20191219095356.4a3ad965@lwn.net> Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 7bit Content-Language: en-US Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org Hey Jonathan! I hope you're doing fine. > So I have to confess that I've lost track of where we stand with this. > Holidays and moving house will do that...apologies. In any case, I have a > couple of additional comments. Actually Miklos replied. While he did not comment on the amount of markup used, he had this to add: > Hmm, most of this document is*not* an admin-guide at all. The only > sections that really belong in that category are "What is FUSE?" and > "Control filesystem" and maybe some of the definitions as well. The > mount options for fuse filesystem are not generally usable for > actually performing a mount, most of those are actually internal > details of the filesystem implementation. > > So I suggest leaving this file under Documentation/filesystems/ for > now and later work towards splitting out the admin-guide parts into a > separate document. Please let me know what you think? I can do another pass to clean this up and remove more markup, no problem! -Daniel.