Page MenuHomeFreeBSD

Update ext2fs(5) man page
ClosedPublic

Authored by pfg on Dec 6 2018, 1:10 AM.
Tags
None
Referenced Files
F103211064: D18445.diff
Fri, Nov 22, 6:56 AM
F103193307: D18445.id.diff
Fri, Nov 22, 2:41 AM
F103173695: D18445.id51636.diff
Thu, Nov 21, 9:30 PM
Unknown Object (File)
Mon, Nov 18, 3:44 AM
Unknown Object (File)
Mon, Nov 18, 3:05 AM
Unknown Object (File)
Mon, Nov 18, 2:12 AM
Unknown Object (File)
Sun, Nov 17, 8:00 PM
Unknown Object (File)
Sun, Nov 17, 4:53 PM
Subscribers

Details

Reviewers
0mp
bcr
Group Reviewers
manpages
Commits
rS342632: ext2fs.5: Update the manpage.
Summary

There were some inaccuracies in the previous manpage, and it seemd like
a good chance to explain the current status.

Test Plan

Please review: I dont have that much experience with manpages.

Diff Detail

Repository
rS FreeBSD src repository - subversion
Lint
Lint Not Applicable
Unit
Tests Not Applicable

Event Timeline

Please create links for ext3fs.5 and ext4fs.5; in share/man/man5/Makefile, add these to the list:

MLINKS+= ext2fs.5 ext3fs.5
MLINKS+= ext2fs.5 ext4fs.5

For that matter, maybe also add these? People might not know to add the "fs":

MLINKS+= ext2fs.5 ext2.5
MLINKS+= ext2fs.5 ext3.5
MLINKS+= ext2fs.5 ext4.5

Add a soflink for ext4fs. I am not currently adding a link to ext3 since
linux doesn't seem to carry it anymore and we don't support the main
feature it brought: journalling.

Please create links for ext3fs.5 and ext4fs.5; in share/man/man5/Makefile, add these to the list:

MLINKS+= ext2fs.5 ext3fs.5
MLINKS+= ext2fs.5 ext4fs.5

I agree the ext4fs link is useful. the ext3fs is probably not

For that matter, maybe also add these? People might not know to add the "fs":

MLINKS+= ext2fs.5 ext2.5
MLINKS+= ext2fs.5 ext3.5
MLINKS+= ext2fs.5 ext4.5

I think it may be interesting to keep that ext2 and ext4 namespaces available to eventually document the formats and perhaps the feature flags.

0mp requested changes to this revision.Dec 6 2018, 8:45 AM
0mp added a subscriber: 0mp.
0mp added inline comments.
share/man/man5/ext2fs.5
88 ↗(On Diff #51636)

typo: missing space after Fx

Try running mandoc -Tlint and igor to see any other errors.

This revision now requires changes to proceed.Dec 6 2018, 8:45 AM
bcr added a subscriber: bcr.

Approved!

This revision was not accepted when it landed; it landed in state Needs Review.Dec 30 2018, 7:45 PM
Closed by commit rS342632: ext2fs.5: Update the manpage. (authored by pfg). · Explain Why
This revision was automatically updated to reflect the committed changes.