]> git.sur5r.net Git - cc65/blob - getting-started.html
Added Mailing Lists page.
[cc65] / getting-started.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2 <html>
3   <head>
4     <title>cc65 - Getting Started</title>
5     <link rel="stylesheet" type="text/css" href="cc65.css"/>
6     <link rel="shortcut icon" type="image/x-icon" href="image/favicon.ico"/>
7   </head>
8   <body>
9     <img style="float:right;" width="300" height="150" src="image/cc65.png" alt=""/>
10     <h1>Getting Started</h1>
11     <div id="menu">
12       <div id="innermenu">
13         <ul>
14           <li><a href="index.html">Main Page</a>
15           </li>
16           <li id="here"><a href="getting-started.html">Getting Started</a>
17           </li>
18         </ul>
19       </div>
20     </div>
21     <h2>Content</h2>
22     <ul class="down">
23       <li><a href="#GNU">GNU/Linux</a>
24       </li>
25       <li><a href="#Windows">Microsoft Windows</a>
26       </li>
27     </ul>
28     <h2><a name="GNU">GNU/Linux</a></h2>
29     <p>Download the
30        <a href="https://github.com/oliverschmidt/cc65/archive/master.zip">
31        current cc65 source code</a> an unzip it to a path of your choice.
32        Change the current working directory to the 'cc65-master' subdirectory
33        of that path and enter 'make'. This builds both the cc65 binaries
34        (located in the 'bin' subdirectory) and the cc65 libraries. Now cc65 is
35        fully functional without further steps.
36     </p>
37     <p>If you want to be able to run the cc65 binaries without providing their
38        path you may additionally enter 'sudo make avail'. This creates symbolic
39        links to the binaries in '/usr/local/bin'.
40     </p>
41     <h2><a name="Windows">Microsoft Windows</a></h2>
42     <p>Download the
43        <a href="https://github.com/oliverschmidt/cc65/archive/master.zip">
44        current cc65 source code</a> and unzip it to a path of your choice that
45        <u>doesn't contain spaces</u> (let's presume 'c:\cc65' here). Download
46        the 'Make for Windows'
47        <a href="http://gnuwin32.sourceforge.net/downlinks/make-bin-zip.php">
48        binary</a> and its
49        <a href="http://gnuwin32.sourceforge.net/downlinks/make-dep-zip.php">
50        dependencies</a> and unzip them both to the <u>same</u> path of your
51        choice (let's presume 'c:\cc65\gnu' here). Now you have two options...
52        <ul class="bullet">
53          <li>Build the cc65 binaries using Microsoft Visual C++ 2010 Express:
54              <br/>
55              Open a 'Visual Studio Command Prompt (2010)', change the current
56              working directory to 'c:\cc65\cc65-master' and enter
57              'c:\cc65\gnu\bin\make'. This builds both the cc65 binaries
58              (located in 'c:\cc65\cc65-master\bin') and the cc65 libraries.
59              Now cc65 is fully functional without further steps.
60          </li>
61        </ul>
62        <ul class="bullet">
63          <li>Use prebuilt cc65 binaries:
64              <br/>
65              Download the
66              <a href="http://sourceforge.net/projects/cc65/files/latest/download">
67              latest cc65 binaries</a> for Microsoft Windows and unzip them to
68              'c:\cc65\cc65-master\bin'. Open a Command Prompt, change the
69              current working directory to 'c:\cc65\cc65-master' and enter
70              'c:\cc65\gnu\bin\make lib'. This builds the cc65 libraries. Now
71              cc65 is fully functional without further steps.<br/>
72              <u>Note:</u> If you receive an error message complaining about
73              'MSVCR100.dll' missing then you need to install the
74              <a href="http://www.microsoft.com/en-us/download/details.aspx?id=8328">
75              Microsoft Visual C++ 2010 SP1 Redistributable Package (x86)</a>.
76          </li>
77        </ul>
78     </p>
79     <p>If you want to be able to run the cc65 binaries without providing their
80        path you may additionally add 'c:\cc65\cc65-master\bin' to your 'Path'
81        environment variable.
82     </p>
83   </body>
84 </html>