This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision Next revision Both sides next revision | ||
other:emacs_doc [2023/08/30 15:21] jypeter [Upgrading emacs] Added a Windows section |
other:emacs_doc [2023/12/06 16:13] jypeter [Windows installation] Improved a bit, and simplified by removing the "emacs in WSL" option |
||
---|---|---|---|
Line 51: | Line 51: | ||
==== Windows installation ==== | ==== 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: | * 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%%'' | * 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) | * 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]] | ||
+ | |||
+ | === 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> | * **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**! | * 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 ===== | ===== Launching emacs ===== | ||
Line 179: | Line 189: | ||
==== Example configuration file ==== | ==== 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)]] | * 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'' | * Rename the file to ''.emacs'' | ||
Line 197: | Line 207: | ||
* ''F4'': indent the selected region (if indenting makes sense for the current buffer mode) | * ''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) | * ''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) | * ''F12'': Repeat complex command (e.g. restart a previous query-replace operation) | ||
Line 254: | Line 265: | ||
* [[https://www.gnu.org/software/emacs/manual/html_node/emacs/|The Emacs Editor]] (the official manual) | * [[https://www.gnu.org/software/emacs/manual/html_node/emacs/|The Emacs Editor]] (the official manual) | ||
* Other official related [[https://www.gnu.org/software/emacs/manual/|GNU Emacs Manuals]] | * Other official related [[https://www.gnu.org/software/emacs/manual/|GNU Emacs Manuals]] | ||
+ | |||
+ | * [[https://github.com/rougier#emacs-hacking|Emacs hacking]] by Nicolas Rougier | ||
===== Updating emacs ===== | ===== Updating emacs ===== |