From 396d540dd0ccaf114dc362b8e66d1b2cf9463396 Mon Sep 17 00:00:00 2001
From: Dylan Araps <dylan.araps@gmail.com>
Date: Thu, 19 Sep 2019 13:19:30 +0300
Subject: [PATCH] docs: update

---
 README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

diff --git a/README.md b/README.md
index 754a820..80ec757 100644
--- a/README.md
+++ b/README.md
@@ -334,6 +334,8 @@ Hello, World
 
 ## Parsing a `key=val` file.
 
+This could be used to parse a simple `key=value` configuration file.
+
 ```shell
 # Setting 'IFS' tells 'read' where to split the string.
 while IFS='=' read -r key val; do
@@ -344,6 +346,18 @@ while IFS='=' read -r key val; do
     # '$key' stores the key.
     # '$val' stores the value.
     printf '%s: %s\n' "$key" "$val"
+
+    # Alternatively replacing 'printf' with the following
+    # populates variables called '$key' with the value of '$val'.
+    #
+    # NOTE: I would extend this with a check to ensure 'key' is
+    #       a valid variable name.
+    # export "$key=$val"
+    #
+    # Example with error handling:
+    #
+    # export "$key=$val" 2>/dev/null ||
+    #     printf 'warning %s is not a valid variable name\n' "$key"
 done < "file"
 ```