Browse Source

Rename binary: shellfu-doc to sfdoc

'sfdoc' is easier to type and resembles 'pydoc' and 'perldoc' so it's
even easier to remember.
Alois Mahdal 6 years ago
parent
commit
50a485467b

+ 7
- 7
README.md View File

@@ -85,18 +85,18 @@ That should return path to *shellfu.sh* and version, respectively.
85 85
 And that's also *all* this command does.
86 86
 
87 87
 Next, if you have also installed some modules, you can look around
88
-using `shellfu-doc`:
88
+using `sfdoc`:
89 89
 
90
-    shellfu-doc --lsmods
91
-    shellfu-doc inigrep
90
+    sfdoc --lsmods
91
+    sfdoc inigrep
92 92
 
93 93
 This is how you access documentation of modules available on the system.
94 94
 You can also access documentation of a modules directly by specifying
95 95
 path to the file (the path must contain slash):
96 96
 
97
-    shellfu-doc path/to/my/module.sh
97
+    sfdoc path/to/my/module.sh
98 98
 
99
-Note that shellfu-doc only works if the module follows Shellfu Style
99
+Note that sfdoc only works if the module follows Shellfu Style
100 100
 Guide, in particular the Docstrings section.
101 101
 
102 102
 Next, you can create your first Shellfu-Bash script:
@@ -130,7 +130,7 @@ This is how above script works:
130 130
  2. Using `shellfu import pretty`, we're importing module called "pretty".
131 131
     shellfu will figure out where exactly it is.
132 132
 
133
- 3. If we called `shellfu-doc pretty` in another terminal, we would find
133
+ 3. If we called `sfdoc pretty` in another terminal, we would find
134 134
     out that among others, this module contains functions `think`, `debug`,
135 135
     `warn` and `die`.
136 136
 
@@ -162,7 +162,7 @@ to do is
162 162
     my_module.sh is.
163 163
 
164 164
 To get the basic stuff, nothing more is really needed.  If you want, however,
165
-your module be explorable by `shellfu-doc`, you need to follow Shellfu Style
165
+your module be explorable by `sfdoc`, you need to follow Shellfu Style
166 166
 Guide.
167 167
 
168 168
 

+ 1
- 1
mkit.ini View File

@@ -41,7 +41,7 @@
41 41
     share    = 644
42 42
 
43 43
 [files]
44
-    bin      = src/bin/shellfu-doc
44
+    bin      = src/bin/sfdoc
45 45
     bin      = src/bin/shellfu-embed
46 46
     bin      = src/bin/sfpath
47 47
     doc      = LICENSE.md

+ 1
- 1
notes/intro.md View File

@@ -75,7 +75,7 @@ Shellfu, as a project consists of three parts:
75 75
     allowing you to collaborate on the code in an efficient manner
76 76
     (in-line documentation, peer review, code readability...).
77 77
 
78
- *  As a bonus, *shellfu-doc*, building upon the Shellfu Style Guide,
78
+ *  As a bonus, *sfdoc*, building upon the Shellfu Style Guide,
79 79
     allows your user to discover and read documentation of installed
80 80
     modules (akin to *perldoc* or *pydoc*).
81 81
 

+ 1
- 1
packaging/debian/shellfu-devel.install View File

@@ -1,3 +1,3 @@
1 1
 /etc/bash_completion.d/shellfu-devel.bash
2
-/usr/bin/shellfu-doc
2
+/usr/bin/sfdoc
3 3
 /usr/bin/shellfu-embed

+ 2
- 2
packaging/template.spec View File

@@ -50,7 +50,7 @@ Summary: Essential developer tools
50 50
 Requires: shellfu-bash-core
51 51
 %description devel
52 52
 This sub-package contains tools useful mostly for development of shellfu
53
-scripts; most notably shellfu-doc which provides access to online
53
+scripts; most notably sfdoc which provides access to online
54 54
 (as in traditional man pages) documentation of shellfu modules.
55 55
 
56 56
 %package sh
@@ -111,7 +111,7 @@ make test \
111 111
 
112 112
 %files devel
113 113
 %config %{_sysconfdir}/bash_completion.d/shellfu-devel.bash
114
-%{_bindir}/shellfu-doc
114
+%{_bindir}/sfdoc
115 115
 %{_bindir}/shellfu-embed
116 116
 
117 117
 %files sh

src/bin/shellfu-doc → src/bin/sfdoc View File


tests/shellfu_doc/TF_RUN → tests/sfdoc/TF_RUN View File

@@ -29,12 +29,12 @@ tf_do_subtest() {
29 29
     local name=$1
30 30
     local cmd
31 31
     case $name in
32
-        lsx_tricky)    cmd="shellfu-doc --ls test/include/tricky.sh" ;;
33
-        lsv_tricky)    cmd="shellfu-doc --lsvar test/include/tricky.sh" ;;
34
-        lsf_tricky)    cmd="shellfu-doc --lsfun test/include/tricky.sh" ;;
35
-        direct_path)   cmd="shellfu-doc -e markdown test/other/path.sh" ;;
36
-        included_path) cmd="shellfu-doc -I test/other -e markdown path" ;;
37
-        *)             cmd="shellfu-doc -e markdown $name" ;;
32
+        lsx_tricky)    cmd="sfdoc --ls test/include/tricky.sh" ;;
33
+        lsv_tricky)    cmd="sfdoc --lsvar test/include/tricky.sh" ;;
34
+        lsf_tricky)    cmd="sfdoc --lsfun test/include/tricky.sh" ;;
35
+        direct_path)   cmd="sfdoc -e markdown test/other/path.sh" ;;
36
+        included_path) cmd="sfdoc -I test/other -e markdown path" ;;
37
+        *)             cmd="sfdoc -e markdown $name" ;;
38 38
     esac
39 39
     tf_testflt -n "$name" -O "oracle/$name.stdout" -E "oracle/$name.stderr" "$cmd"
40 40
 }

tests/shellfu_doc/oracle/direct_path.stderr → tests/sfdoc/oracle/direct_path.stderr View File


tests/shellfu_doc/oracle/direct_path.stdout → tests/sfdoc/oracle/direct_path.stdout View File


tests/shellfu_doc/oracle/empty.stderr → tests/sfdoc/oracle/empty.stderr View File


tests/shellfu_doc/oracle/empty.stdout → tests/sfdoc/oracle/empty.stdout View File


tests/shellfu_doc/oracle/included_path.stderr → tests/sfdoc/oracle/included_path.stderr View File


tests/shellfu_doc/oracle/included_path.stdout → tests/sfdoc/oracle/included_path.stdout View File


tests/shellfu_doc/oracle/lsf_tricky.stderr → tests/sfdoc/oracle/lsf_tricky.stderr View File


tests/shellfu_doc/oracle/lsf_tricky.stdout → tests/sfdoc/oracle/lsf_tricky.stdout View File


tests/shellfu_doc/oracle/lsv_tricky.stderr → tests/sfdoc/oracle/lsv_tricky.stderr View File


tests/shellfu_doc/oracle/lsv_tricky.stdout → tests/sfdoc/oracle/lsv_tricky.stdout View File


tests/shellfu_doc/oracle/lsx_tricky.stderr → tests/sfdoc/oracle/lsx_tricky.stderr View File


tests/shellfu_doc/oracle/lsx_tricky.stdout → tests/sfdoc/oracle/lsx_tricky.stdout View File


tests/shellfu_doc/oracle/naked.stderr → tests/sfdoc/oracle/naked.stderr View File


tests/shellfu_doc/oracle/naked.stdout → tests/sfdoc/oracle/naked.stdout View File


tests/shellfu_doc/oracle/nonesuch.stderr → tests/sfdoc/oracle/nonesuch.stderr View File


tests/shellfu_doc/oracle/nonesuch.stdout → tests/sfdoc/oracle/nonesuch.stdout View File


tests/shellfu_doc/oracle/simple.stderr → tests/sfdoc/oracle/simple.stderr View File


tests/shellfu_doc/oracle/simple.stdout → tests/sfdoc/oracle/simple.stdout View File


tests/shellfu_doc/oracle/simplest.stderr → tests/sfdoc/oracle/simplest.stderr View File


tests/shellfu_doc/oracle/simplest.stdout → tests/sfdoc/oracle/simplest.stdout View File


tests/shellfu_doc/oracle/tricky.stderr → tests/sfdoc/oracle/tricky.stderr View File


tests/shellfu_doc/oracle/tricky.stdout → tests/sfdoc/oracle/tricky.stdout View File


tests/shellfu_doc/test/include/empty.sh → tests/sfdoc/test/include/empty.sh View File


tests/shellfu_doc/test/include/naked.sh → tests/sfdoc/test/include/naked.sh View File


tests/shellfu_doc/test/include/simple.sh → tests/sfdoc/test/include/simple.sh View File


tests/shellfu_doc/test/include/simplest.sh → tests/sfdoc/test/include/simplest.sh View File


tests/shellfu_doc/test/include/tricky.sh → tests/sfdoc/test/include/tricky.sh View File


tests/shellfu_doc/test/other/path.sh → tests/sfdoc/test/other/path.sh View File


+ 3
- 3
tests/shellfu_api/TF_RUN View File

@@ -25,12 +25,12 @@ flt_ours() {
25 25
 
26 26
 shellfu_get_all() {
27 27
     local t=$1      # type (functions, variables, modules)
28
-    shellfu-doc --all --lsmod \
28
+    sfdoc --all --lsmod \
29 29
       | flt_ours \
30 30
       | case $t in
31 31
             modules)    cat ;;
32
-            variables)  xargs -L1 shellfu-doc --all --lsvar ;;
33
-            functions)  xargs -L1 shellfu-doc --all --lsfun ;;
32
+            variables)  xargs -L1 sfdoc --all --lsvar ;;
33
+            functions)  xargs -L1 sfdoc --all --lsfun ;;
34 34
         esac \
35 35
       | LC_ALL=C sort
36 36
 }