docs: Move deprecated functions to bottom

Author: hyperupcall

docs/api.md

@@ -6,27 +6,21 @@ Core functions for any Bash program
 
 ## Index
 
-* [core.init()](#coreinit)
 * [core.trap_add()](#coretrap_add)
 * [core.trap_remove()](#coretrap_remove)
 * [core.shopt_push()](#coreshopt_push)
 * [core.shopt_pop()](#coreshopt_pop)
 * [core.err_set()](#coreerr_set)
 * [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)
 * [core.should_output_color()](#coreshould_output_color)
 * [core.get_package_info()](#coreget_package_info)
-
-### core.init()
-
-(DEPRECATED) Initiates global variables used by other functions. Deprecated as this function is called automatically
-
-_Function has no arguments._
+* [core.init()](#coreinit)
+* [core.stacktrace_print()](#corestacktrace_print)
 
 ### core.trap_add()
 
@@ -132,14 +126,6 @@ _does_ exist
 
 _Function has no arguments._
 
-### core.stacktrace_print()
-
-(DEPRECATED) Prints stacktrace
-
-#### See also
-
-* [core.print_stacktrace](#coreprint_stacktrace)
-
 ### core.print_stacktrace()
 
 Prints stacktrace
@@ -199,3 +185,18 @@ is an empty string
 
 * **REPLY** (string): The full path to the directory
 
+### core.init()
+
+(DEPRECATED) Initiates global variables used by other functions. Deprecated as
+this function is called automatically by functions that use global variables
+
+_Function has no arguments._
+
+### core.stacktrace_print()
+
+(DEPRECATED) Prints stacktrace
+
+#### See also
+
+* [core.print_stacktrace](#coreprint_stacktrace)
+

pkg/src/public/bash-core.sh

@@ -3,12 +3,6 @@
 # @name bash-core
 # @description Core functions for any Bash program
 
-# @description (DEPRECATED) Initiates global variables used by other functions. Deprecated as this function is called automatically
-# @noargs
-core.init() {
-	core.util.init
-}
-
 # @description Adds a handler for a particular `trap` signal or event. Noticably,
 # unlike the 'builtin' trap, this does not override any other existing handlers
 # @arg $1 string Function to execute on an event. Integers are forbiden
@@ -269,13 +263,6 @@ 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
@@ -395,3 +382,17 @@ core.get_package_info() {
 		fi
 	done < "$toml_file"; unset -v line
 }
+
+# @description (DEPRECATED) Initiates global variables used by other functions. Deprecated as
+# this function is called automatically by functions that use global variables
+# @noargs
+core.init() {
+	core.util.init
+}
+
+# @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 "$@"
+}