Use colon to separate module and object in listing

Make the list a bit easier to handle in scripts (colon does not have
special regex meaning).

Also im human-readable contexts, dot makes it more likely to confuse the
string with with filename (eg. `foo.bar`.)  But then again, it's better
for humans to go a bit further and decorate the reference, eg.
`foo:bar()` or `foo:$BAZ`.  (Doing that in default output would make
them hard to parse, though.)

src/include-bash/sfdoc.sh

@@ -76,11 +76,11 @@ sfdoc__ls() {
     case $otype in
             f)
                 grep -HE '^[[:alnum:]_]+\(\) \{' "$mpath" \
-                  | sed -e 's|(.*||; s|\.sh:|.|; s|^.*/||'
+                  | sed -e 's|(.*||; s|\.sh:|:|; s|^.*/||'
                 ;;
             v)
                 grep -HE '^[[:alnum:]_]+=' "$mpath" \
-                  | sed -e 's|=.*||; s|\.sh:|.|; s|^.*/||'
+                  | sed -e 's|=.*||; s|\.sh:|:|; s|^.*/||'
                 ;;
             *)
                 warn "bug: invalid object type: $otype"
@@ -130,7 +130,7 @@ __sfdoc__export_as_markdown() {
     echo
     __sfdoc__get_doc | __sfdoc__md_escapes
     echo
-    for variable in $(sfdoc__ls v "$MPath" | cut -d. -f2);
+    for variable in $(sfdoc__ls v "$MPath" | cut -d: -f2);
     do
         debug -v variable
         $vheader_done || {
@@ -145,7 +145,7 @@ __sfdoc__export_as_markdown() {
         __sfdoc__get_doc "v:$variable" | __sfdoc__md_escapes
         echo
     done
-    for function in $(sfdoc__ls f "$MPath" | cut -d. -f2);
+    for function in $(sfdoc__ls f "$MPath" | cut -d: -f2);
     do
         debug -v function
         $fheader_done || {
@@ -184,7 +184,7 @@ __sfdoc__export_as_pod() {
     echo
     __sfdoc__get_doc
     echo
-    for variable in $(sfdoc__ls v "$MPath" | cut -d. -f2);
+    for variable in $(sfdoc__ls v "$MPath" | cut -d: -f2);
     do
         debug -v variable
         $vheader_done || {
@@ -206,7 +206,7 @@ __sfdoc__export_as_pod() {
         echo "=back"
         echo
     }
-    for function in $(sfdoc__ls f "$MPath" | cut -d. -f2);
+    for function in $(sfdoc__ls f "$MPath" | cut -d: -f2);
     do
         debug -v function
         $fheader_done || {
@@ -351,8 +351,8 @@ __sfdoc__filter_hidden() {
     $SFDOC_SHOW_HIDDEN && cat && return
     case $what in
         m)  grep -v ^_ ;;
-        v)  grep -v \\._ ;;
-        f)  grep -v \\._ ;;
+        v)  grep -v :_ ;;
+        f)  grep -v :_ ;;
         *)  warn "bug: invalid object type: $otype" ;;
     esac
 }

tests/sfdoc/oracle/lsf_tricky.stdout

@@ -1,2 +1,2 @@
-tricky.tricky_foo
-tricky.tricky_other_function
+tricky:tricky_foo
+tricky:tricky_other_function

tests/sfdoc/oracle/lsv_tricky.stdout

@@ -1,3 +1,3 @@
-tricky.TRICKY_DEBUG
-tricky.TRICKY_LIMIT
-tricky.TRICKY_REVERSED
+tricky:TRICKY_DEBUG
+tricky:TRICKY_LIMIT
+tricky:TRICKY_REVERSED

tests/sfdoc/oracle/lsx_tricky.stdout

@@ -1,5 +1,5 @@
-tricky.TRICKY_DEBUG
-tricky.TRICKY_LIMIT
-tricky.TRICKY_REVERSED
-tricky.tricky_foo
-tricky.tricky_other_function
+tricky:TRICKY_DEBUG
+tricky:TRICKY_LIMIT
+tricky:TRICKY_REVERSED
+tricky:tricky_foo
+tricky:tricky_other_function

tests/shellfu_api/oracle/functions.stdout

@@ -1,93 +1,93 @@
-_pretty_color.__shellfu__pretty_color__init
-_pretty_color._pretty__debug
-_pretty_color._pretty__die
-_pretty_color._pretty__mkhelp
-_pretty_color._pretty__mkusage
-_pretty_color._pretty__think
-_pretty_color._pretty__warn
-_pretty_html._pretty__debug
-_pretty_html._pretty__die
-_pretty_html._pretty__mkhelp
-_pretty_html._pretty__mkusage
-_pretty_html._pretty__think
-_pretty_html._pretty__warn
-_pretty_journald._pretty__debug
-_pretty_journald._pretty__die
-_pretty_journald._pretty__mkhelp
-_pretty_journald._pretty__mkusage
-_pretty_journald._pretty__think
-_pretty_journald._pretty__warn
-_pretty_notify._pretty__debug
-_pretty_notify._pretty__die
-_pretty_notify._pretty__mkhelp
-_pretty_notify._pretty__mkusage
-_pretty_notify._pretty__think
-_pretty_notify._pretty__warn
-_pretty_plain._pretty__debug
-_pretty_plain._pretty__die
-_pretty_plain._pretty__mkhelp
-_pretty_plain._pretty__mkusage
-_pretty_plain._pretty__think
-_pretty_plain._pretty__warn
-charmenu.charmenu
-exit.exit_error
-exit.exit_no
-exit.exit_ok
-exit.exit_panic
-exit.exit_usage
-inigrep._inigrep__fltcmt
-inigrep._inigrep__fltkey
-inigrep._inigrep__fltlst
-inigrep._inigrep__fltsct
-inigrep._inigrep__query
-inigrep._inigrep__validate_ks
-inigrep.inigrep
-mdfmt._mdfmt__fmttype
-mdfmt._mdfmt__indent
-mdfmt._mdfmt__join
-mdfmt._mdfmt__quote
-mdfmt._mdfmt__width
-mdfmt.mdfmt
-pretty.__shellfu_pretty__init
-pretty._pretty__cat
-pretty._pretty__echo
-pretty._pretty__echo_args
-pretty._pretty__echo_cmd
-pretty._pretty__echo_files
-pretty._pretty__echo_help
-pretty._pretty__echo_lines
-pretty._pretty__echo_trace
-pretty._pretty__echo_usage
-pretty._pretty__echo_vars
-pretty._pretty__get_caller
-pretty._pretty__get_frontend
-pretty._pretty__is_excluded
-pretty._pretty__is_frontend
-pretty._pretty__is_internal
-pretty._pretty__is_word
-pretty.debug
-pretty.debug_pipe
-pretty.die
-pretty.echos
-pretty.mkhelp
-pretty.mkusage
-pretty.think
-pretty.warn
-sfdoc.__sfdoc__export_as_manpage
-sfdoc.__sfdoc__export_as_markdown
-sfdoc.__sfdoc__export_as_pod
-sfdoc.__sfdoc__filter_body
-sfdoc.__sfdoc__filter_doc
-sfdoc.__sfdoc__filter_fdoc
-sfdoc.__sfdoc__filter_fun
-sfdoc.__sfdoc__filter_hidden
-sfdoc.__sfdoc__filter_mdoc
-sfdoc.__sfdoc__filter_var
-sfdoc.__sfdoc__filter_vdoc
-sfdoc.__sfdoc__get_doc
-sfdoc.__sfdoc__get_part
-sfdoc.__sfdoc__md_escapes
-sfdoc.__sfdoc__strip_doc
-sfdoc.sfdoc__export
-sfdoc.sfdoc__ls
-sfdoc.sfdoc__ls_m
+_pretty_color:__shellfu__pretty_color__init
+_pretty_color:_pretty__debug
+_pretty_color:_pretty__die
+_pretty_color:_pretty__mkhelp
+_pretty_color:_pretty__mkusage
+_pretty_color:_pretty__think
+_pretty_color:_pretty__warn
+_pretty_html:_pretty__debug
+_pretty_html:_pretty__die
+_pretty_html:_pretty__mkhelp
+_pretty_html:_pretty__mkusage
+_pretty_html:_pretty__think
+_pretty_html:_pretty__warn
+_pretty_journald:_pretty__debug
+_pretty_journald:_pretty__die
+_pretty_journald:_pretty__mkhelp
+_pretty_journald:_pretty__mkusage
+_pretty_journald:_pretty__think
+_pretty_journald:_pretty__warn
+_pretty_notify:_pretty__debug
+_pretty_notify:_pretty__die
+_pretty_notify:_pretty__mkhelp
+_pretty_notify:_pretty__mkusage
+_pretty_notify:_pretty__think
+_pretty_notify:_pretty__warn
+_pretty_plain:_pretty__debug
+_pretty_plain:_pretty__die
+_pretty_plain:_pretty__mkhelp
+_pretty_plain:_pretty__mkusage
+_pretty_plain:_pretty__think
+_pretty_plain:_pretty__warn
+charmenu:charmenu
+exit:exit_error
+exit:exit_no
+exit:exit_ok
+exit:exit_panic
+exit:exit_usage
+inigrep:_inigrep__fltcmt
+inigrep:_inigrep__fltkey
+inigrep:_inigrep__fltlst
+inigrep:_inigrep__fltsct
+inigrep:_inigrep__query
+inigrep:_inigrep__validate_ks
+inigrep:inigrep
+mdfmt:_mdfmt__fmttype
+mdfmt:_mdfmt__indent
+mdfmt:_mdfmt__join
+mdfmt:_mdfmt__quote
+mdfmt:_mdfmt__width
+mdfmt:mdfmt
+pretty:__shellfu_pretty__init
+pretty:_pretty__cat
+pretty:_pretty__echo
+pretty:_pretty__echo_args
+pretty:_pretty__echo_cmd
+pretty:_pretty__echo_files
+pretty:_pretty__echo_help
+pretty:_pretty__echo_lines
+pretty:_pretty__echo_trace
+pretty:_pretty__echo_usage
+pretty:_pretty__echo_vars
+pretty:_pretty__get_caller
+pretty:_pretty__get_frontend
+pretty:_pretty__is_excluded
+pretty:_pretty__is_frontend
+pretty:_pretty__is_internal
+pretty:_pretty__is_word
+pretty:debug
+pretty:debug_pipe
+pretty:die
+pretty:echos
+pretty:mkhelp
+pretty:mkusage
+pretty:think
+pretty:warn
+sfdoc:__sfdoc__export_as_manpage
+sfdoc:__sfdoc__export_as_markdown
+sfdoc:__sfdoc__export_as_pod
+sfdoc:__sfdoc__filter_body
+sfdoc:__sfdoc__filter_doc
+sfdoc:__sfdoc__filter_fdoc
+sfdoc:__sfdoc__filter_fun
+sfdoc:__sfdoc__filter_hidden
+sfdoc:__sfdoc__filter_mdoc
+sfdoc:__sfdoc__filter_var
+sfdoc:__sfdoc__filter_vdoc
+sfdoc:__sfdoc__get_doc
+sfdoc:__sfdoc__get_part
+sfdoc:__sfdoc__md_escapes
+sfdoc:__sfdoc__strip_doc
+sfdoc:sfdoc__export
+sfdoc:sfdoc__ls
+sfdoc:sfdoc__ls_m

tests/shellfu_api/oracle/variables.stdout

@@ -1,36 +1,36 @@
-_pretty_color._PRETTY_COLOR_DEBUG
-_pretty_color._PRETTY_COLOR_DIE
-_pretty_color._PRETTY_COLOR_OFF
-_pretty_color._PRETTY_COLOR_THINK
-_pretty_color._PRETTY_COLOR_USAGE_IS
-_pretty_color._PRETTY_COLOR_WARN
-charmenu.CHARMENU_FILE
-exit.EXIT_ERROR
-exit.EXIT_NO
-exit.EXIT_OK
-exit.EXIT_PANIC
-exit.EXIT_USAGE
-mdfmt.MDFMT_WIDTH
-pretty.PRETTY
-pretty.PRETTY_DEBUG
-pretty.PRETTY_DEBUG_EXCLUDE
-pretty.PRETTY_USAGE
-pretty.PRETTY_VERBOSE
-sfdoc.SFDOC_SHOW_HIDDEN
-termcolors.TERMCOLORS_BLACK
-termcolors.TERMCOLORS_BLUE
-termcolors.TERMCOLORS_CYAN
-termcolors.TERMCOLORS_GREEN
-termcolors.TERMCOLORS_LBLACK
-termcolors.TERMCOLORS_LBLUE
-termcolors.TERMCOLORS_LCYAN
-termcolors.TERMCOLORS_LGREEN
-termcolors.TERMCOLORS_LMAGENTA
-termcolors.TERMCOLORS_LRED
-termcolors.TERMCOLORS_LWHITE
-termcolors.TERMCOLORS_LYELLOW
-termcolors.TERMCOLORS_MAGENTA
-termcolors.TERMCOLORS_NONE
-termcolors.TERMCOLORS_RED
-termcolors.TERMCOLORS_WHITE
-termcolors.TERMCOLORS_YELLOW
+_pretty_color:_PRETTY_COLOR_DEBUG
+_pretty_color:_PRETTY_COLOR_DIE
+_pretty_color:_PRETTY_COLOR_OFF
+_pretty_color:_PRETTY_COLOR_THINK
+_pretty_color:_PRETTY_COLOR_USAGE_IS
+_pretty_color:_PRETTY_COLOR_WARN
+charmenu:CHARMENU_FILE
+exit:EXIT_ERROR
+exit:EXIT_NO
+exit:EXIT_OK
+exit:EXIT_PANIC
+exit:EXIT_USAGE
+mdfmt:MDFMT_WIDTH
+pretty:PRETTY
+pretty:PRETTY_DEBUG
+pretty:PRETTY_DEBUG_EXCLUDE
+pretty:PRETTY_USAGE
+pretty:PRETTY_VERBOSE
+sfdoc:SFDOC_SHOW_HIDDEN
+termcolors:TERMCOLORS_BLACK
+termcolors:TERMCOLORS_BLUE
+termcolors:TERMCOLORS_CYAN
+termcolors:TERMCOLORS_GREEN
+termcolors:TERMCOLORS_LBLACK
+termcolors:TERMCOLORS_LBLUE
+termcolors:TERMCOLORS_LCYAN
+termcolors:TERMCOLORS_LGREEN
+termcolors:TERMCOLORS_LMAGENTA
+termcolors:TERMCOLORS_LRED
+termcolors:TERMCOLORS_LWHITE
+termcolors:TERMCOLORS_LYELLOW
+termcolors:TERMCOLORS_MAGENTA
+termcolors:TERMCOLORS_NONE
+termcolors:TERMCOLORS_RED
+termcolors:TERMCOLORS_WHITE
+termcolors:TERMCOLORS_YELLOW