# HG changeset patch
# User Mads Kiilerich <madski@unity3d.com>
# Date 2016-09-06 00:51:18
# Node ID 7fbdd1926fa8464862f1aee90b54aa295907a788
# Parent  ea59ff1f5639b2ca1fa0ca01cbd20a16d81a3c08

helpers: clarify the purpose of linkify_others

diff --git a/kallithea/lib/helpers.py b/kallithea/lib/helpers.py
--- a/kallithea/lib/helpers.py
+++ b/kallithea/lib/helpers.py
@@ -1314,7 +1314,10 @@ def urlify_changesets(text_, repo_name):
 
 
 def linkify_others(t, l):
-    # attempt at fixing double quoting?
+    """Add a default link to html with links.
+    HTML doesn't allow nesting of links, so the outer link must be broken up
+    in pieces and give space for other links.
+    """
     urls = re.compile(r'(\<a.*?\<\/a\>)',)
     links = []
     for e in urls.split(t):
@@ -1328,8 +1331,8 @@ def linkify_others(t, l):
 def urlify_commit(text_, repo_name, link_=None):
     """
     Parses given text message and makes proper links.
-    issues are linked to given issue-server, and rest is a changeset link
-    if link_ is given, in other case it's a plain text
+    Issues are linked to given issue-server. If link_ is provided, all other
+    text will link there.
     """
     newtext = html_escape(text_)