more ideas

README.md

@@ -9,24 +9,34 @@ These functions are responsible for the library's "life time".
 `hl_init()` must be called before any other library function.
 `hl_deinit()` will ensure all occupied memory is freed.
 
+
 ```C
-void render_string(const char * const string, const char * const mode);
+void render_string(const char * const string, const char * const mode);	//XXX: rename
 ```
 This function matches _string_ against all known highlighting rules and dispatches the appropriate callback depending on _mode_.
 
+
 ```C
 #define HLPATH //?!
 ```
 Coma separated list of directories to be searched for syntax scripts. `#undef` to disable it entirely.
 
+
 ```C
 typedef void (*attribute_callback_t)(const char * const string, const int length, void * const attributes);
 ```
-The type used for defining appropriate callbacks for render_string().
+The type used for defining appropriate callbacks for render\_string().
 + string     - string to be outputed
 + length     - number of characters that matched a highlighting rule
 + attributes - arbitrary data associated with the matched rule; intended to hold color/font information for example
 
+
+```C
+struct token_table_t;
+```
+Holds a group of tokens belonging to the same language.
+
+
 ```C
 typedef struct {
 	char * key;
@@ -35,8 +45,12 @@ typedef struct {
 ```
 The type for defining display modes.
 
-	void new_display_mode(display_t * mode);
-This is how you append a display mode that render_string() will search based on _.key_.
+
+```C
+void new_display_mode(display_t * mode);
+```
+This is how you append a display mode that render\_string() will search based on _.key_.
+
 
 ```C
 typedef enum {
@@ -57,24 +71,59 @@ These are the valid type of distinct token types.
 + MATCH     - a regular expression to be recognized
 + REGION    - a regular expression where the starting and ending patters are to be distinguished from the contents
 
+
 The universal way to add a new pattern to be recognized is with:
 ```C
 token * new_token(const char * const syntax, const token_type_t t, const hl_group_t * const g);
 ```
+
+
 There are also convinience functions:
 ```C
 // NOTE: the return value is the number tokens successfully inserted
 int new_keyword_tokens(const char * const * words, hl_group_t * const g);	// _words_ must be NULL terminated
 int new_syntax_character_tokens(const char * const chars, hl_group_t * const g);
 ```
-The regex engine used for MATCHes is Jeger by default, emulating Vim regex.
+
+
+The regex engine used for MATCH-es is Jeger by default, emulating Vim regex.
 However the regex engine can be overridden:
 ```C
 	// ?!
 ```
 
+
+### Default
+There are default of most anything defined for convenience. They can be disable with `#undef`-ing the following macro:
+```C
+#define HL_DEFAULTS
+```
+
+```C
+hl_group_t * normal_hl
+hl_group_t * error_hl
+hl_group_t * warning_hl
+hl_group_t * search_hl
+
+hl_group_t * underlined_hl
+hl_group_t * bold_hl
+hl_group_t * italics_hl
+
+hl_group_t * comment_hl
+hl_group_t * block_hl
+hl_group_t * operator_hl
+hl_group_t * constant_hl
+hl_group_t * special_hl
+hl_group_t * identifier_hl
+hl_group_t * type_hl
+
+// ---
+token_table_t std_token_table;
+```
+
 ---
 
+
 # hl 
 General purpose highlighter (and demo program for libhl).
 

source/hl.c

@@ -133,7 +133,7 @@ int new_keyword_tokens(const char       * const * words,
 
 token_t * new_region_token(const char       * start,
                            const char       *   end,
-                                 hl_group_t *       g) {
+                                 hl_group_t *     g) {
 	char buffer[100];
 	buffer[0] = '\0';
 	strcat(buffer, start);
@@ -183,14 +183,14 @@ int token_fits(const token_t * const            token,
                const char    * const               to,
                const int                string_offset,
                const bool            is_start_of_line,
-                     int     *       match_offset) {
-  UNUSED(match_offset);
+                     int     *           match_offset) {
+	UNUSED(match_offset);
 	//return regex_match(pattern, to, string_offset, match_offset);
 	return (int)regex_match(token->syntax, to, is_start_of_line);
 }
 
 void render_string(const char * const string,
-                   const char * const mode) {
+                   const char * const   mode) {
 	for (const char * s = string; *s != '\00';) {
 		int    f           = 0;
 		size_t token_index = 0;