Firacode: Ligature Request: /**

Created on 19 Feb 2017  路  10Comments  路  Source: tonsky/FiraCode

Swift uses /** to start a documentation comment block. There are currently ligatures for /* and */ and it looks odd when combined with /**.

Most helpful comment

Same for PHP :) 馃憤

All 10 comments

Same for PHP :) 馃憤

And CSS.

Same for Javadoc :+1:

A lot of documentation conventions use it, including the above and Doxygen.

This used to exist (see #219) but was removed because it was misaligned. I think the proper solution is to add it back, properly aligned.

Other useful sequences for Doxygen comments are ///, /*!, //!, and each of the four suggested markers followed by <. I think /// is also used for C#, but I don鈥檛 know if the others will be generally useful. Personally, I use /**, ///, and ///<.

How about having the /** display like /: but have the dots replaced with asterisks? It wouldn't be too long then.

There used to be /** but it was removed due to conflict with file paths and bad alignement with multiline commets block. See #219 and #238. If you have ideas how those could be avoided I鈥檒l be happy to bring it back

Well, for docs, the line with /* typically doesn't have text, so only having the /* ligature if there's a linebreak or newline character after it should work fine (if possible) and not affect the other cases you mentioned

Still, what do you think could be improved? The more I work with Fira Code, the more I think it鈥檚 not worth it having ligatures for simple/trivial cases like this. They look pretty good as they are, and there鈥檚 a lot of complexity bringing them around for a really small gain.

removed due to conflict with file paths

Thats a really good point. Making doc comment blocks look a little bit nicer is not worth having awful looking glob patterns...

Was this page helpful?
0 / 5 - 0 ratings

Related issues

Photonico picture Photonico  路  3Comments

whatisaphone picture whatisaphone  路  3Comments

aolko picture aolko  路  3Comments

magnus-madsen picture magnus-madsen  路  3Comments

hatched picture hatched  路  3Comments