Functions descriptions; Build fix

source/libublsettings-config.c

@@ -532,7 +532,8 @@ int yon_config_load_config(YON_CONFIG_TYPE config_type, ...){
 int yon_config_load_register(YON_CONFIG_TYPE config_type,char *section,char *parameter, ...){
     if (config_type!=YON_CONFIG_BOTH){
         if (__yon__config__strings){
-            __yon__config__strings = yon_dictionary_free_all((dictionary*)__yon__config__strings,NULL);
+            yon_dictionary_free_all((dictionary*)__yon__config__strings,NULL);
+            __yon__config__strings=NULL;
         }
         va_list args;
         va_start(args,parameter);
@@ -834,7 +835,8 @@ int yon_config_set(char *key, void *data){
 
 int yon_config_clean(){
     check_config{
-        __yon__config__strings = (yon_config_parameter*)yon_dictionary_free_all((dictionary*)__yon__config__strings, NULL);
+        yon_dictionary_free_all((dictionary*)__yon__config__strings, NULL);
+        __yon__config__strings = NULL;
         return 1;
     }
     else return 0;

source/libublsettings.h

@@ -584,64 +584,177 @@ dictionary *yon_dictionary_check_loops(dictionary *target);
  */
 #define yon_char_return_if_exist(string,opposite) string&&strcmp(string,"")?string:opposite
 
+/**
+ * @brief Macros. Removes last string symbol.
+ * 
+ * Макрос. Удаление последнего символа строки.
+ * @param string
+ * @param symbol If last string symbol is same, removes it, otherwise does nothing.
+ * 
+ * Если последний символ строки совпадает, он удаляется, иначе ничего не происходит
+ */
+#define yon_char_remove_last_symbol(string,symbol) {if (string[strlen(string)-1]==symbol) string[strlen(string)-1]='\0';}
 
-#define yon_char_remove_last_symbol(target,symbol) {if (target[strlen(target)-1]==symbol) target[strlen(target)-1]='\0';}
-
-char *yon_char_conenct_if_true();
-
+/**
+ * @brief Find last symbol in sting.
+ * 
+ * Найти последний символ в строке.
+ * @param find Symbol to find.
+ * 
+ * Искомый символ.
+ * @return Type: int
+ * 
+ * The location of the last character being searched for.
+ * 
+ * Местоположение последнего искомого символа.
+ */
 int yon_char_find_last(char *source, char find);
 
-/**[EN]
+/**
+ * @brief Create new string by combining two strings.
  * 
- * Creates new char string by combining two char strings.
- * [RU]
- * Создаёт новую строку, состоящую из двух входящих.
+ * Создать новую строку, состоящую из двух входящих.
+ * @param append Appending string.
+ * 
+ * Присоединяемая строка.
+ * @return Type: char* 
+ * A new allocated string, containing both input strings.
+ * 
+ * Новая выделенная строка, состоящая из обеих входящих строк.
  */
 char *yon_char_append(const char *source, const char *append);
 
-/**[EN]
+/**
+ * @brief Create new string by appending string with symbol.
  * 
- * Creates new char string by combining two char strings.
- * [RU]
- * Создаёт новую строку, состоящую из строки [source]
- * с добавлением символа [append] в конец.
+ * Создать новую строку соединением строки и символа
+ * @param append Appending symbol.
+ * 
+ * Прибавляемый символ.
+ * @return Type: char*
+ * 
+ * A new allocated string.
+ * 
+ * Новая выделенная строка. 
  */
 char *yon_char_append_c(const char *source, char append);
 
+/**
+ * @brief Append string with another string, inserting another string between
+ * 
+ * Добавляет к строке другую строку, добавляя между ними разделитель. 
+ * @param target Appending string.
+ * 
+ * Добавляемая строка.
+ * @param divider Divider. A string, which divides source string into substrings.
+ * 
+ * Разделитель. Строка, разделяющая основную строку на подстроки.
+ * @return Type: char*
+ * 
+ * A newly allocated string.
+ * 
+ * Новая выделенная строка. 
+ */
 char *yon_char_append_element(char *source,char *target, char *divider);
+
+/**
+ * @brief Remove substring from string.
+ * 
+ * Удалить подстроку из строки.
+ * @param target Substring to remove.
+ * 
+ * Удаляемая подстрока. 
+ * @param divider Divider. Main string divides into substrings to compare.
+ * @return Type: char*
+ * 
+ * A newly allocated string with reniver substing.
+ * 
+ * Новая выделенная строка с удалённой подстрокой. 
+ */
 char *yon_char_remove_element(char *source,char *target, char *divider);
 
-/**[EN]
+/**
+ * @brief Copy string.
+ * 
+ * Копировать строку.
+ * @return Type: char* 
+ * 
+ * A newly allocated string.
  * 
- * creates new char string by copying another char.
+ * Новая выделенная строка.
  */
 char *yon_char_new(const char *chr);
 
-/**yon_char_unite(const char *source, ...)
- * [En]
+/**
+ * @brief Unite multiple strings.
  * 
- * [RU]
- * Объединяет строку [source] со всеми строками, написанными в [...]. Последний элемент должен быть NULL
-*/
+ * Объединить несколько строк.
+ * @param source First string to unite.
+ * 
+ * Первая объединяемая строка.
+ * @param ... Multiple strings, edning with NULL.
+ * 
+ * Произвольное количество строк, заканчивающееся NULL.
+ * @return Type: char*
+ * 
+ * A newly allocated string.
+ * 
+ * Новая выделенная строка. 
+ */
 char *yon_char_unite(const char *source, ...);
 
-/**yon_cut(char *source, int size, int startpos)
- * [EN]
- * cuts source string by size length from startpos position.
- */
 char *yon_cut(char *source, int size, int startpos);
 
-
+/**
+ * @brief Check if string begins with substring.
+ * 
+ * Проверить начинается ли строка с подстроки.
+ * @param haystack String to check.
+ * 
+ * Проверяемая строка.
+ * @param needle Substring searched in the beginning of main string.
+ * 
+ * Подстрока, искомая в начале основной строки.
+ * @return Type: boolean
+ */
 int yon_char_check_begins_with(char *haystack, char *needle);
 
+/**
+ * @brief Check if string array has string, beginning with substring.
+ * 
+ * Проверить есть ли в массиве строк строка, начинающаяся с подстроки.
+ * @param target String array to check.
+ * 
+ * Проверяемый массив строк.
+ * @param size Pointer to size of string array.
+ * 
+ * Указатель на размер массива строк
+ * @param compare String to search in string array.
+ * 
+ * Искомая строка.
+ * @return Type: char* 
+ * 
+ * If substring was found, full string is returned, otherwise, NULL.
+ * 
+ * Если подстрока была найдена возвращается полная строка, иначе NULL.
+ */
 char *yon_char_parsed_check_exist_begins_with(char **target, int size, char *compare);
 
-/**yon_char_wrap_to_lines(char *target, unsigned int line_count, unsigned int *final_size)
- * [EN]
+/**
+ * @brief Split a string into a given number of lines.
  * 
- * [RU]
- * Делит строку [target] на [line_count] частей по пробелу и
- * возвращает массив строк длиной [final_size]
+ * Разделить строку на заданное количество строк.
+ * @param line_count Number of lines.
+ * 
+ * Количество строк.
+ * @param final_size Pointer to return the size of the string array.
+ * 
+ * Указатель для возврата размера массива строк.
+ * @return Type: config_str 
+ * 
+ * Newly allocated string array with splitted input string.
+ * 
+ * Новый выделенный массив строк с разделённой входной строкой.
  */
 config_str yon_char_wrap_to_lines(char *target, unsigned int line_count, unsigned int *final_size);
 
@@ -651,6 +764,14 @@ config_str yon_char_wrap_to_lines(char *target, unsigned int line_count, unsigne
  * returning left part of divided string and
  * inserting right part to source string.
  */
+
+/**
+ * @brief Divide a sting at position.
+ * 
+ * @param source 
+ * @param dividepos 
+ * @return char* 
+ */
 char *yon_char_divide(char *source, int dividepos);
 
 /**yon_char_divide_search(char *source, char *dividepos, int delete_divider)