docs: add examples

Author: hyperupcall

examples/bashblog.sh

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+# https://github.com/cfenollosa/bashblog
+
+source ./bin/args-init
+
+args.parse <<"EOF"
+@arg post - insert a new blog post, or the filename of a draft to continue editing it. it tries to use markdown by default, and falls back to HTML if it's not available. use '-html' to override it and edit the post as HTML even when markdown is available
+@arg edit - edit an already published .html or .md file. **NEVER** edit manually a published .html file, always use this function as it keeps internal data and rebuilds the blog. use '-n' to give the file a new name, if title was changed. use '-f' to edit full html file, instead of just text part (also preserves name)
+@arg delete - deletes the post and rebuilds the blog
+@arg rebuild - deletes the post and rebuilds the blog
+@arg reset - deletes everything except this script. Use with a lot of caution and back up first!
+@arg list - list all posts
+@arg tags - list all tags in alphabetical order. use '-n' to sort list by number of posts
+
+EOF
+
+printf "%s" "$argsHelpText"

examples/basher.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+# https://github.com/basherpm/basher
+
+source ./bin/args-init
+
+args.parse <<"EOF"
+@arg help - Display help for a command
+@arg commands - List all available basher commands
+@arg init - Configure the shell environment for basher
+EOF

examples/bats.sh

@@ -0,0 +1,23 @@
+#!/usr/bin/env bash
+
+# https://github.com/bats-core/bats-core
+
+source ./bin/args-init
+
+args.parse -- <<"EOF"
+@flag [count.c] - Count test cases without running any tests
+@flag [filter.f] {} - Only run tests that match the regular expression
+@flag [formatter.F] {pretty} - Swithc between formatters: pretty (default), tap (default w/o term), tap13, junit
+@flag [help.h] - Display this help message
+@flag [jobs.j] {1} - Number of parallel jobs (requires GNU parallel)
+@flag [no-tempdir-cleanup] - Serialize test file execution instead of running them in parallel (requires --jobs >1)
+@flag [no-parallelize-within-files] - Serialize test execution within files instead of running them in parallel (requires --jobs >1)
+@flag [output.o] {} - Directory to write report files
+@flag [pretty.p] - Shorthand for "--formatter pretty"
+@flag [recursive.r] - Include tests in subdirectories
+@flag [tap.t] - Shorthand for "--formatter tap"
+@flag [timing.T] - Add timing information to tests
+@flag [version.v] - Display the version number
+EOF
+
+printf "%s" "$argsHelpText"

examples/bocker.sh

@@ -0,0 +1,16 @@
+#!/usr/bin/env bash
+
+# https://github.com/p8952/bocker
+
+source ./bin/args-init
+
+args.parse -- <<"EOF"
+@flag [.p] - Prune empty. Exclude fields with empty values.
+@flag [.l] - Leaf only. Only show leaf nodes, which stops data duplication.
+@flag [.b] - Brief. Combines 'Leaf only' and 'Prune empty' options.
+@flag [.n] - No-head. Do not show nodes that have no path (lines that start with []).
+@flag [.s] - Remove escaping of the solidus symbol (straight slash).
+@flag [.h] - This help text.
+EOF
+
+printf "%s" "$argsHelpText"