From: Randy Dunlap <rdunlap@infradead.org>
To: Bagas Sanjaya <bagasdotme@gmail.com>,
Linux Kernel Mailing List <linux-kernel@vger.kernel.org>,
Linux Documentation <linux-doc@vger.kernel.org>,
Linux AFS <linux-afs@lists.infradead.org>,
Linux Filesystems Development <linux-fsdevel@vger.kernel.org>
Cc: David Howells <dhowells@redhat.com>,
Marc Dionne <marc.dionne@auristor.com>,
Jonathan Corbet <corbet@lwn.net>,
Damien Le Moal <dlemoal@kernel.org>,
Naohiro Aota <naohiro.aota@wdc.com>,
Johannes Thumshirn <jth@kernel.org>,
Andrew Morton <akpm@linux-foundation.org>,
Dan Williams <dan.j.williams@intel.com>,
Gerald Schaefer <gerald.schaefer@linux.ibm.com>,
Daniel Palmer <daniel.palmer@sony.com>
Subject: Re: [PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists
Date: Wed, 26 Nov 2025 16:43:21 -0800 [thread overview]
Message-ID: <a135eb8a-f50d-4033-a5c0-9257c152162e@infradead.org> (raw)
In-Reply-To: <20251126025511.25188-2-bagasdotme@gmail.com>
On 11/25/25 6:55 PM, Bagas Sanjaya wrote:
> The lists use an asterisk in parentheses (``(*)``) as the bullet marker,
> which isn't recognized by Sphinx as the proper bullet. Replace with just
> an asterisk.
>
> Signed-off-by: Bagas Sanjaya <bagasdotme@gmail.com>
Reviewed-by: Randy Dunlap <rdunlap@infradead.org>
Tested-by: Randy Dunlap <rdunlap@infradead.org>
> ---
> Documentation/filesystems/afs.rst | 21 +++++++++------------
> 1 file changed, 9 insertions(+), 12 deletions(-)
>
> diff --git a/Documentation/filesystems/afs.rst b/Documentation/filesystems/afs.rst
> index f15ba388bbde79..6135d64ada6372 100644
> --- a/Documentation/filesystems/afs.rst
> +++ b/Documentation/filesystems/afs.rst
> @@ -23,17 +23,14 @@ This filesystem provides a fairly simple secure AFS filesystem driver. It is
> under development and does not yet provide the full feature set. The features
> it does support include:
>
> - (*) Security (currently only AFS kaserver and KerberosIV tickets).
> -
> - (*) File reading and writing.
> -
> - (*) Automounting.
> -
> - (*) Local caching (via fscache).
> + * Security (currently only AFS kaserver and KerberosIV tickets).
> + * File reading and writing.
> + * Automounting.
> + * Local caching (via fscache).
>
> It does not yet support the following AFS features:
>
> - (*) pioctl() system call.
> + * pioctl() system call.
>
>
> Compilation
> @@ -146,15 +143,15 @@ Proc Filesystem
>
> The AFS module creates a "/proc/fs/afs/" directory and populates it:
>
> - (*) A "cells" file that lists cells currently known to the afs module and
> - their usage counts::
> + * A "cells" file that lists cells currently known to the afs module and
> + their usage counts::
>
> [root@andromeda ~]# cat /proc/fs/afs/cells
> USE NAME
> 3 cambridge.redhat.com
>
> - (*) A directory per cell that contains files that list volume location
> - servers, volumes, and active servers known within that cell::
> + * A directory per cell that contains files that list volume location
> + servers, volumes, and active servers known within that cell::
>
> [root@andromeda ~]# cat /proc/fs/afs/cambridge.redhat.com/servers
> USE ADDR STATE
--
~Randy
next prev parent reply other threads:[~2025-11-27 0:43 UTC|newest]
Thread overview: 14+ messages / expand[flat|nested] mbox.gz Atom feed top
2025-11-26 2:55 [PATCH 0/5] Assorted filesystem docs formatting Bagas Sanjaya
2025-11-26 2:55 ` [PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists Bagas Sanjaya
2025-11-27 0:43 ` Randy Dunlap [this message]
2025-11-26 2:55 ` [PATCH 2/5] Documentation: dax: Coalesce "See also" filesystem pointers into list Bagas Sanjaya
2025-11-27 0:43 ` Randy Dunlap
2025-11-26 2:55 ` [PATCH 3/5] Documentation: dax: Demote "Enabling DAX on xfs and ext4" subsections Bagas Sanjaya
2025-11-27 0:43 ` Randy Dunlap
2025-11-26 2:55 ` [PATCH 4/5] Documentation: zonefs: Separate mount options list Bagas Sanjaya
2025-11-26 4:17 ` Damien Le Moal
2025-11-27 0:43 ` Randy Dunlap
2025-11-26 2:55 ` [PATCH 5/5] Documentation: zonefs: Format error processing table Bagas Sanjaya
2025-11-26 4:17 ` Damien Le Moal
2025-11-27 0:44 ` Randy Dunlap
2025-11-26 9:28 ` [PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists David Howells
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=a135eb8a-f50d-4033-a5c0-9257c152162e@infradead.org \
--to=rdunlap@infradead.org \
--cc=akpm@linux-foundation.org \
--cc=bagasdotme@gmail.com \
--cc=corbet@lwn.net \
--cc=dan.j.williams@intel.com \
--cc=daniel.palmer@sony.com \
--cc=dhowells@redhat.com \
--cc=dlemoal@kernel.org \
--cc=gerald.schaefer@linux.ibm.com \
--cc=jth@kernel.org \
--cc=linux-afs@lists.infradead.org \
--cc=linux-doc@vger.kernel.org \
--cc=linux-fsdevel@vger.kernel.org \
--cc=linux-kernel@vger.kernel.org \
--cc=marc.dionne@auristor.com \
--cc=naohiro.aota@wdc.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 a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).