# Tutorial: Updating a Classic application to modern Carbon

This document shows how to port a small program from Classic to Carbon. More than just a simple porting sample, this project shows a best-practices method to convert legacy code to a "modern" Carbon application designed to take full advantage of Mac OS X. It's intended to be a little more complicated than the one step "turn on the standard handlers and remove most of your code" porting samples, yet still small and simple enough to not have to study it for six months.

This document is aimed at developers who have programmed on Mac OS before but are new to Mac OS X or Carbon. It is intended to be an accompanying narrative to go with the source code included with this document rather than a standalone document.

There is a wealth of Carbon information at Getting Started with Carbon . This document suppliments that material as a hands on tutorial laying out the steps to port a Classic application to Carbon, from making the application launch natively to making the application modern and truly Mac OS X savvy.

One of the nice things about updating to Carbon is that you can do it incrementally. The process has been broken down into six basic steps.

1. Prepare the Classic Code Base
2. The First Carbon Version
3. Carbon Events
4. Mach-O
5. The Data Browser Control
6. HIToolbox
7. Universal Binary
8. Conclusion