Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

placeholders should be formatted with math fonts #326

Open
zygoloid opened this issue Jun 18, 2014 · 6 comments
Open

placeholders should be formatted with math fonts #326

zygoloid opened this issue Jun 18, 2014 · 6 comments
Labels
big An issue causing a large set of changes, scattered across most of the text.

Comments

@zygoloid
Copy link
Member

As discussed at Rapperswil, we'd like to experiment with this.

@tkoeppe
Copy link
Contributor

tkoeppe commented Dec 10, 2015

If we are talking about code placeholders here, then I'm worried that the math font won't harmonize with the teletype font. They have different contrast and different cap height. This may work in certain situations, but it may come to bite us in the future.

I find italic teletype appropriate for the job. Just like "normal" body font italics are appropriate for mathematical variables in the context of body text, italic teletype seems appropriate for "code variables". (Though perhaps we should facilitate disabling the italic correction.)

image

@jensmaurer
Copy link
Member

See also #1060.

@tkoeppe
Copy link
Contributor

tkoeppe commented Nov 17, 2016

Indeed. I think the need for italics in this context is by and large the same as for any code placeholder, so I'd be perfectly happy treating the two the same way.

(Note that for capital letters, the distinction between italic and slanted isn't very big, so either is fine here.)

@jensmaurer
Copy link
Member

See #1139 for indexed (type) variables.

@jensmaurer jensmaurer added the decision-required A decision of the editorial group (or the Project Editor) is required. label Dec 1, 2017
@jensmaurer
Copy link
Member

We should decide how to proceed and update the wiki accordingly.

@jensmaurer
Copy link
Member

jensmaurer commented Jun 7, 2018

Editorial meeting discussion: Variables of different kinds might be formatted differently. Possible kinds: type, variable, object, value, expression. It seems the convention is to use italics for all but the first and last; use code font for those. For meta-variables that expand to code, use code font. For other meta-variables, use math. For string interpolation, use \placeholder. Also for "op" in fold-expression. Update the wiki.
Idea: Introduce \tvar for type placeholders and make them italics. Not pursued.

@jensmaurer jensmaurer removed the decision-required A decision of the editorial group (or the Project Editor) is required. label Jun 7, 2018
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
big An issue causing a large set of changes, scattered across most of the text.
Projects
None yet
Development

No branches or pull requests

4 participants