Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Better formatting, update and remove obsolete link in readme #33

Merged
merged 1 commit into from
Dec 9, 2023
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Jump to
Jump to file
Failed to load files.
Diff view
Diff view
47 changes: 11 additions & 36 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,19 +28,11 @@ OpenMSX is an open source base music set for OpenTTD.
the baseset category.

2. Manually:
download the latest OpenMSX package from its development homepage:
- Download the latest OpenMSX package from its development homepage:
homepage: https://github.com/OpenTTD/OpenMSX
Unpack the zip file into the OpenTTD 'baseset' directory (see section 4.2
of the OpenTTD readme for a detailed treatise on all data dirs OpenTTD
recognizes).
- An OpenTTD folder in your user account's home directory:
Windows:
C:\My Documents (95, 98, ME)
C:\Documents and Settings\<username>\My Documents\OpenTTD (2000, XP)
C:\Users\<username>\Documents\OpenTTD (Vista, 7)
macOS: ~/Documents/OpenTTD
GNU/Linux: ~/.openttd
- The OpenTTD installation directory.
- Unpack the zip file into the OpenTTD 'baseset' directory (see
docs/directory_structure.md in the
[OpenTTD repository](https://github.com/OpenTTD/OpenTTD))

3. In the main menu of the game, click the Game Options button. The Game
Options dialog will appear.
Expand All @@ -57,7 +49,8 @@ OpenMSX is an open source base music set for OpenTTD.
https://www.tt-forums.net

5. Music might not start automatically. If music does not play yet,
start a game and open the music box from the toolbar.
start a game and open the sound/music window ("Jazz Jukebox") from the toolbar,
or open the same window from the Sound section of the Game Options.
Here you can control the volume, and start and stop the music.


Expand All @@ -84,17 +77,12 @@ OpenMSX is an open source base music set for OpenTTD.
## 4.0 Contributing and compiling from source

The OpenMSX source is available in a Git repository or as gzip'ed tarball.
You can do a clone from

> https://github.com/OpenTTD/OpenMSX

e.g. using

> git clone https://github.com/OpenTTD/OpenMSX

You can do a clone from https://github.com/OpenTTD/OpenMSX, e.g. using
```
git clone https://github.com/OpenTTD/OpenMSX.git
```
or obtain the tarball from

> https://www.openttd.org/downloads/openmsx-releases/latest.html
https://www.openttd.org/downloads/openmsx-releases/latest.html

Prerequisites to building OpenMSX:
- Git (only when not building from a tarball)
Expand All @@ -105,19 +93,6 @@ Prerequisites to building OpenMSX:
and you might additionally want a text editor of your choice and possibly a
programme capable of creating and editing midi files.

On Windows: We advise to get a MinGW development environment.
For more detailed instructions, see our guide
at http://dev.openttdcoop.org/projects/home/wiki and the very extensive and
detailed installation instructions on the MinGW wiki at
http://www.mingw.org/wiki/Getting_Started

On GNU/Linux: Your system probably has most of these things installed,
but if not, all of these things should be easy to install if your system
has a software package manager.

On macOS: Install the developers tools. Git is easiest installed via
macports: sudo port install git

The use of Git is strongly encouraged as only that allows to keep track of
changes.

Expand Down