Add a function for smart completion and alignment.

The idea is to bind this function to the <tab> key. Then, both
autocompletion and alignment may be performed in Insert mode using the
<tab> key (super-fast!). See the doc for the details.

Author: Lifepillar

autoload/ledger.vim

@@ -486,6 +486,18 @@ function! s:ledger_cmd(file, args)
 endf
 " }}}
 
+function! ledger#autocomplete_and_align()
+  if pumvisible()
+    return "\<c-n>"
+    " See http://stackoverflow.com/questions/23323747/vim-vimscript-get-exact-character-under-the-cursor
+  elseif matchstr(getline('.'), '\%' . (col('.')-1) . 'c.') =~ '\d'
+    norm h
+    call ledger#align_amount_at_cursor()
+    return "\<c-o>A"
+  endif
+  return "\<c-x>\<c-o>"
+endf
+
 " Use current line as input to ledger entry and replace with output. If there
 " are errors, they are echoed instead.
 func! ledger#entry()

doc/ledger.txt

@@ -77,12 +77,9 @@ Tips and useful commands
   The decimal separator can be set using `g:ledger_decimal_sep`. The default
   value of `g:ledger_decimal_sep` is `'.'`.
 
-  It is convenient to remap the command, for example to `<Leader>a`:
+  See below for the recommended mappings.
 
-        au FileType ledger vnoremap <silent><buffer> <Leader>a \
-        :LedgerAlign<CR>
-
-* :call ledger#align_amount_at_cursor()
+* `:call ledger#align_amount_at_cursor()`
 
   aligns the amount under the cursor and append/prepend the default currency.
   The default currency can be set using `g:ledger_default_commodity`. Whether
@@ -91,13 +88,23 @@ Tips and useful commands
   value is 1). A separator between the commodity and the amount may be set
   using `g:ledger_commodity_sep`.
 
-  It is convenient to define a mapping like the following:
+  See below for the recommended mappings.
+
+* `:call ledger#autocomplete_and_align()`
+
+  when the cursor is on a number or immediately after it, invokes
+  `ledger#align_amount_at_cursor()` to align it and add the default currency;
+  otherwise, performs autocompletion. If you define the following mappings
+  then you may perform both autocompletion and alignment using the <Tab> key:
 
-        au FileType ledger inoremap <silent><buffer> <C-l> \
-        <Esc>:call ledger#align_amount_at_cursor()<CR>
+        au FileType ledger inoremap <silent> <Tab> \
+        <C-r>=ledger#autocomplete_and_align()<CR>
+        au FileType ledger vnoremap <silent> <Tab> :LedgerAlign<CR>
 
-  Now, you may type `123.45<C-l>`, and have `$123.45` properly aligned (assuming
-  your default commodity is set to `'$'`).
+  Now, you may type `asset:check<Tab><Space>123.45<Tab>`, and have the
+  account name autocompleted and `$123.45` properly aligned (assuming your
+  default commodity is set to `'$'`). Or you may press <Tab> in Visual mode
+  to align a number of transactions at once.
 
 * `:call ledger#entry()`