ch documentation

Anton-Latukha · Anton-Latukha · commit 38ded9ac920c · 2017-09-12T20:49:19.000+03:00
diff --git a/scripts/install-nix-from-closure.sh b/scripts/install-nix-from-closure.sh
@@ -36,24 +36,24 @@
 # 1) Since this script tries to be fully POSIX compatible, code is influenced by that. There are day-to-day commands and solutions we get used to, but they are not in POSIX standard. So if you try to simplify some operation, please check it with http://pubs.opengroup.org/onlinepubs/9699919799/ .
 #
 # 2) Notice, Warning, Error, ErrorRevert massages have special form to be very readable and get attention.
-# Message body starts from new line.
+# Message body starts from a new line.
 # And has 4 spaces from the left. Always.
 #
 ###############################
 #
-#    ^ notice "
-#    |
-#<---Install executed for ROOT.
+#      notice "
+#
+#    Install executed for ROOT.
 #
 #    Doing classic Linux package manager mode.
 #    In Nix this mode is called: single-user mode for root.
 #
 #    Nix can do multi-user mode, and manage package trees for users independently.
 #    "
-#    fi
 #
 ###############################
 #
+# This is the best balance of code simplicity and code readability found so far.
 # This produces output in color:
 #
 ###############################

Original file line number	Diff line number	Diff line change
`@@ -36,24 +36,24 @@`
`36`	`36`	`# 1) Since this script tries to be fully POSIX compatible, code is influenced by that. There are day-to-day commands and solutions we get used to, but they are not in POSIX standard. So if you try to simplify some operation, please check it with http://pubs.opengroup.org/onlinepubs/9699919799/ .`
`37`	`37`	`#`
`38`	`38`	`# 2) Notice, Warning, Error, ErrorRevert massages have special form to be very readable and get attention.`
`39`		`-# Message body starts from new line.`
	`39`	`+# Message body starts from a new line.`
`40`	`40`	`# And has 4 spaces from the left. Always.`
`41`	`41`	`#`
`42`	`42`	`###############################`
`43`	`43`	`#`
`44`		`-# ^ notice "`
`45`		`-# \|`
`46`		`-#<---Install executed for ROOT.`
	`44`	`+# notice "`
	`45`	`+#`
	`46`	`+# Install executed for ROOT.`
`47`	`47`	`#`
`48`	`48`	`# Doing classic Linux package manager mode.`
`49`	`49`	`# In Nix this mode is called: single-user mode for root.`
`50`	`50`	`#`
`51`	`51`	`# Nix can do multi-user mode, and manage package trees for users independently.`
`52`	`52`	`# "`
`53`		`-# fi`
`54`	`53`	`#`
`55`	`54`	`###############################`
`56`	`55`	`#`
	`56`	`+# This is the best balance of code simplicity and code readability found so far.`
`57`	`57`	`# This produces output in color:`
`58`	`58`	`#`
`59`	`59`	`###############################`