From: Karel Zak Date: Fri, 21 Feb 2014 11:04:18 +0000 (+0100) Subject: mkfs: mark this wrapper as DEPRECATED X-Git-Tag: v2.25-rc1~572 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=4459245fa320b37bf433b7ddd3b206249ee54381;p=thirdparty%2Futil-linux.git mkfs: mark this wrapper as DEPRECATED Theodore Ts'o: I'll add that I've never been convinced that the mkfs front end is all that useful. It's probably better for people to explicitly run /sbin/mkfs.xfs, /sbin/mkfs.ext4, etc.., so you don't have to worry about which options get passed down to the file system specific mkfs program, and which ones are interpreted by /sbin/mkfs --- and I don't believe /sbin/mkfs adds enough (err, any?) value that using "/sbin/mkfs -t xxx" vs "/sbin/mkfs.xxx" makes any sense whatsoever. ... and I absolutely agree. Reported-by: Theodore Ts'o Signed-off-by: Karel Zak --- diff --git a/Documentation/deprecated.txt b/Documentation/deprecated.txt index 5113594ac9..33072d9d19 100644 --- a/Documentation/deprecated.txt +++ b/Documentation/deprecated.txt @@ -2,6 +2,9 @@ The following is a list of commands or features that are deprecated. All deprecated utils are in maintenance mode and we keep them in source tree for backward compatibility only. +What: mkfs +Why: use filesystem specific mkfs.. + What: fdisk -s Why: this does not belong to fdisk, use "blockdev --getsz" diff --git a/disk-utils/mkfs.8 b/disk-utils/mkfs.8 index 3b905b2845..ba071400d4 100644 --- a/disk-utils/mkfs.8 +++ b/disk-utils/mkfs.8 @@ -8,6 +8,8 @@ mkfs \- build a Linux filesystem .RB [ \-t .IR type "] [" fs-options ] " device " [ size ] .SH DESCRIPTION +.B This mkfs frontend is deprecated in favour of filesystem specific mkfs. utils. +.PP .B mkfs is used to build a Linux filesystem on a device, usually a hard disk partition. The