EVERYTHING FROM THE OTHER REPO

2026-07-29 03:36:26 +03:00
parent 6777ea96db
commit 92a6ae42f5
4426 changed files with 1696506 additions and 2 deletions
@@ -0,0 +1,95 @@
+-- $MawkId: README,v 1.7 2023/02/16 00:19:21 tom Exp $
+-- vile:txtmode fc=78
+
+mawk -- an implementation of new/posix awk
+version 1.3.4
+
+Generic installation instructions are in file INSTALL.
+This file gives more specific information.
+
+Send bug reports, comments, questions, etc. to 
+
+	Thomas E. Dickey <dickey@invisible-island.net>
+	https://invisible-island.net/mawk/
+
+-------------------------------------------------------------------------------
+
+Portability:
+-----------
+
+	This program builds/runs on several POSIX-style platforms.
+	It has been recently tested for these:
+
+	AIX (5.1 and 5.3, using cc and gcc)
+	Cygwin (1.5.21 on Windows/XP)
+	FreeBSD (6.0)
+	HPUX (10.20, 11.00, 11.11 and 11.23, using cc and gcc)
+	IRIX64 (using cc and gcc)
+	Linux (several flavors, using gcc and icc)
+	MinGW/MSYS (on Windows/XP)
+	OpenBSD (4.1)
+	Solaris (2.6 to 10, using cc and gcc)
+	Tru64 (4.0D and 5.1, using cc and gcc)
+
+Options:
+-------
+
+	The configure script has these application-specific options:
+
+	--disable-echo          display "compiling" commands
+
+		Show "compiling foo.c" rather than the full compiler and
+		options.  Those are clutter useful only to a developer. 
+		Developers focus on compiler warnings anyway.
+
+	--enable-warnings       test: turn on gcc compiler warnings
+
+		This turns on the usual gcc compiler warnings needed to
+		do useful development.  If you happen to be using the
+		Intel compiler icc, it does the right thing for that.
+
+	--with-builtin-regex    use mawk's own regular-expressions engine
+
+		Normally mawk's configure script uses the built-in regular
+		expressions.  The choice of default is based on where the
+		greatest lossage occurs.  More scripts use gawk's
+		null-character extension than use POSIX brace expressions.  If
+		your needs are different, build mawk using an external library.
+
+Limitations:
+-----------
+
+	mawk 1.3.3 was developed to correspond with a POSIX draft.  POSIX
+	continued, and incorporated some of mawk's extensions as features. 
+	The 1.3.4 release fills in the major areas in which POSIX grew past
+	the mawk 1.3.3 implementation.
+
+	mawk's built-in regular expression engine does not yet support brace
+	expressions, e.g.,
+
+		/a{,4}/
+
+	Use an external regular expression library if you require brace
+	expressions.  Aside from that, mawk's built-in regular expressions
+	provide POSIX functionality.
+
+	Using an external regular expression library means that mawk cannot
+	match expressions containing the null character.  That is a
+	nonstandard feature provided by gawk.  Using mawk's built-in regular
+	expressions, there is some support for this feature.
+
+	Aside from supporting nulls, using an external regular expression
+	library is usually advantageous.
+
+	The Cygwin math library has some problems (which are also visible in
+	the gawk port).  For instance, its log() function returns Inf
+	(infinity) for log(-8) rather than NaN (not a number) as all of the
+	Unix and similar platforms would do.
+
+	The MSYS package for regular expressions is unusable as an external
+	library for mawk because it generates a runtime error when asked to
+	compile a newline, e.g., "\n".  mawk does this during initialization.
+
+	The MinGW/MSYS port does not currently support pipes.  There is
+	source-code from the obsolete MS-DOS port which can be reused for this
+	purpose; however that is not the focus of the 1.3.4 release.