/usr/share/doc/autogen-doc/autogen.html/SCM-dne.html is in autogen-doc 1:5.18.7-3.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- This manual is for GNU AutoGen version 5.18, updated December 2015.
Copyright (C) 1992-2015 by Bruce Korb.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2 or
any later version published by the Free Software Foundation; with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. -->
<!-- Created by GNU Texinfo 6.0, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU AutoGen - The Automated Program Generator: SCM dne</title>
<meta name="description" content="GNU AutoGen - The Automated Program Generator: SCM dne">
<meta name="keywords" content="GNU AutoGen - The Automated Program Generator: SCM dne">
<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="AutoOpts.html#AutoOpts" rel="index" title="AutoOpts">
<link href="Function-Index.html#SEC_Contents" rel="contents" title="Table of Contents">
<link href="AutoGen-Functions.html#AutoGen-Functions" rel="up" title="AutoGen Functions">
<link href="SCM-emit.html#SCM-emit" rel="next" title="SCM emit">
<link href="SCM-def_002dfile_002dline.html#SCM-def_002dfile_002dline" rel="prev" title="SCM def-file-line">
<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.nocodebreak {white-space: nowrap}
span.nolinebreak {white-space: nowrap}
span.roman {font-family: serif; 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="SCM-dne"></a>
<div class="header">
<p>
Next: <a href="SCM-emit.html#SCM-emit" accesskey="n" rel="next">SCM emit</a>, Previous: <a href="SCM-def_002dfile_002dline.html#SCM-def_002dfile_002dline" accesskey="p" rel="prev">SCM def-file-line</a>, Up: <a href="AutoGen-Functions.html#AutoGen-Functions" accesskey="u" rel="up">AutoGen Functions</a> [<a href="Function-Index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="AutoOpts.html#AutoOpts" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="dne-_002d-_0022Do-Not-Edit_0022-warning"></a>
<h4 class="subsection">3.4.8 <samp>dne</samp> - "Do Not Edit" warning</h4>
<a name="index-dne"></a>
<p>Usage: (dne prefix [ first_prefix ] [ optpfx ])
<br>
Generate a "DO NOT EDIT" or "EDIT WITH CARE" warning string.
Which depends on whether or not the <code>--writable</code> command line
option was set.
</p>
<p>The first argument may be an option: ‘<samp>-D</samp>’ or ‘<samp>-d</samp>’, causing the
second and (potentially) third arguments to be interpreted as the first
and second arguments. The only useful option is ‘<samp>-D</samp>’:
</p>
<dl compact="compact">
<dt>‘<samp>-D</samp>’</dt>
<dd><p>will add date, timestamp and version information.
</p></dd>
<dt>‘<samp>-d</samp>’</dt>
<dd><p>is ignored, but still accepted for compatibility with older versions
of the "dne" function where emitting the date was the default.
</p></dd>
</dl>
<p>If one of these options is specified, then the "prefix" and "first"
arguments are obtained from the following arguments. The presence (or
absence) of this option can be overridden with the environment variable,
‘<samp>AUTOGEN_DNE_DATE</samp>’. The date is disabled if the value is empty or
starts with one of the characters, ‘<samp>0nNfF</samp>’ – zero or the first
letter of "no" or "false".
</p>
<p>The <code>prefix</code> argument is a per-line string prefix. The optional
second argument is a prefix for the first line only and, in read-only
mode, activates editor hints.
</p>
<div class="example">
<pre class="example">-*- buffer-read-only: t -*- vi: set ro:
</pre></div>
<p>The warning string also includes information about the template used
to construct the file and the definitions used in its instantiation.
</p>
<p>Arguments:
<br>
prefix - string for starting each output line
<br>
first_prefix - Optional - for the first output line
<br>
optpfx - Optional - shifted prefix
</p>
</body>
</html>
|