other:emacs_doc
Differences
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 14:00] jypeter [Example configuration file] Added section about fonts |
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 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> | 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... | * 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: | * Changing the default font: | ||
| * ''Options''=>''Set Default Font...'' | * ''Options''=>''Set Default Font...'' | ||
| * Select a font and size | * Select a font and size | ||
| * Linux: ''DejaVu Sans Mono'', size 12 | * 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 | * Mac: FIXME | ||
| * ''Options''=>''Save Options'' | * ''Options''=>''Save Options'' | ||
| Line 306: | 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 316: | 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]] | ||
other/emacs_doc.1715090430.txt.gz · Last modified: 2024/05/07 14:00 by jypeter
