[PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists

Bagas Sanjaya posted 5 patches 5 days, 20 hours ago
[PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists
Posted by Bagas Sanjaya 5 days, 20 hours ago
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>
---
 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
-- 
An old man doll... just what I always wanted! - Clara
Re: [PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists
Posted by Randy Dunlap 4 days, 22 hours ago

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
Re: [PATCH 1/5] Documentation: afs: Use proper bullet for bullet lists
Posted by David Howells 5 days, 14 hours ago
Bagas Sanjaya <bagasdotme@gmail.com> 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>

Acked-by: David Howells <dhowells@redhat.com>