man: add more details for IMPORT, PROGRAM and RUN keys

967de8fa added a note that I found very hard
to understand. Reword it, and also describe how IMPORT and PROGRAM are different
from RUN.

Minor markup adjustements too.

(cherry picked from commit 12254cca)