====== cc65 main page  ======

This is the main page of cc65 related information within the cc65 wiki. If you want to read more about the wiki itself, please see the [[:wiki:mainpage|wiki main page]].


===== What is cc65? =====

cc65 is a complete package, which includes

  * a C compiler for machines with a 6502 compatible CPU,
  * a powerful macro assembler,
  * linker, librarian and several other tools,
  * target libraries that support common 6502 platform like the Commodore C64, the Atari 8-bit machines, the Apple II and others,
  * documentation and more.

===== Downloading and installing =====
According to the author and maintainer: "with one exception in the compiler (access()) the code is plain ISO C, so it should compile on most systems. Memory usage may be a problem, however."

cc65 can surely be compiled and run on the following platforms, for which GNU Compiler Collection - [[http://gcc.gnu.org|GCC]] is available.

  * [[cc65:host_platforms:gnu_linux|GNU/Linux]]
  * [[cc65:host_platforms:osx|OS X]]
  * [[cc65:host_platforms:ms_windows|Microsoft Windows]]
  * [[cc65:host_platforms:amigaos|AmigaOS]]

===== Target platforms =====

  * [[Apple2|Apple II]]
  * [[Atari 2600]]
  * [[Commodore machines]]
  * [[GEOS]]

===== Setting up cc65 project =====

  * [[hello_world|Hello cc65!]]
  * [[project_setup|Setting up bigger project(s)]]
  * [[project_grows|Hey, my project is growing!]]

===== Tips and tricks =====

  * [[Using cc65 with Emacs]]
  * [[Searching the mailing list archive]]
  * [[Using ca65 with foreign source]]
  * [[Using runtime zeropage locations in assembly language]]
  * [[Force addressing mode in ca65]]

===== Frequently asked questions =====

  * [[Mail problems]]
  * [[File path problems]]
  * [[PEEK and POKE]]
  * [[The .ORG directive]]
  * [[Interrupt handlers in C]]
  * [[Direct console I/O]]
  * [[Symbols in local scopes]]

===== Library internals =====

  * [[Tiny Graphics Interface]]
  * [[Priority of constructors and destructors]]
  * [[Reminders]]

===== Compiler internals =====

  * [[The primary register]]
  * [[Parameter and return stacks]]
  * [[Parameter passing and calling conventions]]
  * [[Roadmap]]

===== Debug information =====

  * [[debug-info-overview|Overview]]
  * [[debug-info-data|Available information]]
  * [[debug-info-module|Module usage and API calls]]

===== Applications =====

  * [[cc65-contrib|The contrib area on the ftp server]]
  * [[ca65-apps|Applications written in assembler with ca65]]
  * [[cc65-apps|Applications written in C or C/assembler]]

===== Who is who =====