From: Sami Kerola <kerolasa@iki.fi>
Date: Tue, 28 Feb 2012 22:05:59 +0000 (+0100)
Subject: docs: add deprecation comments
X-Git-Tag: v2.22-rc1~671
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=ba0c903004aa81caeca805472e83adeeb2269aa4;p=thirdparty%2Futil-linux.git

docs: add deprecation comments

Markup deprecation to command header to avoid people wasting time in
fixing these utilities.

Signed-off-by: Sami Kerola <kerolasa@iki.fi>
---

diff --git a/disk-utils/elvtune.c b/disk-utils/elvtune.c
index 7c3caedcce..7c074ffa62 100644
--- a/disk-utils/elvtune.c
+++ b/disk-utils/elvtune.c
@@ -18,6 +18,15 @@
  *  51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 #include <fcntl.h>
 #include <errno.h>
 #include <stdio.h>
diff --git a/login-utils/last.c b/login-utils/last.c
index 734730b3a0..417314ee59 100644
--- a/login-utils/last.c
+++ b/login-utils/last.c
@@ -26,6 +26,15 @@
   * - using mmap() on Linux - great speed improvement
   */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 /*
  * last
  */
diff --git a/login-utils/newgrp.c b/login-utils/newgrp.c
index 9839934169..707c5893a8 100644
--- a/login-utils/newgrp.c
+++ b/login-utils/newgrp.c
@@ -6,6 +6,15 @@
  * - added Native Language Support
  */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 #include <errno.h>
 #include <getopt.h>
 #include <grp.h>
diff --git a/login-utils/vipw.c b/login-utils/vipw.c
index 92b42313f3..c0ed0b3fb3 100644
--- a/login-utils/vipw.c
+++ b/login-utils/vipw.c
@@ -44,6 +44,15 @@
  * - fixed strerr(errno) in gettext calls
  */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 #include <errno.h>
 #include <fcntl.h>
 #include <paths.h>
diff --git a/sys-utils/arch.c b/sys-utils/arch.c
index 0c29c3e0cb..470b12b9aa 100644
--- a/sys-utils/arch.c
+++ b/sys-utils/arch.c
@@ -18,6 +18,15 @@
  * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
  */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 #include <err.h>
 #include <errno.h>
 #include <getopt.h>
diff --git a/text-utils/line.c b/text-utils/line.c
index 826e5a2592..636122e015 100644
--- a/text-utils/line.c
+++ b/text-utils/line.c
@@ -6,6 +6,15 @@
  * Public Domain.
  */
 
+/*
+ * This command is deprecated.  The utility is in maintenance mode,
+ * meaning we keep them in source tree for backward compatibility
+ * only.  Do not waste time making this command better, unless the
+ * fix is about security or other very critical issue.
+ *
+ * See Documentation/deprecated.txt for more information.
+ */
+
 #include	<stdio.h>
 #include	<unistd.h>