docs: Update deprecations and cleanups

Author: hyperupcall

README.md

@@ -6,29 +6,29 @@ Core functions for any Bash program
 
 The following is a brief overview of the available functions. See [api.md](./docs/api.md) for more details
 
-### `trap`
+### trap
 
 Add or remove multiple functions at a time to any set of signals. Without these, it is impossible to trap a signal without erasing a previous one
 
 - `core.trap_add`
 - `core.trap_remove`
 
-### `shopt`
+### shopt
 
 Enable or disable a shell option. Enabling a shell option adds it to a hidden stack. When that shell option is no longer needed, it should be removed by popping it from the stack
 
 - `core.shopt_push`
 - `core.shopt_pop`
 
-### `err`
+### err
 
 It can look redundant (compared to `if ! fn; then :; fi`) to define error functions, but it can help make errors a bit more safe in larger applications, since you don't have to worry about a caller forgetting to `if ! fn` or `fn ||` (and terminating the script if `set -e`). It also makes it easier to communicate specific error codes and helps separate between calculated / expected errors and unexpected errors / faults
 
 - `core.err_set`
 - `core.err_clear`
 - `core.err_exists`
 
-### `print`
+### print
 
 - `core.print_stacktrace`
 - `core.print_error`
@@ -37,22 +37,15 @@ It can look redundant (compared to `if ! fn; then :; fi`) to define error functi
 
 The function `core.print_stacktrace` prints the stack trace. It is recommended to use this with `core.trap_add` (see [example](./docs/api.md#coreprint_stacktrace))
 
-### Misc
-
-Miscellaneous functions
-
-- `core.panic()`
-- `core.should_output_color()`
-
-This is what it may look like
+Following is a `core.print_stacktrace` example:
 
 ```txt
 Stacktrace:
-  in core.stacktrace_print (/storage/ur/storage_home/Docs/Programming/repos/Groups/Bash/bash-core/.hidden/test.sh:0)
-  in err_handler (/storage/ur/storage_home/Docs/Programming/repos/Groups/Bash/bash-core/.hidden/test.sh:36)
-  in fn3 (/storage/ur/storage_home/Docs/Programming/repos/Groups/Bash/bash-core/.hidden/test.sh:48)
-  in fn2 (/storage/ur/storage_home/Docs/Programming/repos/Groups/Bash/bash-core/.hidden/test.sh:53)
-  in fn (/storage/ur/storage_home/Docs/Programming/repos/Groups/Bash/bash-core/.hidden/test.sh:57)
+  in core.stacktrace_print (/home/edwin/repos/bash-core/.hidden/test.sh:0)
+  in err_handler (/home/edwin/repos/bash-core/.hidden/test.sh:36)
+  in fn3 (/home/edwin/repos/bash-core/.hidden/test.sh:48)
+  in fn2 (/home/edwin/repos/bash-core/.hidden/test.sh:53)
+  in fn (/home/edwin/repos/bash-core/.hidden/test.sh:57)
 ```
 
 ## Installation

docs/api.md

@@ -210,13 +210,14 @@ Print an informative message to standard output
 
 ### core.should_output_color()
 
-Determine if color should be printed. Note that this doesn't
-use tput because simple environment variable checking heuristics suffice
+(DEPRECATED). Determine if color should be printed. Note that this doesn't
+use tput because simple environment variable checking heuristics suffice. Deprecated because this code
+has been moved to bash-std
 
 ### core.get_package_info()
 
-Gets information from a particular package. If the key does not exist, then the value
-is an empty string
+(DEPRECATED) Gets information from a particular package. If the key does not exist, then the value
+is an empty string. Deprecated as this code has been moved to bash-std
 
 #### Arguments
 

pkg/src/public/bash-core.sh

@@ -358,8 +358,9 @@ core.print_info() {
 	printf '%s\n' "Info${msg:+": "}$msg"
 }
 
-# @description Determine if color should be printed. Note that this doesn't
-# use tput because simple environment variable checking heuristics suffice
+# @description (DEPRECATED). Determine if color should be printed. Note that this doesn't
+# use tput because simple environment variable checking heuristics suffice. Deprecated because this code
+# has been moved to bash-std
 core.should_output_color() {
 	# https://no-color.org
 	if [ ${NO_COLOR+x} ]; then
@@ -390,8 +391,8 @@ core.should_output_color() {
 	return 1
 }
 
-# @description Gets information from a particular package. If the key does not exist, then the value
-# is an empty string
+# @description (DEPRECATED) Gets information from a particular package. If the key does not exist, then the value
+# is an empty string. Deprecated as this code has been moved to bash-std
 # @arg $1 string The `$BASALT_PACKAGE_DIR` of the caller
 # @set directory string The full path to the directory
 core.get_package_info() {