aBothe/Mono-D — Issue #45: Limit tooltip size
Author: jpf91
Created: 2012-02-02 17:17:32+00:00
State: open

For functions with excessive documentation tooltips can be too big.

Example:

```d
/**
* This function generates a name based (Version 3) uuid from a namespace UUID and a name.
* If no namespace UUID was passed, the nilUUID is used.
*
* Note:
* The default namespaces (dnsNamespace, ...) defined by
* this module should be used when appropriate.
*
* RFC 4122 recommends to use Version 5 UUIDs instead of Version 3
* UUIDs for new applications.
*
* CTFE:
* CTFE is currently not supported as std.md5 doesn't work in CTFE.
*
* Examples:
* ---------------------------------------
* //Use default nilUUID namespace
* auto simpleID = md5UUID("test.uuid.any.string");
*
* //use a name-based id as namespace
* auto namespace = md5UUID("my.app");
* auto id = md5UUID("some-description", namespace);
* ---------------------------------------
*
* Note:
* RFC 4122 isn't very clear on how UUIDs should be generated from names.
* It is possible that different implementations return different UUIDs
* for the same input, so be warned. The implementation for UTF8 strings
* and byte arrays used by std.uuid is compatible with boost's implementation.
* std.uuid guarantees that the same input to this function will generate
* the same output at any time, on any system (this especially means endianness
* doesn't matter).
*
* Note:
* This function does not provide overloads for wstring and dstring, as
* there's no clear answer on how that should be implemented. It could be
* argued, that string, wstring and dstring input should have the same output,
* but that wouldn't be compatible with boost, which generates different output
* for strings and wstrings. It's always possible to pass wstrings and dstrings
* by using the ubyte[] function overload (but be aware of endianness issues!).
*
* BUGS: Could be pure, but this depends on the MD5 hash code.
*/
@safe void md5UUID(const(char[]) name)
{}
```
screenshot:
![](http://i.imgur.com/mNXPR.png)