differences for PR #25

index.md

@@ -2,7 +2,7 @@
 site: sandpaper::sandpaper_site
 ---
 
-This is a new lesson built with [The Carpentries Workbench][workbench]. It is currently in pre-alpha development by the [Edinburgh Parallel Computing Centre][epcc-link], the [National Oceanography Centre][noc-link], and the [UK Met Office][uk-met-link].
+This is a new lesson built with [The Carpentries Workbench][workbench]. It is currently in pre-alpha development by the [Edinburgh Parallel Computing Centre][epcc-link], the [National Centre for Atmospheric Science][ncas-link], the [National Oceanography Centre][noc-link], and the [UK Met Office][uk-met-link].
 
 This course is aimed at users and developers who know how to program,
 but have little or no experience in Fortran, and those who may wish to

links.md

@@ -11,7 +11,11 @@ any links that you are not going to use.
 [contact]: mailto:[email protected]
 
 [epcc-link]: https://www.epcc.ed.ac.uk/
+[ncas-link]: https://ncas.ac.uk/
 [noc-link]: https://noc.ac.uk/
 [uk-met-link]: https://www.metoffice.gov.uk/
 
 [install-gfortran]: https://fortran-lang.org/learn/os_setup/install_gfortran/
+
+[emacs-link]: https://www.gnu.org/software/emacs/
+[emacs-init-link]: https://www.gnu.org/software/emacs/manual/html_node/emacs/Init-File.html

md5sum.txt

@@ -2,11 +2,11 @@
 "CODE_OF_CONDUCT.md" "c93c83c630db2fe2462240bf72552548" "site/built/CODE_OF_CONDUCT.md" "2024-10-07"
 "LICENSE.md" "b24ebbb41b14ca25cf6b8216dda83e5f" "site/built/LICENSE.md" "2024-10-07"
 "config.yaml" "d2267d8f4b7506c689db7eb30c1cfc22" "site/built/config.yaml" "2024-10-07"
-"index.md" "3805e770257efa14dc17eee63ec45500" "site/built/index.md" "2024-10-07"
-"links.md" "e0a8f306dd2dfa5adfc27965f32441a3" "site/built/links.md" "2024-10-07"
+"index.md" "460111f6ab60c07fef2cb1b2e5569475" "site/built/index.md" "2024-10-09"
+"links.md" "3310192ccfeabb362f34db338a2abfee" "site/built/links.md" "2024-10-09"
 "episodes/introduction.Rmd" "82188ceeb809ba0eeb51ec3918a65b95" "site/built/introduction.md" "2024-10-07"
 "instructors/instructor-notes.md" "5cf113fd22defb29d17b64597f3c9bc0" "site/built/instructor-notes.md" "2024-10-07"
 "learners/reference.md" "527a12e217602daae51c5fd9ef8958df" "site/built/reference.md" "2024-10-07"
-"learners/setup.md" "1969cff95cff6288fe45afa8f6a1dfe8" "site/built/setup.md" "2024-10-07"
+"learners/setup.md" "f97b0c03acde4422eeaf05d6dd6f60b1" "site/built/setup.md" "2024-10-09"
 "profiles/learner-profiles.md" "5fe5bf7537072422b91ed393ada03f9a" "site/built/learner-profiles.md" "2024-10-07"
 "renv/profiles/lesson-requirements/renv.lock" "e3647f7536c823a256ab0c3fa64db72f" "site/built/renv.lock" "2024-10-07"

setup.md

@@ -42,5 +42,33 @@ If you are not taking this course on archer2 we recommend installing the [GFortr
 
 :::::::::::::::::::::::::
 
+## Text Editors and Integrated Development Environments (IDEs)
 
+While Fortran files are plain text can could be edited with any plain text editor, it is recommened that you use an editor that is capable of _syntax highlighting_. There are a number of these available.
 
+### Emacs
+
+[Emacs][emacs-link] is a cross-platform text editor available for Linux, MacOS, and Windows. It will contain syntax highlighting for many Fortran file, but additional file extensions, such as `.X90`  may be valid Fortran files but will not be picked up in Emacs _f90-mode_. This mode allows for tab-completion of Fortran statements and the addition of a drop-down menu that provides additional Fortran-related options.
+
+Files can be manually set to f90-mode using `M-x f90-mode`, but file extensions can be added to your [Emacs initialization file][emacs-init-link] to ensure that these are recognised when opened. The format for this is
+```lisp
+(setq auto-mode-alist
+      (append '(("\\.mf90" . f90-mode)
+                ("\\.X90" . f90-mode)
+        ) auto-mode-alist))
+```
+::::::::::::::::: tab
+
+### Windows/MacOS
+
+From your home directory, initialization settings can be placed within your `.emacs.d/init.el` file.
+
+### Linux
+
+Initialization settings can be placed within your `~/.config/emacs/init.el` file. This location follows the Linux desktop environment guidelines.
+
+### Legacy (cross platform)
+
+The `.emacs` or `.emacs.el` file is an older method of configuring Emacs. This file is held in your home directory.
+
+:::::::::::::::::::::::::