## Installation
- Run `make install` as root to install
- Run `make uninstall` as root to remove. Will not delete your personal charfiles
-- Run `make purge` as a normal user to remove charsel files from your home directory
+- Run `make purge` to remove charsel files from your home directory
+- Run `make install-completions` to install the shell completions
## Dependencies
* Bash
* Linux
- * Xclip
- * A terminal with UTF-8 encoding enabled
+ * Xclip (using the -n flag bypasses this)
+ * A terminal with UTF-8 encoding enabled (most desktop environment's default terminal will be fine)
## Usage
For argument usage, use `charsel -h`
Some of the default charfiles have hidden shortcuts for capital letters that are not shown on the table. Simply type a capital version of the shortcut key to access the capital version of the special character.
## Creating a charfile
-Make a new file in the `~/.local/share/charsel/charfiles/` or `/usr/share/charsel/charfiles/` directories with the name that you would like to use to call the charfile in the command.
-
-Fill it in, using the provided examples as a template. Hidden shortcuts go above the '-', lines can be commented out using a '#' at the start of the line. ';' cannot be used as a shortcode, as that is used to quit the program
+Make a new file in `~/.local/share/charsel/charfiles/` or `/usr/share/charsel/charfiles/` with the name that you would like to use to call the charfile in the command.
+
+Fill in your shortcodes, using the provided examples in `/usr/share/charsel/charfiles` as a template. There are just 4 rules to follow.
+ 1. The pattern is "shortcode,output"
+ 2. Hidden shortcuts go above the line with "---"
+ 3. Lines can be commented out using a "#" at the start
+ 4. ";" (semicolon) cannot be used as a shortcode, as that is used to quit the program
+ 5. Shortcodes cannot start with - as that confuses grep
## License
Charfile is GNU GPLv3 licensed, see COPYING for more information