This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author serhiy.storchaka
Recipients docs@python, paul.moore, serhiy.storchaka, steve.dower, tim.golden, zach.ware
Date 2017-11-24.06:26:46
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <>
The documentation of the -x option is virtually not existing. The current short line of the description was enough to me for understanding what is the purpose of this option and how it can be used (I didn't use Windows for more than 10 years). But I was surprised not founding more detailed information about this feature in the documentation. Definitely it should be better documented. Most of users will have no ideas about this feature.

The purpose of this option is turning Python scripts into Windows batch files which can be ran as other executables. Similarly as adding she-bang and setting the executable bit allows to run them on Unix. The extension of the Python script should be changed to ".bat", and the following line should be added at the start of the script:

    @path\to\python -x %0 %* & exit /b


    @py -3 -x %0 %* & exit /b

Unlike a she-bang line which is a Python comment, this line is not valid Python syntax, and the -x option is used for skipping it.
Date User Action Args
2017-11-24 06:26:48serhiy.storchakasetrecipients: + serhiy.storchaka, paul.moore, tim.golden, docs@python, zach.ware, steve.dower
2017-11-24 06:26:48serhiy.storchakasetmessageid: <>
2017-11-24 06:26:47serhiy.storchakalinkissue32122 messages
2017-11-24 06:26:46serhiy.storchakacreate