From de5e3891b9ae0631bb43dc90ea99d145f243bd94 Mon Sep 17 00:00:00 2001
From: sonicspiral <49568191+sonicspiral@users.noreply.github.com>
Date: Wed, 12 Aug 2020 20:35:59 -0700
Subject: [PATCH 1/3] Add FAQ section for possible common issues
* Fix for /bin/bash: mips-linux-gnu-as: command not found.
* Fix for sha1sum: 'papermario.z64'$'\r': No such file or directory.
---
Readme.md | 18 ++++++++++++++++++
1 file changed, 18 insertions(+)
diff --git a/Readme.md b/Readme.md
index 4058e955e3..bd1f5aba2d 100644
--- a/Readme.md
+++ b/Readme.md
@@ -30,3 +30,21 @@ run `make setup` to set up tools and extract the rom
### Make
run `make` to rebuild the rom. Get `OK`? If so, you're all set! Otherwise, please feel free to reach out to us in the discord.
+
+## FAQ
+* `make setup` failed with this error? One of the packages from the _Ubuntu and co (easy mode)_ script did not install correctly. Try to run as sudo `sudo su`, run the script again and append `--fix-missing` to it.
+```
+/bin/bash: mips-linux-gnu-as: command not found
+Makefile:92: recipe for target 'build/asm/boot.o' failed
+make: *** [build/asm/boot.o] Error 127
+```
+
+* `make` failed with this error? This is a Windows line ending issue run `git checkout checksum.sha1` to fix it.
+```
+sha1sum -c checksum.sha1
+sha1sum: 'papermario.z64'$'\r': No such file or directory
+: FAILED open or read
+sha1sum: WARNING: 1 listed file could not be read
+Makefile:118: recipe for target 'verify' failed
+make: *** [verify] Error 1
+```
From f9f6f302a9927d7d516b0407f798168eb733e676 Mon Sep 17 00:00:00 2001
From: sonicspiral <49568191+sonicspiral@users.noreply.github.com>
Date: Wed, 12 Aug 2020 22:47:28 -0700
Subject: [PATCH 2/3] Update FAQ problem and solution order
* Feedback from this [comment](https://github.com/ethteck/papermario/pull/2#issuecomment-673270326) on suggested order.
---
Readme.md | 12 ++++++++++--
1 file changed, 10 insertions(+), 2 deletions(-)
diff --git a/Readme.md b/Readme.md
index bd1f5aba2d..c5b04b50ec 100644
--- a/Readme.md
+++ b/Readme.md
@@ -32,14 +32,19 @@ run `make setup` to set up tools and extract the rom
run `make` to rebuild the rom. Get `OK`? If so, you're all set! Otherwise, please feel free to reach out to us in the discord.
## FAQ
-* `make setup` failed with this error? One of the packages from the _Ubuntu and co (easy mode)_ script did not install correctly. Try to run as sudo `sudo su`, run the script again and append `--fix-missing` to it.
+* If you received the following error when running `make setup`:
```
/bin/bash: mips-linux-gnu-as: command not found
Makefile:92: recipe for target 'build/asm/boot.o' failed
make: *** [build/asm/boot.o] Error 127
```
+> 💡 Solution
+>
+> One of the packages from the _Ubuntu and co (easy mode)_ script did not install correctly. Elevate your user permissions using `sudo su`, run the script again and append `--fix-missing` to it.
+>
-* `make` failed with this error? This is a Windows line ending issue run `git checkout checksum.sha1` to fix it.
+
+* If you received the following error when running `make`:
```
sha1sum -c checksum.sha1
sha1sum: 'papermario.z64'$'\r': No such file or directory
@@ -48,3 +53,6 @@ sha1sum: WARNING: 1 listed file could not be read
Makefile:118: recipe for target 'verify' failed
make: *** [verify] Error 1
```
+> 💡 Solution
+>
+> This is a Windows line ending issue run `git checkout checksum.sha1` to fix it.
From 736f1d79aa20022fc6ee65da0facf6b371f81c33 Mon Sep 17 00:00:00 2001
From: sonicspiral <49568191+sonicspiral@users.noreply.github.com>
Date: Wed, 12 Aug 2020 22:49:08 -0700
Subject: [PATCH 3/3] Increase spacing between question for readability
---
Readme.md | 2 ++
1 file changed, 2 insertions(+)
diff --git a/Readme.md b/Readme.md
index c5b04b50ec..bcd4306137 100644
--- a/Readme.md
+++ b/Readme.md
@@ -43,6 +43,8 @@ make: *** [build/asm/boot.o] Error 127
> One of the packages from the _Ubuntu and co (easy mode)_ script did not install correctly. Elevate your user permissions using `sudo su`, run the script again and append `--fix-missing` to it.
>
+
+
* If you received the following error when running `make`:
```