cap_fileargs.3: Comprehensive rewrite for improved clarity and accuracy

[kfv]

Extensively revised the manual page with clearer phrasing, better structure, and corrected grammar throughout. Also fixed multiple typos and improved overall readability of the documentation.

[kfv]

Cc: @oshogbo

[concussious]

I don't think this was the commit you intended to push?

[kfv]

How come?

[kfv]

By the way, I’m sorry if I forgot to thank you. It’s been a tough day, and I can’t even remember how I managed to handle the changes you requested.

[concussious]

How come?

The commits appear to be unchanged.

By the way, I’m sorry if I forgot to thank you.

Hey, likewise. Improvements to the manual excite me.

[kfv]

Whoops! I'll take a look in an hour. I might have missed something.

[kfv]

You were right, mate. Requested changes are now pushed. Please take a look and let me know if anything else is necessary to consider and apply.

[concussious]

When I make this type of commit, I usually will title it something like "cap_fileargs.3: Polish". This is a wonderful and necessary review and editorial pass, but a comprehensive rewrite is a different type of thing.

[bsdimp]

@asomers @markjdb @oshogbo Any final comments? Looks like there's a few unresolved comments still, but they look minor. @kfv Anything else?

[kfv]

Hi, apologies for the extended delay in addressing the requested changes. The past year has been personally and geopolitically challenging, and I appreciate your patience. I make sure to go through all the pending requests within the coming week at most. Thank you again for your understanding.

[kfv]

@bsdimp: Ready to ship.

[kfv]

Hey while you're here, .Sh LIBRARY is deprecated in the current version of mandoc. Can you remove it, and move the .Lb macro to the top of SYNOPSIS?

I didn't know, thanks! Done, mate.

[oshogbo]

I have committed it as 50dee972977a