Skip to content

Commit

Permalink
Move sdl2 installation docs to separate files
Browse files Browse the repository at this point in the history
  • Loading branch information
TatriX committed Jul 29, 2021
1 parent ae593ad commit 701ef6e
Show file tree
Hide file tree
Showing 3 changed files with 51 additions and 37 deletions.
47 changes: 10 additions & 37 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,42 +6,7 @@ Adapted from http://lazyfoo.net/tutorials/SDL/
The tutorial requires that SDL2, SDL2 Image, and SDL2 TTF are installed before
running the examples.

### Mac OS X

Mac OS X requires each library to be downloaded and copied to
$HOME/Library/Frameworks or /Library/Frameworks.

Library Name | Download Link
------------ | -------------
SDL2 | https://www.libsdl.org/download-2.0.php
SDL2 Image | https://www.libsdl.org/projects/SDL_image
SDL2 TTF | https://www.libsdl.org/projects/SDL_ttf

Running the tutorials will cause Catalina to report that the framework cannot be
opened because the developer cannot be verified. The workaround for this problem
is the following:

1. Navigate to System Preferences -> Security & Privacy -> General on the Mac

2. Run repl.sh

3. When the dialog appears about the developer not being verified, click the
"Cancel" button.

4. Examine the Security & Privacy screen for a button called "Allow Anyway" for
the framework. Click the "Allow Anyway" button with the identified framework.

5. The verification dialog will now appear a second time, but there will be an
option to "Open" the framework. Click "Open".

6. Repeat steps 3 through 5 for the different frameworks.

### Linux

The SDL2 libraries can be installed on a Debian based system with the command
below.

apt install libsdl2-2.0 libsdl2-image-2.0 libsdl2-ttf-2.0
See instructions for [Linux](README_LINUX.md) and [macOS](README_MACOS.md) respectively.


## Installation
Expand All @@ -52,9 +17,17 @@ git clone https://github.com/TatriX/cl-sdl2-tutorial/ ~/quicklisp/local-projects
```

```lisp
> (ql:quickload :sdl2-tutorial)
(ql:quickload :sdl2-tutorial)
```

or [asdf](https://common-lisp.net/project/asdf/)
```
git clone https://github.com/TatriX/cl-sdl2-tutorial/ ~/common-lisp
```

```lisp
(asdf:load-system "sdl2-tutorial")
```

## Running the Examples

Expand Down
12 changes: 12 additions & 0 deletions README_LINUX.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
## Installing the SDL2 Libraries Linux

## Debian

The SDL2 libraries can be installed on a Debian based system with the command
below.

apt install libsdl2-2.0 libsdl2-image-2.0 libsdl2-ttf-2.0

## Arch

sudo pacman -S sdl2 sdl2_image sdl2_ttf
29 changes: 29 additions & 0 deletions README_MACOS.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
### Mac OS X

Mac OS X requires each library to be downloaded and copied to
$HOME/Library/Frameworks or /Library/Frameworks.

Library Name | Download Link
------------ | -------------
SDL2 | https://www.libsdl.org/download-2.0.php
SDL2 Image | https://www.libsdl.org/projects/SDL_image
SDL2 TTF | https://www.libsdl.org/projects/SDL_ttf

Running the tutorials will cause Catalina to report that the framework cannot be
opened because the developer cannot be verified. The workaround for this problem
is the following:

1. Navigate to System Preferences -> Security & Privacy -> General on the Mac

2. Run repl.sh

3. When the dialog appears about the developer not being verified, click the
"Cancel" button.

4. Examine the Security & Privacy screen for a button called "Allow Anyway" for
the framework. Click the "Allow Anyway" button with the identified framework.

5. The verification dialog will now appear a second time, but there will be an
option to "Open" the framework. Click "Open".

6. Repeat steps 3 through 5 for the different frameworks.

0 comments on commit 701ef6e

Please sign in to comment.