api: Deprecate core.stacktrace_print

Use `core.print_stacktrace` instead for consistency.

Author: hyperupcall

docs/api.md

@@ -15,6 +15,7 @@ Core functions for any Bash program
 * [core.err_clear()](#coreerr_clear)
 * [core.err_exists()](#coreerr_exists)
 * [core.stacktrace_print()](#corestacktrace_print)
+* [core.print_stacktrace()](#coreprint_stacktrace)
 * [core.print_error()](#coreprint_error)
 * [core.print_warn()](#coreprint_warn)
 * [core.print_info()](#coreprint_info)
@@ -133,14 +134,22 @@ _Function has no arguments._
 
 ### core.stacktrace_print()
 
+(DEPRECATED) Prints stacktrace
+
+#### See also
+
+* [core.print_stacktrace](#coreprint_stacktrace)
+
+### core.print_stacktrace()
+
 Prints stacktrace
 
 #### Example
 
 ```bash
 err_handler() {
   local exit_code=$?
-  core.stacktrace_print
+  core.print_stacktrace
   exit $exit_code
 }
 core.trap_add 'err_handler' ERR

pkg/src/public/bash-core.sh

@@ -269,16 +269,23 @@ core.err_exists() {
 	fi
 }
 
+# @description (DEPRECATED) Prints stacktrace
+# @see core.print_stacktrace
+core.stacktrace_print() {
+	core.print_warn "The function 'core.stacktrace_print' is deprecated in favor of 'core.print_stacktrace'"
+	core.print_stacktrace "$@"
+}
+
 # @description Prints stacktrace
 # @noargs
 # @example
 #  err_handler() {
 #    local exit_code=$?
-#    core.stacktrace_print
+#    core.print_stacktrace
 #    exit $exit_code
 #  }
 #  core.trap_add 'err_handler' ERR
-core.stacktrace_print() {
+core.print_stacktrace() {
 	printf '%s\n' 'Stacktrace:'
 
 	local old_cd="$PWD" cd_failed='no'