function notes.search {
    # examples
    # notes.search --log --newer-than 30 -E "(streaming.*TDA|TDA.*streaming)"
    # notes.search --txt -F --headings "nextcloud"
    # notes.search --all -F "streaming"
    # notes.search --all --newer-than 30 -F "streaming"
    # notes.search --all --recent "streaming"

    function _usage {
	echo "usage : notes.search.new <options> <pattern>"
	echo "options :"
	echo "                  -E : regex search"
	echo "                  -F : fast search"
	echo "                  -r : reverse order (newer first)"
	echo "               --all : search all notes"
	echo "               --txt : search text notes only (default)"
	echo "               --log : search logs only "
	echo " --newer-than <days> : useful with --log; search only in files that were modified in the last <days> days"
	echo "            --recent : useful with --log; search only in files that were modified in the last 30 days"
	echo "          --headings : search only in headings"
    }

    local search_dirs="$NOTES_TXT"
    local search_type
    local find_recent
    local headings headings_prefix
    local pattern
    local grep_opts grep_opts_debug
    local ls_opts="-t"

    # echo "function args $@"
    TEMP=$(getopt -uo EFr -l all,log,txt,LOG,TXT,newer-than:,headings,recent,all -- $@)
    # echo "TEMP $TEMP"
    set -- $TEMP
    while (($# > 0))
    do
	case "$1" in
	    --all)
		search_dirs="$NOTES_TXT $NOTES_LOG"
		;;

	    --log|--LOG)
		search_dirs="$NOTES_LOG"
		;;

	    --txt|--TXT)
	        search_dirs="$NOTES_TXT"
		;;

	    --newer-than)
		shift
		find_recent="-mtime -$1"
		;;
	    
	    --heading?)
		headings_prefix="^\*.* "
		;;
	    
	    --recent)
		find_recent="-mtime 30"
		;;

	    -E)
		grep_opts="-E"
		;;

	    -F)
		grep_opts="-F"
		;;
	    -r)
		ls_opts="-rt"
		;;
	    --)
		shift
		pattern="$*"
		;;
	esac
	shift 
    done
    
    
    [[ -z $pattern ]] && (echo "no pattern specified"; _usage; return 1)
    [[ -n $grep_opts ]] && grep_opts_debug="with the $grep_opts option"
    > /tmp/notes.search.results.colors
    find $search_dirs -not -name "*~" -type f $find_recent | xargs ls "$ls_opts" | while read file
    do
	grep --color=always -H -n -i $grep_opts "$headings_prefix$pattern" "$file"  | tee -a /tmp/notes.search.results.colors
    done    

    pretty.colors.remove /tmp/notes.search.results.colors > /tmp/notes.search.results
}

#!/bin/sh

# Example of parsing command-line options/arguments.
#
# This supports all the common option style variants,
# but not POSIX short-option combining.
#  e.g.
#    ./scriptname -llogfile.txt
#    ./scriptname -l logfile.txt
#    ./scriptname --logfile=logfile.txt
#    ./scriptname --logfile logfile.txt

########################################################################
# Parse Option Args:

unset opt_logfile opt_verbose

while [ $# -gt 0 ]
do
  case "$1" in
	--)            shift ; break ;;
	-|""|[!-]*)    break ;;
	--logfile)     opt_logfile=${2:?logfile: missing option} ; shift ;;
	--logfile=?*)  opt_logfile=${1#*=} ;;
	--verbose)     opt_verbose=1 ;;
	--?*)          echo "Unknown long-option:$1" >&2 ; exit 1 ;;
	-l?*)          opt_logfile=${1#-l} ;;
	-l)            opt_logfile=${2:?logfile: missing option} ; shift ;;
	-v)            opt_verbose=1 ;;
	-?*)           echo "Unknown option:$1" >&2 ; exit 1 ;;
  esac
  shift
done

[ -n "$opt_logfile" ]  && echo "logfile is: \"$opt_logfile\""

if [ $# -gt 0 ] && [ ${opt_verbose:-0} -ne 0 ]; then
  echo remaining args are:
  for arg in "$@"
  do
	echo $arg
  done
fi

exit 0

################################################################# End. #

-?)  # process short option:
     case ${1#-} in ...

--)            shift ; break ;;
-|""|[!-]*)    break ;;

_usage()
{
  cat<<-USAGE
    usage : notes.search.new <options> <pattern>
    options :
                      -E : regex search
                      -F : fast search
                      -r : reverse order (newer first)
                   --all : search all notes
                   --txt : search text notes only (default)
                   --log : search logs only
     --newer-than <days> : useful with --log; search only in files that were modified in the last <days> days
                --recent : useful with --log; search only in files that were modified in the last 30 days
              --headings : search only in headings
  USAGE
}

declare -a usage

usage=('usage : notes.search.new <options> <pattern>'
		'options :'
		'                  -E : regex search'
		'                  -F : fast search'
		'                  -r : reverse order (newer first)'
		'               --all : search all notes'
		'               --txt : search text notes only (default)'
		'               --log : search logs only '
		' --newer-than <days> : useful with --log; search only in files that were modified in the last <days> days'
		'            --recent : useful with --log; search only in files that were modified in the last 30 days'
		'          --headings : search only in headings'
	)

IFS=$'\n'
echo "${usage[*]}"
unset IFS

for param in $(getopt -uo EFr -l all,log,txt,LOG,TXT,newer-than:,headings,recent,all -- $@)
do
  case ...
done

func1()
{
  local -a usage=(
    'func1:'
    '  usage line one'
    '  usage line two'
  )

  case "$1" in
    -h)  printf '%s\n' "${usage[@]}" ;;
    *)   printf '%s\n' "func1() called with args: " "$@" ;;
  esac
}

[[ -z $pattern ]] && {
  echo "no pattern specified"; _usage; return 1
}

if [[ -z $pattern ]]; then
  echo "no pattern specified"; _usage; return 1
fi

_usage()
{
  echo "\
    usage : notes.search.new <options> <pattern>
    options :
                      -E : regex search
                      -F : fast search
                      -r : reverse order (newer first)
                   --all : search all notes
                   --txt : search text notes only (default)
                   --log : search logs only
     --newer-than <days> : useful with --log; search only in files that were modified in the last <days> days
                --recent : useful with --log; search only in files that were modified in the last 30 days
              --headings : search only in headings"
}

#       designed with korn, works with bash and most shells
#       automagic shell keyword arguments, like:
#
#               name='mr smith' address='the matrix' job=agent 
#       
for V in "$@"
do
        case "$V" in
                *=*) eval ${V%=*}='${V#*=}';;
                *) args[i++]="$V";;
        esac
done
[ "$i" ] && set "${args[@]}"|| shift $#
unset i args V

# EXAMPLE usage
#
#       # optional and default arguments
#       address='no fixed abode'
#       job=
#
#       source keywords
#       
#       # mandatory arguments
#       set -o nounset
#       : $name
#       : $address
#       
#       echo "hello [$name] of [$address]"
#       [ "$job" ] && echo how is the $job business\?|| echo get a job\!