1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html401/loose.dtd">
<html>
<!-- Copyright (C) 2004, 2005, 2006, 2007 Alain Lahellec
Copyright (C) 2004, 2005, 2006, 2007 Patrice Dumas
Copyright (C) 2004, Ste'phane Hallegatte
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.1 or
any later version published by the Free Software Foundation; with no
Invariant Sections, with no Front-Cover text and with no Back-Cover Text.
A copy of the license is included in the section entitled "GNU Free
Documentation License."
-->
<!-- Created on a sunny day by texi2html
texi2html was written by:
Lionel Cons <Lionel.Cons@cern.ch> (original author)
Karl Berry <karl@freefriends.org>
Olaf Bachmann <obachman@mathematik.uni-kl.de>
and many others.
Maintained by: Many creative people.
Send bugs and suggestions to <texi2html-bug@nongnu.org>
-->
<head>
<title>Miniker 102 manual: B.3 File introduction directives</title>
<meta name="description" content="Miniker 102 manual: B.3 File introduction directives">
<meta name="keywords" content="Miniker 102 manual: B.3 File introduction directives">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="texi2html">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<style type="text/css">
<!--
@import "mini_ker_tex4ht_math.css";
@import "mini_ker_tex4ht_tex.css";
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
pre.display {font-family: serif}
pre.format {font-family: serif}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: serif; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: serif; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.roman {font-family:serif; font-weight:normal;}
span.sansserif {font-family:sans-serif; font-weight:normal;}
ul.toc {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="File-introduction-directives"></a>
<ul class="toc"><li><a href="mini_ker.html#Top">Miniker 102 manual</a> </li>
<li><ul class="toc"><li><a href="Cmz-directives-reference.html#Cmz-directives-reference">B. Cmz directives reference</a> </li>
</ul></li>
</ul>
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="Conditional-expressions.html#Conditional-expressions" title="Previous section in reading order"> < </a>]</td>
<td valign="middle" align="left">[<a href="Conditional-directives.html#Conditional-directives" title="Next section in reading order"> > </a>]</td>
<td valign="middle" align="left"> </td>
<td valign="middle" align="left">[<a href="mini_ker.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="Concepts-index.html#Concepts-index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="mini_ker_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<a name="File-introduction-directives-1"></a>
<h2 class="appendixsec"> B.3 File introduction directives </h2>
<p>A file (or sequence) introduction directive appears at the beginning
of the file. There are two different directives, one is <code>DECK</code>
for normal files, the other is <code>KEEP</code> for include files (sequences).
The first argument is the name of the file. The file name may not be larger
than 32 characters and is converted to lower case in the general case.
The optionnal following arguments may be
of 2 type (and may be mixed, separated by ‘<samp>,</samp>’):
</p>
<dl compact="compact">
<dt> conditional</dt>
<dd><p>A conditionnal is introduced by <code>IF=</code> followed by a conditionnal
expression described in
<a href="Conditional-expressions.html#Conditional-expressions">Conditional expressions</a>. The
file is preprocessed if the conditionnal expression is true.
</p></dd>
<dt> language specification</dt>
<dd><p>A language specification is introduced by a <code>T=</code>. The most
common languages are ‘<samp>mtn</samp>’ for the mortran, ‘<samp>ftn</samp>’ for
fortran not preprocessed, ‘<samp>f77</samp>’ for preprocessed fortran,
‘<samp>c</samp>’ for the c language and ‘<samp>txt</samp>’ for text files.
In general the language of the file determines the name of files
the preprocessed file is extracted to, the comment style and
the command for inclusions.
</p></dd>
</dl>
<p>It is a common practice to have wrong language type in <code>KEEP</code>
as the language may be determined from the <code>DECK</code> that include
them with cmz, or from their file name with make. This is not recommended
and considered a bad practice.
</p>
<p>Such a directive will always appear in cmz, as it is built-in. It
is recommended to have one when using make too, even though it is not
required in most cases. Indeed make uses the file name directly
and finds the language and file type by looking at the file extension.
make should then pass the language type with a
<code>--lang <var>lang</var></code> command
line switch when calling the cmz directives preprocessor.
With make, the convention is to have ‘<samp>cm</samp>’ added before the normal
file suffix and after the ‘<samp>.</samp>’. The table <a href="Programming-with-cmz-directives.html#tab_003acmfile_005fsuffix">tab:cmfile_suffix</a>
shows the matching between suffixes, file type and file language.
</p>
<p>For example, a file beginning with
</p>
<pre class="verbatim">+Deck, subroutine_foo, If=monitor&-simple, T=f77.
</pre>
<p>is a main preprocessed fortran file that will only be generated if
‘<samp>monitor</samp>’ is selected and ‘<samp>simple</samp>’ is not selected. The
file to be preprocessed by make should have the ‘<samp>.cmF</samp>’ suffix,
and be called ‘<tt>subroutine_foo.cmF</tt>’.
</p>
<p>A file beginning with
</p>
<pre class="verbatim">+KEEP,inc_common,If=monitor|interface,T=mtn
</pre>
<p>is an mortran include file that should be processed only if ‘<samp>monitor</samp>’
or ‘<samp>interface</samp>’ is selected. The file to be preprocessed by make
should have the ‘<samp>cmmti</samp>’ suffix and be called ‘<tt>inc_common.cmmti</tt>’.
The resulting file when make is used will be called ‘<tt>inc_common.mti</tt>’.
</p>
<hr size="2">
<table cellpadding="1" cellspacing="1" border="0">
<tr><td valign="middle" align="left">[<a href="mini_ker.html#SEC_Contents" title="Table of contents">Contents</a>]</td>
<td valign="middle" align="left">[<a href="Concepts-index.html#Concepts-index" title="Index">Index</a>]</td>
<td valign="middle" align="left">[<a href="mini_ker_abt.html#SEC_About" title="About (help)"> ? </a>]</td>
</tr></table>
<p>
<font size="-1">
This document was generated by <em>a tester</em> on <em>a sunny day</em> using <a href="http://www.nongnu.org/texi2html/"><em>texi2html</em></a>.
</font>
<br>
</p>
</body>
</html>
|
