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

Overuse and misuse of \techterm in [rand] #2072

Closed
jwakely opened this issue May 11, 2018 · 4 comments
Closed

Overuse and misuse of \techterm in [rand] #2072

jwakely opened this issue May 11, 2018 · 4 comments

Comments

@jwakely
Copy link
Member

jwakely commented May 11, 2018

Terms are defined using \techterm and then also referred to using it e.g. [rand.req.urng] uses it for uniform random bit generator in paragraphs 1 and 2. These terms are not indexed, because they're introduced with \techterm not \defn.

We also have terms that don't need defining here, like \techterm{signed} and \techterm{unsigned}.
@jensmaurer
Copy link
Member

We should consider whether there is space for non-indexed, yet italics \techterms that are only valid locally, or whether we should strive for indexed \defn terms in all cases.

@jensmaurer jensmaurer added the decision-required A decision of the editorial group (or the Project Editor) is required. label May 24, 2018
@jensmaurer
Copy link
Member

jensmaurer commented Jun 7, 2018 •
edited by tkoeppe

Editorial meeting consensus: As a rule of thumb, if a term is local to a subclause, do not make it italics and do not index it, i.e. delete any \techterm or \term decoration. Anything with a larger scope should get a (scoped) index entry (e.g. via \defnx). Net result: \techterm has been excised from the standard.

@jensmaurer jensmaurer removed the decision-required A decision of the editorial group (or the Project Editor) is required. label Jun 7, 2018
tkoeppe added a commit that referenced this issue Jun 7, 2018
@tkoeppe
Replace \techterm with \term and remove the \techterm macro.
626c617 
As per #2072, local terms should not be marked up at all, and more widely-used terms should have a (scoped) index entry (via \defnx etc.)
tkoeppe added a commit that referenced this issue Jun 7, 2018
@tkoeppe
Replace \techterm with \term.
c668372 
As per #2072, local terms should not be marked up at all, and more widely-used terms should have a (scoped) index entry (via \defnx etc.)
@tkoeppe
Copy link
Contributor

tkoeppe commented Jun 8, 2018

See also 76545fa.

@jensmaurer
Copy link
Member

$ grep techterm *.tex
(empty)

@morinmorin morinmorin mentioned this issue Jan 6, 2019
Closed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Assignees
No one assigned
Labels
None yet
Projects
None yet
Milestone
No milestone
Development

No branches or pull requests
3 participants
@jwakely @tkoeppe @jensmaurer