Differences

This shows you the differences between two versions of the page.

--- ease:fallschool_cpo [2020/06/29 12:32] – Short Emacs tutorial/overview v1 cpollok
+++ ease:fallschool_cpo [2020/07/01 13:08] (current) – cpollok
@@ Line 5: / Line 5: @@
 ===== Definitions =====
 An Emacs buffer is the equivalent of window / tab in other editors. It can have a file associated with it that you can (or cannot depending on the privileges) edit, or it can be running a process (e.g. when you open the shell: M-x shell). The minibuffer is usually a one-line part of the screen at the bottom of the Emacs window.
 The cursor in Emacs is called the point. Dired is the directory explorer mode of Emacs. When in the following we talk about "closing" a buffer it's not generally meant as really clsoing it, but only the window for it. The buffer is then still active in the background and can be switched to. To really close a buffer you need to "kill" it.
+===== Window Overview =====
+When first opening Emacs you will be welcomed by this screen:
+{{ :ease:emacs:overview.png?direct&600 |}}
+There are the two tool bars (markers 1 and 2), but we will not be using them much. You can explore them if you want, but everything in them can be done with key bindings as well.
+The main window currently occupies most of the screen (3). At the top of this window there's the prompt and cursor (4). The prompt (CL-USER>) also indicates, that the window's current buffer is the REPL. This can also be seen in the bottom bar just below the window (grey bar at marker 5). There it says "slime-repl sbcl", which is the current buffer's name.
+Just below the window there is another white bar. This is the so-called "mini-buffer", where you can type in commands for various purposes.
@@ Line 19: / Line 30: @@
 Short way of writing Ctrl, Alt and Shift is: **C**, **M** and **S** respectively.\\
 **RET** stands for the Enter or Return key\\
+**TAB** stands for the Tabulator key\\
 If a key is supposed to be pressed together with another key, they're connected with a dash, e.g. **C-h**\\
 **C-h b** means first press Ctrl and h together and then b separately (in contrast to **C-h C-b**)\\
@@ Line 31: / Line 43: @@
   * **M-R**: regex-search in the previously executed commands (can step through with **C-Up** and **C-Down**)
-==== Handling multiple buffers: ====
+==== Handling multiple windows: ====
-  * **C-x 2**: Splits the currently selected buffer horizontally
+  * **C-x 2**: Splits the currently selected window horizontally
-  * **C-x 3**: Splits the currently selected buffer vertically
+  * **C-x 3**: Splits the currently selected window vertically
-  * **C-x 0**: Closes the currently selected buffer (the other buffer in the split is scaled back to it's full size)
+  * **C-x 0**: Closes the currently selected window (the other window in the split is scaled back to it's full size)
-  * **C-x 1**: Close any buffer other than the currently selected
+  * **C-x 1**: Close any window other than the currently selected
+=== Example configurations ===
+Through this feature you can arrange windows arbitrarily in any way you want:
+{{:ease:emacs:overview_3-split.png?direct&400|}}
+{{:ease:emacs:overview_extreme_split.png?direct&400|}}
 ==== Opening files, switching and killing buffers: ====
@@ Line 44: / Line 65: @@
 Note: When changing buffers, you can use **C-Up** and **C-Down** to step through the currently open buffers.
-==== Lisp/(Slime)-specific (while in a .lisp-file-buffer): ====
+==== Lisp/(Slime)-specific (while in a .lisp file buffer): ====
   * **M-.** (**M-,**): Jump in (out) of function definition
   * **C-c M-p**: set the package from the selected lisp file as the package in the REPL
@@ Line 55: / Line 76: @@
   * **M-r** (**M-s**): Regexp search backwards (forward) through history
   * **,** : Opens mini-buffer to use shortcuts (see **,help**), one important example is **,ros-load-system** to load ROS package LISP systems.
+==== In mini-buffer: ====
+  * **C-g**: cancel current command input
+> The following commands all need to be written out and executed by hitting the Return key. Except for TAB, which means hititng the tabulator key for auto-completion.
+  * **ros-load-system**: Then enter the ROS package, hit Return, enter the LISP system, hit return.
+> Example:
+> Press **,** on an empty prompt in the REPL to start a command in the mini-buffer.
+> {{ :ease:emacs:mini_buffer:0.png?nolink |}}
+> Enter **r-l-s TAB** so it tab-completes to ros-load-system.
+> {{ :ease:emacs:mini_buffer:1.png?nolink |}}
+> {{ :ease:emacs:mini_buffer:2.png?nolink |}}
+> Enter **cram-mobile-pick-place-plans** for the ROS package (note the udnerscores). (You can use tab-completion here as well.)
+> {{ :ease:emacs:mini_buffer:3.png?nolink |}}
+> Enter **cram-mobile-pick-place-plans** for the LISP system (note the dashes). You have also just pressed **TAB** to choose the default system (as indicated in the prompt text).
+> {{ :ease:emacs:mini_buffer:4.png?nolink |}}
+> After entering the system, Emacs will load the package and after it has completed loading, it will say so in the mini-buffer as well.
@@ Line 60: / Line 112: @@
-When starting out with using Emacs, it can be useful to have a fixed window configuration to not get overwhelmed with having to constantly open and close new buffer windows. When opening Emacs, use the **C-x 2** command to split the window in two and just leave the bottom one as the REPL and use the top one for viewing files (**C-x f** and **C-x b**).
+When starting out with using Emacs, it can be useful to have a fixed window configuration to not get overwhelmed with having to constantly open and close new buffer windows. When opening Emacs, use the **C-x 2** command to split the window in two and just leave the bottom one as the REPL and use the top one for viewing files (**C-x f** and **C-x b**). Like so:
+{{ :ease:emacs:overview_split_working.png?direct&600 |}}