TYPO3 Core

I took me a while to understand how typolink works. The
TSref description
http://typo3.org/documentation/document-library/references/doc_core_tsref/4.4.0/view/1/5/#id2507528
seems to me somehow confusing.

For example the following sentence is very unclear:
"Target is normally defined by the "extTarget" and "target" properties
of typolink. But you may override this target by adding the new target
after the parameter separated by a whitespace. Thus the target becomes
the second parameter."

The above sentence is down below into the description box for the
parameter property of typolink. Nowhere above the quoted sentence, it is said that
the parameter property may have up to four values (or better, a four
parts value: linked-resource, target, class, title), and how you need to
separate them just by whitespaces.

I suggest to start the description for the parameter property of typolink by a sentence which explains that the parameter property may have a value composed by up to four parts: linked-resource, target, class, title; that they need to be separated just by whitespaces, and that the first is required.
Then I would go into the details for each part.

(issue imported from #M13534)