[IPMPROG-1781] Add Makefile recipes to spellcheck(-interactive)

Author: jimklimov

.gitignore

@@ -1 +1,3 @@
 latest.json
+*.spellchecked
+*.bak

Makefile

@@ -3,10 +3,56 @@
 OUTFILE = latest.json
 PRODUCT = ipm
 CONVERT = ./tools/convert.sh
-
 INPUTS = $(shell ls -1 "$(PRODUCT)"/*.md)
 
+EGREP = grep -E
+ASPELL = aspell
+ASPELL_LANG_ARG = en
+ASPELL_LANG_ENV = en_US.UTF-8
+# Must have a path component, goes to homedir otherwise
+ASPELL_DICT = ./relnotes.dict
+ASPELL_OUT_NOTERRORS = (^[ \t]*[\*\@]|^$$)
+
 all: $(OUTFILE)
 
+check: spellcheck
+
+clean:
+	rm -f $(OUTFILE) $(addsuffix .spellchecked, $(INPUTS))
+	# Interactive aspell leaves older copies of checked files; with Git we do not need them:
+	rm -f $(addsuffix .bak, $(INPUTS))
+
 $(OUTFILE): $(INPUTS)
 	$(CONVERT) "$(PRODUCT)" "$(OUTFILE)"
+
+spellcheck: $(addsuffix .spellchecked, $(INPUTS))
+
+# Ported from NUT
+%.spellchecked: %
+	@test -s "$<"
+	@echo "  SPELLCHECK  $<" ; \
+	 OUT="`(sed 's,^\(.*\)$$, \1,' | \
+	 LANG=$(ASPELL_LANG_ENV) LC_ALL=$(ASPELL_LANG_ENV) \
+	    $(ASPELL) -a -M -p "$(ASPELL_DICT)" \
+	    -d "$(ASPELL_LANG_ARG)" --lang="$(ASPELL_LANG_ARG)" \
+	    --ignore-accents --encoding=utf-8 \
+	 ) < "$<"`" \
+	 && { if test -n "$$OUT" ; then OUT="`echo "$$OUT" | $(EGREP) -b -v '$(ASPELL_OUT_NOTERRORS)' `" ; fi; \
+	      test -z "$$OUT" ; } \
+	 || { RES=$$? ; \
+	      echo "FAILED : Aspell reported errors here:" >&2 \
+	      && echo "----- vvv" >&2 \
+	      && echo "$$OUT" >&2 \
+	      && echo "----- ^^^" >&2 ; \
+	      exit $$RES; }
+	@touch "$@"
+
+# Note: here we do not touch any files
+spellcheck-interactive: $(INPUTS)
+	@for F in $^ ; do \
+	    echo "  SPELLCHECK-INTERACTIVE  $$F" ; \
+	    LANG=$(ASPELL_LANG_ENV) LC_ALL=$(ASPELL_LANG_ENV) \
+	        $(ASPELL) -c -M -p "$(ASPELL_DICT)" \
+	        -d "$(ASPELL_LANG_ARG)" --lang="$(ASPELL_LANG_ARG)" \
+	        --ignore-accents --encoding=utf-8 "$$F" ; \
+	done

relnotes.dict

@@ -0,0 +1,26 @@
+personal_ws-1.1 en 25 
+AOS
+Automations
+EMPT
+IDE
+INDGW
+IPM
+LDAP
+MQTT
+Nutanix
+SCVMM
+SNMP
+VMs
+VMware
+VirtualBox
+Virtualization
+automations
+boolean
+hypervisor
+hypervisors
+runtime
+syslog
+vSAN
+vSphere
+vxRail
+webserver