comments on doc.py, clear.sh script