From 4e52f5db352fe54d6ba342bcde01228096db8b19 Mon Sep 17 00:00:00 2001
From: Warner Losh <imp@FreeBSD.org>
Date: Fri, 30 Jul 2021 23:19:58 -0600
Subject: [PATCH] awk: Flag -Ft as deprecated behavior

Upstream is poised to deprecate the -Ft wart in one true awk. None of
the other awks do this, and the gawk maintainer says that he's had no
requests for it in gawk in 30 years maintaining it. github can find a
few instances of it in the wild. As such, warn that it's deprecated and
will go away in the future.

MFC After:		3 days
Sponsored by:		Netflix
---
 contrib/one-true-awk/main.c |  4 +++-
 usr.bin/awk/awk.1           | 10 +++++++++-
 2 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/contrib/one-true-awk/main.c b/contrib/one-true-awk/main.c
index 4e68bfb46d27..35d0ca7d098f 100644
--- a/contrib/one-true-awk/main.c
+++ b/contrib/one-true-awk/main.c
@@ -89,8 +89,10 @@ static const char *
 setfs(char *p)
 {
 	/* wart: t=>\t */
-	if (p[0] == 't' && p[1] == '\0')
+	if (p[0] == 't' && p[1] == '\0') {
+		WARNING("-Ft to imply tab separator is deprecated behavior.");
 		return "\t";
+	}
 	return p;
 }
 
diff --git a/usr.bin/awk/awk.1 b/usr.bin/awk/awk.1
index b85efe9d87cd..20bb510a1516 100644
--- a/usr.bin/awk/awk.1
+++ b/usr.bin/awk/awk.1
@@ -23,7 +23,7 @@
 .\" THIS SOFTWARE.
 .\"
 .\"	$FreeBSD$
-.Dd $Mdocdate: June 6 2020 $
+.Dd July 30, 2021
 .Dt AWK 1
 .Os
 .Sh NAME
@@ -812,3 +812,11 @@ to it.
 .Pp
 The scope rules for variables in functions are a botch;
 the syntax is worse.
+.Sh DEPRECATED BEHAVIOR
+One True Awk has accpeted
+.Fl Ft
+to mean the same as
+.Fl F\t
+to make it easier to specify tabs as the separator character.
+Upstream One True Awk has deprecated this wart in the name of better
+compatibility with other awk implementations like gawk and mawk.