aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorKylie McClain <kylie@somas.is>2020-07-07 09:29:24 -0400
committerKylie McClain <kylie@somas.is>2020-07-07 09:33:53 -0400
commit21ae49ab996ffd256c570afa0056c8ddf32cc0da (patch)
treebf817d86ec3d2e96dc2752f42e68bbc8f2558d06
parent314fe409d5ab0253dcfbdde9b5c48460eaa00f85 (diff)
downloadpraxis-21ae49ab996ffd256c570afa0056c8ddf32cc0da.tar.gz
praxis-21ae49ab996ffd256c570afa0056c8ddf32cc0da.tar.xz
praxis-21ae49ab996ffd256c570afa0056c8ddf32cc0da.zip
theory(5): simplify "Format", rename to "Action"
-rw-r--r--theory.5.adoc16
1 files changed, 5 insertions, 11 deletions
diff --git a/theory.5.adoc b/theory.5.adoc
index 0e6e07a..811bb12 100644
--- a/theory.5.adoc
+++ b/theory.5.adoc
@@ -150,20 +150,14 @@ determine what packages can satisfy it.
If more than one package matches a specification, the package manager *should* prompt the user in
some fashion to be more specific.
-=== Format
+[#pkg-action]
+=== Action
-`theory0` files and `lib0` files are effectively just shell scripts. Package managers *should*
-avoid locking the user into any particular Bourne-style shell implementation; as such, the format
-of these files should adhere to shell syntax as defined in
-http://pubs.opengroup.org/onlinepubs/9699919799/[POSIX 2016].
+:url-posix2016: http://pubs.opengroup.org/onlinepubs/9699919799/
-That said, a few exceptions are made for functionality that is deemed too
-useful to be given up, and isn't yet specified in POSIX...
+`action` files are really just shell scripts. These files should adhere to shell syntax as defined
+in {url-posix2016}[POSIX 2016].
-* Declaring arrays (`array=( "foo" "bar" "baz" )`)
-* Iterating through arrays (`for item in "${array[@]}";do ... done`)
-* Appending to arrays (`array+=( "xyzzy" )`)
-* Local-scope variables (`local var="value"`)
== Build environment