gbdev/rgbds
1
0
Fork 0
mirror of https://github.com/gbdev/rgbds.git synced 2025-11-20 18:22:07 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #127 from rogersachan/patch-1

Browse Source 
Convert README to markdown
This commit is contained in:
AntonioND
2017-02-26 22:28:10 +00:00
committed by GitHub
parent 92b81b1d5a 7adf1dd502
commit 7c2cae7a32
1 changed files with 21 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files

40
README → README.md
View File

@@ -1,6 +1,4 @@
---------------- # RGBDS
RGBDS README
----------------
RGBDS (Rednex Game Boy Development System) is a free assembler/linker package RGBDS (Rednex Game Boy Development System) is a free assembler/linker package
for the Game Boy and Game Boy Color. It consists of: for the Game Boy and Game Boy Color. It consists of:
@@ -14,54 +12,58 @@ rgbds-linux is a fork of the original RGBDS which aims to make the programs
more like other UNIX tools. more like other UNIX tools.
Installing RGBDS (UNIX) ## Installing RGBDS (UNIX)
=========================
RGBDS requires libpng and pkg-config to be installed. RGBDS requires libpng and pkg-config to be installed.
On Mac OS X, install them with [Homebrew](http://brew.sh/). On other Unixes, On Mac OS X, install them with [Homebrew](http://brew.sh/). On other Unixes,
use the built-in package manager. use the built-in package manager.
You can test if they're installed by running "pkg-config --cflags libpng": You can test if they're installed by running `pkg-config --cflags libpng`:
if the output is a path, then you're good, and if it outputs an error then if the output is a path, then you're good, and if it outputs an error then
you need to install them via a package manager. you need to install them via a package manager.
To build the programs on a UNIX or UNIX-like system, just run in your terminal: To build the programs on a UNIX or UNIX-like system, just run in your terminal:
make ```sh
make
```
Then to install the compiled programs and manual pages, run (with appropriate Then to install the compiled programs and manual pages, run (with appropriate
privileges): privileges):
make install ```sh
make install
```
After installation, you can read the manuals with the man(1) command. E.g., After installation, you can read the manuals with the man(1) command. E.g.,
man 1 rgbasm ```sh
man 1 rgbasm
```
Note: the variables described below can affect installation behavior when given Note: the variables described below can affect installation behavior when given
on the make command line. For example, to install rgbds in your home directory on the make command line. For example, to install rgbds in your home directory
instead of systemwide, run the following: instead of systemwide, run the following:
mkdir -p $HOME/{bin,man/man1,man/man7} ```sh
make install PREFIX=$HOME mkdir -p $HOME/{bin,man/man1,man/man7}
make install PREFIX=$HOME
```
`PREFIX`: Location where RGBDS will be installed. Defaults to /usr/local.
PREFIX: Location where RGBDS will be installed. Defaults to /usr/local. `BINPREFIX`: Location where the RGBDS programs will be installed. Defaults
BINPREFIX: Location where the RGBDS programs will be installed. Defaults
to ${PREFIX}/bin. to ${PREFIX}/bin.
MANPREFIX: Location where the RGBDS man pages will be installed. Defaults `MANPREFIX`: Location where the RGBDS man pages will be installed. Defaults
to ${PREFIX}/man. to ${PREFIX}/man.
Q: Whether to quiet the build or not. To make the build more verbose, clear `Q`: Whether to quiet the build or not. To make the build more verbose, clear
this variable. Defaults to @. this variable. Defaults to @.
Installing RGBDS (Windows) ## Installing RGBDS (Windows)
============================
Windows builds are available here: https://github.com/bentley/rgbds/releases Windows builds are available here: https://github.com/bentley/rgbds/releases