clickhouse: added comments for functions [#CONV-6788].

dbms/include/DB/Functions/FunctionsCoding.h

@@ -26,6 +26,8 @@ namespace DB
   * 			Например, hex(257) = '0101'.
   * unhex(string) -	Возвращает строку, hex от которой равен string с точностью до регистра и отбрасывания одного ведущего нуля.
   * 				Если такой строки не существует, оставляет за собой право вернуть любой мусор.
+  * 
+  * bitmaskToArray(x) - Возвращает массив степеней двойки в двоичной записи x. Например, bitmaskToArray(50) = [2, 16, 32].
   */
 
 

dbms/include/DB/Functions/FunctionsDictionaries.h

@@ -17,11 +17,16 @@ namespace DB
 /** Функции, использующие словари Яндекс.Метрики
   * - словари регионов, операционных систем, поисковых систем.
   *
-  * regionToCity, regionToArea, regionToCountry,
-  * OSToRoot,
-  * SEToRoot,
+  * Подняться по дереву до определенного уровня.
+  *  regionToCity, regionToArea, regionToCountry,
+  *  OSToRoot,
+  *  SEToRoot,
   *
-  * regionIn, SEIn, OSIn.
+  * Является ли первый идентификатор потомком второго.
+  *  regionIn, SEIn, OSIn.
+  * 
+  * Получить массив идентификаторов регионов, состоящий из исходного и цепочки родителей. Порядок implementation defined.
+  *  regionHierarchy, OSHierarchy, SEHierarchy.
   */
 
 

dbms/include/DB/Functions/FunctionsMiscellaneous.h

@@ -41,6 +41,8 @@ namespace DB
   *
   * arrayJoin(arr)	- особая функция - выполнить её напрямую нельзя;
   *                   используется только чтобы получить тип результата соответствующего выражения.
+  * 
+  * sleep(n)		- спит n секунд каждый блок.
   */
 
 

dbms/include/DB/Functions/FunctionsStringSearch.h

@@ -24,10 +24,11 @@ namespace DB
   *
   * match(haystack, pattern)	- поиск по регулярному выражению re2; возвращает 0 или 1.
   *
-  * TODO:
-  * extract(haystack, pattern)	- вынимает первый subpattern, (или нулевой, если первого нет) согласно регулярному выражению re2;
-  * 							  возвращает пустую строку, если не матчится.
-  * extract(haystack, pattern, n) - вынимает n-ый subpattern; возвращает пустую строку, если не матчится.
+  * Применяет регексп re2 и достаёт:
+  * - первый subpattern, если в regexp-е есть subpattern;
+  * - нулевой subpattern (сматчившуюся часть, иначе);
+  * - если не сматчилось - пустую строку.
+  * extract(haystack, pattern)
   *
   * replaceOne(haystack, pattern, replacement) - замена шаблона по заданным правилам, только первое вхождение.
   * replaceAll(haystack, pattern, replacement) - замена шаблона по заданным правилам, все вхождения.
@@ -312,11 +313,6 @@ struct MatchImpl
 };
 
 
-/** Применяет регексп и достаёт:
-  * - первый subpattern, если в regexp-е есть subpattern;
-  * - нулевой subpattern (сматчившуюся часть, иначе);
-  * - если не сматчилось - пустую строку.
-  */
 struct ExtractImpl
 {
 	static void vector(const std::vector<UInt8> & data, const ColumnArray::Offsets_t & offsets,