| ... | ... | @@ -60,8 +60,6 @@ Instructions for building on macOS. You should use either [Homebrew](https://bre |
|
|
|
`sudo port install md5sha1sum`<br />
|
|
|
|
`sudo port install findutils`
|
|
|
|
|
|
|
|
1. [Install xquartz](https://www.xquartz.org/)
|
|
|
|
|
|
|
|
## Windows
|
|
|
|
|
|
|
|
Instructions for building on Windows 10. You can copy and paste the commands from here to the MSYS2 window. To paste in the MSYS2 window, right-click and select "Paste".
|
| ... | ... | @@ -91,23 +89,27 @@ and accept all defaults (press return) |
|
|
|
`pip install furo`
|
|
|
|
|
|
|
|
## Common steps
|
|
|
|
1. If you want to submit any (code or documentation) changes to the WP43 project, you will need to have an SSH key to connect to GitLab. If you already have created, skip this step.
|
|
|
|
1. [Install xquartz](https://www.xquartz.org/)
|
|
|
|
|
|
|
|
1. I~~f you want to submit any (code or documentation) changes to the WP43 project, ~~You will need to have an SSH key to connect to GitLab. If you already have created, skip this step.
|
|
|
|
- Run `ssh-keygen -t rsa -b 4096` and accept all defaults (there is no need for a passphrase, so just press return)
|
|
|
|
1. Add the key to your GitLab account (which you should create if you don't have one)
|
|
|
|
1. Copy the key you just created. To do this type `cat ~/.ssh/id_rsa.pub` and then select the text produced from running this using your mouse. Then right click and select "Copy".
|
|
|
|
1. Copy the key you just created. To do this type `cat ~/.ssh/id_rsa.pub` and then select the text produced from running this using your mouse. Then right click and select "Copy". Take care to include the ssh-rsa and exclude the command prompt that is visible at the bottom of the file
|
|
|
|
1. Go to the GitLab Preferences and select [SSH Keys](https://gitlab.com/-/profile/keys)
|
|
|
|
1. Don't enter an expiration date for the key, use the 'optional' setting
|
|
|
|
1. Paste the key you copied into the big box, and give it a title in the appropriate field (any name you want, but normally pick a name that identifies your computer), click "Add key"
|
|
|
|
1. Clone the repository:
|
|
|
|
2. Your repository will be cloned in the current directory as set in the terminal
|
|
|
|
1. `git clone git@gitlab.com:rpncalculators/c43.git`
|
|
|
|
- When it asks you "Are you sure you want to continue connecting (yes/no/\[fingerprint\])?" make sure you type "yes" and press return (do not select the default).
|
|
|
|
1. Change directory into the cloned source directory. <br />
|
|
|
|
`cd wp43`
|
|
|
|
`cd c43`
|
|
|
|
|
|
|
|
### Building the simulator
|
|
|
|
1. Build the source: <br />
|
|
|
|
`make clean` (not mandatory, but solves some compilation problems)
|
|
|
|
`make`
|
|
|
|
1. For Linux or macOS, make sure PulseAudio daemon is running if PulseAudio is installed. Or else there will be no beep sound. For Windows, PulseAudio is not needed to play beep sound.
|
|
|
|
1. (Optional) For Linux or macOS, make sure PulseAudio daemon is running if PulseAudio is installed. Or else there will be no beep sound. For Windows, PulseAudio is not needed to play beep sound.
|
|
|
|
1. To run the resulting simulator exectuable: <br />
|
|
|
|
`./wp43` (Linux, macOS) or `./wp43.exe` (Windows)
|
|
|
|
`./wp43 --landscape` or `./wp43.exe --landscape` runs the simulator in landscape mode
|
| ... | ... | |
