# HG changeset patch # User fturovic # Date 1276706375 18000 # Node ID fb0e02cb252b651d9c3f3c3243b6498859686ec3 # Parent 6c45b7c9cdace58aa31fc1d97c676b8378f6365c minor edits and updated images diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/CarbidePerspective.html --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/CarbidePerspective.html Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/CarbidePerspective.html Wed Jun 16 11:39:35 2010 -0500 @@ -21,7 +21,7 @@
  • Executables view - provides a dynamic list of executables and their related source files
  • Remote Connections view – use to monitor, create, edit, or remove common connection settings
  • -

    +

    Figure 1 - Carbide C/C++ perspective

    NOTE Click the icon to show additional options that may not be visible in the perspective view.

    For more information on perspectives see Workbench User Guide > Concepts > Perspectives, and for views see C/C++ Development User Guide > Reference diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/cvs.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/cvs.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/cvs.htm Wed Jun 16 11:39:35 2010 -0500 @@ -4,13 +4,21 @@ -Concurrent Versions System (CVS) +Software Configuration Management -

    Concurrent Versions System (CVS)

    -

    Carbide.c++ supports the Concurrent Versions System (CVS) for immediate version control support. Other revision systems are also supported but require the downloading of an Eclipse plug-in to add that feature to Carbide. Visit the eclipse.org or eclipse-plugins.2y.net sites to locate the plug-ins you need.

    -

    For more informaton on using CVS within Carbide, see the Workbench User Guide > Concepts > Team programming with CVS.

    +

    Software Configuration Management (SCM)

    +

    The Carbide.c++ tools are built on top of the Eclipse and CDT open source projects (eclipse.org). Carbide can use several popular software configuration management systems including:

    + +

    Other revision systems are also supported but require the downloading of an Eclipse plug-in to add that capability to Carbide. Visit the eclipse-plugins.2y.net sites to locate the plug-ins you need.

    diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/ext_build_support.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/ext_build_support.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/ext_build_support.htm Wed Jun 16 11:39:35 2010 -0500 @@ -9,7 +9,7 @@

    External Builds Support

    -

    The IDE will perform the following tasks on external makefiles:

    +

    The Carbide IDE performs the following tasks on external makefiles:

    • Build
    • Debug
    • @@ -17,10 +17,10 @@
    • Source Browsing
    • Error Lookup
    -

    The IDE can build an external makefile and debug its output. A linker plugin will enable the IDE to manage a command line and targets associated with a makefile. The command line is executed when a build step is initiated. The linker plugin will also supply the executable to use for debugging.

    -

    The linker plugin will provide a preference panel named External Build that is used to configure a target. The preference panel provides text fields for you to configure the command line for the target (which will enable building), specify the working directory and the output file used to launch a debugging session, and the debug platform.

    +

    Carbide can build an external makefile and debug its output. A linker plugin enables Carbide to manage a command line and targets associated with a makefile. The command line is executed when a build step is initiated. The linker plugin will also supply the executable to use for debugging.

    +

    The linker plugin provides a preference panel named External Build that is used to configure a target. The preference panel provides text fields for you to configure the command line for the target (which will enable building), specify the working directory and the output file used to launch a debugging session, and the debug platform.

    The linker plugin is generic so that it can be used regardless of the target CPU and OS. The list of available debugger preference panels will be updated by the IDE when you select the debug platform.

    -

    The External Build Target preference panel will collect the following information:

    +

    The External Build Target preference panel collects the following information:

    • Build command line to be executed in the build step
    @@ -38,12 +38,12 @@

    If multiple build steps are performed on the same target, the output from each build step will be appended to the build output window. Each block of output will be separated by “----Build started----” and “----Done----” tags.

    The build output window will allow users to navigate directly to the location of a compilation error. Double-click a line that contains an error message or press Enter when the cursor is in the line. If the IDE determines that a valid error message exists on the selected line, the source file is opened to the line on which the error occurred.

    Click the right mouse button in the build output window to display a context menu.

    +
      +
    • The Copy command copies selected text to the clipboard. If no text is selected then the line that contains the cursor is copied.
    • +
    • The Clear All command clears the contents of output window.
    • +
    • The Go To Error command navigates to the error location. This is identical to double-clicking.
    • +
    -
      -
    • The Copy command will copy selected text to the clipboard. If no text is selected then the line that contains the cursor will be copied.
    • -
    • The Clear All command will clear contents of output window.
    • -
    • The Go To Error command will navigate to the error location. This is identical to double-clicking.
    • -
    diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/images/wnd_workspace_launcher.png Binary file core/com.nokia.carbide.cpp.doc.user/html/concepts/images/wnd_workspace_launcher.png has changed diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/images/workbench.png Binary file core/com.nokia.carbide.cpp.doc.user/html/concepts/images/workbench.png has changed diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/ngage_projects.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/ngage_projects.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/ngage_projects.htm Wed Jun 16 11:39:35 2010 -0500 @@ -17,12 +17,12 @@
  • Install the N-Gage SDK on your PC
  • Place your game project inside the N-Gage SDK
  • In Carbide.c++, click File > Import
  • -
  • Select Symbian OS Bld.inf importer and navigate to your bld.inf file to import it
  • +
  • Select Symbian OS Bld.inf File importer and navigate to your bld.inf file to import it
  • Building the N-Gage project

    Once the game project has been imported, use these steps to create an N-GAGE game file:

      -
    1. Right-click the project and choose Properties to open the Properties for project_name window
    2. +
    3. Right-click the project name and choose Properties to open the Properties for project_name window
    4. In the Carbide.c++ > Carbide Build Configuration > SIS Builder panel, click Add.
    5. In the SIS Properties window:
        @@ -67,10 +67,10 @@

        Debugging the Game project

        With your game file installed on the device, create a launch configuration for the project. In Carbide:

          -
        1. OpenWindow > Preferences > Run/Debug > Launching preference panel and disable the Build (if required) before launching option
        2. -
        3. Right-click the project and choose Debug As > Debug As to open the Debug window
        4. -
        5. Create an Application TRK launch configuration -
            +
          • Open Window > Preferences > Run/Debug > Launching preference panel and disable the Build (if required) before launching option under the General Options group
          • +
          • Right-click the project and choose Debug As > Debug Configuration to open the Debug Cinfigurations window
          • +
          • Create an Symbian OS Application TRK launch configuration +
            • In the Connection tab select the COM port used to connect to the device.
            • In the Installation tab, verify that the game SISX file is correct
            • In the Debug tab, enable the View messges between PC and debug agent on the phone if you want to monitor communications between TRK and Carbide
            • @@ -82,13 +82,13 @@

              The Debugger launches the game project in the device and halts when it encounters the breakpoint you set.

              For Emulator Debugging

              Deploying and debugging the N-Gage project on an emulator

              -

              With your game file installed to the emulator, create a launch configuration for the project. In Carbide:

              +

              With your game file installed on the emulator, create a launch configuration for the project. In Carbide:

                -
              1. Open Window > Preferences > Run/Debug > Launching and disable the Build (if required) before launching option
              2. -
              3. Right-click the project and choose Debug As > Debug As to open the Debug window
              4. +
              5. Open Window > Preferences > Run/Debug > Launching and disable the Build (if required) before launching option under the General Options group
              6. +
              7. Right-click the project and choose Debug As > Debug Configurations to open the Debug Configurations window
              8. Create an Symbian OS Emulation launch configuration
              9. Click Debug to launch the emulator
              10. -
              11. In the emulator, select File > Open, locate and select the .N-GAGE installation file and click Open to install the project
              12. +
              13. In the emulator, select File > Open, locate and select the .N-GAGE installation file and click Open to install the project
              14. Open the Installation folder, launch the N-Gage runtime application
              15. In the N-Gage runtime launch the game
              16. If any breakpoint is hit in the game project, the debugger suspends
              17. diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/templates.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/templates.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/templates.htm Wed Jun 16 11:39:35 2010 -0500 @@ -29,9 +29,8 @@ S60
                • GUI Application
                • -
                • GUI Application with UI Designer
                • -
                • Open C Console application - project template based on industry-standard POSIX and middleware C libraries for S60
                • -
                +
              18. Open C Console application - project template based on industry-standard POSIX and middleware C libraries for S60
              19. +
            Tutorials diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/tour.html --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/tour.html Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/tour.html Wed Jun 16 11:39:35 2010 -0500 @@ -20,7 +20,7 @@ something like this:

            -

            +

            diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/workspaces.htm Wed Jun 16 11:39:35 2010 -0500 @@ -18,7 +18,9 @@

            Workspace Information

            A workspace is the default place to store and create resources like projects, folders, and files. These are then presented to the user in a perspective which enables the presentation and manipulation of the stored resources.

            -

            When Carbide is launched it asks for a workspace to open. As you can have multiple workspaces, all independent from each other, choosing the workspace containing the projects to work on is important. Projects within a workspace are shown in the Carbide workbench within the Project Explorer and C/C++ Project views. When you create a new project it is automatically added to the currently open workspace. You can import existing projects into a workspace from INF files.

            +

            When Carbide is launched it asks for a workspace to open (Figure 1). As you can have multiple workspaces, all independent from each other, choosing the workspace containing the projects to work on is important. Projects within a workspace are shown in the Carbide workbench within the Project Explorer and C/C++ Project views. When you create a new project it is automatically added to the currently open workspace. You can import existing projects into a workspace from INF files.

            +

            Workspace Launcher dialog

            +

            Figure 1. Workspace Launcher dialog

            WARNING Bld.inf imported projects are not copied, so do not delete the contents when deleting the project.

            Projects in one workspace cannot refer to projects in a different workspace. Thus, large projects spanning folders outside of the workspace are not handled at all. Storing all the project files in the workspace makes managing them easier from a project management perspective. Files accessible inside the workspace, like project source and resource files, are better supported than those outside the workspace (for example, SDK headers). Local History, CVS, MMP/bld.inf editors, etc. are available for files inside the workspace but not for those outside the workspace.

            NOTE Carbide automatically updates MMP and INF files as changes are made within the MMP and INF editors.

            diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml --- a/core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml Wed Jun 16 11:39:35 2010 -0500 @@ -6,7 +6,6 @@ - @@ -98,17 +97,6 @@ - - - - - - Specify the Leavescan directory. - - - - - diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/images/views/perspective_debug.png Binary file core/com.nokia.carbide.cpp.doc.user/html/images/views/perspective_debug.png has changed diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/html/reference/perspective_debug.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/perspective_debug.htm Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/perspective_debug.htm Wed Jun 16 11:39:35 2010 -0500 @@ -32,7 +32,7 @@
          • Modules view - uses the Symbolics Loading option to show modules loaded during a debug session
          • Registers view - shows general, FPU, or host-specific registers of the host computer or target device
          -

          +

          Figure 1. Debug perspective used by Carbide.c++

          NOTE Click the icon to show additional options that may not be visible in the perspective view.

          For more information on perspectives see Workbench User Guide > Concepts > Perspectives, and for views see C/C++ Development User Guide > Reference diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/plugin.xml --- a/core/com.nokia.carbide.cpp.doc.user/plugin.xml Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/plugin.xml Wed Jun 16 11:39:35 2010 -0500 @@ -140,9 +140,6 @@ - - diff -r 6c45b7c9cdac -r fb0e02cb252b core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml --- a/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Tue Jun 15 16:19:30 2010 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/tocCarbide.xml Wed Jun 16 11:39:35 2010 -0500 @@ -69,7 +69,6 @@ - @@ -198,6 +197,7 @@ +