KDevelop User Manual<br><br>1 WhatThis ManualContains<br>2 Getting Startedwith KDevelop — a GuidedTour 3<br>2.1 AVeryFirstLook at KDevelop . . . . . . . . . . . . . . . . . . . 4<br>2.1.1 OntheSurface . . . . . . . . . . . . . . . . . . . . . . . . 4<br>2.1.2 HowtoGetSomeHelp . . . . . . . . . . . . . . . . . . . 5<br>2.1.3 Whatis inthemenus? . . . . . . . . . . . . . . . . . . . . 6<br>2.1.4 Whatarethosetool viewsfor? . . . . . . . . . . . . . . . 8<br>2.2 ABit of Configuration . . . . . . . . . . . . . . . . . . . . . . . . 10<br>2.2.1 SomeGeneralSettings . . . . . . . . . . . . . . . . . . . . 10<br>2.2.2 InitializingDocumentation Search Indexes . . . . . . . . 12<br>2.3 StartingaNewProject . . . . . . . . . . . . . . . . . . . . . . . . 14<br>2.3.1 HowtoCreatea New Project . . . . . . . . . . . . . . . . 15<br>2.3.2 Initial ProjectFiles . . . . . . . . . . . . . . . . . . . . . . 17<br>2.3.2.1 CopyrightIssues . . . . . . . . . . . . . . . . . . 18<br>2.3.2.2 InitialSource Files . . . . . . . . . . . . . . . . . 19<br>2.3.2.3 InitialApplication Documentation . . . . . . . 20<br>2.3.2.4 Projectand Auxiliary Files . . . . . . . . . . . . 20<br>2.3.3 Additional Tool Views . . . . . . . . . . . . . . . . . . . . 21<br>2.3.3.1 Navigation andSelection Tools(leftside) . . . . 22<br>2.3.3.2 Messages(bottom) . . . . . . . . . . . . . . . . . 22<br>2.3.3.3 SourceManagement(rightside) . . . . . . . . . 22<br>2.4 SomeTipsAboutDealingWithDocuments . . . . . . . . . . . . 23<br>2.4.1 SwitchingBetween HeaderandImplementation Files . . 23<br>2.4.2 HowtoAccess Declarationsand Definitions . . . . . . . 24<br><br>KDevelopUserManual<br>2.4.2.1 ExternalDeclarations and Definitions . . . . . . 25<br>2.4.2.2 ProjectInternal Declarations andDefinitions . . 26<br>2.4.3 ArrangingEditor Windows . . . . . . . . . . . . . . . . . 29<br>2.4.3.1 CleaninguptheTabsRow . . . . . . . . . . . . 29<br>2.4.3.2 HowtoRearrange EditWindowTabs . . . . . . 30<br>2.4.3.3 ViewingSeveral FilesSimultaneously . . . . . . 31<br>2.4.3.4 EditC++SourceandHeaderFilesSimultaneously 32<br>2.4.3.5 GroupingSourceFilesIntoDevelopmentSessions 34<br>2.4.4 Keeping anEye onCommonProblems . . . . . . . . . . 36<br>2.5 How toCompileaProject . . . . . . . . . . . . . . . . . . . . . . 38<br>2.5.1 The BasicBuild Cycle . . . . . . . . . . . . . . . . . . . . 39<br>2.5.1.1 Initialize the Projectfor theBuild . . . . . . . . 39<br>2.5.1.2 InitialHello Configuration . . . . . . . . . . . . 41<br>2.5.1.3 Build the Project . . . . . . . . . . . . . . . . . . 43<br>2.5.1.4 RuntheApplication . . . . . . . . . . . . . . . . 44<br>2.5.2 Configuring the Project . . . . . . . . . . . . . . . . . . . 45<br>2.5.2.1 Build Configurations . . . . . . . . . . . . . . . 45<br>2.5.2.2 ProjectConfigureOptions . . . . . . . . . . . . 47<br>2.5.2.2.1 General ConfigurationSettings . . . . 49<br>2.5.2.2.2 Compiler Specific Settings . . . . . . . 49<br>2.5.2.3 HowMake ShouldBuild the Program . . . . . 51<br>2.5.2.4 HowtoRun the Executable . . . . . . . . . . . . 52<br>2.6 How toExtendaProject—the Automake Manager . . . . . . . 54<br>2.6.1 AShortLookat the AutomakeMachinery . . . . . . . . 55<br>2.6.2 HowtoPlace Icons inaSeparateDirectory . . . . . . . . 55<br>2.6.3 HowtoAdd New Classes . . . . . . . . . . . . . . . . . . 55<br>2.6.4 Whatis ina Subproject? . . . . . . . . . . . . . . . . . . . 55<br>2.6.4.1 Concentrate onYour Work — the Active Target 55<br>2.6.5 SomeSteps to Restructure aProject . . . . . . . . . . . . 55<br>2.7 How toDebug . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55<br>2.8 ANoteonYourProject Documentation . . . . . . . . . . . . . . 55<br>2.9 LastBut NotLeast,KeyboardShortcuts . . . . . . . . . . . . . . 56<br>2.10 Wheretogofromhere . . . . . . . . . . . . . . . . . . . . . . . . 56<br>2.10.1 Frequently EncounteredProblems . . . . . . . . . . . . . 56<br>2.10.2 WorkingWithProjects . . . . . . . . . . . . . . . . . . . . 56<br>2.10.2.1 UsingExistingKDevelop Projects . . . . . . . . 56<br>2.10.2.2 Importing ExternalProjects . . . . . . . . . . . 57<br>4<br><br>KDevelopUserManual<br>3 OverviewofKDevelopFeatures 58<br>3.1 AvailableUserInterface Modes . . . . . . . . . . . . . . . . . . . 59<br>3.1.1 HowtoSwitch User Interface Modes . . . . . . . . . . . 60<br>3.1.2 HowtoMaximizetheWorkSpaceArea . . . . . . . . . . 60<br>3.2 ElementsoftheUser Interface . . . . . . . . . . . . . . . . . . . . 61<br>3.2.1 The Workarea . . . . . . . . . . . . . . . . . . . . . . . . . 61<br>3.2.2 The KDevelop Titlebar . . . . . . . . . . . . . . . . . . . . 61<br>3.2.3 The KDevelop Statusbar . . . . . . . . . . . . . . . . . . . 61<br>3.2.4 The menubar . . . . . . . . . . . . . . . . . . . . . . . . . 61<br>3.2.5 The Toolbars . . . . . . . . . . . . . . . . . . . . . . . . . . 61<br>3.2.6 The Tree Tool Views . . . . . . . . . . . . . . . . . . . . . 61<br>3.2.7 The OutputToolViews . . . . . . . . . . . . . . . . . . . 62<br>3.3 ProjectManagementSystems . . . . . . . . . . . . . . . . . . . . 62<br>3.3.1 AutomakeProjects . . . . . . . . . . . . . . . . . . . . . . 62<br>3.3.2 QMake Projects . . . . . . . . . . . . . . . . . . . . . . . . 62<br>3.3.3 CMake Projects . . . . . . . . . . . . . . . . . . . . . . . . 62<br>TM<br>3.3.4 ANT Projects (Java Projects) . . . . . . . . . . . . . . . 63<br>3.3.5 CustomProjects . . . . . . . . . . . . . . . . . . . . . . . . 63<br>3.3.6 HowtoDistributeYour Application . . . . . . . . . . . . 63<br>4 ConfiguringKDevelop 64<br>4.1 GeneralConfiguration . . . . . . . . . . . . . . . . . . . . . . . . 66<br>4.1.1 General Setup . . . . . . . . . . . . . . . . . . . . . . . . . 66<br>4.1.2 Selectingthe UserInterface . . . . . . . . . . . . . . . . . 70<br>4.1.3 File Templates . . . . . . . . . . . . . . . . . . . . . . . . . 75<br>4.1.4 Selectingan Editor . . . . . . . . . . . . . . . . . . . . . . 75<br>4.1.5 Abbreviations for the WordCompletion . . . . . . . . . . 77<br>4.1.6 Scripting . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77<br>4.1.7 AddingKDEStandardApplications totheTools Menu . 77<br>4.1.8 AddingExternal Applicationsto Menus . . . . . . . . . . 77<br>4.1.8.1 Adding to the ToolsMenu . . . . . . . . . . . . 77<br>4.1.8.2 Adding to the File Context Menu . . . . . . . . 77<br>4.1.8.3 Adding to the Directory Context Menu . . . . . 77<br>4.1.9 SelectingaSourceFormat Style . . . . . . . . . . . . . . . 77<br>5<br><br>KDevelopUserManual<br>4.1.9.1 General Formatting Setup . . . . . . . . . . . . 78<br>4.1.9.2 IndentationStyleSetup . . . . . . . . . . . . . . 79<br>4.1.9.3 Other FormattingSetup . . . . . . . . . . . . . . 82<br>4.1.10 SettingUptheCode SnippetsTool . . . . . . . . . . . . . 84<br>4.1.11 File List . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85<br>4.1.12 Configuring the File Selector . . . . . . . . . . . . . . . . 85<br>4.1.13 C++ ClassGenerator . . . . . . . . . . . . . . . . . . . . . 89<br>4.1.14 Formatting . . . . . . . . . . . . . . . . . . . . . . . . . . . 89<br>4.1.15 C++ Parsing . . . . . . . . . . . . . . . . . . . . . . . . . . 89<br>4.2 ConfiguringtheDocumentation . . . . . . . . . . . . . . . . . . . 89<br>4.2.1 SettingUpDocumentation Collections . . . . . . . . . . 91<br>4.2.1.1 CommonDocumentation Setup Structure . . . 92<br>TM<br>4.2.1.2 Qt DocumentationCollections . . . . . . . . 93<br>4.2.1.3 SettingUptheCHMDocumentation Collection 95<br>4.2.1.4 Documentation Generatedby Doxygen . . . . . 95<br>4.2.1.5 Handling Structured Documentation (KDevel-<br>opTOC Files) . . . . . . . . . . . . . . . . . . . . 98<br>4.2.1.6 KDevelop TOC Files . . . . . . . . . . . . . . . . 100<br>4.2.1.7 DevHelpDocumentation . . . . . . . . . . . . . 101<br>4.2.1.8 SettingUpCustom DocumentationCollections 102<br>4.2.2 SettingUpTextSearch Indexes . . . . . . . . . . . . . . . 103<br>4.2.3 OtherDocumentationConfiguration Settings . . . . . . . 104<br>4.3 AdvancedConfiguration . . . . . . . . . . . . . . . . . . . . . . . 104<br>4.3.1 PluginTools . . . . . . . . . . . . . . . . . . . . . . . . . . 104<br>5 Getting Started—theApplicationWizard 105<br>5.1 New Projects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105<br>5.1.1 Initial Steps . . . . . . . . . . . . . . . . . . . . . . . . . . 106<br>5.1.1.1 SelectProgrammingLanguageandApplication<br>107<br>Type . . . . . . . . . . . . . . . . . . . . . . . . .<br>5.1.1.2 Provide General Information . . . . . . . . . . . 108<br>5.1.2 Supply Version SystemInformation . . . . . . . . . . . . 111<br>5.1.3 Supply Header/SourceTemplates . . . . . . . . . . . . . 115<br>5.1.3.1 HowtoEdit the Templates . . . . . . . . . . . . 116<br>5.1.4 Build the InitialProjectFiles . . . . . . . . . . . . . . . . . 118<br>5.2 ConfiguringProjects . . . . . . . . . . . . . . . . . . . . . . . . . 119<br>6<br><br>KDevelopUserManual<br>6 EditingTools 120<br>6.1 CodeSnippets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120<br>6.2 KeyboardMapping . . . . . . . . . . . . . . . . . . . . . . . . . . 120<br>6.3 TheProblemReporter . . . . . . . . . . . . . . . . . . . . . . . . 121<br>6.4 SearchingandGrepping . . . . . . . . . . . . . . . . . . . . . . . 121<br>6.4.1 SearchingforText . . . . . . . . . . . . . . . . . . . . . . . 121<br>6.4.2 ISearch . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121<br>6.4.3 Grep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122<br>6.5 CodeCompletion . . . . . . . . . . . . . . . . . . . . . . . . . . . 123<br>6.6 Creating New Filesand Classes . . . . . . . . . . . . . . . . . . . 123<br>6.6.1 EditingtheTemplates . . . . . . . . . . . . . . . . . . . . 123<br>7 TheFile Browsers 124<br>8 TheClassBrowsers 126<br>8.1 Class View . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126<br>8.2 Class Tools . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128<br>8.3 Class Hierarchy . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128<br>9 Documentation 129<br>9.1 TheDocumentation Browser . . . . . . . . . . . . . . . . . . . . 129<br>10 Buildingand ProjectManagement 131<br>10.1 Summary of Automake Manager . . . . . . . . . . . . . . . . . . 131<br>10.1.1 The Needfor an Automated BuildSystem . . . . . . . . 132<br>10.1.2 Tutorials on Autoconf/Automake/Libtool . . . . . . . . 133<br>10.1.3 WhatdoesAutomake ManagerDo? . . . . . . . . . . . . 133<br>10.1.4 SummaryofWhatAutomakeManagerDoes . . . . . . . 135<br>10.1.5 ContentsofAutomake Files . . . . . . . . . . . . . . . . . 135<br>10.2 AutomakeManagerOperation . . . . . . . . . . . . . . . . . . . 136<br>10.2.1 The Automake Manager Window . . . . . . . . . . . . . 137<br>10.2.2 The OverallViewWindow . . . . . . . . . . . . . . . . . 139<br>10.2.3 The Detail View Window . . . . . . . . . . . . . . . . . . 139<br>10.2.3.1 Targets . . . . . . . . . . . . . . . . . . . . . . . 140<br>10.2.4 Navigatingin the Automake Manager . . . . . . . . . . . 140<br>10.2.5 Popup Menusin the AutomakeManager . . . . . . . . . 141<br>7<br><br>KDevelopUserManual<br>10.2.5.1 The PopupMenuforaFile . . . . . . . . . . . . 141<br>10.2.5.2 The PopupMenuforaTarget . . . . . . . . . . 142<br>10.2.5.3 The PopupMenuforaSubproject . . . . . . . . 143<br>10.3 AutomakeProjects . . . . . . . . . . . . . . . . . . . . . . . . . . 145<br>10.3.1 Autoconf . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145<br>10.3.2 Automake . . . . . . . . . . . . . . . . . . . . . . . . . . . 145<br>10.3.3 KDevelop’sAutomakeManager . . . . . . . . . . . . . . 145<br>10.3.4 BuildingandInstalling Libraries . . . . . . . . . . . . . . 145<br>10.4 Custom Makefiles and Build Scripts . . . . . . . . . . . . . . . . 147<br>10.5 Compiler Options . . . . . . . . . . . . . . . . . . . . . . . . . . . 147<br>10.6 MakeOptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 147<br>11 AdvancedBuild Management 148<br>11.1 MultipleBuildConfigurations . . . . . . . . . . . . . . . . . . . . 148<br>11.2 Cross-Compiling . . . . . . . . . . . . . . . . . . . . . . . . . . . 148<br>11.3 Qt/Embedded . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149<br>12 TheDebugger Interface 150<br>12.1 SettingBreakpoints . . . . . . . . . . . . . . . . . . . . . . . . . . 152<br>12.2 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152<br>13 UsingCVS 153<br>13.1 CVSBasics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153<br>13.2 CVSCommandsinKDevelop . . . . . . . . . . . . . . . . . . . . 154<br>13.3 Behind the Scenes . . . . . . . . . . . . . . . . . . . . . . . . . . . 154<br>13.3.1 WhatCVS Recordsin theWorkingDirectory . . . . . . . 154<br>14 Credits 155<br>14.1 Contributions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 155<br>A Installing KDevelop 156<br>A.1 How toObtain KDevelop . . . . . . . . . . . . . . . . . . . . . . 156<br>A.1.1 GetDailyKDevelop Snapshots from svn . . . . . . . . . 156<br>A.1.1.1 Initialsvn Checkout . . . . . . . . . . . . . . . . 157<br>A.1.1.2 KeepingYour svnCopyuptoDate . . . . . . . 157<br>A.2 KDevelop Requirements . . . . . . . . . . . . . . . . . . . . . . . 158<br>8<br><br>KDevelopUserManual<br>A.3 KDevelop CompilationandInstallation . . . . . . . . . . . . . . 159<br>A.3.1 Preliminary Steps . . . . . . . . . . . . . . . . . . . . . . . 160<br>A.3.1.1 SettingtheEnvironmentfor thebash Shell . . . 160<br>A.3.1.2 SettingtheEnvironmentfor thetcsh Shell . . . 160<br>A.3.2 CompileKDevelop . . . . . . . . . . . . . . . . . . . . . . 160<br>A.3.2.1 Special svn CompilationConsiderations . . . . 161<br>A.3.2.2 Basic makeCommand Sequence . . . . . . . . . 161<br>A.3.3 Some Notes onconfigureOptions . . . . . . . . . . . . . 163<br>A.3.3.1 Non-defaultInstallationDirectory . . . . . . . . 163<br>A.4 How toObtain aKDevelopAPIDocumentation . . . . . . . . . 164<br>B In aNutshell—TipsandTricks 165<br>C DevelopmentonUNIX 168<br>C.1 SomeHistoricalRemarks . . . . . . . . . . . . . . . . . . . . . . . 168<br>C.2 Contemporary Scripting Languages . . . . . . . . . . . . . . . . 169<br>C.2.1 Perl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169<br>C.2.2 Python . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169<br>C.2.3 PHP . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 169<br>C.3 Higher-levelScripting . . . . . . . . . . . . . . . . . . . . . . . . 169<br>C.3.1 The CORBAProtocol . . . . . . . . . . . . . . . . . . . . . 170<br>C.3.2 The DCOPInterface . . . . . . . . . . . . . . . . . . . . . 170<br>C.4 BuildSystems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 170<br>C.4.1 The MakeProcess . . . . . . . . . . . . . . . . . . . . . . . 171<br>C.5 GUI Development . . . . . . . . . . . . . . . . . . . . . . . . . . . 172<br>C.6 IntegratingConceptsandTools –the IDE . . . . . . . . . . . . . 172<br>C.6.1 BasicFeatures of KDevelop3.3.91 . . . . . . . . . . . . . 173<br>D ConfigurationFilesUsed byKDevelop 174<br>D.1 KDevelop Default Configuration . . . . . . . . . . . . . . . . . . 174<br>D.1.1 DefaultKDevelop Configuration . . . . . . . . . . . . . . 174<br>D.1.2 ApplicationSpecificDefaults . . . . . . . . . . . . . . . . 175<br>D.2 UserOrientedConfiguration . . . . . . . . . . . . . . . . . . . . 179<br>D.2.1 ApplicationSpecificConfiguration . . . . . . . . . . . . . 179<br>D.2.2 ResourceConfigurationFiles . . . . . . . . . . . . . . . . 181<br>D.3 ProjectDependentConfiguration . . . . . . . . . . . . . . . . . . 183<br>D.3.1 PersistentCode StoreFiles . . . . . . . . . . . . . . . . . . 183<br>9<br><br>KDevelopUserManual<br>E Plugin Tools 185<br>F KDevelopUserInterface Mode Examples 191<br>F.1 IDEAlMode . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 191<br>F.2 ChildFrameWindows Mode . . . . . . . . . . . . . . . . . . . . 192<br>F.3 Tabbed PagesMode . . . . . . . . . . . . . . . . . . . . . . . . . . 193<br>F.4 ToplevelWindows Mode . . . . . . . . . . . . . . . . . . . . . . . 194<br>G CommandReference 196<br>G.1 TheMenubar . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 196<br>G.1.1 The FileMenu . . . . . . . . . . . . . . . . . . . . . . . . . 196<br>G.1.2 The EditMenu . . . . . . . . . . . . . . . . . . . . . . . . 197<br>G.1.3 The ViewMenu . . . . . . . . . . . . . . . . . . . . . . . . 198<br>G.1.4 The ProjectMenu . . . . . . . . . . . . . . . . . . . . . . . 199<br>G.1.5 The ProjectMenu . . . . . . . . . . . . . . . . . . . . . . . 199<br>G.1.6 The ProjectMenu . . . . . . . . . . . . . . . . . . . . . . . 200<br>G.1.7 The Bookmarks Menu . . . . . . . . . . . . . . . . . . . . 200<br>G.1.8 The Window Menu . . . . . . . . . . . . . . . . . . . . . . 200<br>G.1.9 The ToolsMenu . . . . . . . . . . . . . . . . . . . . . . . . 201<br>G.1.10 The Settings Menu . . . . . . . . . . . . . . . . . . . . . . 202<br>G.1.11 The Help Menu . . . . . . . . . . . . . . . . . . . . . . . . 202<br>H FurtherInformation 203<br>H.1 GettingInformation . . . . . . . . . . . . . . . . . . . . . . . . . . 203<br>H.2 ReportingBugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203<br>H.3 Licensing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 203<br>I Changes 204<br>I.1 ChangestoThis Document . . . . . . . . . . . . . . . . . . . . . 204<br>J Bibliography 205<br>J.0.0.0.0.1 Bibliography . . . . . . . . . . . 205<br>K Index 207





剩余222页未读,继续阅读
















评论0