From: Eric Hodel <drbrain@...7.net>
Date: 2012-12-02T10:08:03+09:00
Subject: Re: [ANN] rdoc 4.0.0.preview2


--Apple-Mail-628F2D2F-F765-4658-9383-EB94395AB81A
Content-Type: text/plain;
	charset=us-ascii
Content-Transfer-Encoding: quoted-printable

On Dec 1, 2012, at 15:07, Intransition <transfire@gmail.com> wrote:

>> Notable feature additions are markdown support and an WEBrick servlet tha=
t can=20
>> serve HTML from an ri store.  (This means that RubyGems 2.0+ no longer ne=
eds=20
>> to build HTML documentation when installing gems.)
>=20
> Nice! I had a gem that did that, but it was quite the hack, so it was neve=
r very useful. But I always seemed like a good idea. So I am pleased to see t=
hat RDoc can now do it right out of the box.
>=20
> Quick questions:
>=20
> 1. Can it browse multiple gems at once, or just one at a time?

Multiple gems at once. At the top level you can type to filter on installed g=
ems.

> 2. Can it take advantage of custom formats?

Currently it uses the darkish generator. Due to lack of time I haven't inves=
tigated alternate output templates. Allowing alternate output formats is pos=
sible before RDoc 4 final. The feature is rather coupled to darkish so I'm u=
nsure what work would be needed for alternate generators. I'd rather delay t=
hat for a future release than rush it.=

--Apple-Mail-628F2D2F-F765-4658-9383-EB94395AB81A
Content-Type: text/html;
	charset=utf-8
Content-Transfer-Encoding: 7bit

<html><head><meta http-equiv="content-type" content="text/html; charset=utf-8"></head><body dir="auto"><div>On Dec 1, 2012, at 15:07, Intransition &lt;<a href="mailto:transfire@gmail.com">transfire@gmail.com</a>&gt; wrote:<br><br></div><blockquote type="cite"><div><blockquote class="gmail_quote" style="margin: 0;margin-left: 0.8ex;border-left: 1px #ccc solid;padding-left: 1ex;">Notable feature additions are markdown support and an WEBrick servlet that can
<br>serve HTML from an ri store. &nbsp;(This means that RubyGems 2.0+ no longer needs
<br>to build HTML documentation when installing gems.)
<br></blockquote><div><br></div><div>Nice! I had a gem that did that, but it was quite the hack, so it was never very useful. But I always seemed like a good idea. So I am pleased to see that RDoc can now do it right out of the box.</div><div><br></div><div>Quick questions:</div><div><br></div><div>1. Can it browse multiple gems at once, or just one at a time?</div></div></blockquote><div><br></div><div>Multiple gems at once. At the top level you can type to filter on installed gems.</div><div><br></div><blockquote type="cite"><div>2. Can it take&nbsp;advantage&nbsp;of custom formats?</div></blockquote><div><br></div><div>Currently it uses the darkish generator. Due to lack of time I haven't investigated alternate output templates. Allowing alternate output formats is possible before RDoc 4 final. The feature is rather coupled to darkish so I'm unsure what work would be needed for alternate generators. I'd rather delay that for a future release than rush it.</div></body></htm
 l>
--Apple-Mail-628F2D2F-F765-4658-9383-EB94395AB81A--