Getting started with Komodo is as easy as opening a file and beginning to edit. However, to ensure that you don't miss any of Komodo's features, take a look at the components of the Komodo workspace described below.
Next, Get Started Fast with Komodo's Sample Project. Use the Sample Project to familiarize yourself with Komodo's project management, editing features and debugging functionality.
From within the Windows environment, use one of the following methods to launch Komodo:
To start Komodo from a command prompt, enter:
komodo [options] [filenames]
Multiple filenames may be specified; all specified filenames will be loaded in the Komodo editor pane.
The following command-line options are available:
From within the OS X environment, use one of the following methods to launch Komodo:
To start Komodo from the Terminal:
If you want to start to Komodo from the command line, it is best to first create the following symlink:
ln -s /Applications/Komodo.app/MacOS/komodo /usr/bin/komodo
You can also link to /usr/local/bin/komodo if /usr/local/bin is in your PATH environment variable.
Once the symlink is created, the following syntax applies:
komodo [options] [filenames]
The same options described in the Windows command prompt section above are valid.
To start Komodo from a shell prompt, enter:
komodo [options] [filenames]
The same options described in the Windows command prompt section above apply.
Desktop icons and taskbar applets are not added automatically during installation on Unix. Check your window manager documentation for information on creating these manually. A choice of Komodo icons is available. By default, the icon files (.xpm) are stored in the Komodo installation directory.
Komodo's Start Page is displayed by default when Komodo is first opened, and the Start Page tab persists when other files are opened. The Start Page provides quick access to recently opened files and projects. By default, the Start Page also displays links to tutorials and Komodo's Sample Project, as well as the Tip of the Day. Select Edit|Preferences|Appearance to change the contents of the Start Page, or to configure the number of recent files and projects.
To clear the names of selected files or projects from the Start Page, check the boxes next to the filenames, then click Remove. To clear the complete list of files or projects, click the "X" button at the top right of each list.
The title bar displays the path and name of the active file. During debugging, the title bar indicates the state of the debugger. See Debugging Programs for more information.
The default drop-down menus are: File, Edit, Code, View, Debug, Project, Toolbox, Tools, Window, and Help. The functions accessed from each menu are described in detail in the relevant section of the User Guide. For example, the items accessed from the Debug menu are described in Debugging Programs.
Note: On Mac OS X systems, a menu labelled Komodo is displayed to the left of the File menu. On OS X, Komodo's Preferences dialog box is accessed by clicking Komodo|Preferences.
Komodo displays right-click context menus with options relative to the area of Komodo where the option was invoked, depending the location of the mouse pointer. Use the left mouse button to select items from context menus.
To hide or show toolbars, or to hide or show button text, do one of the following:
The Standard Toolbar provides quick access to common editing functions. Launch the Komodo User Guide by clicking the Help button.
The Tools Toolbar contains the commonly used commands on the Tools menu, including Preview in Browser, the Regular Expression Toolkit, the Visual Package Manager (VPM), the interactive shell, and the Object Browser.
The Workspace Toolbar toggles the main components of the Komodo workspace. Use this toolbar to show/hide the Left Pane, Bottom Pane and Right Pane, and to display or shift focus to a specific tab in one of these panes (e.g. the Toolbox tab).
The Debug Toolbar provides quick access to common debugging functions, such as Step In and Step Over. For more information about debugging programs, see Debugging Programs.
Use the Open/Find Toolbar to open files and search for strings. Find strings in files currently displayed in the editor or in files not currently open in Komodo but located on the filesystem. See Open/Find Toolbar for more information.
The Source Code Control Toolbar (available only in the Professional Edition of Komodo) makes it easy to work with files that are stored in Perforce or CVS. For more about using the Source Code Control Toolbar, see Source Code Control (Komodo Pro).
The Macros Toolbar makes it easier to record, play and save macros. For more information see Macros.
For users of PDK 6.0 and later, the PDK Toolbar provides quick access to Perl Dev Kit tools. Buttons for launching the core PDK tools (PerlApp, PerlSvc, PerlCtrl and PerlTray) are grayed out unless a Perl file is the active file in the Editor Pane. Availability of buttons also depends on which features are included in the currently installed PDK package. If the PDK is not installed on your system, all toolbar options are grayed out when the PDK Toolbar is displayed. For more information on how the PDK integates with Komodo, see Komodo and the Perl Dev Kit. The PDK is not available on Komodo for Mac OS X.
The Left Pane of the Komodo workspace contains the Projects tab and the Code tab.
The Projects tab displays projects that are currently open. Hide or display the components contained in a project by clicking the plus sign to the left of the project name. To display the Projects tab, select View|Tabs|Projects, or use the associated key binding.
The Code tab displays a hierarchical view of all code symbols (for example, variables, methods, imports) in an open file. Symbols can be sorted and filtered, and the current scope of a symbol can be located. The lower part of the Code Browser provides additional documentation (when available) on program components. To display the Code tab, select View|Tabs|Projects, or use the associated key binding.
Use the Toolbox tab to manage and store Komodo components (for example, frequently used files, code snippets, commands, and URLs). Add items to the Toolbox, as well as to folders within the Toolbox. Items can be imported to the Toolbox and exported as Komodo project files and packages. Items added to the Toolbox are displayed with associated icons for easy identification. To display the Toolbox tab, select View|Tabs|Toolbox, or use the associated key binding.
A Shared Toolbox has the same functionality as the Toolbox except that it can be shared among multiple users. For example, use a Shared Toolbox to store code snippets that are frequently used by a number of programmers. The Toolbox tab is only available if the Shared Toolbox preference has been set (select Edit|Preferences|Shared Support, or, on Mac OS X, select Komodo|Preferences|Shared Support).
The large pane in the middle of the Komodo workspace is the Editor Pane. The Editor Pane is used for editing and debugging. Each open file has a corresponding tab at the top of the Editor Pane. Change the order of the tabs by clicking and dragging tabs to the desired position. The name of the active file (that is, the file that is currently displayed in the Editor Pane) is displayed in bold text. Use the left and right arrow buttons on the right side of the tabs to scroll though open files. Use the close button "X" on the right side of the tab display to close the active file. An asterisk beside the filename indicates that the file has been changed since it was opened, and needs to be saved. If a file is under source code control, a file status icon to the left of the filename indicates its current status.
The Bottom Pane spans the width of the Komodo workspace and displays at the bottom of the screen. The Bottom Pane contains the following tabs:
Use the View menu, Standard Toolbar or Komodo key bindings to choose which tabs are displayed in the Komodo workspace. Use the Standard Toolbar to show and hide the Left Pane, Right Pane and Bottom Pane.
To display a tab in the Left Pane, Right Pane or Bottom Pane, select View|Tabs|<TabName>, or see Komodo's default key bindings (Help|List Key Bindings) for the appropriate keyboard shortcut. Alternatively, click the Show Specific Tab button on the Standard Toolbar.
To show and hide the Left Pane, Right Pane or Bottom Pane, click the associated button on the Standard Toolbar. Click the close arrow in the top right corner of a pane to close it.
When you are focusing on coding alone, you may want to maximize the Editor Pane. To increase the size of the Editor Pane, hide the Left Pane and the Right Pane. The Left, Right and Bottom Panes can be resized by clicking and dragging.
To take advantage of as much of the Komodo workspace as possible, select View|Full Screen. When Full Screen mode is enabled, the workspace is maximized, and the toolbars and status bar are hidden. To restore the previous view, select View|Full Screen again.
Komodo's sample project includes a number of programs in different languages. Use these sample programs to familiarize yourself with Komodo's functionality.
To open a sample program, double-click the file name on the Projects tab. The contents of the file will display in the Editor Pane.
Komodo provides debugging support for Perl, Python, PHP, Tcl and XSLT. Komodo works with the core language distribution for Perl, Python and PHP to provide interpreter support. XSLT, on the other hand, is entirely self-contained. To debug the sample files for Perl, Python, PHP and Tcl, you must configure the location of the language interpreter. See Configuring the Perl Debugger, Configuring the Python Debugger, Configuring the Tcl Debugger, or Debugging PHP for instructions. Then open the sample file for the desired language, and view the comments in the "Debugging" section. General debugging functionality is discussed below.