User Tools

Site Tools


other:emacs_doc

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
other:emacs_doc [2024/02/15 13:49]
jypeter [Windows installation] Improved
other:emacs_doc [2024/02/16 13:23]
jypeter [Windows installation] Improved
Line 63: Line 63:
       * if your Windows terminal does not have //​elevated//​ (i.e. //​administrator//​) permissions,​ a pop-up window will open and ask for confirmation       * if your Windows terminal does not have //​elevated//​ (i.e. //​administrator//​) permissions,​ a pop-up window will open and ask for confirmation
   * 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 [[https://​ftpmirror.gnu.org/​emacs/​|gnu emacs ftp mirror]] +    * Go to [[https://​ftpmirror.gnu.org/​emacs/windows/|gnu emacs for windows ​ftp mirror]] 
-    * Go to the most recent ''​windows/emacs-XX/''​ folder (e.g. ''​windows/emacs-29/''​) +    * Go to the most recent ''​emacs-XX/''​ folder (e.g. ''​emacs-29/'' ​as of February 2024
-    * Download the most recent ''​emacs-XX.YY-installer.exe''​ file (e.g. ''​emacs-29.1_2-installer.exe''​) and execute it+    * 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
  
   * 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 that'​s ​not the case, ask JYP and remind him to finish this section FIXME+    * If the menu shortcuts have **not** been installed:​ 
 +      * 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)   * You can work with the default ''​emacs''​ settings, but it is highly recommended to start with a nice existing emacs configuration file (if available)
Line 86: Line 88:
   * **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 ​and execute ​the //Complete package, except sources installer// (''​diffutils-2.8.7-1.exe''​ as of August 2023) from [[https://​gnuwin32.sourceforge.net/​packages/​diffutils.htm|]] +      * 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 
-      Be sure to uncomment ​the following line in your ''​.emacs''​ configuration file (and restart ​emacs). Otherwise emacs will not be able to find the ''​diffutils''​ binaries it needs for comparing text files +        This will install ​the required binaries and reources ​in ''​C:​\Program Files (x86)\GnuWin32\''​ 
-        * ''(setq exec-path (append exec-path '​("​C:​\\Program Files (x86)\\GnuWin32\\bin"​)))''​ +      * 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 
-    * FIXME Find a recent //compiled for Windows// version of ''​diffutils''​\\ As of July 2023...+        * <​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...
       * [[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 113: Line 118:
 ==== Windows launch ==== ==== Windows launch ====
  
-  * ''​Start''​ => ''​E''​ => ''​Emacs''​+  * ''​Start''​ => ''​E''​ => ''​Emacs-XX.Y''​ => ''​Emacs''​
  
 ==== Mac launch ==== ==== Mac launch ====
Line 198: Line 203:
     * Edit the file (with ''​emacs''​ or another editor) and search //​Microsoft//​ to (un)comment MS Windows specific sections of the configuration file     * Edit the file (with ''​emacs''​ or another editor) and search //​Microsoft//​ to (un)comment MS Windows specific sections of the configuration file
     * (re)start ''​emacs''​ to take this configuration file into account     * (re)start ''​emacs''​ to take this configuration file into account
 +      * If ''​emacs''​ displays the following error message, just create the ''​server''​ directory (''​c:/​Users/​your_login/​AppData/​Roaming/​.emacs.d/​server''​) by hand and restart ''​emacs''​\\ <​code>​Warning (initialization):​ An error occurred while loading ‘c:/​Users/​your_login/​AppData/​Roaming/​.emacs’:​
  
-  ​* Keyboard shortcuts defined by the example configuration file+File is missing: Opening output file, No such file or directory, c:/​Users/​your_login/​AppData/​Roaming/​.emacs.d/​server/​server</​code>​ 
 + 
 +  * **Keyboard shortcuts** defined by the example configuration file
     * ''​C-x C-g'':​ go to a specific line     * ''​C-x C-g'':​ go to a specific line
     * ''​Shift Left_Arrow''​ and ''​Shift Right_Arrow'':​ go to the beginning/​end of a line\\ Same behavior as ''​C-a''​ and ''​C-e'',​ and the ''​Home''​ and ''​End''​ keyboard keys     * ''​Shift Left_Arrow''​ and ''​Shift Right_Arrow'':​ go to the beginning/​end of a line\\ Same behavior as ''​C-a''​ and ''​C-e'',​ and the ''​Home''​ and ''​End''​ keyboard keys
other/emacs_doc.txt · Last modified: 2024/05/08 10:10 by jypeter