builtins now return success if supplied --help; use groff to build HTML man pages; reset mbstate if $'...' strings read an invalid multibyte sequence; read -t 0 now looks at other options (-n/-N/-d) and sets the terminal state appropriately

examples/functions/repeat

@@ -0,0 +1,40 @@
+#   This program is free software: you can redistribute it and/or modify
+#   it under the terms of the GNU General Public License as published by
+#   the Free Software Foundation, either version 3 of the License, or
+#   (at your option) any later version.
+#
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU General Public License for more details.
+#
+#   You should have received a copy of the GNU General Public License
+#   along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+# repeat - repeat a command
+# 
+# usage: repeat N command [arg...]
+#
+# Evaluate COMMAND ARGs N times
+
+repeat()
+{
+	local _i _count
+
+	(( $# < 2 )) && {
+		echo 'repeat: usage: repeat N command [arg...]' >&2
+		return 2
+	}
+
+	_count=$1
+	(( $_count < 1 )) && {
+		echo "repeat: count must be >= 1" >&2
+		return 2
+	}
+	shift
+
+	for ((_i = 1; _i <= $_count; _i++)); do
+		eval "$@"
+	done
+}

examples/functions/repeat2

@@ -0,0 +1,49 @@
+#   This program is free software: you can redistribute it and/or modify
+#   it under the terms of the GNU General Public License as published by
+#   the Free Software Foundation, either version 3 of the License, or
+#   (at your option) any later version.
+#
+#   This program is distributed in the hope that it will be useful,
+#   but WITHOUT ANY WARRANTY; without even the implied warranty of
+#   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+#   GNU General Public License for more details.
+#
+#   You should have received a copy of the GNU General Public License
+#   along with this program.  If not, see <http://www.gnu.org/licenses/>.
+#
+
+# repeat - repeat a command
+# 
+# usage: repeat [-e] N command [arg...]
+#
+# Evaluate COMMAND ARGs N times. If -e is supplied, use eval
+
+repeat()
+{
+	local _i _count _e
+
+	[[ $1 = -e ]] && {
+		e=1
+		shift
+	}
+
+	(( $# < 2 )) && {
+		echo 'repeat: usage: repeat [-e] N command [arg...]' >&2
+		return 2
+	}
+
+	_count=$1
+	(( $_count < 1 )) && {
+		echo "repeat: count must be >= 1" >&2
+		return 2
+	}
+	shift
+
+	for ((_i = 1; _i <= $_count; _i++)); do
+		if [ "$e" ]; then
+			eval "$@"
+		else
+			"$@"
+		fi
+	done
+}