geany/src/templates.h
Matthew Brush 6f87aac118 Normalize use of header guards and extern "C" guards
* Always define GEANY_FOO_H to 1 in the header guards
* Always put a G_BEGIN_DECLS/G_END_DECLS guard in every header for
consistency, even private ones where it doesn't matter.
* Always include either <glib.h>, <gtk/gtk.h> or some other header
that will provide G_BEGIN_DECLS before using it. In a lot of headers
that use glib.h and gtk/gtk.h stuff anyway, this resolves an implicit
dependency they had on them being included before that header.
* Always put a comment at the #endif part of the guard so it's
easier to see what it applies to.
* Always use an underscore between the header guard identifier's words
even though the filename doesn't have one.
2014-05-21 12:18:26 -07:00

95 lines
2.7 KiB
C

/*
* templates.h - this file is part of Geany, a fast and lightweight IDE
*
* Copyright 2005-2012 Enrico Tröger <enrico(dot)troeger(at)uvena(dot)de>
* Copyright 2006-2012 Nick Treleaven <nick(dot)treleaven(at)btinternet(dot)com>
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
*/
/**
* @file templates.h
* Templates (prefs).
**/
#ifndef GEANY_TEMPLATES_H
#define GEANY_TEMPLATES_H 1
#include <glib.h>
G_BEGIN_DECLS
/* Forward-declared to avoid including their headers here */
struct GeanyDocument;
struct GeanyFiletype;
#define GEANY_TEMPLATES_INDENT 3
#define GEANY_TEMPLATES_FORMAT_YEAR C_("DefaultYear", "%Y")
#define GEANY_TEMPLATES_FORMAT_DATE C_("DefaultDate", "%Y-%m-%d")
#define GEANY_TEMPLATES_FORMAT_DATETIME C_("DefaultDateTime", "%d.%m.%Y %H:%M:%S %Z")
enum
{
GEANY_TEMPLATE_GPL = 0,
GEANY_TEMPLATE_BSD,
GEANY_TEMPLATE_FILEHEADER,
GEANY_TEMPLATE_CHANGELOG,
GEANY_TEMPLATE_FUNCTION,
GEANY_MAX_TEMPLATES
};
/** Template preferences. */
typedef struct GeanyTemplatePrefs
{
gchar *developer; /**< Name */
gchar *company; /**< Company */
gchar *mail; /**< Email */
gchar *initials; /**< Initials */
gchar *version; /**< Initial version */
gchar *year_format;
gchar *date_format;
gchar *datetime_format;
}
GeanyTemplatePrefs;
extern GeanyTemplatePrefs template_prefs;
struct filetype;
void templates_init(void);
gchar *templates_get_template_fileheader(gint filetype_idx, const gchar *fname);
gchar *templates_get_template_changelog(struct GeanyDocument *doc);
gchar *templates_get_template_function(struct GeanyDocument *doc, const gchar *func_name);
gchar *templates_get_template_licence(struct GeanyDocument *doc, gint licence_type);
void templates_replace_common(GString *tmpl, const gchar *fname,
struct GeanyFiletype *ft, const gchar *func_name);
void templates_replace_valist(GString *text,
const gchar *first_wildcard, ...) G_GNUC_NULL_TERMINATED;
void templates_free_templates(void);
G_END_DECLS
#endif /* GEANY_TEMPLATES_H */