On Thu, Jun 4, 2009 at 10:16 PM, Alex Chaffee <[email protected]> wrote: >> I'm not particularly attached to the patch it was done while sitting next to >> Jim at SoR. At the same time, I much prefer it to +desc+ in the general >> case, simply from a readability POV. > > Really? I think the natural semantics for code comments is "these are > thrown away" so it's astonishing if they're used for anything > important. Having a named method in the DSL that means "this string > will be visible to end-users" is much more natural and readable to me. > Though "desc" is not the best name for this method -- how about > "description"? > > Or how about an attribute in the default hash for "task", e.g. > > task :test, :description => "runs all tests" do > ... > end > > Speaking of which, it's always baffled and confounded me that only the > tasks whose authors had the presence of mind to add a "desc" show up > in "rake -T" or "rake -D". Can we make all tasks show up by default, > perhaps with an empty description, with perhaps an optional ":private > => true" if you want to hide them? >
-100 on that. By default I have 300 tasks defined in rubyinstaller, listing all them is meaningless since they don't provide a direct benefit to the user. -- Luis Lavena AREA 17 - Perfection in design is achieved not when there is nothing more to add, but rather when there is nothing more to take away. Antoine de Saint-Exupéry _______________________________________________ Rake-devel mailing list [email protected] http://rubyforge.org/mailman/listinfo/rake-devel
