# Comments in the RubySpec tag files

**URL:** <https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086>\
**Category:** IronRuby\
**Created:** [January 7, 2009, 9:11am UTC](https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086 "2009-01-07T09:11:17Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![Shri\_B](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/s/898d66/32.png) [@Shri\_B](https://www.ruby-forum.com/u/Shri_B)\
**Post date:** [January 7, 2009, 9:11am UTC](https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086/1 "2009-01-07T09:11:17Z")

</div>

I added a few comments to critical\_tags.txt like this:

fails(“need to track which thread owns critical lock”):Thread.critical  
defers exit

This will help the next person who tries to fix the bug, and also as  
just documentation. However, I realized that Jim regenerates the tag  
files whenever he pulls down new RubySpec tests. So such comments will  
get lost. Jim, is that correct? If so, I will just not add such comments  
until we change the process so that the tags are not periodically  
regenerated from scratch.

Shri

---

<div class="post-metadata">

**Author:** ![Shri\_B](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/s/898d66/32.png) [@Shri\_B](https://www.ruby-forum.com/u/Shri_B)\
**Post date:** [January 7, 2009, 8:22pm UTC](https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086/2 "2009-01-07T20:22:38Z")

</div>

That is correct. The next time I sync up, I will look into the tools for  
tags that Brian has in Rubyspec.

JD

From: Shri B.  
Sent: Tuesday, January 06, 2009 11:41 PM  
To: Jim D.  
Cc: removed\_email\_address@domain.invalid  
Subject: Comments in the RubySpec tag files

I added a few comments to critical\_tags.txt like this:

fails(“need to track which thread owns critical lock”):Thread.critical  
defers exit

This will help the next person who tries to fix the bug, and also as  
just documentation. However, I realized that Jim regenerates the tag  
files whenever he pulls down new RubySpec tests. So such comments will  
get lost. Jim, is that correct? If so, I will just not add such comments  
until we change the process so that the tags are not periodically  
regenerated from scratch.

Shri

---

<div class="post-metadata">

**Author:** ![Shri\_B](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/s/898d66/32.png) [@Shri\_B](https://www.ruby-forum.com/u/Shri_B)\
**Post date:** [January 7, 2009, 9:01pm UTC](https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086/3 "2009-01-07T21:01:08Z")

</div>

If you’re adding value to the RubySpec tests, the rubyspec guys are  
pretty  
good about giving commit access… spread the wealth!

---

<div class="post-metadata">

**Author:** ![Shri\_B](https://www.ruby-forum.com/letter_avatar_proxy/v4/letter/s/898d66/32.png) [@Shri\_B](https://www.ruby-forum.com/u/Shri_B)\
**Post date:** [January 7, 2009, 9:14pm UTC](https://www.ruby-forum.com/t/comments-in-the-rubyspec-tag-files/157086/4 "2009-01-07T21:14:11Z")

</div>

Jim has commit access and does provide patches to improve the framework.  
This thread is about the ironruby tags though, and it would not help  
anyone other than IronRuby.

From: removed\_email\_address@domain.invalid  
[[mailto:removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid)] On Behalf Of Michael  
Letterle  
Sent: Wednesday, January 07, 2009 11:02 AM  
To: removed\_email\_address@domain.invalid  
Subject: Re: [Ironruby-core] Comments in the RubySpec tag files

If you’re adding value to the RubySpec tests, the rubyspec guys are  
pretty good about giving commit access… spread the wealth!  
On Wed, Jan 7, 2009 at 2:40 AM, Shri B.  
\<removed\_email\_address@domain.invalid[mailto:removed\_email\_address@domain.invalid](mailto:removed_email_address@domain.invalid)\> wrote:

I added a few comments to critical\_tags.txt like this:

fails(“need to track which thread owns critical lock”):Thread.critical  
defers exit

This will help the next person who tries to fix the bug, and also as  
just documentation. However, I realized that Jim regenerates the tag  
files whenever he pulls down new RubySpec tests. So such comments will  
get lost. Jim, is that correct? If so, I will just not add such comments  
until we change the process so that the tags are not periodically  
regenerated from scratch.

Shri
