On Jun 9, 2011, at 4:31 PM, Evan Phoenix wrote: > On Thursday, June 9, 2011 at 3:51 PM, Eric Hodel wrote: >> On Jun 9, 2011, at 1:06 PM, James Tucker wrote: >>> Might it be sensible for that to indicate a document type/style rather than >>> a tool, and then to infer "a compatible document generator", for future >>> safety? >> >> This type of feature should be a suggestion, not a commandment. When I >> install a gem I would rather see some documentation than no documentation. >> >> If the named tool doesn't isn't installed documentation generation should >> fall back to the user's preference via --document then to the default (rdoc). > > If a gem specifies "blah", how can rubygems know that there was no docs > generated and therefore it should fallback? Because there is no coupling, it > doesn't seem like there is a way to detect. Were you just thinking it would > check a directory (and thus all doc tools are expected to put their generated > docs in a certain directory)
We'll probably need more API around this, perhaps a way to register documentation types so RubyGems can detect if the preferred format is installed. _______________________________________________ Rubygems-developers mailing list http://rubyforge.org/projects/rubygems Rubygems-developers@rubyforge.org http://rubyforge.org/mailman/listinfo/rubygems-developers
