ruby
Convention to include non-ASCII characters in C comments
For some classes and methods, it would be great if non-ASCII characters could be included in rdoc documentation. One example would be String#upcase/downcase/swapcase/capitalize, which newly work for all of Unicode.
For Ruby files, this should already work, because these files are UTF-8 by default nowadays.
However, for C source, there is a problem: There are still C compilers that bark at non-ASCII characters/bytes in C source. This would mean that we need some kind of escaping convention. One obvious choice would be HTML/XML escapes (ü).
If there's already a solution for this, I'd appreciate to know. If not, I'll be glad to contribute.
As a workaround you can use :include:, see the documentation here: http://docs.seattlerb.org/rdoc/RDoc/Markup.html#class-RDoc::Markup-label-Other+directives
