From: "Tobin C. Harding" <tobin@kernel.org>
To: Jonathan Corbet <corbet@lwn.net>
Cc: "Tobin C. Harding" <tobin@kernel.org>,
Al Viro <viro@zeniv.linux.org.uk>,
Mauro Carvalho Chehab <mchehab@s-opensource.com>,
Neil Brown <neilb@suse.com>, Randy Dunlap <rdunlap@infradead.org>,
linux-doc@vger.kernel.org, linux-fsdevel@vger.kernel.org,
linux-kernel@vger.kernel.org
Subject: [PATCH v4 4/9] docs: filesystems: vfs: Use uniform spacing around headings
Date: Wed, 15 May 2019 10:29:08 +1000 [thread overview]
Message-ID: <20190515002913.12586-5-tobin@kernel.org> (raw)
In-Reply-To: <20190515002913.12586-1-tobin@kernel.org>
Currently spacing before and after headings is non-uniform. Use two
blank lines before a heading and one after the heading.
Use uniform spacing around headings.
Tested-by: Randy Dunlap <rdunlap@infradead.org>
Signed-off-by: Tobin C. Harding <tobin@kernel.org>
---
Documentation/filesystems/vfs.txt | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/Documentation/filesystems/vfs.txt b/Documentation/filesystems/vfs.txt
index 14839bc84d38..ed12d28bda62 100644
--- a/Documentation/filesystems/vfs.txt
+++ b/Documentation/filesystems/vfs.txt
@@ -321,6 +321,7 @@ Whoever sets up the inode is responsible for filling in the "i_op"
field. This is a pointer to a "struct inode_operations" which describes
the methods that can be performed on individual inodes.
+
struct xattr_handlers
---------------------
@@ -507,6 +508,7 @@ otherwise noted.
tmpfile: called in the end of O_TMPFILE open(). Optional, equivalent to
atomically creating, opening and unlinking a file in given directory.
+
The Address Space Object
========================
@@ -580,8 +582,10 @@ and the constraints under which it is being done. It is also used to
return information back to the caller about the result of a writepage or
writepages request.
+
Handling errors during writeback
--------------------------------
+
Most applications that do buffered I/O will periodically call a file
synchronization call (fsync, fdatasync, msync or sync_file_range) to
ensure that data written has made it to the backing store. When there
@@ -612,6 +616,7 @@ file->fsync operation, they should call file_check_and_advance_wb_err to
ensure that the struct file's error cursor has advanced to the correct
point in the stream of errors emitted by the backing device(s).
+
struct address_space_operations
-------------------------------
@@ -1203,9 +1208,11 @@ manipulate dentries:
and the dentry is returned. The caller must use dput()
to free the dentry when it finishes using it.
+
Mount Options
=============
+
Parsing options
---------------
@@ -1220,6 +1227,7 @@ The <linux/parser.h> header defines an API that helps parse these
options. There are plenty of examples on how to use it in existing
filesystems.
+
Showing options
---------------
@@ -1241,6 +1249,7 @@ The underlying reason for the above rules is to make sure, that a mount
can be accurately replicated (e.g. umounting and mounting again) based
on the information found in /proc/mounts.
+
Resources
=========
--
2.21.0
next prev parent reply other threads:[~2019-05-15 0:31 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2019-05-15 0:29 [PATCH v4 0/9] docs: Convert VFS doc to RST Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 1/9] docs: filesystems: vfs: Remove space before tab Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 2/9] docs: filesystems: vfs: Use uniform space after period Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 3/9] docs: filesystems: vfs: Use 72 character column width Tobin C. Harding
2019-05-15 0:29 ` Tobin C. Harding [this message]
2019-05-15 0:29 ` [PATCH v4 5/9] docs: filesystems: vfs: Use correct initial heading Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 6/9] docs: filesystems: vfs: Use SPDX identifier Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 7/9] docs: filesystems: vfs: Fix pre-amble indentation Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 8/9] docs: filesystems: vfs: Convert spaces to tabs Tobin C. Harding
2019-05-15 0:29 ` [PATCH v4 9/9] docs: filesystems: vfs: Convert vfs.txt to RST Tobin C. Harding
2019-05-29 22:30 ` [PATCH v4 0/9] docs: Convert VFS doc " Jonathan Corbet
2019-05-30 6:01 ` Tobin C. Harding
2019-06-03 23:48 ` Tobin C. Harding
2019-06-04 0:06 ` Tobin C. Harding
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=20190515002913.12586-5-tobin@kernel.org \
--to=tobin@kernel.org \
--cc=corbet@lwn.net \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fsdevel@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=mchehab@s-opensource.com \
--cc=neilb@suse.com \
--cc=rdunlap@infradead.org \
--cc=viro@zeniv.linux.org.uk \
/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.