wxruby development - Sep 2007 - wxRuby Documentation / Textitle Docs

Hey All,

Just wanted to let you guys know, that with the HTML Generated 
documentation from the Textile source code, does not show *''s in stuff 
like Wx::FileDialog.  It''s interpreting this as a Bold, not as an 
Asterisk.  Just thought you''d want to know that.

L8ers,
Mario Steele

Thanks for pointing that out Mario.

It appears to start with (*,?) in the following paragraph:

Both the X and Windows versions implement a wildcard filter. Typing a
filename containing wildcards (*, ?) in the filename text item, and
clicking on Ok, will result in only those files matching the pattern being
displayed. The wildcard may be a specification for multiple
types of file with a description for each, such as:


  "BMP and GIF files (*.bmp;*.gif)|*.bmp;*.gif|PNG files
(*.png)|*.png"


But when I paste this in to the online textile tool it works fine
(http://textism.com/tools/textile/index.php)

I wonder if it is a problem with RedCloth? Alex has done most of the
work on the documentation, I have not used Textile all that much.

Alex have any ideas?

Sean

On 9/27/07, Mario Steele <mario at ruby-im.net>
wrote:
> Hey All,
>
> Just wanted to let you guys know, that with the HTML Generated
> documentation from the Textile source code, does not show *''s in
stuff
> like Wx::FileDialog.  It''s interpreting this as a Bold, not as an
> Asterisk.  Just thought you''d want to know that.
>
> L8ers,
> Mario Steele
> _______________________________________________
> wxruby-development mailing list
> wxruby-development at rubyforge.org
> http://rubyforge.org/mailman/listinfo/wxruby-development
>

Sean Long wrote:
> But when I paste this in to the online textile tool it works fine
> (http://textism.com/tools/textile/index.php)
>
> I wonder if it is a problem with RedCloth? Alex has done most of the
> work on the documentation, I have not used Textile all that much
>   
Thanks Mario, Sean. I think there a few bugs in RedCloth''s 
implementation of Textile, annoyingly. As another example, the Textile 
online tester interprets a line with a space followed by a # character 
as literal text, eg when you want to write code with a comment
 
 # this form of event handler is also allowed:
 evt_foo my_widget, :on_foo

But RedCloth parses the # as a numbered-list member.

As a stopgap, ==symbol== is Textile "escape" syntax for avoiding
special
processing of formatting chars. I''m open to better formats for the
docs,
but when we last looked, the alternatives we considered (DocBook, rdoc) 
all had disadvantages.

alex