@@ -60,59 +60,12 @@ This course will make use of the following software:
6060Instruction for using each system are below:
6161
6262@itemlist[
63- @item{@secref{GRACE}}
6463@item{@secref{Linux}}
6564@item{@secref{mac}}
6665@item{@secref{Windows}}
66+ @item{@secref{GRACE}}
6767]
6868
69- @section[#:tag "GRACE " ]{Using GRACE}
70-
71- The @link["http://www.grace.umd.edu/ " ]{GRACE} system gives students
72- access to an x86-64 Linux system that meets all of the system
73- requirements for the software in this course. If you have an
74- incompatible system, or if you'd rather avoid installing and setting
75- up the software for this course, you can use GRACE.
76-
77- Before using GRACE, you should locally install an implementation of
78- the X.Org X Window System which will enable you to run GUI programs
79- from GRACE on your computer (or any other computer that uses X11). On
80- Linux, this is likely set up by default. On Mac, you will need to
81- install @link["https://www.xquartz.org/ " ]{XQuartz}. On Windows, you
82- can use @link["https://mobaxterm.mobatek.net/ " ]{MobaXterm}.
83-
84- To use GRACE, open a terminal on your computer and
85- type:
86-
87- @verbatim|{ ssh -Y <directoryID>@grace.umd.edu}|
88-
89- You will prompted for your UMD Directory ID password. After entering
90- your password, you will be at the GRACE command line prompt.
91-
92- The @tt{-Y} command line option sets up X11 forwarding, which lets you
93- run GUI applications from GRACE. If you leave this off, programs like
94- DrRacket will fail to launch when started.
95-
96- Racket and @tt{nasm} are already installed, but you will
97- need to modify your @tt{PATH} environment variable so that you can
98- execute them from the command-line. You can do this with the
99- following commands:
100-
101- @verbatim|{
102- # CMSC 430 set up
103- set path = ( /cell_root/software/racket/8.4/sys/bin $path )
104- set path = ( /cell_root/software/nasm/2.15.05/sys/bin/ $path )}|
105-
106- If you add these lines to the @tt{.path} file in your home directory, then you
107- won't have to run this command manually every time you login; it will happen
108- automatically.
109-
110- Once set, you should be able to run commands such as @tt{racket},
111- @tt{raco}, and @tt{nasm}. Other tools such as @tt{gcc} are already
112- available.
113-
114- Finally, you will need to install @secref{langs-package}.
115-
11669@section[#:tag "Linux " ]{Using Linux}
11770
11871If you have an ARM-based machine, you will need to use
@@ -237,6 +190,59 @@ some Linux Distribution. Here is a breakdown of the steps:
237190Regardless of the IDE used, you can now run your tests from your Linux
238191subsystem by entering the project directory and using the raco command.
239192
193+ @section[#:tag "GRACE " ]{Using GRACE}
194+
195+ @margin-note{GRACE is unfortunately not well maintained by the
196+ university and is recommended only as a last resort. Please contact
197+ course staff if you plan to use GRACE for this class so we can help
198+ make sure everything is set-up properly.}
199+
200+ The @link["http://www.grace.umd.edu/ " ]{GRACE} system gives students
201+ access to an x86-64 Linux system that meets all of the system
202+ requirements for the software in this course. If you have an
203+ incompatible system, or if you'd rather avoid installing and setting
204+ up the software for this course, you can use GRACE.
205+
206+ Before using GRACE, you should locally install an implementation of
207+ the X.Org X Window System which will enable you to run GUI programs
208+ from GRACE on your computer (or any other computer that uses X11). On
209+ Linux, this is likely set up by default. On Mac, you will need to
210+ install @link["https://www.xquartz.org/ " ]{XQuartz}. On Windows, you
211+ can use @link["https://mobaxterm.mobatek.net/ " ]{MobaXterm}.
212+
213+ To use GRACE, open a terminal on your computer and
214+ type:
215+
216+ @verbatim|{ ssh -Y <directoryID>@grace.umd.edu}|
217+
218+ You will prompted for your UMD Directory ID password. After entering
219+ your password, you will be at the GRACE command line prompt.
220+
221+ The @tt{-Y} command line option sets up X11 forwarding, which lets you
222+ run GUI applications from GRACE. If you leave this off, programs like
223+ DrRacket will fail to launch when started.
224+
225+ Racket and @tt{nasm} are already installed, but you will
226+ need to modify your @tt{PATH} environment variable so that you can
227+ execute them from the command-line. You can do this with the
228+ following commands:
229+
230+ @verbatim|{
231+ # CMSC 430 set up
232+ set path = ( /cell_root/software/racket/8.4/sys/bin $path )
233+ set path = ( /cell_root/software/nasm/2.15.05/sys/bin/ $path )}|
234+
235+ If you add these lines to the @tt{.path} file in your home directory, then you
236+ won't have to run this command manually every time you login; it will happen
237+ automatically.
238+
239+ Once set, you should be able to run commands such as @tt{racket},
240+ @tt{raco}, and @tt{nasm}. Other tools such as @tt{gcc} are already
241+ available.
242+
243+ Finally, you will need to install @secref{langs-package}.
244+
245+
240246@section[#:tag "install-racket " ]{Installing Racket}
241247
242248Racket is available for all major operating systems from:
@@ -246,6 +252,12 @@ Racket is available for all major operating systems from:
246252We will be using Racket @racket-version, but any version from the past several
247253years should work fine.
248254
255+ It's best to install Racket using the Racket installer rather than any
256+ package management system (e.g. Homebrew) as these bundles are often
257+ out-of-date, missing features, or will select the wrong platform
258+ (remember: you need to be running the Intel 64-bit version, even if
259+ you're on Apple Silicon).
260+
249261There are two essential references:
250262
251263@itemlist[
0 commit comments