msxbuild/lib/make/सिस्टमₚᵣₐᵧToੴ/mb_doc.mk

MB_DOC_FIRE_VARIABLE_FLOW ?= \\n
#*** Recursive variable: MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_VARIABLE_FLOW,"Flow builder of fire flow variable data.")

MB_DOC_FIRE_VARIABLE ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_VARIABLE,"Flow builder of firemake variable data.")

MB_DOC_FIRE_VARIABLE_DEEP ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_VARIABLE_DEEP,"Flow builder of makefire deep variable data.")

MB_DOC_FIRE_VARIABLE_ROCK ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_VARIABLE_ROCK,"Flow builder of makefire rock variable data.")

MB_DOC_FIRE_VARIABLE_I18N ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_VARIABLE_I18N,"Flow builder of makefire i18n variable data.")

MB_DOC_FIRE_FUNCTION ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_FUNCTION,"Flow builder of firemake function data.")

MB_DOC_FIRE_FUNCTION_DEEP ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_FUNCTION_DEEP,"Flow builder of firemake deep function data.")

MB_DOC_FIRE_FUNCTION_FLOW ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_FUNCTION_FLOW,"Flow builder of firemake flow function data.")

MB_DOC_FIRE_TARGET ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET,"Flow builder of firemake target data.")

MB_DOC_FIRE_TARGET_DEEP ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET_DEEP,"Flow builder of firemake deep target data.")

MB_DOC_FIRE_TARGET_RUN ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET_RUN,"Flow builder of firemake run target data.")

MB_DOC_FIRE_TARGET_MODULE ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET_MODULE,"Flow builder of firemake module target data.")

MB_DOC_FIRE_TARGET_ASSERT ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET_ASSERT,"Flow builder of firemake assert target data.")

MB_DOC_FIRE_TARGET_HELP ?= \\n
MB_DOC_FIRE_VARIABLE_FLOW += $(call mb-make-call,_mb-doc-variable4u-flow,MB_DOC_FIRE_TARGET_HELP,"Flow builder of firemake help data.")

MB_DOC_XML_ROOT := firemake
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_ROOT,"XML root tag for firemake output.")

MB_DOC_XML_ATTR_NAME := name
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_ATTR_NAME,"XML name attribute for firemake output.")

MB_DOC_XML_ATTR_LEVEL := level
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_ATTR_LEVEL,"XML level attribute for firemake output.")

MB_DOC_XML_TAG_ARGS := arguments
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_TAG_ARGS,"XML arguments tag for firemake output.")

MB_DOC_XML_TAG_DESC := description
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_TAG_DESC,"XML description tag for firemake output.")

MB_DOC_XML_TAG_VALUE := value
MB_DOC_FIRE_VARIABLE_ROCK += $(call mb-make-call,_mb-doc-variable4u-rock,MB_DOC_XML_TAG_VALUE,"XML value tag for firemake output.")

# rename now internal: _MB_DOC_FORMAT
MB_DOC_FORMAT ?= txt
#MB_DOC_FIRE_VARIABLE_DEEP += $(call mb-make-call,_mb-doc-variable4u-deep,MB_DOC_FORMAT,"Output format of documention$(MB_MAKE_COMMA) only 'txt' or 'xml' is supported.")


define _escape
$(MB_ᕽᕽᕽ　　　)$(subst <,"<",$(subst >,">",$(subst \\n,\\\n,$(subst ','"'"',$(1)))))
endef
define _mb-doc-variable-txt
$(MB_ᕽᕽᕽ　　　)"* "$(2)$(MB_MAKE_EQUALS)$(call mb-make-call,_escape,$(4))\\n$(if $(3),\\t$(3)\\n)\\n
endef
define _mb-doc-variable-xml
$(MB_ᕽᕽᕽ　　　)\\n\\t$(call mb-make-call,mb-make-xml-open,variable,$(MB_DOC_XML_ATTR_NAME),$(2),$(MB_DOC_XML_ATTR_LEVEL),$(1))\\n\\t\\t$(call mb-make-call,mb-make-xml-tag-value,$(MB_DOC_XML_TAG_VALUE),$(4))\\n\\t\\t$(call mb-make-call,mb-make-xml-tag-value,$(MB_DOC_XML_TAG_DESC),$(3))\\n\\t$(call mb-make-call,mb-make-xml-close,variable)
endef
define _mb-doc-variable4u-deep
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-variable-$(MB_DOC_FORMAT),deep,$(1),$(2),$($(1)))
endef
define _mb-doc-variable4u-rock
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-variable-$(MB_DOC_FORMAT),rock,$(1),$(2),$($(1)))
endef
define _mb-doc-variable4u-flow
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-variable-$(MB_DOC_FORMAT),flow,$(1),$(2),$(words $($(1))))
endef
define _mb-doc-variable4u-i18n
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-variable-$(MB_DOC_FORMAT),i18n,$(1),$(2),$($(1)))
endef
define mb-doc-variable
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_VARIABLE += $$(call mb-make-call,_mb-doc-variable-$$(MB_DOC_FORMAT),build,$(1),$(2),$($(1))))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-variable,"Saves formatted documention of an variable.","<name> [desc]")
define mb-doc-variable-deep
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_VARIABLE_DEEP += $$(call mb-make-call,_mb-doc-variable4u-deep,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-variable-deep,"Saves formatted documention of an deep variable.","<name> [desc]")
define mb-doc-variable-rock
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_VARIABLE_ROCK += $$(call mb-make-call,_mb-doc-variable4u-rock,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-variable-rock,"Saves formatted documention of an rock variable.","<name> [desc]")
define mb-doc-variable-flow
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_VARIABLE_FLOW += $$(call mb-make-call,_mb-doc-variable4u-flow,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-variable-flow,"Saves formatted documention of an flow variable.","<name> [desc]")
define mb-doc-variable-i18n
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_VARIABLE_I18N += $$(call mb-make-call,_mb-doc-variable4u-i18n,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-variable-i18n,"Saves formatted documention of an i18n variable.","<name> [desc]")


define _mb-doc-function-txt
$(MB_ᕽᕽᕽ　　　)"* "$(2)$(if $(4), $(4))$(if $(3),\\n\\t$(3)\\n)\\n
endef
define _mb-doc-function-xml
$(MB_ᕽᕽᕽ　　　)\\n\\t$(call mb-make-call,mb-make-xml-open,function,$(MB_DOC_XML_ATTR_NAME),$(2),$(MB_DOC_XML_ATTR_LEVEL),$(1))\\n\\t\\t$(call mb-make-call,mb-make-xml-tag-value,$(MB_DOC_XML_TAG_ARGS),$(4))\\n\\t\\t$(call mb-make-call,mb-make-xml-tag-value,$(MB_DOC_XML_TAG_DESC),$(3))\\n\\t$(call mb-make-call,mb-make-xml-close,function)
endef
define _mb-doc-function4u-deep
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-function-$(MB_DOC_FORMAT),deep,$(1),$(2),$(3))
endef
define _mb-doc-function4u-flow
$(MB_ᕽᕽᕽ　　　)$(call mb-make-call,_mb-doc-function-$(MB_DOC_FORMAT),flow,$(1),$(2),$(3))
endef
define mb-doc-function
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_FUNCTION += $$(call mb-make-call,_mb-doc-function-$$(MB_DOC_FORMAT),build,$(1),$(2),$(3)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-function,"Saves formatted documention of an function.","<name> [desc] [args]")
define mb-doc-function-deep
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_FUNCTION_DEEP += $$(call mb-make-call,_mb-doc-function4u-deep,$(1),$(2),$(3)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-function-deep,"Saves formatted documention of an deep function.","<name> [desc] [args]")
define mb-doc-function-flow
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_FUNCTION_FLOW += $$(call mb-make-call,_mb-doc-function4u-flow,$(1),$(2),$(3)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-function-flow,"Saves formatted documention of an flow function.","<name> [desc] [args]")


define _mb-doc-target-txt
$(MB_ᕽᕽᕽ　　　)"* "$(2)$(if $(3),\\n\\t$(3))\\n\\n
endef
define _mb-doc-target-xml
$(MB_ᕽᕽᕽ　　　)\\n\\t$(call mb-make-call,mb-make-xml-open,target,$(MB_DOC_XML_ATTR_NAME),$(2),$(MB_DOC_XML_ATTR_LEVEL),$(1))$(if $3,\\n\\t\\t$(call mb-make-call,mb-make-xml-tag-value,$(MB_DOC_XML_TAG_DESC),$(3))\\n\\t$(call mb-make-call,mb-make-xml-close,target),\\n\\t$(call mb-make-call,mb-make-xml-close,target))
endef
define mb-doc-target
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),build,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target,"Saves formatted documention of an target.","<name> [desc]")
define mb-doc-target-deep
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET_DEEP += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),deep,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target-deep,"Saves formatted documention of an deep target.","<name> [desc]")
define mb-doc-target-help
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET_HELP += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),help,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target-help,"Saves formatted documention of an help target.","<name> [desc]")
define mb-doc-target-run
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET_RUN += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),run,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target_run,"Saves formatted documention of an run target.","<name> [desc]")
define mb-doc-target-module
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET_MODULE += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),module,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target-module,"Saves formatted documention of an module target.","<name> [desc]")
define mb-doc-target-assert
$(MB_ᕽᕽᕽ　　　)$(eval MB_DOC_FIRE_TARGET_ASSERT += $$(call mb-make-call,_mb-doc-target-$$(MB_DOC_FORMAT),assert,$(1),$(2)))
endef
MB_DOC_FIRE_FUNCTION_DEEP += $(call mb-make-call,_mb-doc-function4u-deep,mb-doc-target-assert,"Saves formatted documention of an assert target.","<name> [desc]")