[
https://issues.apache.org/jira/browse/NUMBERS-133?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16903803#comment-16903803
]
Gilles commented on NUMBERS-133:
--------------------------------
The rule of thumb would to use MathJaX for any formula that would make it
easier to read (rendered or not).
The bar is quite low since even exponents and indices read better in LaTeX:
{noformat}
N_i^k
{noformat}
vs
{noformat}
N<sub>i</sub>^<sup>k</sup>
{noformat}
bq. documentation of private or package-private elements? \[...\] IDEs
generally don't render the MathJax \[...\]
Even so, it's clearer IMO. :-)
When referring to code elements (e.g. variable names), I generally use the
Javadoc "@code" tag:
{code}
/**
* @throws IllegalArgumentException if {@code x <= 0}.
*/
{code}
and the LaTeX syntax for mostly everything else (math-related).
Perhaps we should also provide rendered Javadoc for internal development, where
the private elements are shown (?).
> Speed up Primes.nextPrime(int)
> ------------------------------
>
> Key: NUMBERS-133
> URL: https://issues.apache.org/jira/browse/NUMBERS-133
> Project: Commons Numbers
> Issue Type: Improvement
> Components: primes
> Affects Versions: 1.0
> Reporter: Heinrich Bohne
> Priority: Minor
> Time Spent: 50m
> Remaining Estimate: 0h
>
> The method {{Primes.nextPrime(int)}} can use the same algorithm to skip
> multiples of certain primes as {{SmallPrimes.boundedTrialDivision(int, int,
> List<Integer>)}} uses, instead of hard-coding the alternating increment of
> the trial candidate into a loop.
> Also, if the argument of the method is smaller than or equal to the 512th
> prime number, the method can just infer the next higher prime number directly
> from the array {{SmallPrimes.PRIMES}} without performing any calculations.
--
This message was sent by Atlassian JIRA
(v7.6.14#76016)
