]> git.xolatile.top Git - public-libhl.git/commitdiff
fixup
authoranon <anon@anon.anon>
Mon, 18 Sep 2023 19:47:48 +0000 (21:47 +0200)
committeranon <anon@anon.anon>
Mon, 18 Sep 2023 19:47:48 +0000 (21:47 +0200)
README.md

index bbb406d226cce72c5f66c69a6ffefef1f097a2e9..554275272d75a0bd1d7f4c11124a9bc42f221242 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,38 +1,46 @@
 # libhl 
 
 ## API
+```C
        int hl_init(void);
        int hl_deinit(void);
+```
 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);
+```
 This function matches _string_ against all known highlighting rules and dispatches the appropriate callback depending on _mode_.
 
+```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().
 + 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
 
-
-
-       typedef struct {
-               char * key;
-               attribute_callback_t callback;
-       } display_t;
+```C
+typedef struct {
+       char * key;
+       attribute_callback_t callback;
+} display_t;
+```
 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
        typedef enum {
                KEYSYMBOL,
                KEYWORD,
                MATCH,
                REGION
        } token_type_t;
+```
 These are the valid type of distinct token types.
 
 + KEYSYMBOL - a string which is contextless, the surounding text is ignored
@@ -45,36 +53,44 @@ These are the valid type of distinct token types.
 + 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.
 However the regex engine can be overridden:
-
+```C
        // ?!
+```
 
 ---
 
-#hl 
+# hl 
 General purpose highlighter (and demo program for libhl).
 
 ## Usage
 hl will read from stdin and write to stdout.
+```bash
        hl < source/main.c
+```
 
 ### Cli Options
+```bash
        -h          : display help message
        -F <dir>    : syntax file look up directory
        -s <syntax> : specify syntax to load
+```
 
 ### Environment variables
+```bash
        HL_HOME : default directory to load syntax files from
+```
 
 ---
 
@@ -83,12 +99,16 @@ hl can parse a small subset of VimScript: the few instructions related to highli
 All Vim highlighing scripts should be valid hl scripts.
 The instrunctions in particular are:
 
+```vimscript
        sy[ntax] keyword <hl_group> <word>+
        sy[ntax] match   <hl_group> <regex>
        sy[ntax] region  <hl_group> start=<string|match> end=<string|match>
        hi[ghtlight] link <from_group> <to_group>
        hi[ghtlight] def  <group> <display_t>=<data>+
+```
 
 Additionally hl recognizes:
 
+```vimscript
        syn[ntax] keysymbol <char>+
+```