Skip to contentSkip to conversation

fs(5) man page is out of date

DISCUSSION Jeff B 5 participants 11 messages May 18, 2010 – Jun 10, 2010 9 messages not in the archive Man-pages: manual pages for Linux -- Sections 2, 3, 4, 5, and 7

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

#2 lore raw

Hi!

Quoted 3 lines · Jeff B

Just FYI the fs(5) man page is woefully out of date. The version on your website at http://www.kernel.org/doc/man-pages/online/pages/man5/fs.5.html,
dated 2007-12-14, does not mention EXT4 and NTFS, among other things.

Patches are welcome.

Kind regards,

Petr "Pasky" Baudis
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

author
#4 lore raw
Quoted 7 lines · Petr Baudis

Hi!

On Tue, May 18, 2010 at 12:05:36PM -0400, Jeff B wrote:

Quoted 9 lines
Quoted 4 lines

Just FYI the fs(5) man page is woefully out of date. The version on your website at http://www.kernel.org/doc/man-pages/online/pages/man5/fs.5.html,
dated 2007-12-14, does not mention EXT4 and NTFS, among other things.

Patches are welcome.

Kind regards,
Petr "Pasky" Baudis

OK, you want a patch, you get a patch. This is against the latest
version, man-pages-3.24, of the filesystems.5 man page. I added references to ext4 and ntfs by condensing information I took from the Wikipedia pages for those file systems.

I hope it is acceptable that I attached the patch in diff -u format; pasting it into this eMail was converting tabs into spaces.

Quoted 1 line

cksum filesystems.5.2010-05-19.new.patch.u

55916840 1656 filesystems.5.2010-05-19.new.patch.u

Jeff Barry

filesystems.5.2010-05-19.new renamed from filesystems.5.man-pages-3.24.ori +11 -3
@@ -22,12 +22,14 @@
 .\"
 .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS.
 .\"
-.TH FILESYSTEMS 5 2007-12-14 "Linux" "Linux Programmer's Manual"
+.\" 2010-05-19 Jeff Barry, Added ext4 and ntfs.
+.\"
+.TH FILESYSTEMS 5 2010-05-19 "Linux" "Linux Programmer's Manual"
 .nh
 .SH NAME
-filesystems \- Linux file-system types: minix, ext, ext2, ext3, Reiserfs,
+filesystems \- Linux file-system types: minix, ext, ext2, ext3, ext4, Reiserfs,
 XFS, JFS, xia, msdos,
-umsdos, vfat, proc, nfs, iso9660, hpfs, sysv, smb, ncpfs
+umsdos, vfat, ntfs, proc, nfs, iso9660, hpfs, sysv, smb, ncpfs
 .SH DESCRIPTION
 When, as is customary, the
 .B proc
@@ -77,6 +79,9 @@
 It is easy to
 switch back and forth between ext2 and ext3.
 .TP
+.B ext4
+is a set of upgrades to ext3 including substantial performance and reliability enhancements, plus huge increases in volume, file, and directory size limits.
+.TP
 .B Reiserfs
 is a journaling file system, designed by Hans Reiser,
 that was integrated into Linux in kernel 2.4.1.
@@ -116,6 +121,9 @@
 is an extended DOS file system used by Microsoft Windows95 and Windows NT.
 VFAT adds the capability to use long filenames under the MSDOS file system.
 .TP
+.B ntfs
+replaces Microsoft Window's *FAT* file systems (eg VFAT, FAT32).  It has reliability, performance, and space utilization enhancements plus features like ACLs, journaling, encryption, etc.
+.TP
 .B proc
 is a pseudo file system which is used as an interface to kernel data
 structures rather than reading and interpreting

A message that is not in the archive (sent off-list or not yet received): [email protected]

#6 lore raw
Quoted 19 lines · Jeff B
Quoted 13 lines · Petr Baudis

Hi!

Quoted 3 lines · Jeff B

Just FYI the fs(5) man page is woefully out of date. The version on your website at http://www.kernel.org/doc/man-pages/online/pages/man5/fs.5.html,
dated 2007-12-14, does not mention EXT4 and NTFS, among other things.

Patches are welcome.

Kind regards,
Petr "Pasky" Baudis

OK, you want a patch, you get a patch. This is against the latest
version, man-pages-3.24, of the filesystems.5 man page. I added references to ext4 and ntfs by condensing information I took from the Wikipedia pages for those file systems.

Quoted 5 lines

I hope it is acceptable that I attached the patch in diff -u format; pasting it into this eMail was converting tabs into spaces.

Quoted 1 line

cksum filesystems.5.2010-05-19.new.patch.u

55916840 1656 filesystems.5.2010-05-19.new.patch.u

Thanks! I hope mtk will be able to apply it - one thing that is essential is that you sign off your patch, confirming that you are the copyright holder and release your changes under the appropriate licence; sending a

line will do.

(It would be also nice to get a short subject + commit text in the mail, but mtk or me can also supply one in case you don't.)

filesystems.5.2010-05-19.new line 29

Quoted 12 lines
filesystems.5.2010-05-19.new renamed from filesystems.5.man-pages-3.24.ori +3 -1
@@ -22,12 +22,14 @@
 .\"
 .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS.
 .\"
-.TH FILESYSTEMS 5 2007-12-14 "Linux" "Linux Programmer's Manual"
+.\" 2010-05-19 Jeff Barry, Added ext4 and ntfs.
+.\"
+.TH FILESYSTEMS 5 2010-05-19 "Linux" "Linux Programmer's Manual"
 .nh
 .SH NAME

FYI, we have stopped adding change entries in the file headers.

Signature · 7 lines
				Petr "Pasky" Baudis
When I feel like exercising, I just lie down until the feeling
goes away.  -- xed_over
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

author
#8 lore raw
Quoted 3 lines · Petr Baudis

Thanks! I hope mtk will be able to apply it -

Who or what is "mtk"?

Quoted 9 lines

one thing that is
essential is that you sign off your patch, confirming that you are the copyright holder and release your changes under the appropriate licence; sending a

line will do.

Yes, I made the changes, and the world is welcomed to them.

Quoted 3 lines

(It would be also nice to get a short subject + commit text in the mail, but mtk or me can also supply one in case you don't.)

-m "Added references to ext4 and ntfs file systems."

Quoted 2 lines

FYI, we have stopped adding change entries in the file headers.

You mean I don't get to have my name embedded in a man page
source file forever? :-)

Peace,
Jeff Barry
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): [email protected]

#10 lore raw
Quoted 4 lines · On Wednesday 19 May 2010 16:40:29 Jeff B wrote:
Quoted 2 lines · Petr Baudis

Thanks! I hope mtk will be able to apply it -

Who or what is "mtk"?

he is the man pages maintainer

please dont bcc the mailing lists. it screws things up. -mike

A message that is not in the archive (sent off-list or not yet received): 201005191823.54159.vapier-aBrp7R+bbdUdnm+yROfE0A@public.gmane.org

#12 lore raw
Quoted 9 lines · Mike Frysinger
Quoted 4 lines · On Wednesday 19 May 2010 16:40:29 Jeff B wrote:
Quoted 2 lines · Petr Baudis

Thanks! I hope mtk will be able to apply it -

Who or what is "mtk"?

he is the man pages maintainer

please dont bcc the mailing lists.  it screws things up.

Yep. Please don't do that.

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): AANLkTinDuG9vI4_l7prRc54FUiapH-Vq015OtzBtgAkW-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org

#14 lore raw
Quoted 5 lines · Michael Kerrisk
Quoted 4 lines · Mike Frysinger
Quoted 3 lines · On Wednesday 19 May 2010 16:40:29 Jeff B wrote:
Quoted 2 lines · Petr Baudis

Thanks! I hope mtk will be able to apply it -

Quoted 7 lines
Quoted 5 lines
Quoted 1 line

Who or what is "mtk"?

he is the man pages maintainer

please dont bcc the mailing lists.  it screws things up.

Yep. Please don't do that.

That was my fault; Jeff B replied only to me in private (apparently by mistake) so I just bounced off the reply to the mailing list as well, instead of forwarding it.

Petr "Pasky" Baudis
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

#15 lore raw
In reply to a message not in the archive

Hi Jeff,

Quoted 20 lines · Jeff B
Quoted 14 lines · Petr Baudis

Hi!

Quoted 6 lines · Jeff B

Just FYI the fs(5) man page is woefully out of date.  The version on your website at
http://www.kernel.org/doc/man-pages/online/pages/man5/fs.5.html,
dated 2007-12-14, does not mention EXT4 and NTFS, among other things.

Quoted 5 lines

  Patches are welcome.

  Kind regards,
                               Petr "Pasky" Baudis

Quoted 7 lines

OK, you want a patch, you get a patch.   This is against the latest version, man-pages-3.24, of the filesystems.5 man page.  I added references to ext4 and ntfs by condensing information I took from the Wikipedia pages for those file systems.

I hope it is acceptable that I attached the patch in diff -u format; pasting it into this eMail was converting tabs into spaces.

Inline is best. There's usually a way to do this in most mail clients (though not always obvious).

Thanks for the patch! I tweaked it a little, and applied the form below.

The change will be in man-pages-3.25.

Cheers,

Michael

man5/filesystems.5 +14 -3
@@ -22,12 +22,12 @@
 .\"
 .\" 2007-12-14 mtk Added Reiserfs, XFS, JFS.
 .\"
-.TH FILESYSTEMS 5 2007-12-14 "Linux" "Linux Programmer's Manual"
+.TH FILESYSTEMS 5 2010-05-24 "Linux" "Linux Programmer's Manual"
 .nh
 .SH NAME
-filesystems \- Linux file-system types: minix, ext, ext2, ext3, Reiserfs,
+filesystems \- Linux file-system types: minix, ext, ext2, ext3, ext4, Reiserfs,
 XFS, JFS, xia, msdos,
-umsdos, vfat, proc, nfs, iso9660, hpfs, sysv, smb, ncpfs
+umsdos, vfat, ntfs, proc, nfs, iso9660, hpfs, sysv, smb, ncpfs
 .SH DESCRIPTION
 When, as is customary, the
 .B proc
@@ -77,6 +77,12 @@ is a journaling version of the ext2 file system.
 It is easy to
 switch back and forth between ext2 and ext3.
 .TP
+.B ext4
+is a set of upgrades to ext3 including substantial performance and
+reliability enhancements,
+plus large increases in volume, file, and directory size limits.
+.TP
+ .B Reiserfs
 .B Reiserfs
 is a journaling file system, designed by Hans Reiser,
 that was integrated into Linux in kernel 2.4.1.
@@ -116,6 +122,11 @@ sacrificing compatibility with DOS.
 is an extended DOS file system used by Microsoft Windows95 and Windows NT.
 VFAT adds the capability to use long filenames under the MSDOS file system.
 .TP
+.B ntfs
+replaces Microsoft Window's FAT file systems (VFAT, FAT32).
+It has reliability, performance, and space-utilization enhancements
+plus features like ACLs, journaling, encryption, and so on.
+.TP
 .B proc
 is a pseudo file system which is used as an interface to kernel data
 structures rather than reading and interpreting
Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): AANLkTilvJe1XxwAFtKOu8Z85nz3xutMb-sCTMGtiRnzS-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org

#17 lore raw

On 2010/5/24 Michael Kerrisk wrote:
[...]

Quoted 2 lines
man5/filesystems.5 +0 -0

[...]

man5/filesystems.5 is a journaling version of the ext2 file system. · line 85

Quoted 10 lines
man5/filesystems.5 +0 -0
@@ -77,6 +77,12 @@ is a journaling version of the ext2 file system.

 It is easy to
 switch back and forth between ext2 and ext3.
 .TP
+.B ext4

man5/filesystems.5 +5 -0
+is a set of upgrades to ext3 including substantial performance and
+reliability enhancements,
+plus large increases in volume, file, and directory size limits.
+.TP
+ .B Reiserfs

Hello,

Please remove the line above, it is duplicated and contain a spurious leading space.

Quoted 3 lines

 .B Reiserfs
 is a journaling file system, designed by Hans Reiser, that was integrated into Linux in kernel 2.4.1.

Denis
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to [email protected] More majordomo info at http://vger.kernel.org/majordomo-info.html

A message that is not in the archive (sent off-list or not yet received): AANLkTin_VLloyn1IReU_h_uMWCUl5Z0-HJiK5OCDoiKa-JsoAwUIsXosN+BqQ9rBEUg@public.gmane.org

#19 lore raw

Hello Denis,

Quoted 18 lines · Denis Barbier

On 2010/5/24 Michael Kerrisk wrote:
[...]

Quoted 2 lines
man5/filesystems.5 +0 -0

[...]

man5/filesystems.5 is a journaling version of the ext2 file system. · line 85

Quoted 10 lines
man5/filesystems.5 +0 -0
@@ -77,6 +77,12 @@ is a journaling version of the ext2 file system.

 It is easy to
 switch back and forth between ext2 and ext3.
 .TP
+.B ext4

man5/filesystems.5 +5 -0
+is a set of upgrades to ext3 including substantial performance and
+reliability enhancements,
+plus large increases in volume, file, and directory size limits.
+.TP
+ .B Reiserfs

Hello,

Quoted 6 lines

Please remove the line above, it is duplicated and contain a spurious leading space.

Quoted 3 lines

 .B Reiserfs
 is a journaling file system, designed by Hans Reiser, that was integrated into Linux in kernel 2.4.1.

Thanks for catching that. Fixed now.,

Cheers,

Michael

Signature · 7 lines
Michael Kerrisk
Linux man-pages maintainer; http://www.kernel.org/doc/man-pages/
Author of "The Linux Programming Interface" http://blog.man7.org/
--
To unsubscribe from this list: send the line "unsubscribe linux-man" in
the body of a message to [email protected]
More majordomo info at  http://vger.kernel.org/majordomo-info.html