# RDoc .document

**URL:** <https://www.ruby-forum.com/t/rdoc-document/128815>\
**Category:** Ruby\
**Created:** [February 11, 2008, 8:06pm UTC](https://www.ruby-forum.com/t/rdoc-document/128815 "2008-02-11T20:06:45Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![Trans](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/t/dfb087/32.png) [@Trans](https://www.ruby-forum.com/u/Trans)\
**Post date:** [February 11, 2008, 8:06pm UTC](https://www.ruby-forum.com/t/rdoc-document/128815/1 "2008-02-11T20:06:45Z")

</div>

Is there any way to configure rdoc via a hidden config file? I recall  
briefly hearing something about .document, but can’t find any  
documentation on it.

T.

---

<div class="post-metadata">

**Author:** ![Trans](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/t/dfb087/32.png) [@Trans](https://www.ruby-forum.com/u/Trans)\
**Post date:** [February 11, 2008, 8:26pm UTC](https://www.ruby-forum.com/t/rdoc-document/128815/2 "2008-02-11T20:26:13Z")

</div>

On Feb 11, 12:05 pm, Trans [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> Is there any way to configure rdoc via a hidden config file? I recall  
> briefly hearing something about .document, but can’t find any  
> documentation on it.

Documentation by example:  
C:\ruby\src\ruby-1.8.6\>findfile “.document”  
./.document  
./ext/.document  
./lib/.document  
./lib/cgi/.document  
./lib/rdoc/markup/.document  
./lib/xmlrpc/.document

---

<div class="post-metadata">

**Author:** ![Trans](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/t/dfb087/32.png) [@Trans](https://www.ruby-forum.com/u/Trans)\
**Post date:** [February 12, 2008, 6:16pm UTC](https://www.ruby-forum.com/t/rdoc-document/128815/3 "2008-02-12T18:16:26Z")

</div>

On Feb 11, 2:24 pm, Phrogz [removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid) wrote:

> ./lib/.document  
> ./lib/cgi/.document  
> ./lib/rdoc/markup/.document  
> ./lib/xmlrpc/.document

Thanks. So it looks like it’s solely a list of globs to decide which  
files to include.

One difficulty with Facets is that some of libs need to be rdoc’d  
independent of others. Otherwise it becomes hard to tell what goes  
with what especially when standard libs are extended. I wish RDoc had  
an elegant way of handling tihs kind of “multi-part” documentation  
need. It would make documenting Ruby’s standard lib a lot easier too,  
I 'm sure. As it stands I have a special script to do it, but that  
doesn’t help RubyGems rdoc correctly.

T.
