[Issue 20976] New: pipe documentation incorrectly renders part of memoize
d-bugmail at puremagic.com
d-bugmail at puremagic.com
Thu Jun 25 15:56:18 UTC 2020
https://issues.dlang.org/show_bug.cgi?id=20976
Issue ID: 20976
Summary: pipe documentation incorrectly renders part of memoize
Product: D
Version: D2
Hardware: All
URL: http://dlang.org/library/std/functional.html
OS: All
Status: NEW
Severity: enhancement
Priority: P3
Component: phobos
Assignee: nobody at puremagic.com
Reporter: john.michael.hall at gmail.com
On the dlang site here: https://dlang.org/library/std/functional/pipe.html
the following documentation comment is partially shown and then cut off
strangely. However, this is also the documentation for memoize and not pipe. It
should not be shown at all.
/**
* $(LINK2 https://en.wikipedia.org/wiki/Memoization, Memoizes) a function so
as
* to avoid repeated computation. The memoization structure is a hash table
keyed by a
* tuple of the function's arguments. There is a speed gain if the
* function is repeatedly called with the same arguments and is more
* expensive than a hash table lookup. For more information on memoization,
refer to $(HTTP
docs.google.com/viewer?url=http%3A%2F%2Fhop.perl.plover.com%2Fbook%2Fpdf%2F03CachingAndMemoization.pdf,
this book chapter).
Example:
----
double transmogrify(int a, string b)
{
... expensive computation ...
}
alias fastTransmogrify = memoize!transmogrify;
unittest
{
auto slow = transmogrify(2, "hello");
auto fast = fastTransmogrify(2, "hello");
assert(slow == fast);
}
----
--
More information about the Digitalmars-d-bugs
mailing list