Welcome to RightHand's community place Sign in | | Help

Command prompt utilities should have a readable help message

Today I had to display ILMerge's help information (btw, ILMerge does merge assemblies in a single assembly and it is a must have free utility produced by Microsoft Research labs). This is the output I've got:

C:\Progs\Vodovodi\Vodovodi.Utilities\AddPrefix\bin\Release>"C:\Program Files\Mic rosoft\ILMerge\ILMerge.exe" Usage: ilmerge [/lib:directory]* [/log[:filename]] [/keyfile:filename [/delaysig n]] [/internalize[:filename]] [/t[arget]:(library|exe|winexe)] [/closed] [/ndebu g] [/ver:version] [/copyattrs [/allowMultiple]] [/xmldocs] [/attr:filename] [/ta rgetplatform:<version>[,<platformdir>] | /v1 | /v1.1 | /v2] [/useFullPublicKeyFo rReferences] [/wildcards] [/zeroPeKind] [/allowDup:type]* /out:filename <primary assembly> [<other assemblies>...]

Clear, isn't it? Absolutely not - it is an unreadable mess. It is very obvious that this fine tool was written by scientists who don't care about friendly messages. They should use at least new lines!

C:\Progs\Vodovodi\Vodovodi.Utilities\AddPrefix\bin\Release>"C:\Program Files\Mic rosoft\ILMerge\ILMerge.exe" Usage: ilmerge [/lib:directory]* [/log[:filename]] [/keyfile:filename [/delaysign]] [/internalize[:filename]] [/t[arget]:(library|exe|winexe)] [/closed] [/ndebug] [/ver:version] [/copyattrs [/allowMultiple]] [/xmldocs] [/attr:filename] [/targetplatform:<version>[,<platformdir>] | /v1 | /v1.1 | /v2] [/useFullPublicKeyForReferences] [/wildcards] [/zeroPeKind] [/allowDup:type]* /out:filename <primary assembly> [<other assemblies>...]

So, a simple \r\n does make a huge difference. And there are plenty of fine tools/applications with a great engine and with crappy UI out there. I won't even mention Dotfuscator at this point.

Published 29. avgust 2007 20:14 by Miha Markic
Filed under:

Comments

# re: Command prompt utilities should have a readable help message

29. avgust 2007 23:33 by Bojan Vrhovnik
To bad, that shortcut CTRl + K + D is not present :)

# re: Command prompt utilities should have a readable help message

30. avgust 2007 2:48 by David
Why don't you make your command prompt window wwider? It helps... If you didn't yet, you should also try Console (http://sourceforge.net/projects/console/).

# re: Command prompt utilities should have a readable help message

30. avgust 2007 3:29 by Miha Markic

Hi David,

Unfortunatelly both solutions aren't of any great help in this case. However, I didn't know about Console replacement - seems nice.

# re: Command prompt utilities should have a readable help message

3. november 2007 18:58 by Jon
I actually prefer the compact version rather than your multi-line suggestion. Mind you, I'm one of those annoying people who put the opening brace on the same line as for, if, etc.
Anonymous comments are disabled