/SublimeGDB

GDB integration with Sublime Text 2

Primary LanguagePython

Description

GDB plugin for Sublime Text 2. Filing issues are not welcome (and thus disabled). Pull requests please.

Installation

  1. The easiest way to install SublimeGDB is via the excellent Package Control Plugin
    1. See http://wbond.net/sublime_packages/package_control/installation
      1. Once package control has been installed, bring up the command palette (cmd+shift+P or ctrl+shift+P)
      2. Type Install and select "Package Control: Install Package"
      3. Select SublimeGDB from the list. Package Control will keep it automatically updated for you
    2. If you don't want to use package control, you can manually install it
      1. Go to your packages directory and type:
        1. git clone https://github.com/quarnster/SublimeGDB SublimeGDB
  2. Back in the editor, open up the command palette by pressing cmd+shift+P or ctrl+shift+P
  3. Type SublimeGDB and open up the settings file you want to modify

Usage

See the default key bindings and the default mouse map.

In short:

  • Open up the default settings via the command palette and begin typing GDB and select the default.
  • See what options are available, and open up the User SublimeGDB preferences to tweak any values
  • If you have multiple projects, you most likely want to put project specific setting in your project file, with a prefixed "sublimegdb_". See the comments at the top of the default SublimeGDB preferences for an example.
  • Once you're all configured, you can toggle breakpoints with F9 (OSX Users might want to change the key binding, or disable the "ExposĂ© and Spaces" key bindings in the System Preferences)
  • Launch with F5
  • Step over with F10
  • Step into with F11
  • Step out with Shift+F11
  • Click on the appropriate line in the GDB Callstack view to go to that stack frame
  • Click a variable in the GDB Variables view to show its children (if available)
  • Double click a variable in the GDB Variables view to modify its value
  • You can also access some commands by right clicking in any view

Show your support

Donate

License

This plugin is using the zlib license

Copyright (c) 2012 Fredrik Ehnbom

This software is provided 'as-is', without any express or implied
warranty. In no event will the authors be held liable for any damages
arising from the use of this software.

Permission is granted to anyone to use this software for any purpose,
including commercial applications, and to alter it and redistribute it
freely, subject to the following restrictions:

   1. The origin of this software must not be misrepresented; you must not
   claim that you wrote the original software. If you use this software
   in a product, an acknowledgment in the product documentation would be
   appreciated but is not required.

   2. Altered source versions must be plainly marked as such, and must not be
   misrepresented as being the original software.

   3. This notice may not be removed or altered from any source
   distribution.