src/geany.h

   1 /*
   2  *      geany.h - this file is part of Geany, a fast and lightweight IDE
   3  *
   4  *      Copyright 2005-2011 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
   5  *      Copyright 2006-2011 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
  22 /* Main header - should be included first in all source files.
  23  * externs and function prototypes are implemented in main.c. */
  24
  25 #ifndef GEANY_H
  26 #define GEANY_H
  27
  28 #if defined(HAVE_CONFIG_H) && defined(GEANY_PRIVATE)
  29 #       include "config.h"
  30 #endif
  31
  32 #include <gtk/gtk.h>
  33
  34 #include "tm_tagmanager.h"
  35
  36 #ifndef PLAT_GTK
  37 #   define PLAT_GTK 1   /* needed when including ScintillaWidget.h */
  38 #endif
  39
  40 /* Compatibility for sharing macros between API and core, overridden in plugindata.h */
  41 #define GEANY(symbol_name) symbol_name
  42
  43
  44 /* for detailed description look in the documentation, things are not
  45  * listed in the documentation should not be changed */
  46 #define GEANY_FILEDEFS_SUBDIR                   "filedefs"
  47 #define GEANY_TEMPLATES_SUBDIR                  "templates"
  48 #define GEANY_CODENAME                                  "Tavira"
  49 #define GEANY_HOMEPAGE                                  "http://www.geany.org/"
  50 #define GEANY_WIKI                                              "http://wiki.geany.org/"
  51 #define GEANY_BUG_REPORT                                "http://www.geany.org/Support/Bugs"
  52 #define GEANY_DONATE                                    "https://sourceforge.net/donate/index.php?group_id=153444"
  53 #define GEANY_STRING_UNTITLED                   _("untitled")
  54 #define GEANY_DEFAULT_DIALOG_HEIGHT             350
  55 #define GEANY_WINDOW_DEFAULT_WIDTH              900
  56 #define GEANY_WINDOW_DEFAULT_HEIGHT             600
  57
  58
  59
  60 /* Common forward declarations */
  61 typedef struct GeanyDocument GeanyDocument;
  62 typedef struct GeanyEditor GeanyEditor;
  63 typedef struct GeanyFiletype GeanyFiletype;
  64
  65
  66 /** Important application fields. */
  67 typedef struct GeanyApp
  68 {
  69         gboolean                        debug_mode;             /**< @c TRUE if debug messages should be printed. */
  70         /** User configuration directory, usually @c ~/.config/geany.
  71          * This is a full path read by @ref tm_get_real_path().
  72          * @note Plugin configuration files should be saved as:
  73          * @code g_build_path(G_DIR_SEPARATOR_S, geany->app->configdir, "plugins", "pluginname",
  74          *      "file.conf", NULL); @endcode */
  75         gchar                           *configdir;
  76         gchar                           *datadir;
  77         gchar                           *docdir;
  78         const TMWorkspace       *tm_workspace;  /**< TagManager workspace/session tags. */
  79         struct GeanyProject     *project;               /**< Currently active project or @c NULL if none is open. */
  80 }
  81 GeanyApp;
  82
  83 extern GeanyApp *app;
  84
  85 extern GObject *geany_object;
  86
  87
  88 extern gboolean ignore_callback;
  89
  90
  91 /* prototype is here so that all files can use it. */
  92 void geany_debug(gchar const *format, ...) G_GNUC_PRINTF (1, 2);
  93
  94
  95 #ifndef G_GNUC_WARN_UNUSED_RESULT
  96 #define G_GNUC_WARN_UNUSED_RESULT
  97 #endif
  98
  99 #endif