clarified creating a charfile

[charsel.git] / README.md

diff --git a/README.md b/README.md
index 6ce415bf63f59fe0629b3a6bc02ff2a4f07f753b..b0f81dc084a4906e3fd7938da9b8bf8e31001f15 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,22 +1,37 @@
-# charsel
-A very simple comand line tool to make a shortcut to a special characther. 
+# CHARSEL
+A simple bash script to make copying frequently used special characters to your clipboard easy.
 
-It takes the input of a charfile, then puts it into a table and waits for your input. Once you put in your shortcut key, it prints the special character then copies it to the clipboard.
+It uses a plain-text file known as a "charfile" to define easy to reach shortcuts to special characters
 
-A charfile is just two columns with the shortcut on the left, then a separator, then the special charachter to be copied.
+## Installation
+- Run `make install` as root to install
+- Run `make uninstall` as root to remove. Will not delete your personal charfiles
+- Run `make purge` to remove charsel files from your home directory
+- Run `make install-completions` to install the shell completions
 
-## INSTALLATION
-Run the INSTALL.sh script
-If run as root, it will be installed globally, if run without root, it will be just instaled for the local user
+## Dependencies
+  * Bash
+  * Linux
+  * Xclip (using the -n flag bypasses this)
+  * A terminal with UTF-8 encoding enabled (most desktop environment's default terminal will be fine)
 
-## DEPENDENCIES
-posix shell
-util-linux
-xclip
+## Usage
+For argument usage, use `charsel -h`
 
-## USAGE
-charsel <charfile>
+Once you have started the program, simply type the shortcut listed on the left side of the table to copy the character on the right side of the table to your clipboard. Shortcodes the same length as the longest one will automatically be entered. To quit, type ';' as a shortcode
 
-## CREATING A CHARFILE
-Make a new file in ~/.local/share/charsel/ with the name that you want to use to call the file in the command
-Fill it in, using the provided example as a template.
+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 `~/.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. ";" cannot be used as a shortcode, as that is used to quit the program
+
+## License
+Charfile is GNU GPLv3 licensed, see COPYING for more information
+
+Charfile is written by [Armaan Bhojwani](https://armaan.bhojwani.org), [Email](mailto:3fb650a9-b47e-4604-a282-1dd91953b2ee@anonaddy.me)