Update readme.md

Author: timhall

readme.md

@@ -1,30 +1,41 @@
-# VBA-UTC
+# VBA-Log
 
-UTC and ISO 8601 date conversion and parsing for VBA (Windows and Mac Excel, Access, and other Office applications).
+Logging helpers for VBA. Logs to Immediate Window by default (`ctrl + g`), but can attach multiple loggers with callbacks.
 
 Tested in Windows Excel 2013 32-bit and 64-bit and Excel for Mac 2011, but should apply to Windows Excel 2007+.
 
 # Example
 
 ```VB.net
-' Timezone: EST (UTC-5:00), DST: True (+1:00) -> UTC-4:00
-Dim LocalDate As Date
-Dim UtcDate As Date
-Dim Iso As String
+Logger.LogDebug "Howdy!"
+' -> does nothing because logging is disabled by default
 
-LocalDate = DateValue("Jan. 2, 2003") + TimeValue("4:05:06 PM")
-UtcDate = UtcConverter.ConvertToUtc(LocalDate)
+Logger.LogEnabled = True
+' -> Log all levels (Trace, Debug, Info, Warn, Error)
 
-Debug.Print VBA.Format$(UtcDate, "yyyy-mm-ddTHH:mm:ss.000Z")
-' -> "2003-01-02T20:05:06.000Z"
+Logger.LogThreshold = 3
+' -> Log levels >= 3 (Info, Warn, and Error)
 
-Iso = UtcConverter.ConvertToIso(LocalDate)
-Debug.Print Iso
-' -> "2003-01-02T20:05:06.000Z"
+Logger.LogTrace "Start of logging"
+Logger.LogDebug "Logging has started"
+Logger.LogInfo "Logged with VBA-Log"
+Logger.LogWarn "Watch out!", "ModuleName.SubName"
+Logger.LogError "Something went wrong", "ClassName.FunctionName", Err.Number
 
-LocalDate = UtcConverter.ParseUtc(UtcDate)
-LocalDate = UtcConverter.ParseIso(Iso)
+' Attach alternative logging function(s)
+Public Sub LogFile(Level As Long, Message As String, From As String)
+  ' ...
+End Sub
 
-Debug.Print VBA.Format$(LocalDate, "m/d/yyyy h:mm:ss AM/PM")
-' -> "1/2/2003 4:05:06 PM"
+' Log to single function
+Logger.LogCallback = "LogFile"
+
+Public Sub LogWorkbook(Level As Long, Message As String, From As String)
+  ' ...
+End Sub
+
+' Log to multiple functions
+Logger.LogCallback = Array("LogFile", "LogWorkbook")
 ```
+
+For applications that don't support `Application.Run` (e.g. Access), there is a note in `Logger.Log` for where to put your custom logging function (if desired).