Doc stuff and workflows (#7)

Author: rocky

Makefile

@@ -6,7 +6,7 @@
 
 GIT2CL ?= admin-tools/git2cl
 PYTHON ?= python3
-PIP ?= pip3
+PIP ?= $(PYTHON) -m pip
 RM  ?= rm
 
 # Two-letter language code, e.g. fr, zh
@@ -50,7 +50,7 @@ install: pypi-setup
 	$(PYTHON) setup.py install
 
 #: Run tests
-check: pytest
+test check: pytest
 
 #: Remove derived files
 clean: clean-pyc

pymathics/natlang/__init__.py

@@ -1,9 +1,8 @@
 """Pymathics Natlang
 
-This module provides Mathics functions and varialbles to work with
-expressions in natural language, using the libraries ``nltk`` and
-``spacy``.
-
+This module provides Mathics functions and variables to work with \
+expressions in natural language, using the libraries 'nltk' and  \
+'spacy'.
 """
 
 

pymathics/natlang/main.py

@@ -1,22 +1,25 @@
 # -*- coding: utf-8 -*-
 # FIXME: split this up into smaller pieces
 
-"""Natural language functions.
+"""
+Natural language functions.
 
 The following Python Packages are used:
 
-* ``spacy`` is used for parsing natural languages
-* ``nltk`` is used for functions using WordNet-related builtins
-* `langid``, and ``pycountry`` are used for ``LanguageIdentify[]``
-* ``pyenchant`` is used for SpellingCorrectionList[]
+<ul>
+  <li> 'spacy' is used for parsing natural languages
+  <li> 'nltk' is used for functions using WordNet-related builtins
+  <li> 'langid', and `'pycountry' are used for 'LanguageIdentify[]'
+  <li> 'pyenchant'` is used for 'SpellingCorrectionList[]'
+</ul>
 
 User customization:
 
-For nltk, use the environment variable NLTK_DATA to specify a custom
-data path (instead of $HOME/.nltk).  For spacy, eset  MATHICS3_SPACY_DATA,
-a Mathics3-specific variable.
+For nltk, use the environment variable NLTK_DATA to specify a custom \
+data path (instead of $HOME/.nltk).  For spacy, set 'MATHICS3_SPACY_DATA', \
+a Mathics3-specific variable. \
 
-In order to use the Extended Open Multilingual Wordnet (OMW) with NLTK
+In order to use the Extended Open Multilingual Wordnet (OMW) with 'NLTK'
 and use even more languages, you need to install them manually.
 
 Go to http://compling.hss.ntu.edu.sg/omw/summx.html, download the