Update copyright year to 2014 by running admin/update-copyright.
[emacs.git] / etc / srecode / c.srt
blobe7eafed25c9d95a47691948562406f164097bcd5
1 ;;; c.srt --- SRecode templates for c-mode
3 ;; Copyright (C) 2007-2010, 2012-2014 Free Software Foundation, Inc.
5 ;; Author: Eric M. Ludlam <eric@siege-engine.com>
7 ;; This file is part of GNU Emacs.
9 ;; GNU Emacs is free software: you can redistribute it and/or modify
10 ;; it under the terms of the GNU General Public License as published by
11 ;; the Free Software Foundation, either version 3 of the License, or
12 ;; (at your option) any later version.
14 ;; GNU Emacs is distributed in the hope that it will be useful,
15 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
16 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17 ;; GNU General Public License for more details.
19 ;; You should have received a copy of the GNU General Public License
20 ;; along with GNU Emacs.  If not, see <http://www.gnu.org/licenses/>.
22 set mode "c-mode"
24 set comment_start  "/**"
25 set comment_end    " */"
26 set comment_prefix " *"
28 ;; OVERRIDE THIS in your user or project template file to whatever
29 ;; you use for your project.
30 set HEADEREXT ".h"
32 context file
34 template empty :time :user :file :c
35 ----
36 {{>:filecomment}}
38 {{#NOTHEADER}}
40 {{^}}
41 {{/NOTHEADER}}
42 {{#HEADER}}
43 {{>:header_guard}}
44 {{/HEADER}}
45 ----
47 template header_guard :file :blank :c
48 ----
49 #ifndef {{FILENAME_SYMBOL:upcase}}
50 #define {{FILENAME_SYMBOL:upcase}} 1
52 {{^}}
54 #endif // {{FILENAME_SYMBOL:upcase}}
55 ----
57 context misc
59 template arglist
60 "Insert an argument list for a function.
61 @todo - Support smart CR in a buffer for not too long lines."
62 ----
63 ({{#ARGS}}{{TYPE}} {{NAME}}{{#NOTLAST}},{{/NOTLAST}}{{/ARGS}})
64 ----
66 context declaration
68 prompt TYPE "Return Type: "
70 template function :indent :blank
71 "Insert a function declaration."
72 ----
73 {{?TYPE}} {{?NAME}}{{>:misc:arglist}}
74 {{#INITIALIZERS}}{{>B:initializers}}{{/INITIALIZERS}}
76 {{^}}
78 ----
79 bind "f"
81 template function-prototype :indent :blank
82 "Insert a function declaration."
83 ----
84 {{?TYPE}} {{?NAME}}{{>:misc:arglist}};
85 ----
88 prompt TYPE "Data Type: "
90 template variable :indent :blank
91 "Insert a variable declaration."
92 ----
93 {{?TYPE}} {{?NAME}}{{#HAVEDEFAULT}} = {{DEFAULT}}{{/HAVEDEFAULT}};
94 ----
95 bind "v"
97 template variable-prototype :indent :blank
98 "Insert a variable declaration."
99 ----
100 {{?TYPE}} {{?NAME}};
101 ----
102 bind "v"
105 template include :blank
106 "An include statement."
107 ----
108 #include "{{?NAME}}"
109 ----
110 bind "i"
112 template system-include :blank
113 "An include statement."
114 ----
115 #include <{{?NAME}}>
116 ----
117 bind "i"
119 template label :blank :indent
120 ----
121   {{?NAME}}:
122 ----
124 context declaration
126 template comment-function :indent :blank
127 "Used to put a nice comment in front of a function.
128 Override this with your own preference to avoid using doxygen"
129 ----
130 {{>A:declaration:doxygen-function}}
131 ----
133 ;;; DOXYGEN FEATURES
134 ;; 
136 context declaration
138 template doxygen-function :indent :blank
139 ----
141  * @name {{NAME}} - {{DOC}}{{^}}{{#ARGS}}
142  * @param {{NAME}} - {{DOC}}{{/ARGS}}
143  * @return {{TYPE}}
144  */
145 ----
147 template doxygen-variable-same-line
148 ----
149 /**< {{DOC}}{{^}} */
150 ----
152 template doxygen-section-comment :blank :indent
153 "Insert a comment that separates sections of an Emacs Lisp file."
154 ----
156 /** {{?TITLE}}
158  * {{^}}
159  */
161 ----
164 ;; end