src/geany.h

   1 /*
   2  *      geany.h - this file is part of Geany, a fast and lightweight IDE
   3  *
   4  *      Copyright 2005-2010 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
   5  *      Copyright 2006-2010 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
   6  *
   7  *      This program is free software; you can redistribute it and/or modify
   8  *      it under the terms of the GNU General Public License as published by
   9  *      the Free Software Foundation; either version 2 of the License, or
  10  *      (at your option) any later version.
  11  *
  12  *      This program is distributed in the hope that it will be useful,
  13  *      but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  *      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15  *      GNU General Public License for more details.
  16  *
  17  *      You should have received a copy of the GNU General Public License
  18  *      along with this program; if not, write to the Free Software
  19  *      Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
  20  *
  21  * $Id$
  22  */
  23
  24 /* Main header - should be included first in all source files.
  25  * externs and function prototypes are implemented in main.c. */
  26
  27 #ifndef GEANY_H
  28 #define GEANY_H
  29
  30 #ifdef HAVE_CONFIG_H
  31 #  include <config.h>
  32 #endif
  33
  34 #include <gtk/gtk.h>
  35
  36 #include "tm_tagmanager.h"
  37
  38 #ifndef PLAT_GTK
  39 #   define PLAT_GTK 1   /* needed when including ScintillaWidget.h */
  40 #endif
  41
  42 /* Compatibility for sharing macros between API and core, overridden in plugindata.h */
  43 #define GEANY(symbol_name) symbol_name
  44
  45
  46 /* for detailed description look in the documentation, things are not
  47  * listed in the documentation should not be changed */
  48 #define GEANY_FILEDEFS_SUBDIR                   "filedefs"
  49 #define GEANY_TEMPLATES_SUBDIR                  "templates"
  50 #define GEANY_CODENAME                                  "Vellam"
  51 #define GEANY_HOMEPAGE                                  "http://www.geany.org/"
  52 #define GEANY_STRING_UNTITLED                   _("untitled")
  53 #define GEANY_DEFAULT_DIALOG_HEIGHT             350
  54 #define GEANY_WINDOW_DEFAULT_WIDTH              900
  55 #define GEANY_WINDOW_DEFAULT_HEIGHT             600
  56
  57
  58
  59 /* Common forward declarations */
  60 typedef struct GeanyDocument GeanyDocument;
  61 typedef struct GeanyEditor GeanyEditor;
  62 typedef struct GeanyFiletype GeanyFiletype;
  63
  64
  65 /** Important application fields. */
  66 typedef struct GeanyApp
  67 {
  68         gboolean                        debug_mode;             /**< @c TRUE if debug messages should be printed. */
  69         /** User configuration directory, usually @c ~/.config/geany.
  70          * This is a full path read by @ref tm_get_real_path().
  71          * @note Plugin configuration files should be saved as:
  72          * @code g_build_path(G_DIR_SEPARATOR_S, geany->app->configdir, "plugins", "pluginname",
  73          *      "file.conf"); @endcode */
  74         gchar                           *configdir;
  75         gchar                           *datadir;
  76         gchar                           *docdir;
  77         const TMWorkspace       *tm_workspace;  /**< TagManager workspace/session tags. */
  78         struct GeanyProject     *project;               /**< Currently active project or @c NULL if none is open. */
  79 }
  80 GeanyApp;
  81
  82 extern GeanyApp *app;
  83
  84 extern GObject *geany_object;
  85
  86
  87 extern gboolean ignore_callback;
  88
  89
  90 /* prototype is here so that all files can use it. */
  91 void geany_debug(gchar const *format, ...) G_GNUC_PRINTF (1, 2);
  92
  93
  94 #ifndef G_GNUC_WARN_UNUSED_RESULT
  95 #define G_GNUC_WARN_UNUSED_RESULT
  96 #endif
  97
  98 #endif