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.

Sign up for GitHub

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

Jump to bottom

[sf.math] parenthesized "of the first/second kind"? #1250

Closed
jensmaurer opened this issue Dec 15, 2016 · 1 comment
Closed

[sf.math] parenthesized "of the first/second kind"? #1250

jensmaurer opened this issue Dec 15, 2016 · 1 comment
Assignees
@jensmaurer

Comments

@jensmaurer
Copy link
Member

We're inconsistent here.

For example, [sf.cmath.cyl_bessel_j] has parenthesis in the heading and no parenthesis in the running text. The synopsis follows the spelling in the heading.
@tkoeppe
Copy link
Contributor

tkoeppe commented Dec 15, 2016 •
edited

ISO-80000-2 never parenthesizes anything. We should definitely never parenthesize "of the {first,second} kind", and also never "incomplete", because those words are part of the description, not an additional explanation. (Meaning should never change if you drop parentheticals.)

You could argue that "complete" may be parenthesized, because it's implied, but we may as well also keep it unparenthesized.

jensmaurer added a commit to jensmaurer/draft that referenced this issue Dec 15, 2016
@jensmaurer
[sf.math] Promote parenthesized parts of function names
ee622c1 
to un-parenthesized.

Fixes cplusplus#1250.
@jensmaurer jensmaurer self-assigned this Dec 15, 2016
@jensmaurer jensmaurer mentioned this issue Dec 15, 2016
Merged
tkoeppe pushed a commit that referenced this issue Dec 15, 2016
@jensmaurer @tkoeppe
[sf.math] Promote parenthesized parts of function names to un-parenth…
8e64a08 
…esized. (#1256)

Fixes #1250.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees

@jensmaurer jensmaurer

Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
2 participants
@tkoeppe @jensmaurer