From dea25fb85add59a3d75df3df9822f7b7c803c755 Mon Sep 17 00:00:00 2001
From: Emily Grace Seville <emilyseville7cf@gmail.com>
Date: Sun, 19 Dec 2021 05:46:09 +1000
Subject: [PATCH] declare, local, typeset: add pages (#7529)

---
 pages/common/declare.md | 28 ++++++++++++++++++++++++++++
 pages/common/local.md   | 24 ++++++++++++++++++++++++
 pages/common/typeset.md | 28 ++++++++++++++++++++++++++++
 3 files changed, 80 insertions(+)
 create mode 100644 pages/common/declare.md
 create mode 100644 pages/common/local.md
 create mode 100644 pages/common/typeset.md

diff --git a/pages/common/declare.md b/pages/common/declare.md
new file mode 100644
index 000000000..f758360dd
--- /dev/null
+++ b/pages/common/declare.md
@@ -0,0 +1,28 @@
+# declare
+
+> Declare variables and give them attributes.
+> More information: <https://www.gnu.org/software/bash/manual/bash.html#Bash-Builtins>.
+
+- Declare a string variable with the specified value:
+
+`declare {{variable}}="{{value}}"`
+
+- Declare an integer variable with the specified value:
+
+`declare -i {{variable}}="{{value}}"`
+
+- Declare an array variable with the specified value:
+
+`declare {{variable}}=({{item_a item_b item_c}})`
+
+- Declare an associative array variable with the specified value:
+
+`declare -A {{variable}}=({{[key_a]=item_a [key_b]=item_b [key_c]=item_c}})`
+
+- Declare a readonly string variable with the specified value:
+
+`declare -r {{variable}}="{{value}}"`
+
+- Declare a global variable within a function with the specified value:
+
+`declare -g {{variable}}="{{value}}"`
diff --git a/pages/common/local.md b/pages/common/local.md
new file mode 100644
index 000000000..f23b6fe97
--- /dev/null
+++ b/pages/common/local.md
@@ -0,0 +1,24 @@
+# local
+
+> Declare local variables and give them attributes.
+> More information: <https://www.gnu.org/software/bash/manual/bash.html#Bash-Builtins>.
+
+- Declare a string variable with the specified value:
+
+`local {{variable}}="{{value}}"`
+
+- Declare an integer variable with the specified value:
+
+`local -i {{variable}}="{{value}}"`
+
+- Declare an array variable with the specified value:
+
+`local {{variable}}=({{item_a item_b item_c}})`
+
+- Declare an associative array variable with the specified value:
+
+`local -A {{variable}}=({{[key_a]=item_a [key_b]=item_b [key_c]=item_c}})`
+
+- Declare a readonly variable with the specified value:
+
+`local -r {{variable}}="{{value}}"`
diff --git a/pages/common/typeset.md b/pages/common/typeset.md
new file mode 100644
index 000000000..07e8753f9
--- /dev/null
+++ b/pages/common/typeset.md
@@ -0,0 +1,28 @@
+# typeset
+
+> Declare variables and give them attributes.
+> More information: <https://www.gnu.org/software/bash/manual/bash.html#Bash-Builtins>.
+
+- Declare a string variable with the specified value:
+
+`typeset {{variable}}="{{value}}"`
+
+- Declare an integer variable with the specified value:
+
+`typeset -i {{variable}}="{{value}}"`
+
+- Declare an array variable with the specified value:
+
+`typeset {{variable}}=({{item_a item_b item_c}})`
+
+- Declare an associative array variable with the specified value:
+
+`typeset -A {{variable}}=({{[key_a]=item_a [key_b]=item_b [key_c]=item_c}})`
+
+- Declare a readonly variable with the specified value:
+
+`typeset -r {{variable}}="{{value}}"`
+
+- Declare a global variable within a function with the specified value:
+
+`typeset -g {{variable}}="{{value}}"`