Skip to contentSkip to conversation

Update emacs indentation instructions.

PATCH In review David Brown 2 participants 3 messages Jan 19, 2008 – Jan 20, 2008 Documentation

lore
Share & tools
lore
#0 lore raw

PATCH 1/1 Update emacs indentation instructions.

For quite some time now, Emacs has supported multiple coding styles, including one very close to the Linux style. Update the Emacs configuration instructions in the documentation to reflect this.

---
 Documentation/CodingStyle |   39 ++++++++++++++++++---------------------
 1 files changed, 18 insertions(+), 21 deletions(-)
Documentation/CodingStyle +18 -21
index b49b92e..4511b99 100644
@@ -456,27 +456,24 @@ uses are less than desirable (in fact, they are worse than random
 typing - an infinite number of monkeys typing into GNU emacs would never
 make a good program).
 
-So, you can either get rid of GNU emacs, or change it to use saner
-values.  To do the latter, you can stick the following in your .emacs file:
-
-(defun linux-c-mode ()
-  "C mode with adjusted defaults for use with the Linux kernel."
-  (interactive)
-  (c-mode)
-  (c-set-style "K&R")
-  (setq tab-width 8)
-  (setq indent-tabs-mode t)
-  (setq c-basic-offset 8))
-
-This will define the M-x linux-c-mode command.  When hacking on a
-module, if you put the string -*- linux-c -*- somewhere on the first
-two lines, this mode will be automatically invoked. Also, you may want
-to add
-
-(setq auto-mode-alist (cons '("/usr/src/linux.*/.*\\.[ch]$" . linux-c-mode)
-			auto-mode-alist))
-
-to your .emacs file if you want to have linux-c-mode switched on
+Fortunately, modern versions of GNU emacs support different indentation
+styles.  If you want to use the Linux kernel style for all C code, place
+the following in your .emacs file:
+
+(setq c-default-style "linux")
+
+If you only want to use Linux indenting on Linux source files, you can
+insert something like the following:
+
+(defun my-c-mode-hook ()
+  (c-set-style
+   (if (and (buffer-file-name)
+            (string-match "/usr/src/linux" (buffer-file-name)))
+       "linux"
+     "free-group-style")))
+(add-hook 'c-mode-hook 'my-c-mode-hook)
+
+to your .emacs file if you want to have linux style switched on
 automagically when you edit source files under /usr/src/linux.
 
 But even if you fail in getting emacs to do sane formatting, not
Signature · 1 line
1.5.3.8
#1 lore raw

Hi,

Documentation/CodingStyle uses are less than desirable (in fact, they are worse than random · line 463

Quoted 5 lines · David Brown
Documentation/CodingStyle +5 -0
+Fortunately, modern versions of GNU emacs support different indentation
+styles.  If you want to use the Linux kernel style for all C code, place
+the following in your .emacs file:
+
+(setq c-default-style "linux")

This variable is not defined when emacs starts up. Best is to always use a hook.

So I'd suggest either

	(add-hook 'c-mode-hook (lambda () (c-set-style "linux")))

or for the conditional case

	(add-hook 'c-mode-hook
                  (lambda ()
                    (c-set-style
                      (or (and (string-match "/usr/src/linux"
                                             (or (buffer-file-name) ""))
                               "linux")
                          "free-group-style"))))

Perhaps the logic could be a bit more readable :-)

Other than that, good idea to finally remove this ugly recommendation!

Hannes

#2 lore raw
Quoted 4 lines · Johannes Weiner
Quoted 1 line

+(setq c-default-style "linux")

This variable is not defined when emacs starts up. Best is to always use a hook.

Both of these examples are directly copied out of the emacs manual.

Setting a variable before a module is loaded will override the default set in the module. No need to use a hook for something simple like this.

c-default-style is defined with 'defcustom':

Declare SYMBOL as a customizable variable that defaults to VALUE. DOC is the variable documentation.

Neither SYMBOL nor VALUE need to be quoted.
If SYMBOL is not already bound, initialize it to VALUE.

so the intent is to allow the user to override the value by setting it before the module is loaded.

Dave