Title: Demo/comparisons/ needs some usage information.
Type: enhancement Stage:
Components: Demos and Tools Versions: Python 3.2
Status: closed Resolution: out of date
Dependencies: Superseder:
Assigned To: Nosy List: georg.brandl, ramiroluz
Priority: normal Keywords: patch

Created on 2010-11-22 00:38 by ramiroluz, last changed 2010-12-30 22:35 by georg.brandl. This issue is now closed.

File name Uploaded Description Edit
issue10495_demo_sortingtest_usage_patch.diff ramiroluz, 2010-11-22 01:01
Messages (3)
msg122048 - (view) Author: Ramiro Batista da Luz (ramiroluz) Date: 2010-11-22 00:38
When someone run Demo/comparisons/ without arguments it waits for lines to be inserted in the command line silently, until the EOF, or Ctrl+D in Linux, is entered.

If the user read the file, editing or using cat Demo/comparisons/ he have to understand the code to figure out how to use it.

My suggestion is to add an usage message, plus the if __name__ == '__main__':.
msg122053 - (view) Author: Ramiro Batista da Luz (ramiroluz) Date: 2010-11-22 01:01
I had write a suggested patch before seeing this message from Alexander Belopolsky (belopolsky). 

Probably it will be discarded, but as I commented in the previous #issue10494, the work was already done. (see
msg124940 - (view) Author: Georg Brandl (georg.brandl) * (Python committer) Date: 2010-12-30 22:35
Demo/comparisons has now been removed.
Date User Action Args
2010-12-30 22:35:42georg.brandlsetstatus: open -> closed

nosy: + georg.brandl
messages: + msg124940

resolution: out of date
2010-11-22 01:01:57ramiroluzsetfiles: + issue10495_demo_sortingtest_usage_patch.diff
keywords: + patch
messages: + msg122053
2010-11-22 00:38:30ramiroluzcreate