On 20/2/18 00:11, Mauro Carvalho Chehab wrote:
> - Add a SPDX header;
> - Use copyright symbol;
> - Adjust document title;
> - Some whitespace fixes and new line breaks;
> - Mark literal blocks as such;
> - Add table markups;
> - Add it to filesystems/index.rst.
>
> Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@xxxxxxxxxx>
> ---
> .../filesystems/{dlmfs.txt => dlmfs.rst} | 28 +++++++++++++------
> Documentation/filesystems/index.rst | 1 +
> 2 files changed, 20 insertions(+), 9 deletions(-)
> rename Documentation/filesystems/{dlmfs.txt => dlmfs.rst} (86%)
>
> diff --git a/Documentation/filesystems/dlmfs.txt b/Documentation/filesystems/dlmfs.rst
> similarity index 86%
> rename from Documentation/filesystems/dlmfs.txt
> rename to Documentation/filesystems/dlmfs.rst
> index fcf4d509d118..68daaa7facf9 100644
> --- a/Documentation/filesystems/dlmfs.txt
> +++ b/Documentation/filesystems/dlmfs.rst
> @@ -1,20 +1,25 @@
> -dlmfs
> -==================
> +.. SPDX-License-Identifier: GPL-2.0
> +.. include:: <isonum.txt>
> +
> +=====
> +DLMFS
> +=====
> +
> A minimal DLM userspace interface implemented via a virtual file
> system.
>
> dlmfs is built with OCFS2 as it requires most of its infrastructure.
>
> -Project web page: http://ocfs2.wiki.kernel.org
> -Tools web page: https://github.com/markfasheh/ocfs2-tools
> -OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/
> +:Project web page: http://ocfs2.wiki.kernel.org
> +:Tools web page: https://github.com/markfasheh/ocfs2-tools
> +:OCFS2 mailing lists: http://oss.oracle.com/projects/ocfs2/mailman/
>
> All code copyright 2005 Oracle except when otherwise noted.
>
> -CREDITS
> +Credits
> =======
>
> -Some code taken from ramfs which is Copyright (C) 2000 Linus Torvalds
> +Some code taken from ramfs which is Copyright |copy| 2000 Linus Torvalds
> and Transmeta Corp.
>
> Mark Fasheh <mark.fasheh@xxxxxxxxxx>
> @@ -96,14 +101,19 @@ operation. If the lock succeeds, you'll get an fd.
> open(2) with O_CREAT to ensure the resource inode is created - dlmfs does
> not automatically create inodes for existing lock resources.
>
> +============ ===========================
> Open Flag Lock Request Type
> ---------- -----------------
Better to remove the above line.
> +============ ===========================
> O_RDONLY Shared Read
> O_RDWR Exclusive
> +============ ===========================
>
> +
> +============ ===========================
> Open Flag Resulting Locking Behavior
> ---------- --------------------------
Ditto.
> +============ ===========================
> O_NONBLOCK Trylock operation
> +============ ===========================
>
> You must provide exactly one of O_RDONLY or O_RDWR.
>
> diff --git a/Documentation/filesystems/index.rst b/Documentation/filesystems/index.rst
> index ab3b656bbe60..c6885c7ef781 100644
> --- a/Documentation/filesystems/index.rst
> +++ b/Documentation/filesystems/index.rst
> @@ -58,6 +58,7 @@ Documentation for filesystem implementations.
> ceph
> cramfs
> debugfs
> + dlmfs
> fuse
> overlayfs
> virtiofs
>
