Re: Add sub-topic on 'exFAT' in man mount

[Bagas Sanjaya <bagasdotme@gmail.com>]

[-- Attachment #1: Type: text/plain, Size: 3038 bytes --]

On Tue, Dec 05, 2023 at 01:49:42AM -0600, Seamus de Mora wrote:
> On Mon, Nov 27, 2023 at 4:43 PM Seamus de Mora <seamusdemora@gmail.com> wrote:
> >
> > On Sun, Nov 26, 2023 at 5:59 PM Namjae Jeon <linkinjeon@kernel.org> wrote:
> > >
> > > 2023-11-21 15:55 GMT+09:00, Bagas Sanjaya <bagasdotme@gmail.com>:
> > > > On Mon, Nov 20, 2023 at 04:55:18PM -0600, Seamus de Mora wrote:
> > > >> I'd like to volunteer to add some information to the mount manual.
> > > >>
> > > >> I'm told that exFAT was added to the kernel about 4 years ago, but
> > > >> last I checked, there was nothing about it in man mount.  I feel this
> > > >> could be addressed best by adding a sub-topic on exFAT under the topic
> > > >> `FILESYSTEM-SPECIFIC MOUNT OPTIONS`.
> > > >>
> > > >> If my application is of interest, please let me know what steps I need
> > > >> to take - or how to approach this task.
> > > >>
> > > >
> > > > I'm adding from Alejandro's reply.
> > > >
> > > > You can start reading the source in fs/exfat in linux.git tree [1].
> > > > Then you can write the documentation for exfat in Documentation/exfat.rst
> > > > (currently doesn't exist yet), at the same time of your manpage
> > > > contribution.
> > > >
> > > > Cc'ing exfat maintainers for better treatment.
> > > Thanks Bagas for forwarding this to us!
> > >
> > > Hi Seamus,
> > >
> > > Some of mount options are same with fatfs's ones. You can refer the
> > > descriptions of fatfs
> > > documentation(Documentation/filesystems/vfat.rst).
> > > If you have any questions about other options or documentation for
> > > exfat, please give an email me.
> > >
> > > Thanks!
> > > >
> > > > Thanks.
> > > >
> > > > [1]:
> > > > https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git/tree/fs/exfat
> >
> > Thanks for the offer Namjae; I'm sure I'll take you up on that when I
> > get ready to actually produce something. For now, I am reading and
> > trying to get myself up to speed to tackle this. So far, the going has
> > been a bit slow as I have a couple of commitments I need to finish.
> 
> I've read a bit about the mechanics & markup for creating/editing man
> pages. Now all I need is something useful to say :)
> 
> In that regard, I **guess** the best place to look for the details I
> need is in the source code. Without access to the author or
> maintainers, I don't see how else to get at the details needed for a
> decent piece of documentation. I think that is what Bagas (?)
> suggested, but how/where do I find "fs/exfat in linux.git tree" ??

That's simple. First, you need to clone Linus's tree:

```
$ git clone https://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git linux-kernel
$ cd linux-kernel/
```

You can now browse exfat sources in fs/exfat.

To get maintainers list that you should Cc: when submitting patches, do
from cloned repo:

```
$ scripts/get_maintainer.pl fs/exfat/
```

Thanks.

-- 
An old man doll... just what I always wanted! - Clara

[-- Attachment #2: signature.asc --]
[-- Type: application/pgp-signature, Size: 228 bytes --]