/usr/share/doc/fweb/html-info/Customization.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 147 | <!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: Customization</title>
<meta name="description" content="FWEB: Customization">
<meta name="keywords" content="FWEB: Customization">
<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="index.html#Top" rel="up" title="Top">
<link href="Environment-variables.html#Environment-variables" rel="next" title="Environment variables">
<link href="Merging-indexes.html#Merging-indexes" rel="prev" title="Merging indexes">
<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="Customization"></a>
<div class="header">
<p>
Next: <a href="Hints.html#Hints" accesskey="n" rel="next">Hints</a>, Previous: <a href="Index.html#Index" accesskey="p" rel="prev">Index</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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="CUSTOMIZATION"></a>
<h2 class="chapter">12 CUSTOMIZATION</h2>
<a name="index-Customization"></a>
<a name="index-Customizing-FWEB"></a>
<a name="index-FWEB_002c-customizing"></a>
<p>The default behavior of <small>FWEB</small> can be changed in a variety of ways.
</p>
<blockquote>
<ol>
<li> <small>UNIX</small> environment variables (logical variables in VMS) affect path or
file names.
</li><li> An initialization file resides in the home directory.
</li><li> A style file resides in the current directory.
</li></ol>
</blockquote>
<p>The initialization file (usually called <samp>.fweb</samp>) is intended to contain
command-line options (one per line) that are to be used in every run.
See <a href="Initialization.html#Initialization">Initialization</a>.
</p>
<p>The style file (called <samp>fweb.sty</samp> by default; see <a href="_002dz.html#g_t_002dz">-z</a>) is
intended to provide more local customization, perhaps
differing for each source file and group of source files. The style
file does not contain command-line
options; rather, it contains parameter settings that override
<small>FWEB</small>’s defaults. The ‘<samp>-p</samp>’ option (see <a href="_002dp.html#g_t_002dp">-p</a>)
may be used to specify a style-file entry in <samp>.fweb</samp> (i.e., a
global value for all source files) or on the
command line (i.e., a value used for a single run).
</p>
<p>The order of processing is:
</p>
<blockquote>
<ol>
<li> Evaluate environment variables. See <a href="Environment-variables.html#Environment-variables">Environment variables</a>.
</li><li> Read <samp>.fweb</samp> and remember its contents; sort those into three
groups: options beginning with ‘<samp>-</samp>’, beginning with ‘<samp>&</samp>’, and
beginning with a letter (file names) . See <a href="Initialization.html#Initialization">Initialization</a>.
</li><li> Process <samp>.fweb</samp> options beginning with ‘<samp>-</samp>’ (or ‘<samp>+</samp>’, for
backward compatibility), except for ‘<samp>-p</samp>’.
</li><li> Read and process command-line options, except for ‘<samp>-p</samp>’. See <a href="Options.html#Options">Options</a>.
</li><li> Process remaining <samp>.fweb</samp> options (either file names, or options
beginning with ‘<samp>&</samp>’).
</li><li> Process any ‘<samp>-p</samp>’ options from <samp>.fweb</samp>. See <a href="_002dp.html#g_t_002dp">-p</a>.
</li><li> Process the style file. See <a href="Style.html#Style">Style</a>.
</li><li> Process any ‘<samp>-p</samp>’ options from the command line.
</li></ol>
</blockquote>
<p>Unfortunately, because not all options are processed immediately when
they are read, errors may not show up when one expects. For example,
nothing is actually processed while <samp>.fweb</samp> is being read; its
contents are just being stored. It
could therefore happen that a syntax error in entering a ‘<samp>-p</samp>’
option in <samp>.fweb</samp> may not be reported until after the style file
has been read, possibly confusing the user as to the source of the
error.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="Environment-variables.html#Environment-variables" accesskey="1">Environment variables</a>:</td><td> </td><td align="left" valign="top">Environment or logical variables.
</td></tr>
<tr><td align="left" valign="top">• <a href="Initialization.html#Initialization" accesskey="2">Initialization</a>:</td><td> </td><td align="left" valign="top">Initialization file.
</td></tr>
<tr><td align="left" valign="top">• <a href="Memory-allocation.html#Memory-allocation" accesskey="3">Memory allocation</a>:</td><td> </td><td align="left" valign="top">Dynamic memory allocation.
</td></tr>
<tr><td align="left" valign="top">• <a href="Style.html#Style" accesskey="4">Style</a>:</td><td> </td><td align="left" valign="top">Style file.
</td></tr>
</table>
<hr>
<div class="header">
<p>
Next: <a href="Hints.html#Hints" accesskey="n" rel="next">Hints</a>, Previous: <a href="Index.html#Index" accesskey="p" rel="prev">Index</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</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>
|