DWIM(.nl) - Emacs? Help!


Do What I Mean

February 15th, 2020

Emacs? Help!

A powerful tool like Emacs can be intimidating for beginners. But actually, Emacs is very beginner-friendly, because it comes standard with a plethora of help features. In this post, I'll give some starting points, and show what help functions I use the most.

First, just start up a vanilla Emacs (use emacs -q to bypass any user configuration files, if necessary) and the startup screen provides you with some helpful entry points, like the Emacs manual and guided tour. Of course, you can find the same information, and much more, under the Help menu item.

The manual that you can open from the startup screen teaches you some Emacs jargon, like how key bindings are defined. It provides an interactive introduction with exercises you can perform in the same buffer. It teaches you the Emacs-way to do things like navigate a document. To my taste its a bit dogmatic about that: I prefer arrow keys and PgUp/Dn to navigate, but the tutorial sticks to C-v/M-v and the likes.

The startup screen also contains a link to the Emacs manual, which introduces us to the wonderful world of Info. We'll come back to that later, when we discuss the C-h key. For now, let's assume that Info is like the web: hypertext with links. So, open the manual and have a look around. What I like to do every now and then, is page though the documents by just pressing the space bar repeatedly. This is like leafing through a book and never fails to uncover gems I didn't know yet.

Section 1 "The Organization of the Screen" introduces much Emacs jargon that may put off beginners. This section explains words like frame, window, buffer, point, mode line and mini buffer, all essential to be able to use all other information that is available to us.

Then, when you actually start to use Emacs, the menu bar provides access to most common commands, including the key bindings that go with them for commands you find you need most often. Please resist the urge to install all those shiny third-party packages for now, and first dig through all the features that Emacs ships with out of the box, like searching, bookmarks, email and version control. Also have a look at all you can customize through the Options menu. But again, please stick with the defaults at first. They have been selected based on years of experience, and more often than not make more sense that you might think at first (promise!).

Finally, I you ever wonder How do I do X? C-h is your friend:

  • C-h ? shows all help command, including the ones I use most:
  • C-h a (apropos) show commands matching a pattern
  • C-h k describes a key
  • C-h f describes a function (by default the function under point) and the keys associated with it
  • C-h v describes a variable, its current value, its original value, and its possible values
  • C-h m describes all currently active modes
  • C-h i starts Info, which opens a whole library full of manuals, I don't believe you I will ever finish in this lifetime

Have fun exploring Emacs!

tags: emacs

 Work vs problems 
 Emacs: Is it worth it? 
Loading script...