fix some documentation and check prereqs

Author: mateoconlechuga

docs/headers/intce.rst

@@ -9,9 +9,11 @@ intce.h
 
 This header includes defines and prototypes for working with user interrupts.
 
-**WARNING: As of hardware revision I, user interrupts are no longer supported.**
+.. warning::
 
-**Send TI a strongly worded email about removal of this feature.**
+    As of hardware revision I, user interrupt vectors are no longer supported.
+    Some functions will no longer work on the newer hardware, and are labeled as such.
+    Feel free to send TI a strongly worded email about this limitation.
 
 .. contents:: :local:
    :depth: 3

docs/static/faq.rst

@@ -81,11 +81,12 @@ This table lists the locations relative to *sp* from within the called funciton.
 +------------+------------+----------------------+
 
 This table lists which registers are used for return values.
-Note that for shorts, the upper byte does not matter.
+The type's sign does not affect the registers used, but may affect the value returned.
 
-**xx**: Contains data.
+.. note::
 
-**??**: Don't care.
+    | **xx**: Byte must contain valid data.
+    | **??**: Byte contents don't matter.
 
 +------------+------------+-------------------+
 | C Type     | Register   | Register Contents |

makefile

@@ -30,19 +30,19 @@ LIB_DIR = $(call NATIVEPATH,src/$1)
 
 all: convbin convimg convfont $(LIBS) std
 
-std:
+std: check
 	$(Q)$(MAKE) -C $(call NATIVEPATH,src/std)
 
-fasmg:
+fasmg: check
 	$(Q)$(MAKE) -C $(call NATIVEPATH,tools/fasmg)
 
-convbin:
+convbin: check
 	$(Q)$(MAKE) -C $(call NATIVEPATH,tools/convbin) release
 
-convimg:
+convimg: check
 	$(Q)$(MAKE) -C $(call NATIVEPATH,tools/convimg) release
 
-convfont:
+convfont: check
 	$(Q)$(MAKE) -C $(call NATIVEPATH,tools/convfont)
 
 $(LIBS): fasmg
@@ -109,9 +109,14 @@ clean: $(addprefix clean-,$(LIBS)) clean-std
 clean-std:
 	$(Q)$(MAKE) -C $(call NATIVEPATH,src/std) clean
 
+check:
+	$(Q)$(EZCC) --version || ( echo Please install ez80-clang && exit 1 )
+	$(Q)$(FASMG) $(NULL) $(NULL) || ( echo Please install fasmg && exit 1 )
+
 help:
 	@echo Helpful targets:
 	@echo   all
+	@echo   check
 	@echo   docs-html
 	@echo   docs-pdf
 	@echo   clean
@@ -123,7 +128,6 @@ help:
 
 .PHONY: $(LIBS)
 .PHONY: install-fasmg install-std install-ce $(addprefix install-,$(LIBS))
-.PHONY: clean clean-std $(addprefix clean-,$(LIBS)) 
+.PHONY: check clean clean-std $(addprefix clean-,$(LIBS))
 .PHONY: all help install uninstall release release-libs docs-pdf docs-html
 .PHONY: fasmg convbin convimg convfont
-

src/common.mk

@@ -41,6 +41,7 @@ WINDOWS := 1
 SHELL := cmd.exe
 FASMG ?= fasmg.exe
 EZCC ?= ez80-clang.exe
+NULL ?= nul
 NATIVEPATH ?= $(subst /,\,$1)
 NATIVEEXE ?= $(NATIVEPATH).exe
 MKDIR ?= ( mkdir $1 2>nul || call )
@@ -56,6 +57,7 @@ RELEASE_NAME = windows
 else
 FASMG ?= fasmg
 EZCC ?= ez80-clang
+NULL ?= /dev/null
 NATIVEPATH ?= $(subst \,/,$1)
 NATIVEEXE ?= $(NATIVEPATH)
 MKDIR ?= mkdir -p $1