Skip to contentSkip to conversation

Kconfig: rename "---help---" to "help" in Kconfig files (first part)

PATCH Bodo Eggert <[email protected]> 2 participants 2 messages May 3, 2005 – May 4, 2005 4 messages not in the archive

lore
Share & tools
lore

A message that is not in the archive (sent off-list or not yet received): [email protected]

A message that is not in the archive (sent off-list or not yet received): [email protected]

A message that is not in the archive (sent off-list or not yet received): [email protected]

A message that is not in the archive (sent off-list or not yet received): [email protected]

#4 lore raw
Quoted 7 lines · Roman Zippel
Quoted 3 lines · Adrian Bunk

IMHO, Kconfig files are quite readable due to this indentation even though only a minority of the entries was using "---help---" even before this patch.

So why exactly has to be removed? Is it ugly?

IMO yes, it's less readable for me than "help". ¢¢

Signature · 2 lines
Fun things to slip into your budget
TRUE:  $3000 for light bulb rotation
#5 lore raw
Quoted 10 lines · Bodo Eggert
Quoted 7 lines · Roman Zippel
Quoted 3 lines · Adrian Bunk

IMHO, Kconfig files are quite readable due to this indentation even though only a minority of the entries was using "---help---" even before this patch.

So why exactly has to be removed? Is it ugly?

IMO yes, it's less readable for me than "help". ¢¢

the main problem with having two alternatives for the same thing (in *any* context) is that it gives beginners a distorted sense of what is acceptable usage.

if you accept both "help" and "---help---", then you just *know* that a beginner will notice that and start thinking, "hmmm ... well, if both of those are alright, maybe "--help--" or "-help-" is alright, too. and maybe it's just the leading hyphens that really count, not the trailing hyphens. and maybe ..."

kbuild is already over-convoluted as it is. please don't give folks even more redundant ways to do exactly the same thing.

rday