Fix Ddoc warnings

This commit is contained in:
Sebastian Wilzbach 2016-12-20 01:11:01 +01:00
parent 00cbd34e78
commit b8a88558a9
7 changed files with 21 additions and 17 deletions

View file

@ -444,7 +444,7 @@ left to right for all elements $(D a) in $(D range). The original ranges are
not changed. Evaluation is done lazily.
Params:
fun = one or more functions
fun = one or more transformation functions
r = an $(REF_ALTTEXT input range, isInputRange, std,range,primitives)
Returns:
@ -2711,6 +2711,9 @@ seed (the range must be non-empty).
Returns:
the accumulated $(D result)
Params:
fun = one or more functions
See_Also:
$(HTTP en.wikipedia.org/wiki/Fold_(higher-order_function), Fold (higher-order function))
@ -3238,6 +3241,10 @@ This function is also known as
$(HTTP docs.python.org/3/library/itertools.html#itertools.accumulate, accumulate),
$(HTTP hackage.haskell.org/package/base-4.8.2.0/docs/Prelude.html#v:scanl, scan),
$(HTTP mathworld.wolfram.com/CumulativeSum.html, Cumulative Sum).
Params:
fun = one or more functions to use as fold operation
Returns:
The function returns a range containing the consecutive reduced values. If
there is more than one `fun`, the element type will be $(REF Tuple,
@ -3259,6 +3266,7 @@ if (fun.length >= 1)
`ElementType!R`.
Once `S` has been determined, then $(D S s = e;) and $(D s = f(s, e);) must
both be legal.
Params:
range = An $(REF_ALTTEXT input range, isInputRange, std,range,primitives)
Returns:
@ -3277,6 +3285,7 @@ if (fun.length >= 1)
For convenience, if the seed is `const`, or has qualified fields, then
`cumulativeFold` will operate on an unqualified copy. If this happens
then the returned type will not perfectly match `S`.
Params:
range = An $(REF_ALTTEXT input range, isInputRange, std,range,primitives)
seed = the initial value of the accumulator

View file

@ -1877,7 +1877,7 @@ This overload converts an character input range to a `bool`.
Params:
Target = the type to convert to
s = the lvalue of an input range
source = the lvalue of an input range
Returns:
A `bool`
@ -2534,7 +2534,7 @@ if (isSomeString!Source && !is(Source == enum) &&
*
* Params:
* Target = a floating point type
* p = the lvalue of the range to _parse
* source = the lvalue of the range to _parse
*
* Returns:
* A floating point number of type `Target`

View file

@ -1612,18 +1612,18 @@ lengths = static array containing the size of each dimension
Returns:
An N-dimensional array with individual elements of type T.
*/
auto makeMultidimensionalArray(T, Allocator, size_t n)(auto ref Allocator alloc, size_t[n] lengths...)
auto makeMultidimensionalArray(T, Allocator, size_t N)(auto ref Allocator alloc, size_t[N] lengths...)
{
static if (n == 1)
static if (N == 1)
{
return makeArray!T(alloc, lengths[0]);
}
else
{
alias E = typeof(makeMultidimensionalArray!(T, Allocator, n - 1)(alloc, lengths[1 .. $]));
alias E = typeof(makeMultidimensionalArray!(T, Allocator, N - 1)(alloc, lengths[1 .. $]));
auto ret = makeArray!E(alloc, lengths[0]);
foreach (ref e; ret)
e = makeMultidimensionalArray!(T, Allocator, n - 1)(alloc, lengths[1 .. $]);
e = makeMultidimensionalArray!(T, Allocator, N - 1)(alloc, lengths[1 .. $]);
return ret;
}
}

View file

@ -404,7 +404,6 @@ Params:
slice = input slice
Dimensions = indexes of dimensions to be brought to the first position
dimensions = indexes of dimensions to be brought to the first position
dimension = index of dimension to be brought to the first position
Returns:
n-dimensional slice of the same type
See_also: $(LREF swapped), $(LREF everted)
@ -535,7 +534,6 @@ Params:
slice = input slice
Dimensions = indexes of dimensions to reverse order of iteration
dimensions = indexes of dimensions to reverse order of iteration
dimension = index of dimension to reverse order of iteration
Returns:
n-dimensional slice of the same type
+/
@ -641,8 +639,7 @@ Multiplies the stride of the selected dimension by a factor.
Params:
slice = input slice
Dimensions = indexes of dimensions to be strided
dimensions = indexes of dimensions to be strided
factors = list of step extension factors
factors = list of step extension factor
factor = step extension factors
Returns:
n-dimensional slice of the same type
@ -996,7 +993,6 @@ This makes `dropExactly` faster than `drop`.
Params:
slice = input slice
ns = list of numbers of elements to drop
n = number of elements to drop
Returns:
n-dimensional slice of the same type

View file

@ -611,7 +611,6 @@ pure nothrow @system unittest
Creates an uninitialized array and an n-dimensional slice over it.
Params:
lengths = list of lengths for each dimension
slice = slice to copy shape and data from
Returns:
uninitialized n-dimensional slice
+/
@ -749,8 +748,6 @@ See also $(MREF std, experimental, allocator).
Params:
alloc = allocator
lengths = list of lengths for each dimension
init = default value for array initialization
slice = slice to copy shape and data from
Returns:
a structure with fields `array` and `slice`
+/

View file

@ -2877,13 +2877,13 @@ pure @safe nothrow @nogc unittest
/++
Convenience function which calls
`range.$(REF popFrontN, std, range, primitives)(n)) and returns `range`.
`range.$(REF popFrontN, std, range, primitives)(n) and returns `range`.
`drop` makes it easier to pop elements from a range
and then pass it to another function within a single expression,
whereas `popFrontN` would require multiple statements.
`dropBack` provides the same functionality but instead calls
`range.$(REF popBackN, std, range, primitives)(n))
`range.$(REF popBackN, std, range, primitives)(n)
Note: `drop` and `dropBack` will only pop $(I up to)
`n` elements but will stop if the range is empty first.
@ -9941,6 +9941,7 @@ bit, from the least significant bit to the most significant bit.
Params:
R = an integral input range to iterate over
range = range to consume bit by by
Returns:
A `Bitwise` input range with propagated forward, bidirectional

View file

@ -3744,6 +3744,7 @@ int impureVariable;
*
* Params:
* C = `char`, `wchar`, or `dchar`
*
* Returns:
* A forward range if `R` is a range and not auto-decodable, as defined by
* $(REF isAutodecodableString, std, traits), and if the base range is