# HG changeset patch # User timkelly # Date 1246377018 18000 # Node ID d40e42540f1f7da958dca9f89d3531cf9db7d189 # Parent 4c93a2b1f48122263a223629b6d6cd8ab8f86520 add documentation and hook up tray dialog for abld deps tracking query (bug 9227) diff -r 4c93a2b1f481 -r d40e42540f1f builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/CarbideCPPBuilderUIHelpIds.java --- a/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/CarbideCPPBuilderUIHelpIds.java Tue Jun 30 10:49:24 2009 -0500 +++ b/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/CarbideCPPBuilderUIHelpIds.java Tue Jun 30 10:50:18 2009 -0500 @@ -32,4 +32,5 @@ public static final String CARBIDE_BUILDER_SIS_DIALOG = CarbideBuilderPlugin.PLUGIN_ID + ".builder_sis_dialog"; //$NON-NLS-1$ public static final String CARBIDE_BUILDER_MMP_CHANGED_ACTION_DIALOG = CarbideBuilderPlugin.PLUGIN_ID + ".builder_mmp_changed_action_dialog"; //$NON-NLS-1$ public static final String CARBIDE_BUILDER_MMP_SELECTION_DIALOG = CarbideBuilderPlugin.PLUGIN_ID + ".builder_mmp_selection_dialog"; //$NON-NLS-1$ + public static final String CARBIDE_BUILDER_TRACK_DEPENDENCIES_QUERY_DIALOG = CarbideBuilderPlugin.PLUGIN_ID + ".dependency_tracking_dialog"; //$NON-NLS-1$ } diff -r 4c93a2b1f481 -r d40e42540f1f builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/TrackDependenciesQueryDialog.java --- a/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/TrackDependenciesQueryDialog.java Tue Jun 30 10:49:24 2009 -0500 +++ b/builder/com.nokia.carbide.cdt.builder/src/com/nokia/carbide/cdt/internal/builder/ui/TrackDependenciesQueryDialog.java Tue Jun 30 10:50:18 2009 -0500 @@ -25,6 +25,7 @@ import org.eclipse.swt.layout.GridData; import org.eclipse.swt.layout.GridLayout; import org.eclipse.swt.widgets.*; +import org.eclipse.ui.PlatformUI; import com.nokia.carbide.cdt.builder.BuilderPreferenceConstants; import com.nokia.carbide.cdt.builder.CarbideBuilderPlugin; @@ -57,6 +58,7 @@ public TrackDependenciesQueryDialog(Shell shell, ICarbideProjectInfo cpi) { super(shell); this.cpi = cpi; + setShellStyle(getShellStyle() | SWT.RESIZE); } /** @@ -113,6 +115,7 @@ */ protected void configureShell(Shell shell) { super.configureShell(shell); + PlatformUI.getWorkbench().getHelpSystem().setHelp(shell, CarbideCPPBuilderUIHelpIds.CARBIDE_BUILDER_TRACK_DEPENDENCIES_QUERY_DIALOG); shell.setText("Project rebuild notification"); //$NON-NLS-1$ } diff -r 4c93a2b1f481 -r d40e42540f1f core/com.nokia.carbide.cpp.doc.user/html/concepts/dependency_tracking.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/concepts/dependency_tracking.htm Tue Jun 30 10:49:24 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/concepts/dependency_tracking.htm Tue Jun 30 10:50:18 2009 -0500 @@ -1,22 +1,31 @@ - - - - - - -Dependency Tracking - - - -

Dependency Tracking

-

blah blah blah

-

 

-

Figure 1 -Dependency Tracking dialog

-
Related references
- - - - - + + + + + + +Dependency Tracking + + + + +

Dependency Tracking

+

This section only applies to the SBSv1 (abld) build system. If you are using the Raptor (SBSv2) build system Carbide does not perform any build system modifications to optimize dependency tracking.

+

Carbide has made some performance improvements over command-line builds when performing incremental builds. Once a project has been built, many users will invoke 'abld build' on their project, not knowing that their makefiles will be regenerated each time, taking a large performance hit. Although a command-line user can invoke 'abld target' to improve incremental build performance, Carbide invokes each build stage independently for a full incremental build (including the 'abld makefile' stage). In order to get around this performance hit from the IDE, Carbide manages the source and resource dependencies in separate .d (dependency) files generated under the build system. Then Carbide makes a small modification to each component's (MMP) makefile under the \epoc32\build\ directory by including the generated .d files as dependency includes. This performance modification makes incremental builds faster from Carbide.

+

Normally, you do not need to know the details dependency management unless you first build from the command-line and then try to build their project from the IDE. When this happens, Carbide will prompt you with the following dialog when you initiate a build from the IDE.

+

+

Figure 1 -Dependency Tracking dialog

+

If you plan to continue building in Carbide it is recommended you choose the option to Improve Carbide build times. However, be cautious of this as Carbide will remove all the object code and build everything from scratch. If you do choose the option Do not update dependencies, then Carbide will disable the option to manage dependencies under the Carbide Project Settings, SBSv1 tab.

+
Related references
+ + + + + diff -r 4c93a2b1f481 -r d40e42540f1f 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 30 10:49:24 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/context_help/carbide_ide_dialogs_help.xml Tue Jun 30 10:50:18 2009 -0500 @@ -76,10 +76,8 @@ Managing makefile dependencies - + - - diff -r 4c93a2b1f481 -r d40e42540f1f core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_build_prefs.htm --- a/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_build_prefs.htm Tue Jun 30 10:49:24 2009 -0500 +++ b/core/com.nokia.carbide.cpp.doc.user/html/reference/wnd_build_prefs.htm Tue Jun 30 10:50:18 2009 -0500 @@ -90,6 +90,10 @@ + + Do not offer to track dependencies for projects build on command-line + If you build a project from the command-line (with 'abld build') and then import the project into Carbide and attempt to build, Carbide will prompt you if you would like Carbide to manage source dependencies for you. Enabling this option insures Carbide will not ask you to manage dependencies (they will be done as normally done via 'abld build' command). +

 

sbsv2 tab