On Jun 8, 2011, at 12:59 PM, Jon wrote:

>> Additionally, --no-rdoc and --no-ri are now deprecated:
>> ...SNIP...
>> Replacing these is --document which accepts a comma separated list of 
>> documentation types to generate.  `gem install rake --doc=rdoc` will 
>> generate only RDoc.  `gem install rake --doc=rdoc,ri` is the default.  `gem 
>> install rake --no-doc` will generate no documentation.
> 
> 1) Assuming these options will be removed in the future, when are you 
> targeting removal?

I'm not currently targetting any removal date.  I've learned from rdoc that it 
is Very Hard to deprecate command line arguments.

> 2) What specifically will RG do when it sees a .gemrc containing:
> 
> gem: --no-ri --no-rdoc

The same as it does now.  These options now set options[:document] on the 
command instead of :generate_rdoc and :generate_ri.

> 3) One can use --doc or --document interchangeably?

You can use either as OptionParser allows the shortest unambiguous argument to 
be used much like `gem` allows the shortest unambiguous subcommand.  (`gem 
install` and `gem i` both install gems.)
_______________________________________________
Rubygems-developers mailing list
http://rubyforge.org/projects/rubygems
Rubygems-developers@rubyforge.org
http://rubyforge.org/mailman/listinfo/rubygems-developers

Reply via email to