When an included file contains an import of the top level source, there is a puzzling anomaly. The command:
The nim c topsource.nim
command will work fine - even though the inclusion makes no sense.
But the command:
nim doc topsource.nim
generates many many error messages - including some that make no sense.
SOLUTION: remove the import from the included file - since that is silly anyway.