Re: [PATCH V3 21/21] famfs_fuse: Add documentation

[Jonathan Cameron]

On Wed,  7 Jan 2026 09:33:30 -0600
John Groves <John@xxxxxxxxxx> wrote:

> Add Documentation/filesystems/famfs.rst and update MAINTAINERS
> 
> Reviewed-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Tested-by: Randy Dunlap <rdunlap@xxxxxxxxxxxxx>
> Signed-off-by: John Groves <john@xxxxxxxxxx>
> ---
>  Documentation/filesystems/famfs.rst | 142 ++++++++++++++++++++++++++++
>  Documentation/filesystems/index.rst |   1 +
>  MAINTAINERS                         |   1 +
>  3 files changed, 144 insertions(+)
>  create mode 100644 Documentation/filesystems/famfs.rst
> 
> diff --git a/Documentation/filesystems/famfs.rst b/Documentation/filesystems/famfs.rst
> new file mode 100644
> index 000000000000..0d3c9ba9b7a8
> --- /dev/null
> +++ b/Documentation/filesystems/famfs.rst

> +Principles of Operation
> +=======================
....
> +When an app accesses a data object in a famfs file, there is no page cache
> +involvement. The CPU cache is loaded directly from the shared memory. In
> +some use cases, this is an enormous reduction read amplification compared
> +to loading an entire page into the page cache.
> +
Trivial but this double blank line seems inconsistent.
I don't mind if it's one or two, but do the same everywhere.

> +
> +Famfs is Not a Conventional File System
> +---------------------------------------

Nice doc.

Reviewed-by: Jonathan Cameron <jonathan.cameron@xxxxxxxxxx>