Allow installing RDoc from a git source

[st0012]

This implements option 2 in #1107, which is to use extconf.rb to conditionally run rake generate when the gem is installed as a git source.

To make sure the target machine has the required dependencies for the generation, I modified rake generate to conditionally install the kpeg and racc.

[st0012]

@colby-swandale do you know if there's any rubygems API to better handle these dependencies without bundler?

[colby-swandale]

Could you expand the context where Bundler wouldn't be available?

[st0012]

Bundler will be available, but this will be executed in 2 scenarios:

• When a developer runs rake generate (or any tasks that depend on it) manually
• When a user installs RDoc through git source

In the later case, I want to avoid installing all of RDoc's development dependencies as most of them aren't needed for generating the missing files.

[st0012]

@nobu Thanks for the suggestions 👍

[st0012]

@nobu Would you mind giving this another look? If you're not against it, I'd like to give it a try.

[ioquatix]

This does not work, at least when I tested it.

The problem is, extconf.rb is executed from the root directory, so the relative path (computed from Dir.pwd is wrong):

The fix is:

git_path = File.expand_path("../../.git", __dir__)
if File.exist?(git_path)
	system("rake generate")
end

At least that gets us to the next issue:

> ruby ./ext/rdoc/extconf.rb
Generating lib/rdoc/markdown.rb...
rake aborted!
Gem::GemNotFoundException: can't find gem kpeg (>= 0) with executable kpeg (Gem::GemNotFoundException)
/home/samuel/.gem/ruby/3.4.1/bundler/gems/rdoc-c75f094920b3/Rakefile:80:in 'block (2 levels) in <top (required)>'
Tasks: TOP => generate => lib/rdoc/markdown.rb
(See full trace by running task with --trace)
creating Makefile

[ioquatix]

Would it be crazy to do this:

# rdoc.gemspec

  if ENV["RDOC_FROM_SOURCE"] # or something better???
    gem "kpeg"
    ...

[tompng]

#1107 is solved with #1410 (option 1 mentioned in the original issue)