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
other:emacs_doc [2024/02/15 13:51]
jypeter [Windows launch]
other:emacs_doc [2024/02/16 13:23] (current)
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 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.1708005072.txt.gz · Last modified: 2024/02/15 13:51 by jypeter