Updated README

Author: AllanLRH

README.md

@@ -2,16 +2,22 @@
 
 Sublime Text 3 plugin - inline python evaluation.
 
+## Functionality
+
+### As a calculator
+
 For example you can write 3.14*0.6 and get the result (1.884) in your text.
 It also supports multiple selection.
 
+### Incremnt counter at cursor positions
+
 Another feature is the use of $ as accumolation variable, e.g. having the following multipe selection:
 
 	arr[$]
 	arr[$]
 	arr[$]
 
-will result with 
+will result with
 
 	arr[1]
 	arr[2]
@@ -23,6 +29,69 @@ similarly:
 	arr[$+2]  -> arr[3]
 	arr[$*3]     arr[6]
 
+### General Python evalueator
+
+Besides that, you have the following imports avaiable:
+
+	from math import *
+	from random import *
+	from collections import Counter
+	import datetime
+	import re  # though you should probably use the build in regex features of ST instead.
+
+So you can do:
+
+	Counter(('Ann', 'Bob', 'Bob', 'Michael')) = Counter({'Bob': 2, 'Ann': 1, 'Michael': 1})
+	Counter(('Ann', 'Bob', 'Bob', 'Michael', 'michael')) = Counter({'Bob': 2, 'Ann': 1, 'michael': 1, 'Michael': 1})
+	Counter(name.title() for name in ('Ann', 'Bob', 'Bob', 'Michael', 'michael')) = Counter({'Bob': 2, 'Michael': 2, 'Ann': 1})
+
+### Computing checksums
+
+And the functions `md5` and `sha1` returns the correspondingly hex-digest of the stringified version of the inputs, e.g. `md5(['foo', 'bar', 'baz']) = dbb432a3f0ac1a2687911715dfbf7502`. Notice that it's possible to hash the list _because it's the string-representation of the list which are being hashed!_
+
+The python `hashlib.md5` and `hashlib.sha1` functions are avaiable under the names `_md5` and `_sha1`.
+
+### Inserting datatimes
+
+The functions `dnow`, `tnow` and `dtnow` return respectively the current string-formatted date, time and datetime:
+
+	dnow() = 03/05/2017
+	tnow() = 09:36:03
+	dtnow() = 03/05/2017 09:36:03
+
+Notice that you need to have parenthesis after the function name to invoke the function call.
+
+### Formatting numbers
+
+The fnuction `formatnum` formats numbers, and takes two mandatory and an optional argument:
+
+num
+:	The number bieng formatted.
+
+digits
+:	The number of desired digits in the formatted number.
+
+scientificNotation
+:	Wether of not to use scientific notation.
+:	Can be True, False or int, where int is the threshold for how many characters the number may contain when formatted un-scientifically, before switching to scientific notation.
+:	This is the default behaviour, and it's set to 8.
+
+Example usage:
+
+	formatnum(0.123456789, 4) = 0.1235
+	formatnum(0.123456789, 9) = 1.234567890e-01
+	formatnum(123456789.0, 9) = 1.234567890e+08
+	formatnum(123456789.0, 2) = 1.23e+08
+	formatnum(123.456789, 12) = 1.234567890000e+02
+	formatnum(123.456789, 12, False) = 123.456789000000
+	formatnum(123.456789, 3) = 123.457
+	formatnum(3.14159, 4) = 3.1416
+	formatnum(3.14159, 3) = 3.142
+	formatnum(3.14159, 2) = 3.14
+	formatnum(3.14159, 2, True) = 3.14e+00
+	formatnum(3.141592653589793238462643383279502884197169399375105820974944, 3) = 3.142
+
+
 ## Usage
 
 To evaluate term, highlight and: