fix: fix Makefile.toml task names

Author: savente93

examples/Makefile.toml

@@ -1,38 +1,54 @@
-[tasks.doc-build]
+# Modify these to suit your needs
+[env]
+BIBFILE = "cite.bib"
+STYLE = "apa"
+
+# actually generate the docs
+[tasks.doc-gen]
 command = "cargo"
 args = ["doc", "--no-deps", "-q"]
 
-[tasks.doc-post-proc]
+[tasks.doc-post-process]
+# we'll use fd to find all the doc files
 command = "fd"
 args = [
   ".",
-  "./${CARGO_MAKE_CRATE_TARGET_DIRECTORY}/doc/${CARGO_MAKE_CRATE_FS_NAME}",
+  "${CARGO_MAKE_CRATE_TARGET_DIRECTORY}/doc/${CARGO_MAKE_CRATE_FS_NAME}", # search the generated doc files
   "-e",
-  "html",
-  "-x",
+  "html",                                                                 # only those with extention html
+  "-x",                                                                   # run the cmb command on each file found
   "cmb",
-  "-b",
-  "cite.bib",
-  "--style",
-  "apa",
-  "--format",
+  "-b",                                                                   # use bibfile cite.bib
+  "${BIBFILE}",
+  "--style",                                                              # use style defined in env table
+  "${STYLE}",
+  "--format",                                                             # generate in html so it looks good in docs
   "html",
-  "-i",
-  "{}",
+  "-i",                                                                   # modify files inplace
+  "{}",                                                                   # fd shorthand for "the file you just found"
 ]
-dependencies = ["fd", "doc-build"]
+# dependencies to make sure the necessary binaries are installed
+# and the docs are actually generated
+dependencies = ["fd", "cmb", "doc-gen"]
 
-[tasks.doc-http]
+# serve docs over simple http server
+[tasks.doc-serve]
 command = "http-server"
-args = ['-i', '--cors', 'target/doc']
+args = ['-i', '--cors', 'target/doc']       # -i to open index.html in dir
+dependencies = ["http", "doc-post-process"]
 
-[tasks.doc-serve]
-run_task = [{ name = ['doc-http', "doc-post-proc"], parallel = true }]
+# just an alias
+[tasks.doc-build]
+run_task = "doc-post-process"
 
+# needed for finding the files to modify in a cross platform way
 [tasks.fd]
 install_crate = { crate_name = "fd-find", binary = "fd", test_arg = ["--help"] }
 
+# simple http server we can bootstrap from crates.io directly
 [tasks.http]
-install_crate = { crate_name = "http-server", binary = "http-server", test_arg = [
-  "--help",
-] }
+install_crate = { crate_name = "http-server", binary = "http-server", test_arg = "--help" }
+
+# that's us of course
+[tasks.cmb]
+install_crate = { crate_name = "cite-me-bro", binary = "cmb", test_arg = "--help" }