summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorTodd C. Miller <millert@cvs.openbsd.org>2023-10-30 22:12:03 +0000
committerTodd C. Miller <millert@cvs.openbsd.org>2023-10-30 22:12:03 +0000
commit52c66b1459164bbfc8d83c52bb7cded8519b472f (patch)
treeb6c004abbe6e49aec51ba63618f64575a9ad8a22
parent54c1e5ca07f936bf87bc6646d44f75d525b9ee04 (diff)
This is the OpenBSD version of Awk.
-rw-r--r--usr.bin/awk/README.md50
1 files changed, 18 insertions, 32 deletions
diff --git a/usr.bin/awk/README.md b/usr.bin/awk/README.md
index 010a08f5c60..89e0abfe465 100644
--- a/usr.bin/awk/README.md
+++ b/usr.bin/awk/README.md
@@ -1,6 +1,15 @@
-$OpenBSD: README.md,v 1.8 2023/10/30 17:52:54 millert Exp $
+# OpenBSD Awk
-# The One True Awk
+This is a fork of The One True Awk, as shipped with OpenBSD. It
+includes changes not present in the upstream version because they
+are OpenBSD-specific, are still open PRs, or were rejected by the
+upstream maintainer. This version of `awk` relies on APIs that are
+not present in some other systems, such as `asprintf`, `pledge`,
+`reallocarray`, `srandom_deterministic` and `strlcpy`.
+
+## What is upstream? ##
+
+Upstream is the bsd-features branch of https://github.com/onetrueawk/awk.
This is the version of `awk` described in _The AWK Programming Language_,
Second Edition, by Al Aho, Brian Kernighan, and Peter Weinberger
@@ -66,30 +75,14 @@ Changes, mostly bug fixes and occasional enhancements, are listed
in `FIXES`. If you distribute this code further, please please please
distribute `FIXES` with it.
-If you find errors, please report them
-to the current maintainer, ozan.yigit@gmail.com.
-Please _also_ open an issue in the GitHub issue tracker, to make
-it easy to track issues.
-Thanks.
-
-## Submitting Pull Requests
-
-Pull requests are welcome. Some guidelines:
+If you find errors, please report them to bugs@openbsd.org rather
+than the upstream maintainer unless you can also reproduce the
+problem with an unmodified version of the upstream awk.
-* Please do not use functions or facilities that are not standard (e.g.,
-`strlcpy()`, `fpurge()`).
+## Submitting Patches
-* Please run the test suite and make sure that your changes pass before
-posting the pull request. To do so:
-
- 1. Save the previous version of `awk` somewhere in your path. Call it `nawk` (for example).
- 1. Run `oldawk=nawk make check > check.out 2>&1`.
- 1. Search for `BAD` or `error` in the result. In general, look over it manually to make sure there are no errors.
-
-* Please create the pull request with a request
-to merge into the `staging` branch instead of into the `master` branch.
-This allows us to do testing, and to make any additional edits or changes
-after the merge but before merging to `master`.
+Patches may be submitted to the tech@openbsd.org mailing list, or
+bugs@openbsd.org if you are fixing a bug.
## Building
@@ -138,13 +131,6 @@ should you choose to do so.
We don't usually do releases.
-## A Note About Maintenance
-
-NOTICE! Maintenance of this program is on a ''best effort''
-basis. We try to get to issues and pull requests as quickly
-as we can. Unfortunately, however, keeping this program going
-is not at the top of our priority list.
-
#### Last Updated
-Sun Sep 3 09:26:43 EDT 2023
+Mon 30 Oct 2023 12:53:07 MDT