1
0
mirror of https://github.com/cc65/cc65.git synced 2024-07-09 01:28:58 +00:00
cc65/getting-started.html

116 lines
4.9 KiB
HTML

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<title>cc65 - Getting Started</title>
<link rel="stylesheet" type="text/css" href="cc65.css"/>
<link rel="shortcut icon" type="image/x-icon" href="image/favicon.ico"/>
</head>
<body>
<img style="float:right;" width="300" height="150" src="image/cc65.png" alt=""/>
<h1>Getting Started</h1>
<div id="menu">
<div id="innermenu">
<ul>
<li><a href="index.html">Main Page</a>
</li>
<li id="here"><a href="getting-started.html">Getting Started</a>
</li>
<li><a href="mailing-lists.html">Mailing Lists</a>
</li>
</ul>
</div>
</div>
<h2>Content</h2>
<ul class="down">
<li><a href="#GNU">GNU/Linux</a>
</li>
<li><a href="#Windows">Microsoft Windows</a>
</li>
</ul>
<h2><a name="GNU">GNU/Linux</a></h2>
<p>You have two options...
<ul class="bullet">
<li>
<p>Download the
<a href="https://github.com/oliverschmidt/cc65/archive/master.zip">
current cc65 source code</a> and unzip it to a path of your
choice. Change the current working directory to the 'cc65-master'
subdirectory of that path and enter 'make'. This builds both the
cc65 binaries (located in the 'bin' subdirectory) and the cc65
libraries. Now cc65 is fully functional without further steps.
</p>
<p>If you want to be able to run the cc65 binaries without providing
their path you may additionally enter 'sudo make avail'. This
creates symbolic links to the binaries in '/usr/local/bin'.
</p>
</li>
</ul>
<ul class="bullet">
<li>
<p>Download pre-built packages for RPM based systems (OpenSUSE) or
DEB based systems (Debian) from the
<a href="http://software.opensuse.org/download.html?project=home%3Astrik&package=cc65">
openSUSE Build Service download page for cc65</a>.
</p>
</li>
</ul>
</p>
<h2><a name="Windows">Microsoft Windows</a></h2>
<p><u>Note:</u> If you have used cc65 before then you need to make sure
to remove all environment variables related to cc65 (like CC65_HOME).
</p>
<p>Download the
<a href="https://github.com/oliverschmidt/cc65/archive/master.zip">
current cc65 source code</a> and unzip it to a path of your choice that
<u>doesn't contain spaces</u> (let's presume 'c:\cc65' here). Download
the 'Make for Windows'
<a href="http://gnuwin32.sourceforge.net/downlinks/make-bin-zip.php">
binary</a> and its
<a href="http://gnuwin32.sourceforge.net/downlinks/make-dep-zip.php">
dependencies</a> and unzip them both to the <u>same</u> path of your
choice (let's presume 'c:\cc65\gnu' here). Now you have two options...
<ul class="bullet">
<li>
<p>Build the cc65 binaries using Microsoft Visual C++ 2010 Express:
<br/>
Open a 'Visual Studio Command Prompt (2010)', change the current
working directory to 'c:\cc65\cc65-master' and enter
'c:\cc65\gnu\bin\make'. This builds both the cc65 binaries
(located in 'c:\cc65\cc65-master\bin') and the cc65 libraries.
Now cc65 is fully functional without further steps.
</p>
<p><u>Note:</u> If you receive an error message complaining about
a permission denied then you need to run the Visual Studio
Command Prompt as administrator.
</p>
</li>
</ul>
<ul class="bullet">
<li>
<p>Use prebuilt cc65 binaries:
<br/>
Download the
<a href="http://sourceforge.net/projects/cc65/files/latest/download">
latest cc65 binaries</a> for Microsoft Windows and unzip the them to
'c:\cc65\cc65-master'. Rename the directory 'c:\cc65\cc65-master\drop'
to 'c:\cc65\cc65-master\bin'. Open a Command Prompt, change the
current working directory to 'c:\cc65\cc65-master' and enter
'c:\cc65\gnu\bin\make lib'. This builds the cc65 libraries. Now
cc65 is fully functional without further steps.
</p>
<p><u>Note:</u>
If you receive an error message complaining about 'MSVCR100.dll'
missing then you need to install the
<a href="http://www.microsoft.com/en-us/download/details.aspx?id=8328">
Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)</a>.
</p>
</li>
</ul>
</p>
<p>If you want to be able to run the cc65 binaries without providing their
path you may additionally add 'c:\cc65\cc65-master\bin' to your 'Path'
environment variable.
</p>
</body>
</html>