Differences

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

--- other:emacs_doc [2023/08/30 16:59] – [Windows installation] Added link to .emacs config file jypeter
+++ other:emacs_doc [2023/12/06 17:13] – [Windows installation] Improved a bit, and simplified by removing the "emacs in WSL" option jypeter
@@ Line 51: / Line 51: @@
 ==== Windows installation ====
-=== emacs for Windows ===
-This is the //light and easy// option!
+=== emacs binaries for Windows ===
+<note warning>When installing emacs, you will need an account that can get **//elevated// (i.e. //administrator//) permissions**
+\\ At LSCE, use the ''[[https://wiki.lsce.ipsl.fr/pmip3/doku.php/other:win10config#the_available_accounts|.\admin]]'' account</note>
   * Use [[other:win10apps#installing_applications_with_winget|winget]] to install ''emacs'' for Windows:
     * Just type the folllowing, in a windows ''cmd'', ''PowerShell'' or ''Terminal'' **with //elevated// (i.e. //administrator//) permissions**:\\ ''%%winget install --id GNU.Emacs%%''
-    * Note: if the automated installation with ''winget'' does not work, download the Windows installer from the most recent ''windows/gnu-XX'' directory of a [[https://ftpmirror.gnu.org/emacs/|gnu ftp mirror]]
+  * IF the automated installation with ''winget'' does not work, download the most recent Windows installer from a gnu ftp mirror
+    * Go to [[https://ftpmirror.gnu.org/emacs/|gnu emacs ftp mirror]]
+    * Go to the most recent ''windows/emacs-XX/'' folder (e.g. ''windows/emacs-29/'')
+    * Download the most recent ''emacs-XX.YY-installer.exe'' file (e.g. ''emacs-29.1_2-installer.exe'') and execute it
   * You can work with the default ''emacs'' settings, but it is highly recommended to start with a nice existing emacs configuration file (if available)
     * [[other:emacs_doc#example_configuration_file|Example configuration file]]
+=== Recommended EXTRA binaries for Windows ===
   * **If** you need to **work with remote files**, ''emacs'' can automatically transfer files from your computer and remote servers, if configured properly\\ <wrap hi>**Extremely** useful</wrap>
@@ Line 80: / Line 89: @@
       * The ''2.8.7-1'' Win32 binaries are dated //May 2004//, but **work perfectly fine**!
-  * Extra Windows specific information (optional, read only if you need it): [[https://www.gnu.org/software/emacs/manual/html_mono/efaq-w32.html|GNU Emacs FAQ for MS Windows]]
+=== emacs for Windows technical notes ===
-=== emacs for Linux, inside WSL ===
+<note tip>These notes are only here for finding them easily, but **you probably don't need them**.\\ Just follow exactly the windows related instructions on this page!</note>
-This is the //overkill// option... Useful only if you really need WSL! But you should also install the [[#emacs_for_windows|emacs Windows version]]!
+  * [[https://www.gnu.org/software/emacs/manual/html_mono/emacs.html#Microsoft-Windows|Emacs and Microsoft Windows/MS-DOS]] (//Appendix H// of the //The Emacs Editor manual//)
-  * Install [[other:win10wsl|Windows Subsystem for Linux]]
+  * [[https://www.gnu.org/software/emacs/manual/html_mono/efaq-w32.html|GNU Emacs FAQ for MS Windows]]
-  * Install emacs for Linux (check [[#linux_installation|Linux installation]] above)
+  * Extra Windows specific information (optional, read only if you need it): [[https://www.gnu.org/software/emacs/manual/html_mono/efaq-w32.html|GNU Emacs FAQ for MS Windows]]
 ===== Launching emacs =====
@@ Line 179: / Line 189: @@
 ==== Example configuration file ====
-  * Recommended {{ :other:emacs_jyp_2023-08-11.txt |emacs configuration file}}
+  * Recommended {{ :other:emacs_jyp_2023-09-12.txt |emacs configuration file}}
     * Download this ''emacs_jyp_yyyy-mm-dd.txt'' file to the [[other:emacs_doc#location_of_the_configuration_file|appropriate configuration directory (for your system)]]
     * Rename the file to ''.emacs''
@@ Line 197: / Line 207: @@
       * ''F4'': indent the selected region (if indenting makes sense for the current buffer mode)
       * ''F5'': comment out the selected region (comment style depends on the current buffer mode)
+        * ''M-;'' can be used for commenting **and un-commenting**
       * ''F12'': Repeat complex command (e.g. restart a previous query-replace operation)
@@ Line 255: / Line 266: @@
     * Other official related [[https://www.gnu.org/software/emacs/manual/|GNU Emacs Manuals]]
-===== Upgrading emacs =====
+  * [[https://github.com/rougier#emacs-hacking|Emacs hacking]] by Nicolas Rougier
+===== Updating emacs =====
+==== Linux ====
+==== Mac ====
+==== Windows ====
+Using ''winget upgrade'' for updating emacs on Windows unfortunately [[https://github.com/microsoft/winget-pkgs/issues/88443#issuecomment-1688257680|does not work yet (August 2023)]]. The easiest way to update Emacs is:
-FIXME Add a section about //Upgrading//. Note: [[https://github.com/microsoft/winget-pkgs/issues/88443#issuecomment-1688257680|winget upgrade does not work yet (August 2023)]]
+  * Check the version of the installed Emacs
+    * In the ''Start'' menu: ''Start'' => ''E'' => ''Emacs-**version**'' (e.g. ''Emacs 28.2'')
+    * In a running Emacs: ''Help'' menu => ''About Emacs''
+  * Use ''winget show'' in a PowerShell to determine (all) the available versions
+    * <code>PS C:> winget show --id GNU.Emacs --versions
+Found GNU Emacs [GNU.Emacs]
+Version
+-------
+.1
+.2
+[...]</code>
+  * If you want/need to update Emacs (after making sure it is not running)
+    * Uninstall it with: ''Start'' => ''E'' => ''Emacs-**version**'' => ''Uninstall''\\ Your emacs configuration file and other files you have installed will **not** be removed!
+    * Perform a new [[other:emacs_doc#windows_installation|Emacs for Windows installation]]
 /* standard page footer */