diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/TXT.rtf b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/TXT.rtf index 26ff5110a..5a62de3df 100644 --- a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/TXT.rtf +++ b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/TXT.rtf @@ -1,73 +1,180 @@ -{\rtf1\ansi\ansicpg1252\cocoartf1187 +{\rtf1\ansi\ansicpg1252\cocoartf1187\cocoasubrtf370 {\fonttbl\f0\fnil\fcharset0 LucidaGrande;\f1\fswiss\fcharset0 Helvetica;\f2\fmodern\fcharset0 Courier; } {\colortbl;\red255\green255\blue255;} +{\*\listtable{\list\listtemplateid1\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid1\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid1} +{\list\listtemplateid2\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid101\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid2} +{\list\listtemplateid3\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid201\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid3} +{\list\listtemplateid4\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid301\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid4} +{\list\listtemplateid5\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid401\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid5} +{\list\listtemplateid6\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid501\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid6} +{\list\listtemplateid7\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid601\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid7} +{\list\listtemplateid8\listhybrid{\listlevel\levelnfc23\levelnfcn23\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{square\}}{\leveltext\leveltemplateid701\'01\uc0\u9642 ;}{\levelnumbers;}\fi-360\li720\lin720 }{\listname ;}\listid8} +{\list\listtemplateid9\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid801\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid9} +{\list\listtemplateid10\listhybrid{\listlevel\levelnfc0\levelnfcn0\leveljc0\leveljcn0\levelfollow0\levelstartat1\levelspace360\levelindent0{\*\levelmarker \{decimal\}.}{\leveltext\leveltemplateid901\'02\'00.;}{\levelnumbers\'01;}\fi-360\li720\lin720 }{\listname ;}\listid10}} +{\*\listoverridetable{\listoverride\listid1\listoverridecount0\ls1}{\listoverride\listid2\listoverridecount0\ls2}{\listoverride\listid3\listoverridecount0\ls3}{\listoverride\listid4\listoverridecount0\ls4}{\listoverride\listid5\listoverridecount0\ls5}{\listoverride\listid6\listoverridecount0\ls6}{\listoverride\listid7\listoverridecount0\ls7}{\listoverride\listid8\listoverridecount0\ls8}{\listoverride\listid9\listoverridecount0\ls9}{\listoverride\listid10\listoverridecount0\ls10}} \margl1440\margr1440\vieww16380\viewh15560\viewkind0 \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0\b\fs36 \cf0 XcodeCapp Help \b0 \ \ - -\b\fs24 What is XcodeCapp?\ - -\b0\fs36 \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\fs24 \cf0 One of Cappuccino\'92s greatest features is the ability to use Xcode 4 to create the user interface for your web applications. Xcode creates .xib files which then must be converted by the command line utility +\b\fs28 \cf0 What is XcodeCapp?\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\b0\fs36 \cf0 \ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\fs24 \cf0 One of Cappuccino\'92s greatest features is its ability to use Xcode 4 to create the user interface for your web applications. Xcode creates .xib files which then must be converted by the command line utility \b nib2cib \b0 to .cib files for use with Cappuccino. But beginning with Xcode 4, there is no way to directly create outlets and actions without editing Objective-C header files.\ \ XcodeCapp acts as a bridge between Xcode and Cappuccino. It performs two main functions:\ \ -\'95 Reads your source files when they are modified and automatically creates outlets and actions in the .xib file.\ -\'95 Automatically converts .xib files to .cib files when the .xib file is modified.\ -\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls1\ilvl0\cf0 {\listtext \uc0\u9642 }Creates an Xcode project where you can edit your Cappuccino project\'92s xibs.\ +{\listtext \uc0\u9642 }Reads your source files and automatically creates outlets and actions in the xib file.\ +{\listtext \uc0\u9642 }Automatically converts xib files to cib files when the .xib file is modified.\ +{\listtext \uc0\u9642 }Listens for changes to source files and xibs and updates outlets and actions in the xib file accordingly.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\b \cf0 Using XcodeCapp +\b\fs28 \cf0 Using XcodeCapp \b0 \ -\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\fs24 \cf0 \ XcodeCapp is very easy to use and requires very little user interaction. When you build Cappuccino with jake, it will create a symlink to the XcodeCapp application in your Applications folder. Launch XcodeCapp from there and the XcodeCapp icon will appear in your menu bar. Clicking on the icon will display the XcodeCapp menu:\ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f1 \cf0 {{\NeXTGraphic menu1.png \width4220 \height3440 +\f1 \cf0 {{\NeXTGraphic XcodeCapp-menu.png \width4260 \height4480 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ \ +When the round indicator in the center of the status icon is gray, XcodeCapp does not have a project open.\ \ -If this is the first time you have run XcodeCapp, or if you were not listening to a project when XcodeCapp was last quit, you need to choose a Cappuccino project. Select "Listen to Project\'85\'94, and a folder chooser will appear. Navigate to the root folder of your project \'97 the one that contains index.html and Jakefile \'97 and click Open.\ -\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b \ +Opening a Project\ + +\b0 \ +First you have to tell XcodeCapp what Cappuccino project to open.\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls2\ilvl0\cf0 {\listtext 1. }Select \'93Open Project\'85\'94 from the XcodeCapp menu. A folder chooser dialog will appear.\ +{\listtext 2. }Navigate to the root folder of your project \'97 the one that contains index-debug.html and Jakefile.\ +{\listtext 3. }Click Open.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \cf0 \ -Once you select a project, XcodeCapp will import your project and create a hidden folder called \'93.XcodeSupport\'94 in the root project directory. This folder contains files built by XcodeCapp that it needs to perform its magic, so you should never directly modify those files. You will probably want to ignore this folder in your IDE and source code management system as well.\ -\ -After XcodeCapp has imported a project, it will listen to changes in the following files anywhere in the project:\ -\ -\'95 *.xib \'96 Interface Builder files\ -\'95 *.j - Objective-J source\ -\'95 .xcodecapp-ignore - specifies files XcodeCapp should ignore\ -\ -Any time these files are modified, XcodeCapp will process the files and show a Growl notification when the processing is done.\ -\ -\ \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural - -\b \cf0 Declaring Outlets and Actions\ +\cf0 Once you open a project, XcodeCapp does the following:\ +\ +\pard\tx220\tx720\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\li720\fi-720\pardirnatural +\ls3\ilvl0\cf0 {\listtext 1. }Creates an Xcode project with the name of the project directory, if no such project already exists.\ +{\listtext 2. }Parses source code in the project directory and all non-Cappuccino subdirectories (such as Build, Frameworks, etc.).\ +{\listtext 3. }Parses source code in non-Cappuccino frameworks.\ +{\listtext 4. }If no cib file exists for a given xib file, converts the xib using nib2cib.\ +\pard\tx560\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural +\cf0 \ \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural - -\b0 \cf0 \ -The most important function XcodeCapp performs is to create outlets and actions for use with Interface Builder. You create outlets by prefixing them in your source files with -\b @outlet -\b0 or -\b IBOutlet -\b0 . For example, in the class below, there are seven outlets defined:\ +\cf0 When XcodeCapp is processing files, the indicator in the menubar icon changes to yellow.\ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f1 \cf0 {{\NeXTGraphic outlets.png \width10580 \height4580 +\f1 \cf0 {{\NeXTGraphic processing.png \width6480 \height1920 +}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f0 \cf0 \ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural +\cf0 \ +During the source parsing, XcodeCapp creates a folder called \'93XcodeSupport\'94 in the root project directory. This folder contains files created by XcodeCapp that act as the bridge between Cappuccino and Xcode, so you should never directly modify those files. You will probably want to ignore this folder in your IDE and source code management system as well.\ +\ +After XcodeCapp has opened a project, it will listen for changes to the following files anywhere in the project:\ +\ +\pard\tx220\tx720\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\li720\fi-720\pardirnatural +\ls4\ilvl0\cf0 {\listtext \uc0\u9642 }*.xib \'96 Xcode 4 interface builder files\ +{\listtext \uc0\u9642 }*.j - Objective-J source\ +{\listtext \uc0\u9642 }.xcodecapp-ignore - Specifies files XcodeCapp should ignore. See \'93Ignoring Files and Folders\'94 below.\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural +\cf0 \ +When XcodeCapp has a project open and is listening for changes, the indicator turns green.\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f1 \cf0 {{\NeXTGraphic listening.png \width700 \height540 +}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f0 \cf0 \ +\ +The most recently opened project is inserted at the top of the Open Recent submenu in the XcodeCapp menu. By default, the recent project list is limited to 20 projects. You can change that number in the Preferences window. See \'93Preferences\'94 below for more information.\ +\ +If you quit XcodeCapp while a project is open, by default when you reopen XcodeCapp it will reopen the most recently opened project. You can change this behavior in the Preferences window. See \'93Preferences\'94 below for more information.\ +\ +\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b \cf0 Notifications\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b0 \cf0 \ +XcodeCapp shows notifications whenever it processes files. If you are using Mac OS X 10.8+, notifications will appear in Notification Center. Otherwise they will appear according to Growl\'92s preferences if Growl is installed, or in a simple notification window if Growl is not installed.\ +\ +Note that notifications remain on screen for a minimum amount of time, and thus may lag behind the actual processing of the files.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b \cf0 Handling Errors\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b0 \cf0 \ +If an error or warning occurs during the parsing of an Objective-J file or the conversion of a xib, by default XcodeCapp will open the Errors & Warnings panel and display information about the error or warning.\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f1 \cf0 {{\NeXTGraphic errors-panel.png \width11780 \height5900 +}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f0 \cf0 \ +\ +Selecting an error in the list and clicking Open or double-clicking on an error opens the offending file in the preferred editor for that file and closes the Errors panel. In the case of .j files, XcodeCapp will attempt to open the file directly to the offending line in the following editors:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls5\ilvl0\cf0 {\listtext \uc0\u9642 }Sublime Text\ +{\listtext \uc0\u9642 }TextMate\ +{\listtext \uc0\u9642 }TextWrangler\ +{\listtext \uc0\u9642 }BBEdit\ +{\listtext \uc0\u9642 }Chocolat\ +{\listtext \uc0\u9642 }MacVIM\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural +\cf0 \ +The error list is cleared when a new project is opened. Also, whenever a file is modified, any existing errors for that file are removed. So the Errors & Warnings panel always represents the current state of your files.\ +\ +If you do not wish the Errors panel to open automatically when errors occur, you can change that behavior in the Preferences window. See \'93Preferences\'94 below for more information.\ +\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b \cf0 \ +Declaring Outlets and Actions\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b0 \cf0 \ +The most important function XcodeCapp performs is to create outlets and actions for use with Xcode. You create outlets by prefixing them in your source files with +\b @outlet +\b0 or +\b IBOutlet +\b0 . For example, in the class below, there are four outlets defined:\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f1 \cf0 {{\NeXTGraphic outlets.png \width10720 \height4820 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ @@ -81,86 +188,183 @@ The most important function XcodeCapp performs is to create outlets and actions \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f1 \cf0 {{\NeXTGraphic action.png \width14180 \height2440 +\f1 \cf0 {{\NeXTGraphic actions.png \width10800 \height1580 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural \cf0 \ -\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural - -\b \cf0 Editing XIBs\ \ \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural -\b0 \cf0 XcodeCapp creates an Xcode 4 project that allows you to edit your project\'92s xibs. To open the project, click on the XcodeCapp menu and select \'93Open Project in Xcode\'94.\ +\b \cf0 Editing Xibs\ +\ +\pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural + +\b0 \cf0 When you open a project, XcodeCapp creates an Xcode 4 project with which you to edit your project\'92s xibs. To open the Xcode project, click on the XcodeCapp menu and select \'93Open Project in Xcode\'94.\ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \cf0 \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f1 \cf0 {{\NeXTGraphic menu2.png \width5220 \height3480 +\f1 \cf0 {{\NeXTGraphic open-in-xcode.png \width5200 \height4540 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ \ -Once the Xcode project is open, you can edit your xibs with the interface builder. All of the outlets and actions you declared in your source will be available in interface builder for connection to views. For example, the InfoPanelController shown above would have these outlets in interface builder:\ +Once the Xcode project is open, you can edit your xibs with the interface builder. The Xcode project contains three folders by default:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls6\ilvl0\cf0 {\listtext \uc0\u9642 }Resources \'96 Contains the files in your project\'92s Resources directory.\ +{\listtext \uc0\u9642 }Classes \'96 Contains the Objective-C classes generated by XcodeCapp. You should not edit or remove these.\ +{\listtext \uc0\u9642 }Sources \'96 Contains the source files found by XcodeCapp. You may edit these files in Xcode if you wish.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +All of the outlets and actions you declared in your source will be available in interface builder for connection to views. For example, the InfoPanelController shown above would have these outlets in interface builder:\ \pard\tx566\tx1133\tx1700\tx2267\tx2834\tx3401\tx3968\tx4535\tx5102\tx5669\tx6236\tx6803\pardirnatural \cf0 \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f1 \cf0 {{\NeXTGraphic outlets2.png \width8040 \height4160 +\f1 \cf0 {{\NeXTGraphic outlets-xcode.png \width9760 \height5960 }¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ \ +To add more outlets or actions to the xib, you must edit the Cappuccino source and wait briefly while XcodeCapp processes the changes; do not attempt to add an outlet or action in Xcode.\ +\ +\ + +\b Working with User Frameworks\ +\ + +\b0 When a project is opened, XcodeCapp looks for user (non-Cappuccino) frameworks in your project\'92s Frameworks/Debug directory. Any debug user frameworks in source form will be processed by XcodeCapp. This allows you to declare outlets and actions in frameworks and use them within Xcode. In addition, if a framework contains a Resources directory, a \'93 Resources\'94 folder referencing that directory is created in the Xcode project. This allows you to reference framework resources within Xcode.\ +\ +If you want your user frameworks to execute in compiled form, but you still want XcodeCapp to have access to the framework\'92s source in order to parse outlets and actions, do the following:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls7\ilvl0\cf0 {\listtext 1. }Copy or symlink to the compiled framework as usual within your project\'92s Frameworks directory.\ +{\listtext 2. }Create a directory called \'93Source\'94 within your project\'92s Frameworks directory.\ +{\listtext 3. }Within the Source directory, copy or symlink to the framework source directory.\ +{\listtext 4. }XcodeCapp will recursively search the Frameworks/Source directory when a project is opened.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +For example, here is the structure of a project\'92s Frameworks directory:\ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\b \cf0 Ignoring Files and Folders\ -\ -\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\f1 \cf0 {{\NeXTGraphic frameworks.png \width6320 \height7060 +}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\b0 \cf0 To have XcodeCapp ignore files and folders, create a file in the root project directory named \'93.xcodecapp-ignore\'94, and enter one line for each pattern you would like to ignore. Patterns may use \'93*\'94 as a wildcard to match zero or more characters (it is +\f0 \cf0 \ +\ +Note the following:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls8\ilvl0\cf0 {\listtext \uc0\u9642 }Debug/JQueryFileUpload is a symlink to the compiled framework. This is what will be executed when the app is run in debug mode.\ +{\listtext \uc0\u9642 }The Source directory contains a symlink to the JQueryFileUpload source. This will be parsed by XcodeCapp.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +\ + +\b Ignoring Files and Folders\ +\ + +\b0 There may be source which you do not want XcodeCapp to process. To specify directories or files which you want XcodeCapp to ignore, do the following:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls9\ilvl0\cf0 {\listtext 1. }Create a text file in the root of the project directory named \'93.xcodecapp-ignore\'94.\ +{\listtext 2. }Enter one line for each pattern you would like to ignore, where a pattern matches the +\b absolute +\b0 (full) path to the file or directory.\ +{\listtext 3. }Save the file. Whenever .xcodecapp-ignore is modified, XcodeCapp will parse it to rebuild the ignore list.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +Patterns may use \'93*\'94 as a wildcard to match zero or more characters (it is \b not \b0 a shell glob) and are matched against the \b absolute -\b0 path of the file or folder, so in most cases your patterns should begin with \'93*\'94. To safely match a folder name, the pattern should be -\f2 *//* -\f0 , where -\f2 name -\f0 is the name of the folder.\ +\b0 path of the file or directory, so in most cases your patterns should begin with \'93*\'94. To ignore a directory, add \'93/\'94 at the end of the directory name. For example, \'93*/server/\'94 will ignore that directory and any files within it.\ \ For example, to ignore the \'93Modules\'94 directory and the xib file \'93foo.xib\'94 in your project, enter these lines in .xcodecapp-ignore:\ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\f2 \cf0 */Modules/*\ -*/foo.xib +\f2 \cf0 */Modules/\ +*/foo.xib\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f0 \cf0 \ +Sometimes you may want to ignore almost all of the files or directories within a given directory. In such cases you can use an include pattern. An include pattern has the same syntax as the normal exclude patterns, but begins with \'93!\'94. Since ignore patterns are parsed in the order they appear in .xcodecapp-ignore, an include pattern should come after the exclude pattern it overrides. For example, if you wanted to exclude everything in the Modules directory, except for the Classes directory and any xib files, you would use the following patterns:\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f2 \cf0 */Modules/\ +!*/Modules/Classes/\ +!*/Modules/*.xib \f0 \ \ -Note that in addition to whatever patterns you specify (if any), XcodeCapp +Note that in addition to whatever patterns you specify (if any) in .xcodecapp-ignore, XcodeCapp \b always -\b0 ignores the following patterns:\ +\b0 parses the following patterns +\b before +\b0 your patterns:\ \ -\f2 */.git/*\ -*/.svn/*\ -*/.hg/*\ -*/Frameworks/*\ -*/.XcodeSupport/*\ -*/Build/*\ +\f2 */Frameworks/\ +!*/Frameworks/Debug/\ +*/AppKit/\ +*/Foundation/\ +*/Objective-J/\ +*/*.environment/\ +*/Build/\ +*/.*/\ */NS_*.j\ +*/main.j\ +*/.*\ +!*/.xcodecapp-ignore\ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \f0 \cf0 \ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural -\b \cf0 Credits -\fs28 \ +\b\fs28 \cf0 Preferences\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\fs24 \cf0 \ + +\b0 XcodeCapp supports the following preferences:\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f1 \cf0 {{\NeXTGraphic preferences.png \width6720 \height4400 +}¬}\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\f0 \cf0 \ +\ +The first three are mentioned above. \'93React to inode meta information changes\'94 is an advanced preference that you normally would not need to change.\ +\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\b\fs28 \cf0 Troubleshooting\ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\b0\fs24 \cf0 Ultimately XcodeCapp is a bit of a hack. It is doing all kinds of processing behind Xcode\'92s back, so to speak, and occasionally Xcode may get out of sync with your source files. In such cases, you can reset XcodeCapp by following these steps:\ +\ +\pard\tx220\tx720\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\li720\fi-720\pardirnatural +\ls10\ilvl0\cf0 {\listtext 1. }If XcodeCapp has your project open, select Close \'93\'94 from the XcodeCapp menu.\ +{\listtext 2. }Delete .xcodeproj and XcodeSupport from your project directory.\ +{\listtext 3. }Open the project again from the XcodeCapp menu. XcodeCapp will reparse your project and regenerate the Xcode project.\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural +\cf0 \ +\ +\pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural + +\b\fs28 \cf0 Credits\ \ \pard\tx560\tx1120\tx1680\tx2240\tx2800\tx3360\tx3920\tx4480\tx5040\tx5600\tx6160\tx6720\pardirnatural \b0\fs24 \cf0 XcodeCapp was originally written by Francisco Tolmasky.\ -The Cocoa port was written by Antoine Mercadal with contributions from Aparajita Fishman.\ +The Cocoa port was written by Antoine Mercadal and Aparajita Fishman.\ XcodeCapp (Cocoa version, formerly known as XcodeCapp-cocoa) was originally built for the Archipel Project (archipelproject.org) and is now part of Cappuccino.} \ No newline at end of file diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/XcodeCapp-menu.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/XcodeCapp-menu.png new file mode 100644 index 000000000..86045b593 Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/XcodeCapp-menu.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/action.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/action.png deleted file mode 100644 index 409188785..000000000 Binary files a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/action.png and /dev/null differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/actions.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/actions.png new file mode 100644 index 000000000..ad22c38b3 Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/actions.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/errors-panel.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/errors-panel.png new file mode 100644 index 000000000..28e144d12 Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/errors-panel.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/frameworks.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/frameworks.png new file mode 100644 index 000000000..32ef912a1 Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/frameworks.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/listening.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/listening.png new file mode 100644 index 000000000..903b69c1a Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/listening.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu1.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu1.png deleted file mode 100644 index 546d52de3..000000000 Binary files a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu1.png and /dev/null differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu2.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu2.png deleted file mode 100644 index 64bc9317f..000000000 Binary files a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/menu2.png and /dev/null differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/open-in-xcode.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/open-in-xcode.png new file mode 100644 index 000000000..04d91911f Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/open-in-xcode.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets-xcode.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets-xcode.png new file mode 100644 index 000000000..2944758ca Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets-xcode.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets.png index 95ecd57f9..8231afa34 100644 Binary files a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets.png and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets2.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets2.png deleted file mode 100644 index c85045d17..000000000 Binary files a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/outlets2.png and /dev/null differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/preferences.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/preferences.png new file mode 100644 index 000000000..519331565 Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/preferences.png differ diff --git a/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/processing.png b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/processing.png new file mode 100644 index 000000000..26d8a1a1c Binary files /dev/null and b/Tools/XcodeCapp/XcodeCapp/Resources/help.rtfd/processing.png differ