[cfe-dev] [PATCH] Comment parsing: rendering kind field for inline command

Dmitri Gribenko gribozavr at gmail.com
Mon Jul 23 09:45:07 PDT 2012


On Mon, Jul 23, 2012 at 8:40 AM, Douglas Gregor <dgregor at apple.com> wrote:
>
> On Jul 23, 2012, at 8:30 AM, Jordan Rose <jordan_rose at apple.com> wrote:
>
>> Bikeshedding: ICR_Monospaced or ICR_FixedWidth instead of ICR_Typewriter, since it's 2012.
>>
>> Less bikeshedding: although we're conditioned to think of code in a monospace font, there's not really a /reason/ for that. (Smalltalk and AppleScript traditionally use non-monospaced fonts for code listings...not that those are necessarily relevant for us.) In HTML this is the (often not observed) difference between <code> and <tt> (like <em> and <i>). In Doxygen and other documentation systems, does "\c" mean "code" or "fixed-width"?
>>
>> (I'm inclined to think "code", and thus go with Doug's original listing, and emit <code> rather than <tt>.)
>
> Doxygen's documentation says "using a typewriter font", and specifically mentions <tt>.
>
> I slightly prefer the term 'Monospaced' to 'Typewriter', but only slightly.

Thank you Douglas and Jordan for reviews!  Committed r160633 with
s/Typewriter/Monospaced/.

Dmitri

-- 
main(i,j){for(i=2;;i++){for(j=2;j<i;j++){if(!(i%j)){j=0;break;}}if
(j){printf("%d\n",i);}}} /*Dmitri Gribenko <gribozavr at gmail.com>*/




More information about the cfe-dev mailing list