On Mon, Mar 10, 2008 at 1:26 AM, Trans <[EMAIL PROTECTED]> wrote:
>  bother generating the rdocs --that's a simple way in fact for RubyGems
>  to know if it should generate rdocs, rather than using the has_rdoc
>  config, just look to see if there is any content in the conventional
>  location or not.

That is an elegant solution.  Either, you produce your custom HTML
based documentation in a specific folder (maybe /docs/ anchored at
index.html) within your package, or rubygems will generate your RDocs
from source.

unless File.exist?('docs/index.html')
  generate rdoc
end

Simple.

The other nice thing about that solution is that all the packages out
there that know nothing about pre-built rdoc will continue to work
exactly as they do no without any modification.

Compressed pre generated RDoc pages will not create a huge hit for
those packages that want to distribute their own documents.

Mikel
_______________________________________________
Rubygems-developers mailing list
[email protected]
http://rubyforge.org/mailman/listinfo/rubygems-developers

Reply via email to