From 157027a6f5b27846910f4f0915d044491ba5441f Mon Sep 17 00:00:00 2001
From: Hypolite Petovan <mrpetovan@gmail.com>
Date: Mon, 5 Feb 2018 11:42:06 -0500
Subject: [PATCH] Improve BBCode documentation/comment

---
 doc/BBCode.md               | 23 ++++++++++++++++++++++-
 src/Content/Text/BBCode.php |  2 +-
 2 files changed, 23 insertions(+), 2 deletions(-)

diff --git a/doc/BBCode.md b/doc/BBCode.md
index 6eebed486..946c61f24 100644
--- a/doc/BBCode.md
+++ b/doc/BBCode.md
@@ -165,7 +165,7 @@ line
 code</code></td>
 </tr>
 <tr>
-  <td>[code=php]function text_highlight($s,$lang)[/code]</td>
+  <td>[code=php]function text_highlight($s,$lang)[/code]<sup><a href="#supported-code">1</a></sup></td>
   <td><code><div class="hl-main"><ol class="hl-main"><li><span class="hl-code">&nbsp;</span><span class="hl-reserved">function</span><span class="hl-code"> </span><span class="hl-identifier">text_highlight</span><span class="hl-brackets">(</span><span class="hl-var">$s</span><span class="hl-code">,</span><span class="hl-var">$lang</span><span class="hl-brackets">)</span></li></ol></div></code></td>
 </tr>
 <tr>
@@ -208,6 +208,27 @@ code</code></td>
 </tr>
 </table>
 
+<a name="supported-code">1</a>: Supported language parameter values for code highlighting:
+- abap
+- avrc
+- cpp
+- css
+- diff
+- dtd
+- html
+- java
+- javascript
+- js
+- mysql
+- perl
+- php
+- python
+- ruby
+- sh
+- sql
+- vbscript
+- xml
+
 ### Titles
 
 <table class="bbcodes">
diff --git a/src/Content/Text/BBCode.php b/src/Content/Text/BBCode.php
index a4eb46115..d68208a60 100644
--- a/src/Content/Text/BBCode.php
+++ b/src/Content/Text/BBCode.php
@@ -1075,7 +1075,7 @@ class BBCode
 		}
 
 		// We only call this so that a previously unknown contact can be added.
-		// This is important for the function "get_contact_details_by_url".
+		// This is important for the function "Model\Contact::getDetailsByURL()".
 		// This function then can fetch an entry from the contact table.
 		Contact::getIdForURL($profile, 0);