[docs] [issue10454] Clarify compileall options

[Éric Araujo]

New submission from Éric Araujo <merwok at netwok.org>:

This is the help text of compileall:

 usage: python compileall.py [-l] [-f] [-q] [-d destdir] [-x regexp] [-i list] [directory|file ...]
 -l: don't recurse down
 -f: force rebuild even if timestamps are up-to-date
 -q: quiet operation
 -d destdir: purported directory name for error messages
    if no directory arguments, -l sys.path is assumed
 -x regexp: skip files matching the regular expression regexp
    the regexp is searched for in the full path of the file
 -i list: expand list with its content (file and directory names)
 -b: Produce legacy byte-compile file paths

1) I do not understand the help of -d and -i.  Experimenting with the script, reading the code and eventually looking at the file history would certainly clear that.

2) The short usage line at the top also lacks mention of “-b”.

3) (minor) I want to rephrase -x, -d and -b.

Bug week-end candidate!

----------
assignee: docs at python
components: Documentation
keywords: easy
messages: 121469
nosy: docs at python, eric.araujo
priority: normal
severity: normal
stage: needs patch
status: open
title: Clarify compileall options
type: behavior
versions: Python 2.7, Python 3.1, Python 3.2

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue10454>
_______________________________________