adds Vim-Elixir-SmartTrace plugin for trace directly in Vim

Author: Gaspar Chilingarov

.gitmodules

@@ -52,3 +52,6 @@
 [submodule "bundle/indentLine"]
 	path = bundle/indentLine
 	url = https://github.com/Yggdroot/indentLine.git
+[submodule "bundle/vim-elixir-smarttrace"]
+	path = bundle/vim-elixir-smarttrace
+	url = https://github.com/gasparch/vim-elixir-smarttrace.git

CHEATSHEET.md

@@ -102,6 +102,22 @@ shortcuts/commands:
  * `<Leader>tv` opens correlative source/test file in vertical split
  * `<Leader>t!` opens correlative source/test, creates directories if necessary
 
+#### Tracing
+ * `<Leader>te` execute ExUnit test under cursor with tracing and window with
+   trace output
+ * `<Leader>ts` execute selected text with tracing and show trace
+
+ **In trace window**
+ * `<Enter>` opens file with module/function under cursor and changes window
+ * `p` opens file with module/function under cursor and stays in trace window
+ * `%` jumps to matching call/return lines
+ * `;`, `,` jumps back/forward to same function call
+ * `(`, `)` jumps back/forward to next function call/return (skips messages)
+ * `{`, `}` jumps back/forward over repeated function calls
+ * `F3` opens arguments fold; also when cursor is on function call/ret line
+
+ More on [vim-elixir-smarttrace page](https://github.com/gasparch/vim-elixir-smarttrace).
+
 #### Git integration
  * `:Gstatus` - show modified files and staged status
     * `-` (in normal mode) on file name moves between staged/unstaged mode

README.md

@@ -24,9 +24,12 @@ avoid laborious task of finding and tuning of plugins/themes.
   * Compile project from and jump to errors/warnings
   * Run ExUnit tests and jump to errors
   * Run ExUnit tests on source save and just to errors
+ * Tracing
+  * Run trace on selected ExUnit test or text selection
+  * Quickly navigate in trace file
  * Other
   * Colorschemes for Elixir programming
-  * Git integration directly from Vim.
+  * Git integration directly from Vim
   * Viewing of Module/function documentation
   * Restore buffer position on load
   * Clutter free vim-airline settings
@@ -116,6 +119,8 @@ file using [vim-sleuth](https://github.com/tpope/vim-sleuth).
 Tagbar most of the time shows correct arity on functions and does not report
 multiple function clauses.  GenServer callbacks moved to separate group.
 
+ * `F4` will toggle Tagbar window visibility.
+
 ## Compiler and ExUnit integration
 
 Compiler and ExUnit integration provided with vim-elixir-exunit module, which
@@ -209,14 +214,54 @@ Following commands and shortcuts are available:
 
  Use `[e` and `]e` to navigate test errors.
 
-
  **Note**
 
  All `mix test` commands executed with `--seed 0` parameter which forces
  execution from top to down of test file. If you want randomized execution
  sequence to check hidden errors in tests - you will need to run tests
  manually.
 
+## Tracing support
+
+ Erlang runtime has amazing tools to understand what happens in code using trace
+ and profiling. Unfortumately they have just command line interface and
+ sometimes output is hard to understand. Vim-Elixir-IDE aims to boost developer
+ efficiency while using this tools.
+
+#### Running trace
+
+ You can run trace on arbitrary piece of code or existing ExUnit test case. I
+ would recommend running it on ExUnit test, which assures that all aliases,
+ variables are resolved. If you run trace on code selection it should be
+ self-sufficient (it will be copied to separate .exs file).
+
+ So, once again, run ExUnit tests under tracing, not the selection :)
+
+ Tracing support removes some number of redundant messages appearing in trace
+ log file and tries to make output more readable to human eyes and for
+ inspection.
+
+ Also navigating around trace may be difficult, as there is so much information
+ present, so navigation shortcuts are provided for that.
+
+ Available commands: 
+ 
+ * `ErlTraceTest` or `<Leader>te` runs ExUnit test under cursor with tracing
+   enabled and shows resulting trace in separate window.
+ * `ErlTraceSelection` or `<Leader>ts` runs selected test with tracing enabled
+   and shows resulting trace in separate window.
+
+ In tracing window there are shortcuts available:
+
+ * `<Enter>` opens file with module/function under cursor and switches window
+ * `p` opens file with module/function under cursor and stays in trace window
+ * `%` jumps to matching call/return lines
+ * `;`, `,` jumps back/forward to same function call
+ * `(`, `)` jumps back/forward to next function call/return (skips messages)
+ * `{`, `}` jumps back/forward over repeated function calls
+ * `F3` opens arguments fold; also when cursor is on function call/ret line
+
+
 
 
 
@@ -228,3 +273,4 @@ Following commands and shortcuts are available:
 
 
 
+