Differences

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

--- other:emacs_doc [2024/05/07 16:00] – [Example configuration file] Added section about fonts jypeter
+++ other:emacs_doc [2025/03/17 10:32] (current) – [Windows] Added note about upgrade possibly working with emacs>=30.1 jypeter
@@ Line 69: / Line 69: @@
   * IF the automated installation with ''winget'' does not work, download the most recent Windows installer from a gnu //ftp// mirror
     * Go to a [[https://ftpmirror.gnu.org/emacs/windows/|gnu emacs for windows ftp mirror]]
-    * Go to the most recent ''emacs-XX/'' folder (e.g. ''emacs-29/'' as of February 2024)
+    * Go to the most recent ''emacs-XX/'' folder (e.g. ''emacs-29/'' as of August 2024)
-    * Download the most recent ''emacs-XX.YY-installer.exe'' file (e.g. ''emacs-29.2_1-installer.exe'' as of February 2024) and execute it
+    * Download the most recent ''emacs-XX.YY-installer.exe'' file (e.g. ''emacs-29.4-installer.exe'' as of August 2024) and execute it
   * If everything went well, you should have a new ''Start''=>''Emacs-XX'' menu that you can use to start ''emacs''
     * If the menu shortcuts have **not** been installed:
-      * Go to the emacs binaries directory: ''C:\\Program Files\\Emacs\\emacs-XX.YY\\bin''
+      * Go to the emacs binaries directory: ''C:\Program Files\Emacs\emacs-XX.YY\bin''
       * Click on the ''addpm.exe'' program to (re-)run the program that will create the shortcuts ([[https://www.gnu.org/software/emacs/manual/html_node/efaq-w32/Installing-binaries.html|official page]])
   * 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]]
+  * Note: Emacs is installed in the ''C:\Program Files\Emacs\emacs-XX.YY\bin'' directory
 === Recommended EXTRA binaries for Windows ===
@@ Line 93: / Line 95: @@
   * **If** you need to use the **emacs //ediff// mode to compare text files**\\ <wrap hi>Very useful</wrap>
     * Install the Windows version of [[https://www.gnu.org/software/diffutils/diffutils.html|Gnu diffutils]]
-      * Download the //Complete package, except sources installer// (''diffutils-2.8.7-1.exe'' as of February 2024) from [[https://gnuwin32.sourceforge.net/packages/diffutils.htm|]] and execute the installer
+      * Download the //Complete package, except sources// ''Setup'' installer (''diffutils-2.8.7-1.exe'' as of August 2024) from [[https://gnuwin32.sourceforge.net/packages/diffutils.htm|]] and execute the installer
         * This will install the required binaries and reources in ''C:\Program Files (x86)\GnuWin32\''
-      * If you use the recommended ''.emacs'' configuration file, it should already have a section telling emacs where to find the ''diffutils'' binaries it needs for comparing text files
+      * If you use the recommended ''.emacs'' configuration file, it should already include the following section telling ''emacs'' where to find the ''diffutils'' binaries it needs for comparing text files
         * <code>(when (eq window-system 'w32)
   (setq exec-path (append exec-path '("C:\\Program Files (x86)\\GnuWin32\\bin")))
   )</code>
-    * FIXME Check if there is a recent //compiled for Windows// version of ''diffutils''\\ As of February 2024...
+    * FIXME Check if there is a recent //compiled for Windows// version of ''diffutils''\\ As of August 2024...
       * [[https://savannah.gnu.org/news/?id=10368|diffutils-3.10]] is available (released in May 2023)
       * The ''2.8.7-1'' Win32 binaries are dated //May 2004//, but **work perfectly fine**!
@@ Line 204: / Line 206: @@
 ==== Example configuration file ====
-  * Recommended {{ :other:emacs_jyp_2023-09-12.txt |emacs configuration file}}
+  * Recommended {{ :other:emacs_jyp_2024-05-07.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)]]
     * Copy the ''emacs_jyp_yyyy-mm-dd.txt'' file to ''.emacs''
@@ Line 214: / Line 216: @@
 File is missing: Opening output file, No such file or directory, c:/Users/your_login/AppData/Roaming/.emacs.d/server/server</code>
     * You may want to **change the default font** defined in the recommended configuration file, depending on the fonts available on the computer/server where ''emacs'' is running, the size of your screen, etc...
-      * The recommended configuration file will probably use the ''Consolas'' or ''Cascadia Code'' fonts, with size ''12'', available on Windows. Note: the ''Cascadia Code'' font is only available if you have installed [[other:win10apps#windows_terminal|Windows Terminal]]
+      * The recommended configuration file will probably use the ''Consolas'' or ''Cascadia Code'' fonts, with size ''12'', available on Windows.
       * Changing the default font:
         * ''Options''=>''Set Default Font...''
         * Select a font and size
           * Linux: ''DejaVu Sans Mono'', size 12
-          * Windows: ''Consolas'' or ''Cascadia Code'', size 10 or 12
+          * Windows: ''Consolas''+''Normal'' size ''12'' or ''Cascadia Code''+''Regular'' size ''10''
+            * Note: the ''Cascadia Code'' font is only available after installing [[other:win10apps#windows_terminal|Windows Terminal]]
           * Mac: FIXME
         * ''Options''=>''Save Options''
@@ Line 306: / Line 309: @@
 ==== 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:
+<note tip>''winget list'' returns a result, **after installing ''Emacs 30.1''**, so it is possible that ''winget upgrade'' will work, at last! :-)
+<code>> winget list --id GNU.Emacs
+Nom            ID        Version Disponible Source
+--------------------------------------------------
+GNU Emacs 30.1 GNU.Emacs Unknown 30.1       winget</code></note>
+Using ''winget upgrade'' for updating emacs on Windows unfortunately [[https://github.com/microsoft/winget-pkgs/issues/88443#issuecomment-1688257680|does not work yet (August 2024)]]. The easiest way to update Emacs is:
-  * Check the version of the installed Emacs
+  * Check the version of the **installed** Emacs
-    * In the ''Start'' menu: ''Start'' => ''E'' => ''Emacs-**version**'' (e.g. ''Emacs 28.2'')
+    * In the ''Start'' menu: ''Start'' => ''E'' => ''Emacs-**version**'' (e.g. ''Emacs 29.3'')
     * In a running Emacs: ''Help'' menu => ''About Emacs''
+      * or ''M-x version''
   * Use ''winget show'' in a PowerShell to determine (all) the available versions
     * <code>PS C:> winget show --id GNU.Emacs --versions
@@ Line 316: / Line 327: @@
 Version
 -------
-.1
+.4
-.2
+.3
+.2
 [...]</code>
-  * If you want/need to update Emacs (after making sure it is not running)
+  * If you want/need to update Emacs
-    * Uninstall it with: ''Start'' => ''E'' => ''Emacs-**version**'' => ''Uninstall''\\ Your emacs configuration file and other files you have installed will **not** be removed!
+    * Make sure Emacs 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!
+      * This will remove the ''C:\Program Files\Emacs'' directory and its content
+      * Slight //bug//: this will **not** remove the shortcuts from the ''Start'' menu
+        * e.g. If you uninstalled emacs 29.3 and installed emacs 29.4, you will end up with the following ''Start'' Menu:{{ :other:emacs_in_start_menu.jpg?direct&200 |}}
+        * Just go to the ''C:\Users\your_login\AppData\Roaming\Microsoft\Windows\Start Menu\Programs'' directory and remove the **old** menu/directory (e.g. ''Emacs-29.3'')
     * Perform a new [[other:emacs_doc#windows_installation|Emacs for Windows installation]]