]> code.delx.au - gnu-emacs-elpa/blobdiff - README.md
Update email and GH username.
[gnu-emacs-elpa] / README.md
index 82abcb0bf3e202fdfe34dceca1e3419b8bfdf458..8abb380823aaf773cf3bc6d54b415350910cb3d3 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 aggressive-indent-mode
 ======================
+(_[Wanna say thank you?](https://gratipay.com/Malabarba/)_)
 
 `electric-indent-mode` is enough to keep your code nicely aligned when
 all you do is type. However, once you start shifting blocks around,
@@ -15,8 +16,8 @@ than `electric-indent-mode`.
 - An example of Lisp mode (Emacs Lisp):
 ![Lisp Code Example](lisp-example.gif)
 
-- An example of non-Lisp mode (C++):
-![Cpp Code Example](cpp-example.gif)
+- An example of non-Lisp mode (C):
+![C Code Example](c-example.gif)
 
 ### Instructions ###
 
@@ -36,7 +37,7 @@ every programming mode, you can do something like:
     (global-aggressive-indent-mode 1)
     (add-to-list 'aggressive-indent-excluded-modes 'html-mode)
 
-### Manual Installation ###
+#### Manual Installation ####
 
 If you don't want to install from Melpa, you can download it manually,
 place it in your `load-path` along with its two dependencies:
@@ -47,3 +48,17 @@ place it in your `load-path` along with its two dependencies:
 Then require it with:
 
     (require 'aggressive-indent)
+
+### Customization ###
+
+The variable `aggressive-indent-dont-indent-if` lets you customize
+when you **don't** want indentation to happen.
+For instance, if you think it's annoying that lines jump around in
+`c++-mode` because you haven't typed the `;` yet, you could add the
+following clause:
+
+    (add-to-list
+     'aggressive-indent-dont-indent-if
+     '(and (derived-mode-p 'c++-mode)
+           (null (string-match "\\([;{}]\\|\\b\\(if\\|for\\|while\\)\\b\\)"
+                               (thing-at-point 'line)))))