Parse Markdown links at beginning of line within a paragraph (#1470)

* Catch Markdown links at beginning of line within paragraph

Per Issue #774, Markdown links were being parsed as ordinary text when
they occurred at the beginning of a line other than the first line of
the paragraph. This occurred because the parser was not interpreting a
left square bracket as a special character that could delimit special
markup. A space character was considered a special character, so, if a
space occurred at the beginning of the new line, then the parser would
interpret the space by itself and then continue parsing, thereby
catching the Markdown link. '\n' was not treated as a special character,
so the parser did not catch a Markdown link that may have followed.

Note that this will allow for Markdown links that are not surrounded by
spaces. For example, the following text includes a Markdown link that
will be parsed:

  Hello, world[label](url)

This is consistent with how the parser handles other types of markup.

* Remove obsolete documentation hint

Commit 6b9aeafddf20efc65d3725c16e3fc43a20aac343 should eliminate the
need for the workaround suggested in the documentation.

1 files changed, 0 insertions, 11 deletions

diff --git a/doc/markup.rst b/doc/markup.rst
index abfeb52a..73ec22fd 100644
--- a/doc/markup.rst
+++ b/doc/markup.rst
@@ -1126,17 +1126,6 @@ followed by the URL enclosed in regular parentheses, for example: ::
 
 The link text is used as a description for the URL if the output
 format supports it.
-
-Hint: There's a `known issue <https://github.com/haskell/haddock/issues/774>`_ 
-that any inline link at the beginning of a line within a multi-line comment 
-isn't rendered correctly: ::
-   
-    {-| Some multi-line comment that has a
-    [link](https://example.com) and a
-    [reference link]: https://example.com
-    -}
-    
-Adding a space or a word in front of such a link can be used as a workaround.   
    
 Images
 ~~~~~~