From 650c112c0f0ac3b8d103ac45a0595c36a4ad4135 Mon Sep 17 00:00:00 2001 From: Gracjan Polak Date: Wed, 6 Apr 2016 17:35:47 +0200 Subject: [PATCH] Document indent-region as a no-op --- doc/haskell-mode.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/doc/haskell-mode.texi b/doc/haskell-mode.texi index 48139351a..8b8c7b06b 100644 --- a/doc/haskell-mode.texi +++ b/doc/haskell-mode.texi @@ -511,6 +511,26 @@ selection mode (without redefining @kbd{C-x},@kbd{C-c},@kbd{C-v}, and @kbd{C-z}) by calling @kbd{M-x cua-selection-mode} (or adding @code{(cua-selection-mode nil)} to your @code{haskell-mode-hook}). +@section Region indent is a no-op + +There is a @code{indent-region} function that supposedly could be used +to indent code region without changing its semantics. Sadly it does not +work that way because usual use case for @code{indent-region} is: + +@enumerate +@item +Alter first line of code in region. +@item +Call @code{indent-region} to fix indentation for remaining lines. +@end enumerate + +Note that between 1 and 2 program is already semantically broken and +knowing how to indent it preserving semantic from before step 1 would +require time travel. + +To stay on the safe side @code{indent-region-function} is bound to a +no-op in @code{haskell-mode}. + @node External indentation @chapter Other ways to indent code