/usr/share/doc/fweb/html-info/ATz.html is in fweb-doc 1.62-13.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Created by GNU Texinfo 6.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>FWEB: ATz</title>
<meta name="description" content="FWEB: ATz">
<meta name="keywords" content="FWEB: ATz">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Concept-index.html#Concept-index" rel="index" title="Concept index">
<link href="Parameter-index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="AT-commands.html#AT-commands" rel="up" title="AT commands">
<link href="ATquote.html#ATquote" rel="next" title="ATquote">
<link href="ATy.html#ATy" rel="prev" title="ATy">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.indentedblock {margin-right: 0em}
blockquote.smallindentedblock {margin-right: 0em; font-size: smaller}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smalllisp {margin-left: 3.2em}
kbd {font-style: oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: initial; font-weight: normal}
span.sansserif {font-family: sans-serif; font-weight: normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en">
<a name="ATz"></a>
<div class="header">
<p>
Next: <a href="ATquote.html#ATquote" accesskey="n" rel="next">ATquote</a>, Previous: <a href="ATy.html#ATy" accesskey="p" rel="prev">ATy</a>, Up: <a href="AT-commands.html#AT-commands" accesskey="u" rel="up">AT commands</a> [<a href="Parameter-index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="g_t_0040z_003a-Begin-ignorable-material_002c-or-terminate-change"></a>
<h4 class="subsection">5.5.31 ‘<samp>@z</samp>’: Begin ignorable material, or terminate change</h4>
<a name="index-_0040z"></a>
<p><small>FWEB</small> files may begin with the construction
</p>
<div class="example">
<pre class="example">@z
.
.
@x
</pre></div>
<p>where the ‘<samp>@z</samp>’ occupies the very first two characters of the file, and
where the ‘<samp>@z</samp>’ and ‘<samp>@x</samp>’ must begin in column 1.
Material between the ‘<samp>@z</samp>’ and ‘<samp>@x</samp>’ is <em>pure commentary</em> and is
ignored by both processors, with one exception.
</p>
<a name="index-_0040K"></a>
<a name="index-_0040k"></a>
<a name="index-_0024KEYWORD"></a>
<a name="index-_0024L_005fKEYWORD"></a>
<a name="index-RCS_002dlike-keyword"></a>
<a name="index-Keyword_002c-RCS_002dlike"></a>
<p>The exception is that an RCS-like line (RCS stands for
“revision-control system”) with syntax
</p>
<div class="example">
<pre class="example">$Keyword: Text of Keyword $
</pre></div>
<p>(at least one blank after the colon, and at least one before the last
dollar sign; <small>UNIX</small> users, see ‘<samp>man ident</samp>’) is parsed, and the
text of the <code>Keyword</code> is made
available to the control codes ‘<samp>@K</samp>’ (see <a href="ATK_005f.html#ATK_005f">ATK_</a>) and ‘<samp>@k</samp>’
(see <a href="ATk.html#ATk">ATk</a>) as well as to <small>FTANGLE</small>’s built-in function <code>$KEYWORD</code>
(see <a href="_0024KEYWORD.html#g_t_0024KEYWORD">$KEYWORD</a>.
</p>
<p>A distinction is made between keywords that are found in the ignorable
commentary at the beginning of the master web file, which are called
<em>global keywords</em>, and ones that are found at the beginning of files
included via ‘<samp>@i</samp>’, which are called <em>local keywords</em>.
</p>
<p>The commands that access RCS-like keywords function as follows:
</p>
<blockquote>
<ul>
<li> ‘<samp>$KEYWORD(Keyword)</samp>’ accesses a global keyword. It is a built-in
function that is
expanded by <small>FTANGLE</small> (during output) into the quoted character
string <code>"Text of Keyword"</code>.
</li><li> ‘<samp>@K</samp>’ and ‘<samp>@k</samp>’ are expanded during input. ‘<samp>@K</samp>’
accesses a global keyword, whereas ‘<samp>@k</samp>’ accesses a local keyword.
</li><li> In the limbo section or a TeX part, <small>FWEAVE</small> will expand ‘<samp>@K
Keyword @></samp>’ into <code>Text of Keyword</code> (without the surrounding
quotes), and similarly for ‘<samp>@k</samp>’. (The intention is that the
expanded text can be used as bodies of TeX macros.)
<small>FWEAVE</small> will also print the
values of global keywords at the end of its output, whether or not they
are referenced by ‘<samp>@K</samp>’.
</li><li> Elsewhere <small>FWEAVE</small> will just print the keyword name itself,
surrounded by double angle brackets. If the keyword was local
(‘<samp>@k</samp>’), the brackets will carry the subscript 0.
</li><li> <small>FTANGLE</small> treats the global command ‘<samp>@K Keyword @></samp>’
essentially like it does ‘<samp>$Keyword</samp>’, except that the construction
is expanded on input rather than output.
</li><li> <small>FTANGLE</small> expands the command ‘<samp>@k keyword @></samp>’ on input,
generating a quoted string containing the value of the local keyword.
</li></ul>
</blockquote>
<p>The command ‘<samp>@z</samp>’ is also used in change files to end a change.
See <a href="Change-files.html#Change-files">Change files</a>.
</p>
<hr>
<div class="header">
<p>
Next: <a href="ATquote.html#ATquote" accesskey="n" rel="next">ATquote</a>, Previous: <a href="ATy.html#ATy" accesskey="p" rel="prev">ATy</a>, Up: <a href="AT-commands.html#AT-commands" accesskey="u" rel="up">AT commands</a> [<a href="Parameter-index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-index.html#Concept-index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|