Moved all quoting of docs to print functions.
All checks were successful
Run test asserts / Test-Asserts (push) Successful in 8s

This commit is contained in:
Willem Cazander 2024-07-16 19:32:08 +02:00
parent ff16e6b5cb
commit 760ebffb6f
37 changed files with 410 additions and 409 deletions

View file

@ -4,7 +4,7 @@ $(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-make-check-arg2,$(0),$(1),$(2))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_CONV_UNIX2DOS) $(2))
$(MB_ᕽᕽᕽ   )unix2dos -q -n $(1) $(2)
endef
$(call mb-make-call,mb-doc-function,mb-conv-unix2dos,"Converts an unix file to dos.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-conv-unix2dos,Converts an unix file to dos.,<in> <out>)
define mb-conv-dos2unix
@ -12,5 +12,5 @@ $(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-make-check-arg2,mb-conv-dos2unix,
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_CONV_DOS2UNIX) $(2))
$(MB_ᕽᕽᕽ   )dos2unix -q -n $(1) $(2)
endef
$(call mb-make-call,mb-doc-function,mb-conv-dos2unix,"Converts an dos file to unix.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-conv-dos2unix,Converts an dos file to unix.,<in> <out>)

View file

@ -1,15 +1,15 @@
MB_NESTOR80_PATH ?=
$(call mb-make-call,mb-doc-variable,MB_NESTOR80_PATH,"Optional path where Nestor80 binaries are located.")
$(call mb-make-call,mb-doc-variable,MB_NESTOR80_PATH,Optional path where Nestor80 binaries are located.)
MB_NESTOR80_FLAG_VERBOSE ?=--no-show-banner --no-color-output --verbosity 0
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_FLAG_VERBOSE,"The Nestor80 shared verbose flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_FLAG_VERBOSE,The Nestor80 shared verbose flags.)
MB_NESTOR80_N80_FLAGS ?=
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_N80_FLAGS,"The N80 compile flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_N80_FLAGS,The N80 compile flags.)
MB_NESTOR80_LK80_FLAGS ?=
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_LK80_FLAGS,"The LK80 linker flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_NESTOR80_LK80_FLAGS,The LK80 linker flags.)
define _mb-nestor80-path
@ -21,54 +21,54 @@ define mb-nestor80-compile
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_NESTOR80_COMPILE) $(2))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-nestor80-path,N80) $(1) $(2) $(MB_NESTOR80_N80_FLAGS) $(MB_NESTOR80_FLAG_VERBOSE)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-compile,"Compiles source code.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-compile,Compiles source code.,<in> <out>)
define mb-nestor80-link
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_NESTOR80_LINK) $(2) @ $(3))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-nestor80-path,LK80) $(MB_NESTOR80_LK80_FLAGS) $(MB_NESTOR80_FLAG_VERBOSE) --code $(3) --output-format bin -o $(2) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link,"Links to custom code location.","<in> <out> <code-loc>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link,Links to custom code location.,<in> <out> <code-loc>)
define mb-nestor80-link-0000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),0000h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-0000,"Links to 0x0000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-0000,Links to 0x0000.,<in> <out>)
define mb-nestor80-link-0100
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),0100h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-0100,"Links to 0x0100.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-0100,Links to 0x0100.,<in> <out>)
define mb-nestor80-link-1000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),1000h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-1000,"Links to 0x1000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-1000,Links to 0x1000.,<in> <out>)
define mb-nestor80-link-4000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),4000h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-4000,"Links to 0x4000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-4000,Links to 0x4000.,<in> <out>)
define mb-nestor80-link-8000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),8000h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-8000,"Links to 0x8000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-8000,Links to 0x8000.,<in> <out>)
define mb-nestor80-link-C000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link,$(1),$(2),C000h)
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-C000,"Links to 0xC000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-C000,Links to 0xC000.,<in> <out>)
define mb-nestor80-link-bdos
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-nestor80-link-0100,$(1),$(2))
endef
$(call mb-make-call,mb-doc-function,mb-nestor80-link-bdos,"Links to BDOS.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-nestor80-link-bdos,Links to BDOS.,<in> <out>)

View file

@ -1,30 +1,30 @@
MB_OS_RM ?= rm -f
$(call mb-make-call,mb-doc-variable-rock,MB_OS_RM,"Native OS delete command.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_RM,Native OS delete command.)
MB_OS_RMDIR ?= rm -rf
$(call mb-make-call,mb-doc-variable-rock,MB_OS_RMDIR,"Native OS remove folder command.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_RMDIR,Native OS remove folder command.)
MB_OS_MKDIR ?= mkdir -p
$(call mb-make-call,mb-doc-variable-rock,MB_OS_MKDIR,"Native OS create folder command.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_MKDIR,Native OS create folder command.)
MB_OS_COPY ?= cp
$(call mb-make-call,mb-doc-variable-rock,MB_OS_COPY,"Native OS copy command.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_COPY,Native OS copy command.)
MB_OS_STDOUT_IGNORE ?= >/dev/null
$(call mb-make-call,mb-doc-variable-rock,MB_OS_STDOUT_IGNORE,"Native OS ignore stdout.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_STDOUT_IGNORE,Native OS ignore stdout.)
MB_OS_STDERR_IGNORE ?= 2>/dev/null
$(call mb-make-call,mb-doc-variable-rock,MB_OS_STDERR_IGNORE,"Native OS ignore stderr.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_STDERR_IGNORE,Native OS ignore stderr.)
MB_OS_SEP ?=/
$(call mb-make-call,mb-doc-variable-rock,MB_OS_SEP,"Native OS path seperator.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_SEP,Native OS path seperator.)
MB_OS_CACHE ?= ~/.cache
$(call mb-make-call,mb-doc-variable-rock,MB_OS_CACHE,"Native OS application cache folder.")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_CACHE,Native OS application cache folder.)
MB_OS_TERM_COLORS ?= $(shell tput colors 2> /dev/null;test $$? -eq 0 || echo "-1")
$(call mb-make-call,mb-doc-variable-rock,MB_OS_TERM_COLORS,"Native OS terminal color count support.")
MB_OS_TERM_COLORS ?= $(shell tput colors 2> /dev/null;test $$? -eq 0 || echo -1)
$(call mb-make-call,mb-doc-variable-rock,MB_OS_TERM_COLORS,Native OS terminal color count support.)
ifdef OS
@ -45,83 +45,83 @@ endif
define mb-os-file-empty
$(MB_ᕽᕽᕽ   )$(file >$(1))
endef
$(call mb-make-call,mb-doc-function,mb-os-file-empty,"Makes an file empty.","<file>")
$(call mb-make-call,mb-doc-function,mb-os-file-empty,Makes an file empty.,<file>)
define mb-os-file-append
$(MB_ᕽᕽᕽ   )$(file >>$(1),$(2))
endef
$(call mb-make-call,mb-doc-function,mb-os-file-append,"Appends text to an file","<file> <text>")
$(call mb-make-call,mb-doc-function,mb-os-file-append,Appends text to an file,<file> <text>)
define mb-os-file-copy
$(MB_ᕽᕽᕽ   )$(MB_OS_COPY) $(1) $(2)
endef
$(call mb-make-call,mb-doc-function,mb-os-file-copy,"Copy an file.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-os-file-copy,Copy an file.,<in> <out>)
define mb-os-file-delete
$(MB_ᕽᕽᕽ   )$(MB_OS_RM) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-os-file-delete,"Deletes an file.","<file>")
$(call mb-make-call,mb-doc-function,mb-os-file-delete,Deletes an file.,<file>)
define mb-os-file-touch
$(MB_ᕽᕽᕽ   )touch $(1)
endef
$(call mb-make-call,mb-doc-function,mb-os-file_touch,"Changes file timestamps.","<file>")
$(call mb-make-call,mb-doc-function,mb-os-file_touch,Changes file timestamps.,<file>)
define mb-os-dir-delete
$(MB_ᕽᕽᕽ   )$(MB_OS_RMDIR) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-os-dir-delete,"Delete the full folder.","<dir>")
$(call mb-make-call,mb-doc-function,mb-os-dir-delete,Delete the full folder.,<dir>)
define mb-os-dir-create
$(MB_ᕽᕽᕽ   )$(MB_OS_MKDIR) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-os-dir-create,"Creates an folder.","<dir>")
$(call mb-make-call,mb-doc-function,mb-os-dir-create,Creates an folder.,<dir>)
define mb-os-crayon-tagged-echo
$(MB_ᕽᕽᕽ   )$(if $(filter -1,$(MB_OS_TERM_COLORS)),@echo $(MB_I18N_OS_CRAYON_TAG) $(2),@echo -e "\x1B[$(1)m$(MB_I18N_OS_CRAYON_TAG)\x1B[39m $(2)")
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-crayon-tagged-echo,"Echo's an prefixed message to stdout with ansi color code.","<color-code> <message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-crayon-tagged-echo,Echo's an prefixed message to stdout with ansi color code.,<color-code> <message>)
define mb-os-echo-report
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,31,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-report,"Echo's an message to stdout with 'red' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-report,Echo's an message to stdout with 'red' crayon.,<message>)
define mb-os-echo-good
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,32,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-good,"Echo's an message to stdout with 'green' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-good,Echo's an message to stdout with 'green' crayon.,<message>)
define mb-os-echo-assert
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,33,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-assert,"Echo's an message to stdout with 'yellow' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-assert,Echo's an message to stdout with 'yellow' crayon.,<message>)
define mb-os-echo-command
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,34,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-command,"Echo's an message to stdout with 'blue' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-command,Echo's an message to stdout with 'blue' crayon.,<message>)
define mb-os-echo-phase
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,35,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-phase,"Echo's an message to stdout with 'magenta' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-phase,Echo's an message to stdout with 'magenta' crayon.,<message>)
define mb-os-echo-remark
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-crayon-tagged-echo,36,$(1))
endef
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-alert,"Echo's an message to stdout with 'cyan' crayon.","<message>")
$(call mb-make-call,mb-doc-function-deep,mb-os-echo-alert,Echo's an message to stdout with 'cyan' crayon.,<message>)

View file

@ -3,5 +3,5 @@ define mb-package-create-archive
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_PACKAGE_CREATE_ARCHIVE) $(2))
$(MB_ᕽᕽᕽ   )tar -czf $(2) -C $(1) `ls $(1)`
endef
$(call mb-make-call,mb-doc-function,mb-package-create_archive,"Create an distribution archive.","<dir> <artifact>")
$(call mb-make-call,mb-doc-function,mb-package-create_archive,Create an distribution archive.,<dir> <artifact>)

View file

@ -1,21 +1,21 @@
MB_SDCC_PATH ?=
$(call mb-make-call,mb-doc-variable,MB_SDCC_PATH,"Optional path where SDCC binaries are located.")
$(call mb-make-call,mb-doc-variable,MB_SDCC_PATH,Optional path where SDCC binaries are located.)
MB_SDCC_FLAG_CPU ?= -mz80
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_FLAG_CPU,"The SDCC cpu target option.")
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_FLAG_CPU,The SDCC cpu target option.)
MB_SDCC_FLAG_LD ?= --nostdinc
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_FLAG_LD,"The SDCC linker option.")
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_FLAG_LD,The SDCC linker option.)
MB_SDCC_ASZ80_FLAGS ?= -g -l -c -o
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_ASZ80_FLAGS,"The SDCC z80 asm compiler flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_ASZ80_FLAGS,The SDCC z80 asm compiler flags.)
MB_SDCC_CC_FLAGS ?=
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_CC_FLAGS,"The SDCC C compiler flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_CC_FLAGS,The SDCC C compiler flags.)
MB_SDCC_AR_FLAGS ?= -rc
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_AR_FLAGS,"The SDCC module archive flags.")
$(call mb-make-call,mb-doc-variable-deep,MB_SDCC_AR_FLAGS,The SDCC module archive flags.)
# TODO: Add C + mixed support;
@ -32,68 +32,68 @@ define mb-sdcc-compile-asm
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_SDCC_COMPILE) $(2) - ASM)
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-sdcc-path,sdasz80) $(MB_SDCC_ASZ80_FLAGS) $(2) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-compile-asm,"Compiles asm source code.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-compile-asm,Compiles asm source code.,<in> <out>)
define mb-sdcc-arlib-asm
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_SDCC_ARLIB) $(2))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-sdcc-path,sdar) $(MB_SDCC_AR_FLAGS) $(1) $(2)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-arlib-asm,"Link asm lib module.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-arlib-asm,Link asm lib module.,<in> <out>)
define mb-sdcc-link-asm
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_SDCC_LINK) $(2) - ASM @ $(3))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-sdcc-path,sdcc) $(MB_SDCC_FLAG_CPU) $(MB_SDCC_CC_FLAGS) --no-std-crt0 --code-loc $(3) -o $(2) $(1)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm,"Links asm to custom code location.","<in> <out> <code-loc>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm,Links asm to custom code location.,<in> <out> <code-loc>)
define mb-sdcc-link-asm-0000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0x0000)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-0000,"Links asm to 0x0000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-0000,Links asm to 0x0000.,<in> <out>)
define mb-sdcc-link-asm-0100
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0x0100)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-0100,"Links asm to 0x0100.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-0100,Links asm to 0x0100.,<in> <out>)
define mb-sdcc-link-asm-1000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0x1000)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-1000,"Links asm to 0x1000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-1000,Links asm to 0x1000.,<in> <out>)
define mb-sdcc-link-asm-4000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0x4000)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-4000,"Links asm to 0x4000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-4000,Links asm to 0x4000.,<in> <out>)
define mb-sdcc-link-asm-8000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0x8000)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-8000,"Links asm to 0x8000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-8000,Links asm to 0x8000.,<in> <out>)
define mb-sdcc-link-asm-C000
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm,$(1),$(2),0xC000)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-C000,"Links asm to 0xC000.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-C000,Links asm to 0xC000.,<in> <out>)
define mb-sdcc-link-asm-bdos
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-sdcc-link-asm-0100,$(1),$(2))
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-bdos,"Links asm to BDOS.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-link-asm-bdos,Links asm to BDOS.,<in> <out>)
define mb-sdcc-objcopy
$(MB_ᕽᕽᕽ   )$(call mb-make-call,mb-os-echo-command,$(MB_I18N_SDCC_OBJCOPY) $(2))
$(MB_ᕽᕽᕽ   )$(call mb-make-call,_mb-sdcc-path,sdobjcopy) -I ihex --output-target$(MB_MAKE_EQUALS)binary $(1) $(2)
endef
$(call mb-make-call,mb-doc-function,mb-sdcc-objcopy,"Converts an hex file to binary.","<in> <out>")
$(call mb-make-call,mb-doc-function,mb-sdcc-objcopy,Converts an hex file to binary.,<in> <out>)