This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
other:emacs_doc [2024/05/07 13:21] jypeter [Example configuration file] Improved |
other:emacs_doc [2024/07/30 15:03] (current) jypeter [Windows installation] Updated some dates |
||
---|---|---|---|
Line 69: | Line 69: | ||
* IF the automated installation with ''winget'' does not work, download the most recent Windows installer from a 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 a [[https://ftpmirror.gnu.org/emacs/windows/|gnu emacs for windows 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 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: | * 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]]) | * 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) | * 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]] | * [[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 === | === 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> | * **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]] | * 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\'' | * 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) | * <code>(when (eq window-system 'w32) | ||
(setq exec-path (append exec-path '("C:\\Program Files (x86)\\GnuWin32\\bin"))) | (setq exec-path (append exec-path '("C:\\Program Files (x86)\\GnuWin32\\bin"))) | ||
)</code> | )</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) | * [[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**! | * The ''2.8.7-1'' Win32 binaries are dated //May 2004//, but **work perfectly fine**! | ||
Line 204: | Line 206: | ||
==== Example configuration file ==== | ==== 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)]] | * 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'' | * Copy the ''emacs_jyp_yyyy-mm-dd.txt'' file to ''.emacs'' | ||
Line 213: | Line 215: | ||
File is missing: Opening output file, No such file or directory, c:/Users/your_login/AppData/Roaming/.emacs.d/server/server</code> | 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. | ||
+ | * Changing the default font: | ||
+ | * ''Options''=>''Set Default Font...'' | ||
+ | * Select a font and size | ||
+ | * Linux: ''DejaVu Sans Mono'', size 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'' | ||
* **Keyboard shortcuts** defined by the example configuration file | * **Keyboard shortcuts** defined by the example configuration file | ||
Line 297: | Line 309: | ||
==== Windows ==== | ==== 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: | + | 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'' | * In a running Emacs: ''Help'' menu => ''About Emacs'' | ||
* Use ''winget show'' in a PowerShell to determine (all) the available versions | * Use ''winget show'' in a PowerShell to determine (all) the available versions | ||
Line 307: | Line 319: | ||
Version | Version | ||
------- | ------- | ||
- | 29.1 | + | 29.4 |
- | 28.2 | + | 29.3 |
+ | 29.2 | ||
[...]</code> | [...]</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]] | * Perform a new [[other:emacs_doc#windows_installation|Emacs for Windows installation]] | ||