From owner-freebsd-doc@freebsd.org Mon Sep 19 11:49:14 2016 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 95242BE048C for ; Mon, 19 Sep 2016 11:49:14 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from kenobi.freebsd.org (kenobi.freebsd.org [IPv6:2001:1900:2254:206a::16:76]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 6C7C1CCA for ; Mon, 19 Sep 2016 11:49:14 +0000 (UTC) (envelope-from bugzilla-noreply@freebsd.org) Received: from bugs.freebsd.org ([127.0.1.118]) by kenobi.freebsd.org (8.15.2/8.15.2) with ESMTP id u8JBnEl5061264 for ; Mon, 19 Sep 2016 11:49:14 GMT (envelope-from bugzilla-noreply@freebsd.org) From: bugzilla-noreply@freebsd.org To: freebsd-doc@FreeBSD.org Subject: [Bug 206283] Awk manpage fails to cite ampersand substitutions. Date: Mon, 19 Sep 2016 11:49:14 +0000 X-Bugzilla-Reason: AssignedTo X-Bugzilla-Type: changed X-Bugzilla-Watch-Reason: None X-Bugzilla-Product: Documentation X-Bugzilla-Component: Documentation X-Bugzilla-Version: Latest X-Bugzilla-Keywords: X-Bugzilla-Severity: Affects Some People X-Bugzilla-Who: nibbana@gmx.us X-Bugzilla-Status: New X-Bugzilla-Resolution: X-Bugzilla-Priority: --- X-Bugzilla-Assigned-To: freebsd-doc@FreeBSD.org X-Bugzilla-Flags: X-Bugzilla-Changed-Fields: Message-ID: In-Reply-To: References: Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable X-Bugzilla-URL: https://bugs.freebsd.org/bugzilla/ Auto-Submitted: auto-generated MIME-Version: 1.0 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 19 Sep 2016 11:49:14 -0000 https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=3D206283 --- Comment #1 from nibbana@gmx.us --- The AWK manpage used to be fairly nice (10+ years ago), and it really appears that somebody trashed it intentionally. The formatting is botched (wrapping around to the 1st column) and there are stupid comments such as: BUGS There are no explicit conversions between numbers and strings. To force an expression to be treated as a number add 0 to it; to force it to be treated as a string concatenate "" to it. The scope rules for variables in functions are a botch; the syntax is worse. That is just bullshit. 100% bullshit. The implicit conversions between numbers and strings is intentional, and part of many more modern scripting languages. And what is wrong with the scope rules? Variables are local to the function; how is that a botch? And what is so bad about the syntax? It's just a stupid comment intended to insult - the obvious question is "for what purpose?" Did the author create something better than K&R, justifying such "authoritive insult?" AWK is part of the entire suite of Unix tools, and it is designed to do what AWK is designed to do, as M4 is designed to do what it is designed to do, and the same for SH, SED, YACC, LEX, PS ... and in that role, is nearly flawless. If anything is to be criticized, it would properly be the failure to process all 8-bit bytes equally (eg, without special consideration to 0x0), or the fact that nawk closes stdin if requested, or some other quirks that have been fixed in mawk/gawk. AWK is a very important and critical part of the Unix tool set, and honestly, this manpage is of highly inappropriate quality in comparison. --=20 You are receiving this mail because: You are the assignee for the bug.=