Debian Codegraph @

texmf-dist/source/latex/sf298/sf298.dtx

raw
1 % \iffalse
2 % Fill-in and print the Standard Form 298.
3 % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
4 % This is file `sf298.dtx', the documentation file for the `sf298'
5 % package.
6 %
7 % Copyright (C) 2000,2004 Steven Douglas Cochran.
8 %
9 % The copyright remains with the above author.
10 %
11 % The sf298 package may be distributed and/or modified under the
12 % conditions of the LaTeX Project Public License, either version 1.2
13 % of this license or (at your option) any later version. The latest
14 % version of this license is in:
15 % http://www.latex-project.org/lppl.txt
16 % and version 1.2 or later is part of all distributions of LaTeX
17 % version 1999/12/01 or later.
18 %
19 % The sf298 package is distributed in the hope that it will be
20 % useful, but `as is', WITHOUT WARRANTY OF ANY KIND, either expressed
21 % or implied, including, but not limited to, the implied warranties of
22 % MERCHANTABILITY and FITNESS FOR A PARTICULAR PURPOSE. See the LaTeX
23 % Project Public License for more details.
24 %
25 % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
26 % @LaTeX-style-file{
27 % Author = "Peter A. Rochford",
28 % Version = "1.3",
29 % Date = "2016/7/7",
30 % Time = "11:38:00",
31 % Filename = "sf298.sty",
32 % Address = "Acorn Science & Innovation, Inc.
33 % 1616 Anderson Road, Suite 213
34 % McLean, VA 22102, USA",
35 % Telephone = "+1 703-995-9872",
36 % Email = "[email protected]",
37 % Abstract = "Extension of the LaTeX package to optionally provide the page of
38 % General Instructions. Also fixed known bug when using \usepackage{totpages}.''
39 %
40 % Author = "Steven Douglas Cochran",
41 % Version = "1.2",
42 % Date = "2004/12/22",
43 % Time = "10:33:25",
44 % Filename = "sf298.sty",
45 % Address = "SVC HS Information Technology, M200 Scaife Hall
46 % 3550 Terrace Street
47 % Pittsburgh, PA 15261, USA",
48 % Telephone = "+1 412.624.9282",
49 % FAX = "+1 412.648.8865",
50 % Email = "[email protected]",
51 % CodeTable = "ISO/ASCII",
52 % Keywords = "LaTeX, standard forms, sf298, report documentation",
53 % Supported = "yes",
54 % Abstract = "LaTeX package for generating a completed standard
55 % form 298 (Rev.\ 8/98) as prescribed by ANSI
56 % Std.\ Z39.18 for report documentation, for instance,
57 % as part of a document delivered on a U.S. Government
58 % contract.''
59 % }
60 % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
61 %
62 % \fi
63 %
64 % \iffalse
65 %<*driver>
66 \ProvidesFile{sf298.dtx}
67 \documentclass[letterpaper]{ltxdoc}
68 \usepackage{totpages} % needed to provide total number of pages in SF298
69 \def\CurrentOption{} % fix bug in totpages
70 \usepackage[noconfig]{sf298}
71 \usepackage{afterpage}
72 \advance\textheight2\baselineskip
73 \setlength\hfuzz{26pt}
74
75 \usepackage[textwidth=\textwidth,textheight=\textheight]{geometry} % needed to change textwidth for \GeneralInstructions
76 %</driver>
77 %
78 %<*ltxdoc>
79 \AtBeginDocument{
80 \EnableCrossrefs
81 \RecordChanges
82 \CodelineIndex}
83 \AtEndDocument{
84 \PrintChanges
85 \PrintIndex}
86 \begin{document}
87 \DocInput{sf298.dtx}
88 \end{document}
89 %</ltxdoc>
90 %
91 % \fi
92 %
93 % \newcommand*{\Lopt}[1]{\textsf{#1}}
94 % \newcommand*{\Lfile}[1]{\texttt{#1}}
95 % \newcommand*{\Lpack}[1]{\textsf{#1}}
96 %
97 % \changes{v1.0}{11 Jan 2000}{Initial revision.}
98 % %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
99 % \DoNotIndex{\ ,\(,\),\@car,\@date,\@empty,\@gobble,\@ifnextchar}
100 % \DoNotIndex{\@ifundefined,\@nil,\@tempa,\@tempboxa,\@tempskipa}
101 % \DoNotIndex{\@viiipt,\@vpt,\@vipt,\@xipt,\@xivpt,\@warning,\@xpt,\\}
102 % \DoNotIndex{\2,\AtEndDocument,\addtocounter,\advance,\arabic}
103 % \DoNotIndex{\baselineskip,\baselinestretch,\begin,\bf,\c@page}
104 % \DoNotIndex{\cleardoublepage,\csname,\date,\day,\DeclareFixedFont}
105 % \DoNotIndex{\def,\documentclass,\documentpackage,\edef,\else,\end}
106 % \DoNotIndex{\endcsname,\evensidemargin,\ExecuteOptions,\expandafter}
107 % \DoNotIndex{\fi,\font,\fontdimen,\footnote,\framebox,\global,\hbox}
108 % \DoNotIndex{\headheight,\headsep,\hrule,\hskip,\hss,\if,\if@twoside}
109 % \DoNotIndex{\ifdim,\IfFileExists,\ifodd,\ifx,\InputIfFileExists,\LARGE}
110 % \DoNotIndex{\large,\leftskip,\let,\line,\lineskip,\linethickness}
111 % \DoNotIndex{\linewidth,\makeatletter,\makeatother,\makebox,\maketitle}
112 % \DoNotIndex{\month,\NeedsTeXFormat,\newcommand,\newcounter,\newif}
113 % \DoNotIndex{\newpage,\noindent,\normalbaselineskip,\null,\number}
114 % \DoNotIndex{\oddsidemargin,\pagenumbering,\pagestyle,\par,\parbox,\phantom}
115 % \DoNotIndex{\ProvidesPackage,\put,\r@TotPages,\raggedright,\relax}
116 % \DoNotIndex{\renewcommand,\rightskip,\rule,\section,\setcounter}
117 % \DoNotIndex{\setbox,\setlength,\shortstack,\space,\spaceskip,\string}
118 % \DoNotIndex{\tableofcontents,\textheight,\textwidth,\thispagestyle}
119 % \DoNotIndex{\topmargin,\tt,\typeout,\unitlength,\usepackage,\value}
120 % \DoNotIndex{\vbox,\vfil,\voffset,\vskip,\vss,\wd,\xspaceskip,\year}
121 %
122 % \newcommand{\ie}{{\it i.e.\/}}
123 %
124 % \def\filename{sf298.dtx}
125 % \def\fileversion{1.3}
126 % \def\filedate{2016/7/7}
127 % \def\docdate {2016/7/7}
128 % \makeatletter
129 % \def\drawform{\sf@drawform}
130 % \def\@oddfoot{%
131 % \rm
132 % \hfill
133 % \@ifundefined{r@fig:form}%
134 % {thepage}%
135 % {\@tempcnta\pageref{fig:form}
136 % \ifnum \c@page=\@tempcnta \else
137 % \thepage
138 % \fi}%
139 % \hfill}
140 % \let\@evenfoot\@oddfoot
141 % \makeatother
142 %
143 % \CheckSum{1457}
144 %
145 % \CharacterTable
146 % {Upper-case \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
147 % Lower-case \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
148 % Digits \0\1\2\3\4\5\6\7\8\9
149 % Exclamation \! Double quote \" Hash (number) \#
150 % Dollar \$ Percent \% Ampersand \&
151 % Acute accent \' Left paren \( Right paren \)
152 % Asterisk \* Plus \+ Comma \,
153 % Minus \- Point \. Solidus \/
154 % Colon \: Semicolon \; Less than \<
155 % Equals \= Greater than \> Question mark \?
156 % Commercial at \@ Left bracket \[ Backslash \\
157 % Right bracket \] Circumflex \^ Underscore \_
158 % Grave accent \` Left brace \{ Vertical bar \|
159 % Right brace \} Tilde \~}
160 %
161 % \title{The \Lpack{sf298} Package\footnote{This paper documents
162 % the \Lpack{sf298} package v\fileversion, last revised \filedate.}}
163 % \author{
164 % Steven Douglas Cochran\\[5pt]
165 % SVC HS Information Technology, M200 Scaife Hall \\
166 % 3550 Terrace Street \\
167 % Pittsburgh, PA 15261, USA\\[5pt]
168 % \texttt{[email protected]}
169 % \and\\[5pt]
170 % Peter Andrew Rochford\\[5pt]
171 % Acorn Science \& Innovation, Inc. \\
172 % 1616 Anderson Road, Suite 213 \\
173 % McLean, VA 22102, USA\\[5pt]
174 % \texttt{[email protected]}
175 % }
176 % \date{\docdate}
177 % \maketitle
178 % \vspace{-20pt}
179 % \begin{abstract}
180 % \noindent
181 % This article documents the \LaTeX\ package for generating a completed
182 % standard form 298 (Rev.\ 8/98) as prescribed by ANSI Std.\ Z39.18 for
183 % report documentation, for instance, as part of a document delivered on
184 % a U.S. Government contract. The latest revision includes the option of
185 % inserting the General Instructions page that typically appears after the
186 % form.
187 %
188 %\end{abstract}
189 %
190 % \setcounter{tocdepth}{2}
191 % \tableofcontents
192 %
193 % \section{Introduction}
194 % \begin{figure}
195 % \ReportDate{}
196 % \DistributionStatement{}
197 % \ReportClassification{}
198 % \AbstractClassification{}
199 % \PageClassification{}
200 % \AbstractLimitation{}
201 % \NumberPages{}
202 % \Abstract{\hfill Figure~\ref{fig:form}: Blank Special Form 298
203 % (Report Documentation Page).\hfill\null}
204 % \refstepcounter{figure}
205 % \label{fig:form}
206 % \vbox to \textheight{%
207 % \vspace{-78pt}%
208 % \hbox to \textwidth{%
209 % \hspace{-130pt}%
210 % \drawform
211 % \hss}%
212 % \vss}
213 % \end{figure}
214 %
215 % The \Lpack{sf298} package provides for creating a filled-in copy of
216 % the standard form 298 (Rev.\ 8/98), ``Report Documentation Page''
217 % (shown in Figure~\ref{fig:form}). This form is used in announcing and
218 % cataloging reports submitted as deliverables on contracts with the
219 % U.S. Government. It is important that the information on the sf298
220 % page be consistent with the rest of the report, particularly the cover
221 % and title page. Instructions for filling in each block of the form
222 % are given below. The macro \cmd{\MakeRptDocPage} causes the page to be
223 % printed. If the \Lopt{twoside} option is specified in the
224 % documentclass, then it is printed as a separate page with a blank
225 % back. The macro \cmd{\GeneralInstructions} causes the page of general
226 % instructions that accompanies the form to be printed. This is typically inserted
227 % after the |sf298| form.
228 %
229 % If you are changing the base font families for your paper (\eg, you
230 % load the \Lpack{times} package to use the PostScript fonts) and you
231 % want the fonts used on the |sf298| to change also, then you must
232 % change the font families before loading the \Lpack{sf298} package (see
233 % section~\ref{sec:configfont}).
234 %
235 % The package takes two sets of options: The \Lopt{config} option (default),
236 % causes it to check for a configuration file, while \Lopt{noconfig} disables
237 % this check (see section~\ref{sec:configfile}); The
238 % \Lopt{nofloatlongboxes} option (default) causes the package to generate
239 % the fixed standard form, while the \Lopt{floatlongboxes} option causes
240 % boxes 12--15 to distribute their vertical spacing in order to handle
241 % special cases such as a very long supplementary note in box 13.
242 %
243 % A sample report is given in section~\ref{sec:sample} that shows one
244 % approach to using the \Lpack{sf298} package.
245 %
246 % \section{The Individual Fields}
247 % \changes{v1.2}{22 Dec 2004}{Added note about the \Lopt{floatlongboxes}
248 % option.}
249 %
250 % There are nineteen fields, three with multiple sub-fields, on the
251 % sf298. The following macros, each having a single argument, define
252 % the data to be included in each field. Usually only a few fields will
253 % apply to a given report. Table~\ref{tab:attributes} notes which
254 % fields are required and which have default values. It also gives an
255 % approximate number of lines and characters per line that will fit into
256 % each block (for the Computer Modern Roman font family, PostScript Times
257 % Roman or other fonts will differ). The best approach to insure that
258 % the form is properly filled-in is to preview the page and adjust any
259 % fields that appear to have a problem.
260 %
261 % A few fields allow a partial extra line along the top of the box. The
262 % last two columns of Table~\ref{tab:attributes} shows the offset needed
263 % to add such an extra line. To use this extra space, you must already
264 % have used up the maximum number of (regular) lines for this field and
265 % you must begin the argument with an \cmd{\hspace} of the size of the
266 % indicated {\bf Skip}. The last {\bf Chars.} column gives the approximate
267 % amount of extra characters that you can add.
268 %
269 % \begin{table}
270 % \null\vspace{-.1in}
271 % \def\n{\hfill{\bf ---}\hfill\null}
272 % \def\d#1#2{\smash{\lower#1\hbox{#2}}}
273 % \def\p{\phantom{0}}
274 % \def\s#1{{\footnotesize (#1)}}
275 % \def\S#1{%
276 % \ifnum#1<10
277 % {\footnotesize \phantom{0}(#1)}%
278 % \else
279 % \s{#1}%
280 % \fi}
281 % \def\z#1{\hbox to 0pt{#1\hss}\p\p\p}
282 % \doublerulesep.5pt
283 % \arrayrulewidth.5pt
284 % \caption{Field Attributes and Approximate Maximum Size.}
285 % \label{tab:attributes}
286 % \vspace{10pt}
287 % \DeleteShortVerb{\|}
288 % \hbox to 1.1\textwidth{%
289 % \hss
290 % \begin{tabular}{rlcccccc} \hline\hline
291 % \multicolumn{1}{c}{\rule{0pt}{14pt}\bf Field}
292 % & \multicolumn{1}{c}{\d{1ex}{\bf Macro Name}}
293 % & \multicolumn{1}{c}{\d{1ex}{\bf Required}}
294 % & \multicolumn{1}{l}{\bf Default}
295 % & \multicolumn{1}{c}{\bf Max}
296 % & \multicolumn{1}{c}{{\bf Chars.}\d{-2.5pt}{\s{6}}}
297 % & \multicolumn{2}{c}{\d{-2pt}{{\bf Extra Space}\d{-2.5pt}{\s{8}}}}
298 % \\ \cline{7-8}
299 % \multicolumn{1}{c}{\rule[-7pt]{0pt}{7pt}\bf Number}
300 % & & & \multicolumn{1}{l}{{\bf Value}\d{-2.5pt}{\s{1}}}
301 % & \multicolumn{1}{c}{\bf Lines}
302 % & \multicolumn{1}{c}{\bf per Line}
303 % & \multicolumn{1}{c}{\d{2pt}{{\bf Skip}\d{-2.5pt}{\s{7}}}}
304 % & \multicolumn{1}{c}{\d{2pt}{{\bf Chars.}\d{-2.5pt}{\s{6}}}}
305 % \\ \hline\rule{0pt}{14pt}
306 % 1\z{} & \cmd{\ReportDate} & Yes &\s{2}& \p1 & \p31 & \n & \n \\
307 % 2\z{} & \cmd{\ReportType} & Yes & \n & \p1 & \p46 & \n & \n \\
308 % 3\z{} & \cmd{\DatesCovered} & Yes & \n & \p1 & \p39 & \n & \n \\
309 % 4\z{} & \cmd{\Title} & Yes & \n & \p7 & \p72 & 35mm & \p48 \\
310 % 5\z{a} & \cmd{\ContractNumber} & \n & \n & \p1 & \p46 & \n & \n \\
311 % 5\z{b} & \cmd{\GrantNumber} & \n & \n & \p1 & \p46 & \n & \n \\
312 % 5\z{c} & \cmd{\ProgramElementNumber} & \n & \n & \p1 & \p46 & \n & \n \\
313 % 5\z{d} & \cmd{\ProjectNumber} & \n & \n & \p1 & \p46 & \n & \n \\
314 % 5\z{e} & \cmd{\TaskNumber} & \n & \n & \p1 & \p46 & \n & \n \\
315 % 5\z{f} & \cmd{\WorkUnitNumber} & \n & \n & \p1 & \p46 & \n & \n \\
316 % 6\z{} & \cmd{\Author} & Yes & \n & \p7 & \p72 & 22mm & \p58 \\
317 % 7\z{} & \cmd{\PerformingOrg} & Yes & \n & \p4 & \p81 & \n & \n \\
318 % 8\z{} & \cmd{\POReportNumber} & \n & \n & \p4 & \p39 & 18mm & \p26 \\
319 % 9\z{} & \cmd{\SponsoringAgency} & Yes & \n & \p5 & \p81 & \n & \n \\
320 % 10\z{} & \cmd{\Acronym} & \n & \n & \p2 & \p30 & \n & \n \\
321 % 11\z{} & \cmd{\SMReportNumber} & \n & \n & \p1 & \p39 & 23mm & \p23 \\
322 % 12\z{} & \cmd{\DistributionStatement} \s{9} & \n &\s{3}& \p3 & 120 & 70mm & \p75 \\
323 % 13\z{} & \cmd{\SupplementaryNotes} \s{9} & \n & \n & \p2 & 120 & 45mm & \p92 \\
324 % 14\z{} & \cmd{\Abstract} \s{9} & Yes & \n & 10 & 120 & 22mm & 105 \\
325 % 15\z{} & \cmd{\SubjectTerms} \s{9} & \n & \n & \p3 & 125 & 32mm & 103 \\
326 % 16\z{a} & \cmd{\ReportClassification} & Yes &\s{4}& \p1 & \p\p9 & \n & \n \\
327 % 16\z{b} & \cmd{\AbstractClassification} & Yes &\s{4}& \p1 & \p\p9 & \n & \n \\
328 % 16\z{c} & \cmd{\PageClassification} & Yes &\s{4}& \p1 & \p\p9 & \n & \n \\
329 % 17\z{} & \cmd{\AbstractLimitation} & \n &\s{5}& \p1 & \p12 & \n & \n \\
330 % 18\z{} & \cmd{\NumberPages} & Yes & \n & \p1 & \p\p8 & \n & \n \\
331 % 19\z{a} & \cmd{\ResponsiblePerson} & \n & \n & \p1 & \p41 & \n & \n \\ \rule[-7pt]{0pt}{7pt}
332 % 19\z{b} & \cmd{\RPTelephone} & \n & \n & \p1 & \p41 & \n & \n \\ \hline\hline
333 % \multicolumn{8}{l}{\rule{0pt}{14pt}{\bf Notes:}} \\
334 % \multicolumn{8}{l}{\quad\S{1} All defaults may be overridden by specifying a
335 % value. Custom defaults may be assigned using a} \\
336 % \multicolumn{8}{l}{\quad\phantom{\S{1}} configuration file (see
337 % section~\ref{sec:configfile})}. \\
338 % \multicolumn{8}{l}{\quad\S{2} Defaults to the current date (in dd-mm-yyyy
339 % format).} \\
340 % \multicolumn{8}{l}{\quad\S{3} Defaults to ``Approved for public release;
341 % distribution is unlimited''}. \\
342 % \multicolumn{8}{l}{\quad\S{4} Defaults to ``U'' (Unclassified)}. \\
343 % \multicolumn{8}{l}{\quad\S{5} Defaults to ``UU'' (Unclassified Unlimited).} \\
344 % \multicolumn{8}{l}{\quad\phantom{\S{1}} otherwise, there is no default (see
345 % section~\ref{sec:configpage}).} \\
346 % \multicolumn{8}{l}{\quad\S{6} The number of characters is approximate and for
347 % the Computer Modern Roman font family only.} \\
348 % \multicolumn{8}{l}{\quad\S{7} Amount to indent the extra first line,
349 % \eg, \cmd{\Title}\{\cmd{\hspace}\{37mm\} \dots text\dots\}.} \\
350 % \multicolumn{8}{l}{\quad\S{8} More text may be placed in these blocks by
351 % adjusting the font family or size and/or changing} \\
352 % \multicolumn{8}{l}{\quad\phantom{\S{8}} the interline gap (see
353 % \cmd{\PerformingOrg} in sections~\ref{sec:configfile} and
354 % \ref{sec:sample} for an example).} \\
355 % \multicolumn{8}{l}{\quad\S{9} If the \Lopt{floatlongboxes} option is set
356 % when loading the pacakage, then this box may hold more or} \\
357 % \multicolumn{8}{l}{\quad\phantom{\S{9}} less than indicated in this table,
358 % however the extra space sizes are still valid.}
359 % \end{tabular}%
360 % \hskip-5mm}
361 % \vspace{.1in}
362 % \MakeShortVerb{\|}
363 % \end{table}
364 %
365 % For those blocks that allow more than one line (see
366 % Table~\ref{tab:attributes}), the text argument will automatically be
367 % broken to fit the box and the paragraph is usually vertically centered
368 % and left justified. You can use ``|\\|'' (newline) to override the
369 % default linebreaking, if desired (see section~\ref{sec:configfile} for
370 % an example).
371 %
372 % \newpage
373 % \paragraph{1. REPORT DATE.}
374 % \DescribeMacro{\ReportDate}
375 %
376 % \noindent
377 % Full publication date including day and month, if available.
378 % Must cite at least the year and be Year 2000 compliant, \eg
379 % \par\null\noindent
380 % \begin{tabular}{llll}
381 % ~~ & {\tt \cmd{\ReportDate}\{30--06--1998\}} & $\rightarrow$ & 30--06--1998 \\
382 % ~~ & {\tt \cmd{\ReportDate}\{xx--06--1998\}} & $\rightarrow$ & xx--06--1998 \\
383 % ~~ & {\tt \cmd{\ReportDate}\{xx--xx--1998\}} & $\rightarrow$ & xx--xx--1998
384 % \end{tabular}
385 % \par\null\noindent
386 % This field is required, but will default to the current date.
387 %
388 % \paragraph{2. REPORT TYPE.}
389 % \DescribeMacro{\ReportType}
390 %
391 % \noindent
392 % State the type of report, such as final, technical, interim,
393 % memorandum, master's thesis, progress, quarterly, research, special,
394 % group study, {\it etc\@.\/} This field is required.
395 %
396 % \paragraph{3. DATES COVERED.}
397 % \DescribeMacro{\DatesCovered}
398 %
399 % \noindent
400 % Indicate the time during which the work was performed and the report
401 % was written, \eg,
402 % \par\null\noindent
403 % \begin{tabular}{llll}
404 % ~~ & {\tt \cmd{\DatesCovered}\{Jun 1997--Jun 1998\}} & $\rightarrow$ & Jun 1997--Jun 1998 \\
405 % ~~ & {\tt \cmd{\DatesCovered}\{1--10 Jun 1996\}} & $\rightarrow$ & 1--10 Jun 1996 \\
406 % ~~ & {\tt \cmd{\DatesCovered}\{May--Nov 1998\}} & $\rightarrow$ & May--Nov 1998 \\
407 % ~~ & {\tt \cmd{\DatesCovered}\{Nov 1998\}} & $\rightarrow$ & Nov 1998
408 % \end{tabular}
409 % \par\null\noindent
410 % The month and year for at least one month are required.
411 %
412 % \paragraph{4. TITLE AND SUBTITLE.}
413 % \DescribeMacro{\Title}
414 %
415 % \noindent
416 % A title is taken from the part of the report that provides the most
417 % meaningful and complete information. When a report is prepared in
418 % more than one volume, repeat the primary title, add volume number, and
419 % include subtitle for the specific volume. On classified documents enter
420 % the title classification in parentheses. This field is required.
421 %
422 % \paragraph{5a. CONTRACT NUMBER.}
423 % \DescribeMacro{\ContractNumber}
424 %
425 % \noindent
426 % Enter all contract numbers as they appear in the report, \eg
427 %
428 % \par\null\noindent
429 % \begin{tabular}{llll}
430 % ~~ & {\tt \cmd{\ContractNumber}\{F33615--86--C--5169\}} & $\rightarrow$ & F33615--86--C--5169
431 % \end{tabular}
432 %
433 % \paragraph{5b. GRANT NUMBER.}
434 % \DescribeMacro{\GrantNumber}
435 %
436 % \noindent
437 % Enter all grant numbers as they appear in the report, \eg
438 %
439 % \par\null\noindent
440 % \begin{tabular}{llll}
441 % ~~ & {\tt \cmd{\GrantNumber}\{AFOSR--82--1234\}} & $\rightarrow$ & AFOSR--82--1234
442 % \end{tabular}
443 %
444 % \paragraph{5c. PROGRAM ELEMENT NUMBER.}
445 % \DescribeMacro{\ProgramElementNumber}
446 %
447 % \noindent
448 % Enter all program element numbers as they appear in the report, \eg
449 %
450 % \par\null\noindent
451 % \begin{tabular}{llll}
452 % ~~ & {\tt \cmd{\ProgramElementNumber}\{61101A\}} & $\rightarrow$ & 61101A
453 % \end{tabular}
454 %
455 % \paragraph{5d. PROJECT NUMBER.}
456 % \DescribeMacro{\ProjectNumber}
457 %
458 % \noindent
459 % Enter all project numbers as they appear in the report, \eg
460 %
461 % \par\null\noindent
462 % \begin{tabular}{llll}
463 % ~~ & {\tt \cmd{\ProjectNumber}\{1F665702D1257; ILIR\}} & $\rightarrow$ & 1F665702D1257; ILIR
464 % \end{tabular}
465 %
466 % \paragraph{5e. TASK NUMBER.}
467 % \DescribeMacro{\TaskNumber}
468 %
469 % \noindent
470 % Enter all task numbers as they appear in the report, \eg
471 %
472 % \par\null\noindent
473 % \begin{tabular}{llll}
474 % ~~ & {\tt \cmd{\TaskNumber}\{05; RF0330201; T4112\}} & $\rightarrow$ & 05; RF0330201; T4112
475 % \end{tabular}
476 %
477 % \paragraph{5f. WORK UNIT NUMBER.}
478 % \DescribeMacro{\WorkUnitNumber}
479 %
480 % \noindent
481 % Enter all work unit numbers as they appear in the report, \eg
482 %
483 % \par\null\noindent
484 % \begin{tabular}{llll}
485 % ~~ & {\tt \cmd{\WorkUnitNumber}\{001; AFAPL30480105\}} & $\rightarrow$ & 001; AFAPL30480105
486 % \end{tabular}
487 %
488 % \paragraph{6. AUTHOR(S).}
489 % \DescribeMacro{\Author}
490 %
491 % \noindent
492 % Enter name(s) of the person(s) responsible for writing the report,
493 % performing the research, or credited with the content of the report.
494 % The form of entry is the last name, first name, middle initial, and
495 % additional qualifiers separated by commas, \eg
496 % \par\null\noindent
497 % \begin{tabular}{llll}
498 % ~~ & {\tt \cmd{\Author}\{Smith, Richard, J, Jr\}} & $\rightarrow$ & Smith, Richard, J, Jr
499 % \end{tabular}
500 % \par\null\noindent
501 % If editor or compiler, this should follow the name(s).
502 %
503 % \paragraph[7. PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES).]
504 % {\hbox to 1in{7. PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES).\hss}}
505 % \DescribeMacro{\PerformingOrg}
506 %
507 % \noindent
508 % Self-explanatory. This field is one of the best examples of one that
509 % may be defined in a configuration file that may be used for many
510 % papers. For an example of how to use a configuration file, see
511 % section~\ref{sec:configfile}.
512 %
513 % \paragraph{8. PERFORMING ORGANIZATION REPORT NUMBER.}
514 % \DescribeMacro{\POReportNumber}
515 %
516 % \noindent
517 % Enter the unique alphanumeric report number(s) assigned by the
518 % performing organization, \eg
519 % \par\null\noindent
520 % \begin{tabular}{llll}
521 % ~~ & \multicolumn{3}{l}{\tt \cmd{\POReportNumber}\{BRL--1234; AFWL--TR--85--4017--Vol21--PT--2\}} \\
522 % & \hspace{1in} & $\rightarrow$ & BRL--1234; AFWL--TR--85--4017--Vol21--PT--2
523 % \end{tabular}
524 %
525 % \paragraph{9. SPONSORING/MONITORING AGENCY NAME(S) AND ADDRESS(ES).}
526 % \DescribeMacro{\SponsoringAgency}
527 %
528 % \noindent
529 % Enter the name and address of the organization(s) financially
530 % responsible for and monitoring the work. If it is desired to place
531 % two organizations in this field, then they may be split up in two
532 % different ways, the first is to use two 2-line addresses with (for
533 % example) a % ``|\\[10pt]|'' line break after the first address to show
534 % both % the sponsoring and the monitoring agency addresses. The second
535 % method is to place the addresses in a |tabular| environment. An
536 % example of both methods is shown below.
537 % \begin{verbatim}
538 % \SponsoringAgency{%
539 % U.S. Government Sponsoring Department \\
540 % P.O. Box 92919, Miltown, AK 97909--6543 \\[10pt]
541 % U.S. Army Monitoring Agency \\
542 % 909 Mission Rd., Somecity, MD 29399--9753}
543 % \end{verbatim}
544 % \begin{verbatim}
545 % \SponsoringAgency{%
546 % \begin{tabular}{@{}l@{\hspace{5mm}}l@{}}
547 % U.S. Government Sponsoring Dept. & U.S. Government Monitoring Agency \\
548 % P.O. Box 92919 & 909 Mission Rd. \\
549 % Miltown, AK 97909--6543 & Somecity, MD 29399--9753
550 % \end{tabular}}
551 % \end{verbatim}
552 % These give the following, respectively:
553 % \par\null\noindent
554 % \frame{\vbox to 72.8pt{%
555 % \vfil
556 % \parbox{364.2pt}{%
557 % U.S. Government Sponsoring Dept. \\
558 % P.O. Box 92919, Miltown, AK 97909--6543 \\[10pt]
559 % U.S. Government Monitoring Agency \\
560 % 909 Mission Rd., Somecity, MD 29399--9753}%
561 % \vfil}}
562 % \par\null\noindent
563 % \frame{\vbox to 72.8pt{%
564 % \vfil
565 % \parbox{364.2pt}{%
566 % \begin{tabular}{@{}l@{\hspace{5mm}}l@{}}
567 % U.S. Government Sponsoring Dept. & U.S. Government Monitoring Agency \\
568 % P.O. Box 92919 & 909 Mission Rd. \\
569 % Miltown, AK 97909--6543 & Somecity, MD 29399--9753
570 % \end{tabular}}
571 % \vfil}}
572 %
573 % \paragraph{10. SPONSOR/MONITOR'S ACRONYM(S).}
574 % \DescribeMacro{\Acronyms}
575 %
576 % \noindent
577 % Enter any acronym(s) that pertain to the Sponsor/Monitor, separated
578 % with commas, if available, \eg
579 % \par\null\noindent
580 % \begin{tabular}{llll}
581 % ~~ & {\tt \cmd{\Acronyms}\{BRL, ARDEC, NADC\}} & $\rightarrow$ & BRL, ARDEC, NADC
582 % \end{tabular}
583 %
584 % \paragraph{11. SPONSOR/MONITOR'S REPORT NUMBER(S).}
585 % \DescribeMacro{\SMReportNumber}
586 %
587 % \noindent
588 % Enter the report number(s) as assigned by the sponsoring/monitoring
589 % agency, if available, \eg
590 % \par\null\noindent
591 % \begin{tabular}{llll}
592 % ~~ & {\tt \cmd{\SMReportNumber}\{BRL-TR--829\}} & $\rightarrow$ & BRL-TR--829
593 % \end{tabular}
594 %
595 % \paragraph{12. DISTRIBUTION/AVAILABILITY STATEMENT.}\hskip-3mm%
596 % \footnote{The \Lopt{floatlongboxes} option may shrink or enlarge this
597 % box vertically as it equalizes the vertical space for boxes 12--15.}
598 % \DescribeMacro{\DistributionStatement}
599 % \changes{v1.2}{22 Dec 2004}{Added note about the \Lopt{floatlongboxes}
600 % option.}
601 %
602 % \noindent
603 % Use agency-mandated availability statements to indicated the public
604 % availability or distribution limitations of the report. If additional
605 % limitations/restrictions or special markings are indicated follow
606 % agency authorization procedures, \eg, RD/FRD, PROPIN, ITAR.
607 % Include copyright information. This field is {\bf not} required, but will
608 % default to the first of the following examples:
609 % \par\null\noindent
610 % ``Approved for public release; distribution is unlimited.''
611 % \par\null\noindent
612 % ``Distribution authorized to DoD only; (reason and date). Other
613 % requests shall be referred to (controlling DoD office).''
614 % \par\null\noindent
615 % ``Further dissemination only as directed by (controlling DoD office
616 % and date) or higher DoD authority.''
617 % \par\null\noindent
618 % \hbox to \textwidth{%
619 % \begin{tabular}{l@{\space---\space}l}
620 % For DoD & See DoDD 5230.24, ``Distribution Statements on Technical
621 % Documents.''\\
622 % For DoE & See authorities.\\
623 % For NASA & See Handbook NHB 2200.2.\\
624 % For NTIS & Leave blank.
625 % \end{tabular}%
626 % \hss}
627 %
628 % \paragraph{13. SUPPLEMENTARY NOTES.}\hskip-3mm\addtocounter{footnote}{-1}\footnotemark
629 % \DescribeMacro{\SupplementaryNotes}
630 % \changes{v1.2}{22 Dec 2004}{Added note about the \Lopt{floatlongboxes}
631 % option.}
632 %
633 % \noindent
634 % Enter information not included elsewhere such as: ``Prepared in
635 % cooperation with\dots''; ``Translation of\dots''; ``To be published
636 % in\dots''. When a report is revised, include a statement whether the
637 % new report supersedes or supplements the older report and the older
638 % report number if different. ARO requires the following text:
639 % \begin{verse}\noindent
640 % ``The views, opinions and/or findings contained in this report
641 % are those of the authors and should not be construed as an
642 % official Department of Army position, policy or decision, unless
643 % so designated by other documentation.''
644 % \end{verse}
645 %
646 % \paragraph{14. ABSTRACT.}\hskip-3mm{\addtocounter{footnote}{-1}\footnotemark
647 % \DescribeMacro{\Abstract}
648 % \changes{v1.2}{22 Dec 2004}{Added note about the \Lopt{floatlongboxes}
649 % option.}
650 %
651 % \noindent
652 % Include a brief (approximately 200 words) factual summary of
653 % the most significant information contained in the report. This field
654 % is required.
655 %
656 % \paragraph{15. SUBJECT TERMS.}\hskip-3mm\addtocounter{footnote}{-1}\footnotemark
657 % \DescribeMacro{\SubjectTerms}
658 % \changes{v1.2}{22 Dec 2004}{Added note about the \Lopt{floatlongboxes}
659 % option.}
660 %
661 % \noindent
662 % Enter keywords or phrases identifying major subjects in the report.
663 % Separate key words and phrases with semicolons (;).
664 %
665 % \paragraph{16a. REPORT SECURITY CLASSIFICATION.}
666 % \DescribeMacro{\ReportClassification}
667 %
668 % \noindent
669 % Enter U.S.\ Security Classification in accordance with U.S.\ Security
670 % Regulations, \eg\ U, C, S, etc. If this form contains classified
671 % information, stamp classification level on the top and bottom of the
672 % page. This field is required, but will default to ``U'' (Unclassified).
673 %
674 % \paragraph{16b. ABSTRACT SECURITY CLASSIFICATION.}
675 % \DescribeMacro{\AbstractClassification}
676 %
677 % \noindent
678 % See 16a (above).
679 %
680 % \paragraph{16c. THIS PAGE SECURITY CLASSIFICATION.}
681 % \DescribeMacro{\PageClassification}
682 %
683 % \noindent
684 % See 16a (above).
685 %
686 % \paragraph{17. LIMITATION OF ABSTRACT.}
687 % \DescribeMacro{\AbstractLimitation}
688 %
689 % \noindent
690 % This block must be completed to assign a distribution limitation to
691 % the abstract. Enter either ``UU'' (Unclassified Unlimited) or ``SAR''
692 % (same as report). An entry in this block is necessary if the abstract
693 % is to be limited. If blank, the abstract is assumed to be unlimited.
694 % This field is {\bf not} required, but defaults to ``UU''.
695 %
696 % \paragraph{18. NUMBER OF PAGES.}
697 % \DescribeMacro{\NumberPages}
698 % \DescribeMacro{\NumberPages*}
699 %
700 % \noindent
701 % Enter the total number of pages (including including Roman numerals).
702 % This field is required. The current implementation of the \Lpack{sf298}
703 % package uses the \Lpack{totpages} package that is now commonly
704 % available with standard \LaTeX\ distributions or can be easily obtained
705 % from Internet accessible package distribution sites such as the
706 % The Com­pre­hen­sive TeX Archive Net­work (CTAN) (https://www.ctan.org/).
707 % You may ignore this field and a value will be entered on the page after the
708 % processing of the document with \LaTeX. As with labels and citations
709 % referenced in the document, a message will be printed if \LaTeX\ must
710 % be run again to propagate a correct label value to the sf298 form. If
711 % a value is given with this macro, then it {\bf will} be the one used
712 % on the form.
713 %
714 % There is also a star version of the \cmd{\NumberPages} macro that is
715 % only used with the \Lpack{totpages} package. This adds the given
716 % number of pages to the result rather than directly setting the page
717 % number. This macro is used when you are inserting a known number of
718 % pages, say for an appendix, into the document.
719 %
720 % \paragraph{19a. NAME OF RESPONSIBLE PERSON.}
721 % \DescribeMacro{\ResponsiblePerson}
722 %
723 % \noindent
724 % Enter the name of the person responsible for submission of the
725 % document.
726 %
727 % \paragraph{19b. TELEPHONE NUMBER OF RESPONSIBLE PERSON.}
728 % \DescribeMacro{\RPTelephone}
729 %
730 % \noindent
731 % Enter the telephone number of the person responsible for the
732 % submission of the document (including area code).
733 %
734 % \section{SF298 Form}
735 % \changes{v1.3}{23 Jun 2016}{Added section describing how to insert the Special
736 % Form 298 into the document.}
737 %
738 % The macro \cmd{\ReportDescription} will insert the standard form 298 on a
739 % separate page at the location where it appears. This will produce the Report
740 % Documentation page as appears earlier in this document.
741 %
742 % \section{General Instructions Page}
743 % \changes{v1.3}{20 Jun 2016}{Added section describing the option to
744 % add a General Instructions page.}
745 %
746 % Some government organizations require that a General Instructions
747 % page be included after the standard form 298. The macro
748 % \cmd{\GeneralInstructions\{\Lopt{typesize}\}} causes the page to be printed
749 % according to a generic type size, \eg \Lopt{footnotesize}. The \Lopt{typesize}
750 % argument was implemented to allow the end user control over the print size
751 % of the general instructions.
752 %
753 % The\cmd{\GeneralInstructions} command need simply be inserted into your
754 % \LaTeX\ document after the \cmd{\MakeRptDocPage} command. This will
755 % result in the following page appearing in the document.
756 %
757 % \newgeometry{textheight=1.1\textheight}
758 % \GeneralInstructions{small}
759 % \restoregeometry
760 %
761 % \section{Configuration}
762 % \enlargethispage{24pt}
763 %
764 % In order to make the use of the report documentation page as easy as
765 % possible, several aspects of the package are automated or can be easily
766 % configured.
767 %
768 % \subsection{Fonts}
769 % \label{sec:configfont}
770 %
771 % When the package is loaded it defines the fonts that are used by
772 % basing them on the font families \cmd{\sfdefault} for the field labels and
773 % \cmd{\rmdefault} for the text entries. By default, they will be based on
774 % the Computer Modern font family. If you are changing the base font
775 % families for your paper and you want the fonts used on the |sf298| to
776 % change also, then you must change the font families before loading the
777 % \Lpack{sf298} package. See \cite[pages 229,236]{Kopk-Daly93} for more
778 % information about the default font families.
779 %
780 % For any specific field, you can override the default font by
781 % declaring your preferred value along with your entry, \eg
782 % \par\null\noindent
783 % \begin{tabular}{llll}
784 % ~~ & {\tt \cmd{\Title}\{\cmd{\Huge} A Huge Title\}} & $\rightarrow$ & \smash{\Huge\lower.5ex\hbox{A Huge Title}}
785 % \end{tabular}
786 %
787 % \subsection{Configuration file}
788 % \label{sec:configfile}
789 %
790 % When the package is loaded, it searches along the standard \TeX\
791 % search path, as configured in the system and modified by
792 % the {\tt TEXINPUTS} environment variable (or equivalent) for the
793 % file \Lfile{sf298.cfg}. It loads the first such file that
794 % it finds and this file may be used to change defaults or make other
795 % changes to the \Lpack{sf298} package, \eg
796 % \par\null\noindent
797 % \begin{tabular}{ll@{}l}
798 % ~~ & {\tt \cmd{\PerformingOrg}\{} & {\tt Our Little Laboratory \cmd{\\[-1pt]}}\footnotemark \\[-1pt]
799 % & & {\tt Computer Science Department \cmd{\\[-1pt]}} \\[-1pt]
800 % & & {\tt The Big University \cmd{\\[-1pt]}} \\[-1pt]
801 % & & {\tt 9999 Avenue Street \cmd{\\[-1pt]}} \\[-1pt]
802 % & & {\tt Anytown, TX 19293--8765}
803 % \end{tabular}\footnotetext{Note that five lines are fit where only four are recommended in
804 % Table~\ref{tab:attributes} by shrinking the baselineskip by one point.}
805 % \par\null\noindent
806 % For an organization, other typical fields for inclusion in the
807 % configuration file are \cmd{\ResponsiblePerson} and
808 % \cmd{\RPTelephone}. For a set of papers that are part of the same
809 % contract, you could set the \TeX\ search path so that a local version
810 % of \Lfile{sf298.cfg} is loaded that first \cmd{\inputs} the more global
811 % one and then sets contract specific defaults associated with a single
812 % contract, \eg, \cmd{\ContractNumber}, \cmd{\Sponsoring Agency},
813 % \cmd{\Acronym}, {\it etc.\/}
814 %
815 % The option |noconfig| turns off the input of the configuration file.
816 % For symmetry, there exists an option |config|, but that is the
817 % default and does not need to be specified.
818 %
819 % \subsection{``Number of Pages'' field}
820 % \label{sec:configpage}
821 %
822 % The {\bf Number of Pages} field will be automatically filled-in by calculating the
823 % difference between the page count of the |sf298| page and the last
824 % page. If the \Lpack{totpages} package is not present, and if the field
825 % is not defined, a warning will be issued.
826 %
827 % If the {\bf Number of Pages} is incorrectly calculated, then the
828 % correct value can be explicitly defined with the \cmd{\NumberPage}
829 % macro or offset by a fixed value with the \cmd{\NumberPage*} macro.
830 % The former may be needed if the sf298 form is not the first page of
831 % the document. An example of the latter is where there is an
832 % appendix whose pages are inserted and are, therefore, not
833 % automatically counted.
834 %
835 % \subsection{Adjusting the form placement}
836 % \DescribeMacro{\LeftShift}
837 % \DescribeMacro{\DownShift}
838 % \changes{v1.1}{15 Feb 2000}{Changed reference of millimeters to big points.}
839 %
840 % \noindent
841 % Sometimes you need to adjust the placement of a large form, such as to
842 % provide an extra amount of margin space or for a different page size.
843 % These two macros allow this fine-tuning: \cmd{\LeftShift\{5\}} will cause
844 % the form to be shifted 5 big points to the left\@.\footnote{Note that
845 % there are no units here, the unit step is defined as one big point
846 % (1 bp) at the beginning of the \cmd{\MakeRptDocPage} command above by
847 % setting the \cmd{\unitlength}.} The \cmd{\DownShift\{-8.5\}} will cause the
848 % form to be shifted up $8\frac{1}{2}$ big points (\ie, down a negative
849 % $8\frac{1}{2}$ big points). For example, the following commands will
850 % center the sf298 form on A4 paper:
851 % \par\null\noindent
852 % \begin{tabular}{ll}
853 % ~~ & {\tt \cmd{\LeftShift}\{8.5\}} \\
854 % & {\tt \cmd{\DownShift}\{-22.0\}}
855 % \end{tabular}
856 %
857 % \section{An example of use with the \Lpack{article} class}
858 % \label{sec:sample}
859 % \iffalse
860 %<*sample>
861 % \fi%
862 %
863 % This sample program demonstrates how the \Lpack{sf298} package may
864 % be used and integrated with an existing class. Here we redefine
865 % \cmd{\@makefile} so that we can create a titlepage and report
866 % documentation page that share a common set of fields, such as the
867 % report title, the performing organization title and address and the
868 % report abstract.
869 %
870 % First we have to start the paper as an \Lpack{article} with twosided
871 % pages and using the \Lpack{sf298} package. We also make the `@' a
872 % letter so that we can update some internal names.
873 %
874 % \begin{macrocode}
875 \documentclass[twoside]{article}
876 \usepackage{sf298}
877
878 \setlength{\parindent}{5ex}
879 \setlength{\paperwidth}{8.5in}
880 \setlength{\textwidth}{6.5in}
881 \setlength{\oddsidemargin}{0in}
882 \setlength{\evensidemargin}{0in}
883
884 \makeatletter
885 % \end{macrocode}
886 %
887 % \begin{macro}{\@maketitle}
888 %
889 % We modify the standard \cmd{\@maketitle} so that the title and author's
890 % address (from the internal \cmd{\sf@PeformingOrg} value) are
891 % integrated into the standard titlepage layout. This may not always be
892 % the best approach, since the blocks may contain different internal
893 % layout information on the title page and on the report documentation
894 % page. Here, the \cmd{\@date} macro is used for the date rather than
895 % \cmd{\sf@ReportDate} and similarly for the author's names, since the
896 % desired format is different for these fields, even though the
897 % information is the same. Another way to do the same thing is to
898 % define the macro to parse and format these values as desired in each
899 % case.
900 %
901 % As much as possible, a document class that generates both a titlepage
902 % and the report documentation page (sf298) should allow the common
903 % information to be entered only once.
904 %
905 % \begin{macrocode}
906 \renewcommand{\@maketitle}{%
907 \newpage
908 \null
909 \vskip 2em%
910 \begin{center}%
911 \let\footnote\thanks
912 {\LARGE\sf@Title\par}%
913 \vskip 1.5em%
914 {\large
915 \lineskip .5em%
916 \begin{tabular}[t]{c}%
917 \@author\\[10pt]
918 \sf@PerformingOrg
919 \end{tabular}\par}%
920 \vskip 1em%
921 {\large\@date}%
922 \end{center}%
923 \par
924 \vskip 1.5em}
925 % \end{macrocode}
926 % \end{macro}
927 %
928 % \begin{macro}{\showabstract}
929 %
930 % The next macro, \cmd{\showabstract} shows one method of pulling the
931 % abstract text out of the internal (``hidden'') define, in order to
932 % include it on the titlepage as we show in the accompanying
933 % \Lfile{sample298.txt} file. We just have to make sure that we use it
934 % before making the report documentation page, since this data is
935 % thrown away after that.
936 %
937 % \begin{macrocode}
938 \newcommand{\showabstract}{%
939 \noindent
940 \sf@Abstract}
941 % \end{macrocode}
942 % \end{macro}
943 %
944 % We are finished with our example integration, so we close off changing
945 % the internals and make `@' an ``other'' once more.
946 %
947 % \begin{macrocode}
948 \makeatother
949 % \end{macrocode}
950 %
951 % Now we fill in the fields needed for the title and the report
952 % documentation pages. For reference as a template, we have entered all
953 % of the \Lpack{sf298} block macros below. The ones that are not being
954 % used are commented out. Note that although block 7 (Performing Organization Name)
955 % is rated at four lines according to Table~\ref{tab:attributes}, we can fit five
956 % lines if we compress them a little. Depending on your base font family and
957 % such small adjustments, you can probably fit any reasonable set of information
958 % onto this form in the way that you want to.
959 %
960 % \begin{macrocode}
961 \date{June 1996}
962 \ReportDate{10--06--1996}
963 \ReportType{Final}
964 \DatesCovered{1 June 1996 --- 31 May 1999}
965 \Title{Final Report Title\thanks{We wish to thank all those who helped with
966 this project. The views and conclusions contained
967 in this document are those of the authors and should
968 not be interpreted as representing anyone else.}}
969 \ContractNumber{DACA99--99--C--9999}
970 %\GrantNumber{}
971 %\ProgramElementNumber{}
972 %\ProjectNumber{}
973 %\TaskNumber{}
974 %\WorkUnitNumber{}
975 \author{Joe A. Uthor and Jane E. Ditor}
976 \Author{Uthor, Joe, A., and Ditor, Jane, E.}
977 \PerformingOrg{%
978 Our Little Laboratory\\[-1pt]
979 Computer Science Department\\[-1pt]
980 The Big University\\[-1pt]
981 9999 Avenue Street\\[-1pt]
982 Anytown, TX 19293--8765}
983 %\POReportNumber{}
984 \SponsoringAgency{%
985 U.S. Army Sponsoring Department\\
986 P.O. Box 92919, Miltown, AK 97909--6543\\[10pt]
987 U.S. Army Monitoring Agency\\
988 909 Mission Rd., Somecity, MD 29399--9753}
989 %\Acronyms{}
990 %\SMReportNumber{}
991 %\DistributionStatement{}
992 \SupplementaryNotes{%
993 The views, opinions and/or findings contained in this report are
994 those of the authors and should not be construed as an official
995 U.S.\ Government position, policy or decision, unless so designated
996 by other documentation.}
997 \Abstract{%
998 This sample paper shows one way to use the sf298 package along with
999 the article documentclass to generate a paper with the standard form 298
1000 as the second physical page in the document.
1001
1002 In addition, the common text of the title, authors and abstract are
1003 shared and the ``{\tt \string\thanks}'' macro is treated specially so
1004 that it is active for the titlepage and inactive for the report
1005 documentation page.}
1006 \SubjectTerms{keywords; associated words; other words}
1007 %\NumberPages{}
1008 %\ReportClassification{}
1009 %\PageClassification{}
1010 %\AbstractClassification{}
1011 \AbstractLimitation{UU}
1012 \ResponsiblePerson{Mr.\ Joe A. Uthor}
1013 \RPTelephone{(412) 555--9999}
1014 % \end{macrocode}
1015 %
1016 % Finally we begin a very simple report. First we print the titlepage
1017 % and the abstract. Next the report documentation and general
1018 % instructions pages are written. Following these two pages, the
1019 % table of contents is output, followed by the very short report.
1020 %
1021 % \begin{macrocode}
1022 \begin{document}
1023 \pagenumbering{roman}
1024
1025 \maketitle\thispagestyle{empty}
1026 \begin{abstract}
1027 \showabstract
1028 \end{abstract}
1029
1030 \ReportDescription
1031
1032 \GeneralInstructions{small}
1033
1034 \tableofcontents
1035 \cleardoublepage
1036 \pagenumbering{arabic}
1037 \setcounter{page}{1}
1038
1039 \section{Introduction}
1040
1041 Blah, blah and blah.
1042
1043 \section{Conclusion}
1044
1045 More blah, blah and blah.
1046
1047 \end{document}
1048 % \end{macrocode}
1049 % \iffalse
1050 %</sample>
1051 % \fi%
1052 %
1053 % \StopEventually{%
1054 % \section{Acknowledgments}
1055 %
1056 % Dr. Cochran would like to thank Professor Bruce M. Boghosian at the Center for
1057 % Computational Science, Boston University ([email protected]) for
1058 % discovering problems with the use of a PostScript background for the
1059 % sf298 form which convinced him to original write the entire package in \LaTeX\
1060 % (versions 1.1 \& 1.2). Also, to Dr.\ Nino Pereira ([email protected]) for the
1061 % suggestion to make some of the fields more flexible.
1062 %
1063 % Dr. Rochford would like to thank Dr. Cochran for creating the orginal version of
1064 % the package, to which he added the option of providing the page of General
1065 % Instructions (version 1.3).
1066 %
1067 % \begin{thebibliography}{6}%
1068 % \bibitem{Mull99}%
1069 % Wihelm M\"uller,
1070 % \emph{The \Lpack{totpages} package},
1071 % 1999/07/13.
1072 % \bibitem{Kopk-Daly93}%
1073 % Michel Goossens, Framk Mittelbach, and Alexander Samarin,
1074 % \emph{A Guide to \LaTeXe},
1075 % 1993, 2$^{nd}$ edition (revised 1995).
1076 % \end{thebibliography}}
1077 %
1078 % \section{The {\tt DOCSTRIP} modules}
1079 % The following modules are used in the implementation to direct
1080 % {\tt DOCSCRIPT} in generating the external files:
1081 % \begin{tabular}[t]{ll}
1082 % driver & produces a documentation driver file.\\
1083 % package & produces the package sf298.sty.\\
1084 % sample & produces a sample \LaTeX\ template and test file.
1085 % \end{tabular}
1086 %
1087 % \newpage
1088 % \section{The code}
1089 % \iffalse
1090 %<*package>
1091 % \fi%
1092 % \subsection{Identification}
1093 %
1094 % \changes{v1.1}{15 Feb 2000}{No longer require the graphicx package.}
1095 % \changes{v1.2}{22 Dec 2004}{Updated package ID.}
1096 %
1097 % \begin{macrocode}
1098 \NeedsTeXFormat{LaTeX2e}
1099 \ProvidesPackage{sf298}[2016/07/07 Standard Form 298]
1100 \typeout{Package: sf298 2016/07/07 v1.3)}
1101 \providecommand{\eg}{{\it e.g.\/\ }}
1102 % \end{macrocode}
1103 %
1104 % \subsection{Load the \Lpack{totpages} package, if it exists.}
1105 %
1106 % \begin{macro}{\sf@page}
1107 % \changes{v1.1}{22 Feb 2000}{Added the optional loading of the
1108 % {\sf totpages} package. If present, then the total pages block
1109 % is automatically set.}
1110 %
1111 % Check to see if the \Lpack{totpages} package is present. If it is,
1112 % then load the package and create a local page counter for use in
1113 % calculating the actual total pages.
1114 %
1115 % \begin{macrocode}
1116 \IfFileExists{totpages.sty}{%
1117 \usepackage{totpages}
1118 \newcounter{sf@page}}{}
1119 % \end{macrocode}
1120 % \end{macro}
1121 %
1122 % \subsection{Load the \Lpack{multicol} package.}
1123 %
1124 % \changes{v1.3}{20 Jun 2016}{Added the multicol package to support multi-column formatting
1125 % for the General Instructions page.}
1126 %
1127 % Check to see if the \Lpack{multicol} package is present. If it is, then load the package to
1128 % support multi-column formatting for the General Instructions page. If it is not present then
1129 % report error and terminate.
1130 %
1131 % \begin{macrocode}
1132 \IfFileExists{multicol.sty}{%
1133 \usepackage{multicol}}
1134 {\PackageError {sf298}{The multicol package was not found.}
1135 {Install the multicol package on your system.}}
1136 % \end{macrocode}
1137 %
1138 % \subsection{Load the \Lpack{fancyhdr} Package}
1139 %
1140 % Check to see if the \Lpack{fancyhdr} package is present. If it is, then load the package to
1141 % define a custom footer. If it is not present then report error and terminate. This package
1142 % is needed to define a custom footer where the form identifier appears on the General
1143 % Instructions produced by \cmd{\GeneralInstructions}.
1144 %
1145 % \begin{macrocode}
1146 \IfFileExists{fancyhdr.sty}{%
1147 \usepackage{fancyhdr}}
1148 {\PackageError {sf298}{The fancyhdr package was not found.}
1149 {Install the fancyhdr package on your system.}}
1150 % \end{macrocode}
1151 %
1152 % \subsection{Create the user interface}
1153 %
1154 % \changes{v1.1}{22 Feb 2000}{Moved user interface commands and default
1155 % prior to loading a configuration file}
1156 %
1157 % The following macros define the external and internal portions of the
1158 % user interface. These macros are used to fill the various blocks of
1159 % the form. All but one of the macros have the same pattern: a public
1160 % version which sets the internal value, both based on the block name.
1161 % The exception is the \cmd{\NumberPages} macro that has a starred form
1162 % for special use when the \Lpack{totpages} when the page count is
1163 % calculated automatically (see below).
1164 %
1165 % \begin{macro}{\ReportDate}
1166 % \begin{macro}{\sf@ReportDate}
1167 % \begin{macrocode}
1168 \newcommand\ReportDate[1]{\renewcommand\sf@ReportDate{#1}}
1169 \newcommand\sf@ReportDate{\number\day--\number\month--\number\year}
1170 % \end{macrocode}
1171 % \end{macro}
1172 % \end{macro}
1173 %
1174 % \begin{macro}{\ReportType}
1175 % \begin{macro}{\sf@ReportType}
1176 % \begin{macrocode}
1177 \newcommand\ReportType[1]{\renewcommand\sf@ReportType{#1}}
1178 \newcommand\sf@ReportType{\relax}
1179 % \end{macrocode}
1180 % \end{macro}
1181 % \end{macro}
1182 %
1183 % \begin{macro}{\DatesCovered}
1184 % \begin{macro}{\sf@DatesCovered}
1185 % \begin{macrocode}
1186 \newcommand\DatesCovered[1]{\renewcommand\sf@DatesCovered{#1}}
1187 \newcommand\sf@DatesCovered{\relax}
1188 % \end{macrocode}
1189 % \end{macro}
1190 % \end{macro}
1191 %
1192 % \begin{macro}{\Title}
1193 % \begin{macro}{\sf@Title}
1194 % \begin{macrocode}
1195 \newcommand\Title[1]{\renewcommand\sf@Title{#1}}
1196 \newcommand\sf@Title{\relax}
1197 % \end{macrocode}
1198 % \end{macro}
1199 % \end{macro}
1200 %
1201 % \begin{macro}{\ContractNumber}
1202 % \begin{macro}{\sf@ContractNumber}
1203 % \begin{macrocode}
1204 \newcommand\ContractNumber[1]{\renewcommand\sf@ContractNumber{#1}}
1205 \newcommand\sf@ContractNumber{\relax}
1206 % \end{macrocode}
1207 % \end{macro}
1208 % \end{macro}
1209 %
1210 % \begin{macro}{\GrantNumber}
1211 % \begin{macro}{\sf@GrantNumber}
1212 % \begin{macrocode}
1213 \newcommand\GrantNumber[1]{\renewcommand\sf@GrantNumber{#1}}
1214 \newcommand\sf@GrantNumber{\relax}
1215 % \end{macrocode}
1216 % \end{macro}
1217 % \end{macro}
1218 %
1219 % \begin{macro}{\ProgramElementNumber}
1220 % \begin{macro}{\sf@ProgramElementNumber}
1221 % \begin{macrocode}
1222 \newcommand\ProgramElementNumber[1]{\renewcommand\sf@ProgramElementNumber{#1}}
1223 \newcommand\sf@ProgramElementNumber{\relax}
1224 % \end{macrocode}
1225 % \end{macro}
1226 % \end{macro}
1227 %
1228 % \begin{macro}{\ProjectNumber}
1229 % \begin{macro}{\sf@ProjectNumber}
1230 % \begin{macrocode}
1231 \newcommand\ProjectNumber[1]{\renewcommand\sf@ProjectNumber{#1}}
1232 \newcommand\sf@ProjectNumber{\relax}
1233 % \end{macrocode}
1234 % \end{macro}
1235 % \end{macro}
1236 %
1237 % \begin{macro}{\TaskNumber}
1238 % \begin{macro}{\sf@TaskNumber}
1239 % \begin{macrocode}
1240 \newcommand\TaskNumber[1]{\renewcommand\sf@TaskNumber{#1}}
1241 \newcommand\sf@TaskNumber{\relax}
1242 % \end{macrocode}
1243 % \end{macro}
1244 % \end{macro}
1245 %
1246 % \begin{macro}{\WorkUnitNumber}
1247 % \begin{macro}{\sf@WorkUnitNumber}
1248 % \begin{macrocode}
1249 \newcommand\WorkUnitNumber[1]{\renewcommand\sf@WorkUnitNumber{#1}}
1250 \newcommand\sf@WorkUnitNumber{\relax}
1251 % \end{macrocode}
1252 % \end{macro}
1253 % \end{macro}
1254 %
1255 % \begin{macro}{\Author}
1256 % \begin{macro}{\sf@Author}
1257 % \begin{macrocode}
1258 \newcommand\Author[1]{\renewcommand\sf@Author{#1}}
1259 \newcommand\sf@Author{\relax}
1260 % \end{macrocode}
1261 % \end{macro}
1262 % \end{macro}
1263 %
1264 % \begin{macro}{\PerformingOrg}
1265 % \begin{macro}{\sf@PerformingOrg}
1266 % \begin{macrocode}
1267 \newcommand\PerformingOrg[1]{\renewcommand\sf@PerformingOrg{#1}}
1268 \newcommand\sf@PerformingOrg{\relax}
1269 % \end{macrocode}
1270 % \end{macro}
1271 % \end{macro}
1272 %
1273 % \begin{macro}{\POReportNumber}
1274 % \begin{macro}{\sf@POReportNumber}
1275 % \begin{macrocode}
1276 \newcommand\POReportNumber[1]{\renewcommand\sf@POReportNumber{#1}}
1277 \newcommand\sf@POReportNumber{\relax}
1278 % \end{macrocode}
1279 % \end{macro}
1280 % \end{macro}
1281 %
1282 % \begin{macro}{\SponsoringAgency}
1283 % \begin{macro}{\sf@SponsoringAgency}
1284 % \begin{macrocode}
1285 \newcommand\SponsoringAgency[1]{\renewcommand\sf@SponsoringAgency{#1}}
1286 \newcommand\sf@SponsoringAgency{\relax}
1287 % \end{macrocode}
1288 % \end{macro}
1289 % \end{macro}
1290 %
1291 % \begin{macro}{\Acronyms}
1292 % \begin{macro}{\sf@Acronyms}
1293 % \begin{macrocode}
1294 \newcommand\Acronyms[1]{\renewcommand\sf@Acronyms{#1}}
1295 \newcommand\sf@Acronyms{\relax}
1296 % \end{macrocode}
1297 % \end{macro}
1298 % \end{macro}
1299 %
1300 % \begin{macro}{\SMReportNumber}
1301 % \begin{macro}{\sf@SMReportNumber}
1302 % \begin{macrocode}
1303 \newcommand\SMReportNumber[1]{\renewcommand\sf@SMReportNumber{#1}}
1304 \newcommand\sf@SMReportNumber{\relax}
1305 % \end{macrocode}
1306 % \end{macro}
1307 % \end{macro}
1308 %
1309 % \begin{macro}{\DistributionStatement}
1310 % \begin{macro}{\sf@DistributionStatement}
1311 % \begin{macrocode}
1312 \newcommand\DistributionStatement[1]{%
1313 \renewcommand\sf@DistributionStatement{#1}}
1314 \newcommand\sf@DistributionStatement{Approval for public release;
1315 distribution is unlimited.}
1316 % \end{macrocode}
1317 % \end{macro}
1318 % \end{macro}
1319 %
1320 % \begin{macro}{\SupplementaryNotes}
1321 % \begin{macro}{\sf@SupplementaryNotes}
1322 % \begin{macrocode}
1323 \newcommand\SupplementaryNotes[1]{\renewcommand\sf@SupplementaryNotes{#1}}
1324 \newcommand\sf@SupplementaryNotes{\relax}
1325 % \end{macrocode}
1326 % \end{macro}
1327 % \end{macro}
1328 %
1329 % \begin{macro}{\Abstract}
1330 % \begin{macro}{\sf@Abstract}
1331 % \begin{macrocode}
1332 \newcommand\Abstract[1]{\renewcommand\sf@Abstract{#1}}
1333 \newcommand\sf@Abstract{\relax}
1334 % \end{macrocode}
1335 % \end{macro}
1336 % \end{macro}
1337 %
1338 % \begin{macro}{\SubjectTerms}
1339 % \begin{macro}{\sf@SubjectTerms}
1340 % \begin{macrocode}
1341 \newcommand\SubjectTerms[1]{\renewcommand\sf@SubjectTerms{#1}}
1342 \newcommand\sf@SubjectTerms{\relax}
1343 % \end{macrocode}
1344 % \end{macro}
1345 % \end{macro}
1346 %
1347 % \begin{macro}{\ReportClassification}
1348 % \begin{macro}{\sf@ReportClassification}
1349 % \begin{macrocode}
1350 \newcommand\ReportClassification[1]{\renewcommand\sf@ReportClassification{#1}}
1351 \newcommand\sf@ReportClassification{U}
1352 % \end{macrocode}
1353 % \end{macro}
1354 % \end{macro}
1355 %
1356 % \begin{macro}{\AbstractClassification}
1357 % \begin{macro}{\sf@AbstractClassification}
1358 % \begin{macrocode}
1359 \newcommand\AbstractClassification[1]{%
1360 \renewcommand\sf@AbstractClassification{#1}}
1361 \newcommand\sf@AbstractClassification{U}
1362 % \end{macrocode}
1363 % \end{macro}
1364 % \end{macro}
1365 %
1366 % \begin{macro}{\PageClassification}
1367 % \begin{macro}{\sf@PageClassification}
1368 % \begin{macrocode}
1369 \newcommand\PageClassification[1]{\renewcommand\sf@PageClassification{#1}}
1370 \newcommand\sf@PageClassification{U}
1371 % \end{macrocode}
1372 % \end{macro}
1373 % \end{macro}
1374 %
1375 % \begin{macro}{\AbstractLimitation}
1376 % \begin{macro}{\sf@AbstractLimitation}
1377 % \begin{macrocode}
1378 \newcommand\AbstractLimitation[1]{\renewcommand\sf@AbstractLimitation{#1}}
1379 \newcommand\sf@AbstractLimitation{UU}
1380 % \end{macrocode}
1381 % \end{macro}
1382 % \end{macro}
1383 %
1384 % \begin{macro}{\ResponsiblePerson}
1385 % \begin{macro}{\sf@ResponsiblePerson}
1386 % \begin{macrocode}
1387 \newcommand\ResponsiblePerson[1]{\renewcommand\sf@ResponsiblePerson{#1}}
1388 \newcommand\sf@ResponsiblePerson{\relax}
1389 % \end{macrocode}
1390 % \end{macro}
1391 % \end{macro}
1392 %
1393 % \begin{macro}{\RPTelephone}
1394 % \begin{macro}{\sf@RPTelephone}
1395 % \begin{macrocode}
1396 \newcommand\RPTelephone[1]{\renewcommand\sf@RPTelephone{#1}}
1397 \newcommand\sf@RPTelephone{\relax}
1398 % \end{macrocode}
1399 % \end{macro}
1400 % \end{macro}
1401 %
1402 % \begin{macro}{\NumberPages}
1403 % \begin{macro}{\NumberPages*}
1404 % \changes{v1.1}{29 Feb 2000}{Added ability to offset the automatic
1405 % number of pages calculation.}
1406 %
1407 % The \cmd{\NumberPages} macro that has a both a regular form
1408 % (\cmd{\NumberPages}) that is used when setting the number of pages,
1409 % and a starred form (\cmd{\NumberPages*}) that is used to offset
1410 % the automatically calculated number of pages calculated using the
1411 % \Lpack{totpages} package. The value supplied by the starred form
1412 % is added to account for inserted pages that are not part of the
1413 % \LaTeX\ paper. For instance, when you are inserting a known number of
1414 % pages from an alternative source, say for an appendix, into the
1415 % document.
1416 %
1417 % The \cmd{\NumberPages} macro looks ahead for an asterisk and if it
1418 % finds one, then it ``eats'' it and passes the argument to the internal
1419 % \cmd{\sf@SNumberPages} macro where it is stored for later use to with the
1420 % total pages calculation. Otherwise, it sends the argument to
1421 % the \cmd{\sf@NNumberPages} macro where it becomes the actual page number.
1422 %
1423 % \begin{macrocode}
1424 \newcommand\NumberPages{%
1425 \@ifnextchar *%
1426 {\def\@tempa*{\sf@SNumberPages}%
1427 \@tempa}%
1428 {\sf@NNumberPages}}
1429 % \end{macrocode}
1430 % \end{macro}
1431 % \end{macro}
1432 %
1433 % \begin{macro}{\sf@NNumberPages}
1434 % \begin{macro}{\sf@NumberPages}
1435 % \begin{macrocode}
1436 \newcommand\sf@NNumberPages[1]{\renewcommand\sf@NumberPages{#1}}
1437 \newcommand\sf@NumberPages{\relax}
1438 % \end{macrocode}
1439 % \end{macro}
1440 % \end{macro}
1441 %
1442 % \begin{macro}{\sf@SNumberPages}
1443 % \begin{macro}{\sf@ExtraPages}
1444 % \begin{macrocode}
1445 \newcommand\sf@SNumberPages[1]{\renewcommand\sf@ExtraPages{#1}}
1446 \newcommand\sf@ExtraPages{0}
1447 % \end{macrocode}
1448 % \end{macro}
1449 % \end{macro}
1450 %
1451 % \begin{macro}{\fancypagestyle}
1452 % The macro \cmd{\fancypagestyle\{sf298FormIDStyle\}} is defined so the
1453 % form identifier for the General Instructions page can be placed at the bottom
1454 % of the page, namely ``{\bfseries Standard Form 298 Back} (Rev.\ 8/98)''.
1455 % \end{macro}
1456 %
1457 % \begin{macrocode}
1458 \fancypagestyle{sf298FormIDStyle}
1459 {\fancyhf{}\renewcommand{\headrulewidth}{0pt}
1460 \fancyfoot[R]{\footnotesize {\bfseries Standard Form 298 Back} (Rev.\ 8/98)} }
1461 % \end{macrocode}
1462 %
1463 % \subsection{Options Processing: Check for a configuration file}
1464 %
1465 % \changes{v1.1}{29 Feb 2000}{Added option to turn on/off the
1466 % configuration file check.}
1467 % \changes{v1.1}{22 Feb 2000}{Added check for a configuration file.}
1468 % \changes{v1.2}{22 Dec 2004}{Added new option: [no]floatlongboxes.}
1469 %
1470 % First we define a switch that we can set with the optional arguments
1471 % and then declare the optional arguments themselves.
1472 %
1473 % \begin{macrocode}
1474 \DeclareOption{config}{\def\sf@config{Y}}
1475 \DeclareOption{noconfig}{\def\sf@config{N}}
1476 % \end{macrocode}
1477 %
1478 % Second, we define an option that floats the four long boxes near
1479 % the bottom of the page. This allows for more flexibility in the
1480 % layout without greatly modifying the standard form.
1481 %
1482 % \begin{macrocode}
1483 \newif\ifsf@floatlongboxes
1484 \DeclareOption{floatlongboxes}{\sf@floatlongboxestrue}
1485 \DeclareOption{nofloatlongboxes}{\sf@floatlongboxesfalse}
1486 % \end{macrocode}
1487 %
1488 % Next we process the optional arguments. We set the default
1489 % to read the configuration file and process any options to
1490 % allow the user to turn it off. Then, depending on the
1491 % current value of the configuration switch, we check for the
1492 % configuration file.
1493 %
1494 % \begin{macrocode}
1495 \ExecuteOptions{config,nofloatlongboxes}
1496 \ProcessOptions
1497 % \end{macrocode}
1498 %
1499 % \begin{macrocode}
1500 \if Y\sf@config
1501 \InputIfFileExists{sf298.cfg}{}{}
1502 \fi
1503 \let\sf@config\relax
1504 % \end{macrocode}
1505 %
1506 % \subsection{Form placement fine tuning}
1507 %
1508 % \begin{macro}{\LeftShift}
1509 % \begin{macro}{\DownShift}
1510 %
1511 % These two macros allow the user to set any offset for the form. This
1512 % allows fine tuning of the form placement as necessary.
1513 %
1514 % \begin{macrocode}
1515 \newcommand\LeftShift[1]{\renewcommand\sf@LeftShift{#1}}
1516 \newcommand\sf@LeftShift{0}
1517 % \end{macrocode}
1518 %
1519 % \begin{macrocode}
1520 \newcommand\DownShift[1]{\renewcommand\sf@DownShift{#1}}
1521 \newcommand\sf@DownShift{0}
1522 % \end{macrocode}
1523 % \end{macro}
1524 % \end{macro}
1525 %
1526 % \subsection{Font definition}
1527 % \changes{v1.3}{20 Jun 2016}{Changed fonts for form identifiers at bottom of page.}
1528 %
1529 % \begin{macro}{\sf@setfont}
1530 % \changes{v1.1}{15 Feb 2000}{Added titlefonts to support a \LaTeX-based
1531 % blank form (rather than the previous PostScript one). Added setfont
1532 % stuff to fix weird things that can be done to upset a fixed format.}
1533 %
1534 % This macro is used to set the baseline and insure that the interword
1535 % spacing has not been changed by evil outside influences when
1536 % typesetting the form titles and entries.
1537 %
1538 % \begin{macrocode}
1539 \newcommand{\sf@setfont}[2]{%
1540 \renewcommand{\baselinestretch}{1.0}%
1541 \setlength{\baselineskip}{#2}%
1542 \setlength{\normalbaselineskip}{\baselineskip}%
1543 #1
1544 \spaceskip=\fontdimen2\font % space between words (\raggedright)
1545 \xspaceskip=\fontdimen2\font
1546 \advance\xspaceskip by\fontdimen7\font}
1547 % \end{macrocode}
1548 % \end{macro}
1549 %
1550 % \begin{macro}{\sf@strut}
1551 % \changes{v1.1}{15 Feb 2000}{Added strut to space the block heading at the
1552 % exactly proper position in the upper left corner.}
1553 %
1554 % This strut is added at the beginning of each block title to place the
1555 % title text at the desired offset from the upper left corner of the
1556 % block.
1557 %
1558 % \begin{macrocode}
1559 \newcommand{\sf@strut}{\rule{0pt}{7pt}}
1560 % \end{macrocode}
1561 % \end{macro}
1562 %
1563 % \begin{macro}{\sf@titlefontA}
1564 % \begin{macro}{\sf@settitlefontA}
1565 % \begin{macro}{\sf@titlefontB}
1566 % \begin{macro}{\sf@settitlefontB}
1567 % \begin{macro}{\sf@titlefontC}
1568 % \begin{macro}{\sf@settitlefontC}
1569 % \begin{macro}{\sf@titlefontD}
1570 % \begin{macro}{\sf@settitlefontD}
1571 % \begin{macro}{\sf@titlefontE}
1572 % \begin{macro}{\sf@settitlefontE}
1573 % \begin{macro}{\sf@titlefontF}
1574 % \begin{macro}{\sf@settitlefontF}
1575 % \changes{v1.1}{22 Feb 2000}{Changed font declarations to use
1576 % \cmd{\sfdefault} so that they will adjust to the preferred font family.}
1577 %
1578 % The form headings are set with Sans Serif at 14-, 11-, 8-, and 6-point
1579 % sizes and a couple of different shapes and sizes. Each font is
1580 % actually set by the related \cmd{\settitlefont?} macro which switches
1581 % to the indicated fixed font, sets the new baseline and protects the
1582 % text from external settings. The actual font family used depends on
1583 % the current setting of \cmd{\sfdefault} \cite[pages 229,236]{Kopk-Daly93}.
1584 %
1585 % \begin{macrocode}
1586 \DeclareFixedFont{\sf@titlefontA}{OT1}{\sfdefault}{bx}{n}{\@xivpt}
1587 \newcommand{\sf@settitlefontA}{\sf@setfont{\sf@titlefontA}{18pt}}
1588 % \end{macrocode}
1589 %
1590 % \begin{macrocode}
1591 \DeclareFixedFont{\sf@titlefontB}{OT1}{\sfdefault}{m}{sl}{\@xipt}
1592 \newcommand{\sf@settitlefontB}{\sf@setfont{\sf@titlefontB}{13.6pt}}
1593 % \end{macrocode}
1594 %
1595 % \begin{macrocode}
1596 \DeclareFixedFont{\sf@titlefontC}{OT1}{\sfdefault}{m}{n}{\@vipt}
1597 \newcommand{\sf@settitlefontC}{\sf@setfont{\sf@titlefontC}{7pt}}
1598 % \end{macrocode}
1599 %
1600 % \begin{macrocode}
1601 \DeclareFixedFont{\sf@titlefontD}{OT1}{\sfdefault}{bx}{n}{\@vipt}
1602 \newcommand{\sf@settitlefontD}{\sf@setfont{\sf@titlefontD}{7pt}}
1603 % \end{macrocode}
1604 %
1605 % \begin{macrocode}
1606 \DeclareFixedFont{\sf@titlefontE}{OT1}{\sfdefault}{bx}{n}{\@viiipt}
1607 \newcommand{\sf@settitlefontE}{\sf@setfont{\sf@titlefontE}{9.5pt}}
1608 % \end{macrocode}
1609 %
1610 % \begin{macrocode}
1611 \DeclareFixedFont{\sf@titlefontF}{OT1}{\sfdefault}{m}{sl}{\@viiipt}
1612 \newcommand{\sf@settitlefontF}{\sf@setfont{\sf@titlefontF}{9.5pt}}
1613 % \end{macrocode}
1614 % \end{macro}
1615 % \end{macro}
1616 % \end{macro}
1617 % \end{macro}
1618 % \end{macro}
1619 % \end{macro}
1620 % \end{macro}
1621 % \end{macro}
1622 % \end{macro}
1623 % \end{macro}
1624 % \end{macro}
1625 % \end{macro}
1626 % \begin{macro}{\sf@entryfont}
1627 % \begin{macro}{\sf@setentryfont}
1628 % \changes{v1.1}{22 Feb 2000}{Changed font declaration to use
1629 % \cmd{\rmdefault} so that it will adjust to the preferred font family.}
1630 %
1631 % The form is filled in with Roman 10-point text. This insures that the
1632 % text will reasonably fit in the form boxes and will not vary with
1633 % the choice of the normal fontsize of the document. As with the title
1634 % fonts, above, the entry font is actually set by the related
1635 % \cmd{\setentryfont} macro. The actual font family used depends on
1636 % the current setting of \cmd{\rmdefault}
1637 % \cite[pages 229,236]{Kopk-Daly93}.
1638 %
1639 % \begin{macrocode}
1640 \DeclareFixedFont{\sf@entryfont}{OT1}{\rmdefault}{m}{n}{\@xpt}
1641 \newcommand{\sf@setentryfont}{\sf@setfont{\sf@entryfont}{11pt}}
1642 % \end{macrocode}
1643 % \end{macro}
1644 % \end{macro}
1645 % \begin{macro}{\sf@revfontbold}
1646 % \begin{macro}{\sf@setrevfontbold}
1647 % \begin{macro}{\sf@revfont}
1648 % \begin{macro}{\sf@setrevfont}
1649 % \changes{v1.3}{20 Jun 2016}{Added font declaration for form identifier (i.e.
1650 % revision) that appears at the bottom of the forms.}
1651 %
1652 % The form identifiers are filled in with Sans Serif at 9-point size to match the
1653 % appearance of the form as publicly distributed in Portable Data Format (PDF)
1654 % by the United States Government. Separate fonts are specified for the bold
1655 % and non-bold portions of the identifiers.
1656 %
1657 % \begin{macrocode}
1658 \DeclareFixedFont{\sf@revfontbold}{OT1}{\sfdefault}{bx}{n}{9pt}
1659 \newcommand{\sf@setrevfontbold}{\sf@setfont{\sf@revfontbold}{10pt}}
1660 % \end{macrocode}
1661 %
1662 % \begin{macrocode}
1663 \DeclareFixedFont{\sf@revfont}{OT1}{\sfdefault}{m}{n}{9pt}
1664 \newcommand{\sf@setrevfont}{\sf@setfont{\sf@revfont}{10pt}}
1665 % \end{macrocode}
1666 % \end{macro}
1667 % \end{macro}
1668 % \end{macro}
1669 % \end{macro}
1670 %
1671 % \subsection{Error checking and reporting}
1672 %
1673 % \changes{v1.1}{22 Feb 2000}{Added the error checking and reporting.}
1674 % \begin{macro}{\ifsf@undef}
1675 % \begin{macro}{\sf@undeftrue}
1676 % \begin{macro}{\sf@undeffalse}
1677 %
1678 % This switch is used by the error reporting at the end of the document
1679 % to generate a general message that there was an undefined required
1680 % field.
1681 %
1682 % \begin{macrocode}
1683 \newif\ifsf@undef
1684 \sf@undeffalse
1685 % \end{macrocode}
1686 % \end{macro}
1687 % \end{macro}
1688 % \end{macro}
1689 %
1690 % \begin{macro}{\sf@undefined}
1691 %
1692 % The \cmd{\sf@undefined} macro is executed with the optional argument for
1693 % each required field and without the optional argument at the end of
1694 % the document.
1695 %
1696 % \begin{macrocode}
1697 \newcommand{\sf@undefined}[1][\@empty]{%
1698 \ifx \@empty#1\relax
1699 \ifsf@undef
1700 \typeout{^^J%
1701 SF298 Warning: There are required fields that are undefined.%
1702 ^^J}%
1703 \fi
1704 \else
1705 \sf@undeftrue
1706 \typeout{^^J%
1707 SF298 Warning: \expandafter\string\csname #1\endcsname\space
1708 is undefined.%
1709 ^^J}%
1710 \fi}
1711 % \end{macrocode}
1712 % \end{macro}
1713 %
1714 % \begin{macro}{\sf@checkfield}
1715 %
1716 % This macro does the actual checking for undefined required fields.
1717 % Because of the different sorts of field definitions that could be
1718 % created, it was easier to just fill a box with whatever the user
1719 % defined and check to see if the box has a non-zero width. You could
1720 % defeat this if you really wanted to, but it should work for reasonable
1721 % field values.
1722 %
1723 % \begin{macrocode}
1724 \newcommand{\sf@checkfield}[1]{%
1725 \setbox\@tempboxa\vbox{\csname sf@#1\endcsname}%
1726 \ifdim \wd\@tempboxa =0pt
1727 \sf@undefined[#1]
1728 \fi}
1729 % \end{macrocode}
1730 % \end{macro}
1731 %
1732 % \begin{macrocode}
1733 \AtEndDocument{\sf@undefined}
1734 % \end{macrocode}
1735 %
1736 %
1737 % \subsection{Page layout}
1738 %
1739 % This is the part of the code that actually sets up the form page and
1740 % draws the form. After the form is drawn, most of the macros are set
1741 % to \cmd{\relax} in order to recover as much pool space as possible.
1742 %
1743 % \subsubsection{Form setup and cleanup}
1744 %
1745 % \begin{macro}{\ReportDescription}
1746 %
1747 % At the end of the \cmd{\titlepage} command, the \cmd{\thanks} macro is
1748 % redefined to be \cmd{\relax}. If we want to define the title once and
1749 % also want to be able to have a \cmd{\thanks} message associated with the
1750 % title on the titlepage, and want to use that same title text on the
1751 % report documentation page, then we need to redefine the \cmd{\thanks}
1752 % macro to eat it's argument. This is done by setting \cmd{\thanks} to
1753 % \cmd{\@gobble} while printing the report documentation page.
1754 %
1755 % \begin{macrocode}
1756 \newcommand{\ReportDescription}{%
1757 \global\let\thanks\@gobble
1758 \MakeRptDocPage
1759 \global\let\thanks\relax}
1760 % \end{macrocode}
1761 % \end{macro}
1762 %
1763 % \begin{macro}{\MakeRptDocPage}
1764 %
1765 % The \cmd{\MakeRptDocPage} command creates the Report Documentation Page
1766 % using the information defined by the associated field macros. This
1767 % should be used at the beginning of a deliverable report just after
1768 % the cover or title page and counts as the first actual page of the
1769 % document.
1770 %
1771 % \begin{macrocode}
1772 \newcommand\MakeRptDocPage{%
1773 % \end{macrocode}
1774 %
1775 % If the \Lpack{twoside} option is specified in the \cmd{\documentclass}, then
1776 % it is printed as a separate page with a blank back. This page is treated
1777 % as page `{\it i}' (if the documentclass \Lpack{twoside} option is
1778 % specified, then the back treated as page `{\it ii}'.
1779 %
1780 % \begin{macrocode}
1781 \newpage
1782 \if@twoside\ifodd\c@page\else
1783 \null
1784 \thispagestyle{empty}%
1785 \newpage
1786 \fi\fi
1787 % \end{macrocode}
1788 %
1789 % \changes{v1.1}{22 Feb 2000}{Added calculation of total pages (if the
1790 % totpages package is present). Added check for missing fields.}
1791 %
1792 % Check for missing required fields. If the field value is missing, then
1793 % print a warning. In the case of the number of pages, if the
1794 % \Lpack{totpages} package was loaded, then calculate the value, else if
1795 % the total pages is not given, then give a warning.
1796 %
1797 % \begin{macrocode}
1798 \sf@checkfield{ReportDate}
1799 \sf@checkfield{ReportType}
1800 \sf@checkfield{DatesCovered}
1801 \sf@checkfield{Title}
1802 \sf@checkfield{Author}
1803 \sf@checkfield{PerformingOrg}
1804 \sf@checkfield{SponsoringAgency}
1805 \sf@checkfield{Abstract}
1806 \sf@checkfield{ReportClassification}
1807 \sf@checkfield{AbstractClassification}
1808 \sf@checkfield{PageClassification}
1809 \sf@checkfield{AbstractLimitation}
1810 % \end{macrocode}
1811 %
1812 % \begin{macrocode}
1813 \edef\@tempa{\sf@NumberPages}%
1814 \edef\@tempa{\expandafter\@car\@tempa \@nil}%
1815 \if \relax\@tempa\relax
1816 \@ifundefined{c@TotPages}%
1817 {\sf@undefined[NumberPages]}
1818 {\@ifundefined{r@TotPages}%
1819 {\renewcommand{\sf@NumberPages}{{\bf ??}}}%
1820 {\setcounter{sf@page}{\expandafter\@car\r@TotPages\@nil}
1821 \addtocounter{sf@page}{-\value{TotPages}}
1822 \addtocounter{sf@page}{\sf@ExtraPages}
1823 \renewcommand{\sf@NumberPages}{\arabic{sf@page}}}}
1824 \fi
1825 % \end{macrocode}
1826 %
1827 % \changes{v1.1}{15 Feb 2000}{Adjusted offset calculations for new
1828 % blank form.}
1829 %
1830 % Next we make this page number one of the document and draw the form on
1831 % an $8\frac{1}{2}\times 11$ inch letter-size page and all offsets in
1832 % the actual form layout are in pixels from the lower-left corner of the
1833 % picture box as defined by the \cmd{\sf@drawform} macro. When we close
1834 % off the boxes, we allow the form to expand beyond the zero sized box.
1835 % This keeps \LaTeX\ from issuing warnings about overfull boxes.
1836 %
1837 % \begin{macrocode}
1838 \setcounter{page}{1}%
1839 \thispagestyle{empty}
1840 \vbox to 0pt{%
1841 \@tempskipa 34pt
1842 \advance\@tempskipa\voffset
1843 \advance\@tempskipa\topmargin
1844 \advance\@tempskipa\headheight
1845 \advance\@tempskipa\headsep
1846 \advance\@tempskipa\baselineskip
1847 \vskip-\@tempskipa
1848 \hbox to 0pt{%
1849 \@tempskipa\oddsidemargin
1850 \advance\@tempskipa 42pt
1851 \hskip-\@tempskipa
1852 % \end{macrocode}
1853 %
1854 % \begin{macrocode}
1855 \sf@drawform
1856 % \end{macrocode}
1857 %
1858 % \begin{macrocode}
1859 \hss}%
1860 \vss}%
1861 % \end{macrocode}
1862 %
1863 % The page is now done, so, if the documentclass \Lpack{twoside} option
1864 % is specified, generate a blank page for its back, which counts as
1865 % page `{\it ii}').
1866 %
1867 % \begin{macrocode}
1868 \newpage
1869 \if@twoside
1870 \null
1871 \thispagestyle{empty}%
1872 \newpage
1873 \fi
1874 % \end{macrocode}
1875 %
1876 % \changes{v1.1}{15 Feb 2000}{Added font macros to the list of unused
1877 % definitions. Also \cmd{\ReportDate} and \cmd{\sf@ReportDate}.}
1878 % Finally, the last step is to set all of the now unused definitions to
1879 % \cmd{\relax}, thereby freeing some space.
1880 %
1881 % \begin{macrocode}
1882 \global\let\ReportDate\relax
1883 \global\let\sf@ReportDate\relax
1884 \global\let\ReportType\relax
1885 \global\let\sf@ReportType\relax
1886 \global\let\DatesCovered\relax
1887 \global\let\sf@DatesCovered\relax
1888 \global\let\Title\relax
1889 \global\let\sf@Title\relax
1890 \global\let\ContractNumber\relax
1891 \global\let\sf@ContractNumber\relax
1892 \global\let\GrantNumber\relax
1893 \global\let\sf@GrantNumber\relax
1894 \global\let\ProgramElementNumber\relax
1895 \global\let\sf@ProgramElementNumber\relax
1896 \global\let\ProjectNumber\relax
1897 \global\let\sf@ProjectNumber\relax
1898 \global\let\TaskNumber\relax
1899 \global\let\sf@TaskNumber\relax
1900 \global\let\WorkUnitNumber\relax
1901 \global\let\sf@WorkUnitNumber\relax
1902 \global\let\Author\relax
1903 \global\let\sf@Author\relax
1904 \global\let\PerformingOrg\relax
1905 \global\let\sf@PerformingOrg\relax
1906 \global\let\POReportNumber\relax
1907 \global\let\sf@POReportNumber\relax
1908 \global\let\SponsoringAgency\relax
1909 \global\let\sf@SponsoringAgency\relax
1910 \global\let\Acronyms\relax
1911 \global\let\sf@Acronyms\relax
1912 \global\let\SMReportNumber\relax
1913 \global\let\sf@SMReportNumber\relax
1914 \global\let\DistributionStatement\relax
1915 \global\let\sf@DistributionStatement\relax
1916 \global\let\SupplementaryNotes\relax
1917 \global\let\sf@SupplementaryNotes\relax
1918 \global\let\Abstract\relax
1919 \global\let\sf@Abstract\relax
1920 \global\let\SubjectTerms\relax
1921 \global\let\sf@SubjectTerms\relax
1922 \global\let\ReportClassification\relax
1923 \global\let\sf@ReportClassification\relax
1924 \global\let\AbstractClassification\relax
1925 \global\let\sf@AbstractClassification\relax
1926 \global\let\PageClassification\relax
1927 \global\let\sf@PageClassification\relax
1928 \global\let\AbstractLimitation\relax
1929 \global\let\sf@AbstractLimitation\relax
1930 \global\let\ResponsiblePerson\relax
1931 \global\let\sf@ResponsiblePerson\relax
1932 \global\let\RPTelephone\relax
1933 \global\let\NumberPages\relax
1934 \global\let\sf@NNumberPages\relax
1935 \global\let\sf@NumberPages\relax
1936 \global\let\sf@SNumberPages\relax
1937 \global\let\sf@ExtraPages\relax
1938 \global\let\LeftShift\relax
1939 \global\let\sf@LeftShift\relax
1940 \global\let\DownShift\relax
1941 \global\let\sf@DownShift\relax
1942 \global\let\sf@RPTelephone\relax
1943 \global\let\sf@setfont
1944 \global\let\sf@strut\relax
1945 \global\let\sf@titlefontA\relax
1946 \global\let\sf@settitlefontA\relax
1947 \global\let\sf@titlefontB\relax
1948 \global\let\sf@settitlefontB\relax
1949 \global\let\sf@titlefontC\relax
1950 \global\let\sf@settitlefontC\relax
1951 \global\let\sf@titlefontD\relax
1952 \global\let\sf@settitlefontD\relax
1953 \global\let\sf@titlefontE\relax
1954 \global\let\sf@settitlefontE\relax
1955 \global\let\sf@titlefontF\relax
1956 \global\let\sf@settitlefontF\relax
1957 \global\let\sf@entryfont\relax
1958 \global\let\sf@setentryfont\relax
1959 \global\let\sf@revfontbold\relax
1960 \global\let\sf@setrevfontbold\relax
1961 \global\let\sf@revfont\relax
1962 \global\let\sf@setrevfont\relax
1963 \global\let\sf@checkfield\relax
1964 \global\let\sf@parbox\relax
1965 \global\let\sf@drawform\relax
1966 \global\let\MakeRptDocPage\relax}
1967 % \end{macrocode}
1968 % \end{macro}
1969 %
1970 % \subsubsection{Form layout}
1971 % \begin{macro}{\sf@parbox}
1972 % \changes{v1.1}{15 Feb 2000}{Added.}
1973 %
1974 % This macro is used in the following \cmd{\sf@drawform} to contain fields that
1975 % are to be centered in a block, but expand upward when overfull.
1976 % \begin{macrocode}
1977 \def\sf@parbox(#1,#2)#3{%
1978 \makebox(0,0)[bl]{%
1979 \vbox to #1\unitlength{%
1980 \vss
1981 \noindent
1982 \parbox{#2\unitlength}{\raggedright#3}%
1983 \vfil}}}
1984 % \end{macrocode}
1985 % \end{macro}
1986 %
1987 % \begin{macro}{\sf@drawform}
1988 % \changes{v1.1}{15 Feb 2000}{Changed from millimeter to big point spacing.}
1989 % \changes{v1.2}{22 Dec 2004}{Removed hard lines on the four long
1990 % boxes if `floatlingboxes' is used.}
1991 %
1992 % First draw the boxes of the form as a large thick-walled box with
1993 % a series of thin horizontal and vertical lines.
1994 %
1995 % \begin{macrocode}
1996 \newcommand\sf@drawform{%
1997 \sf@setentryfont
1998 \setlength{\unitlength}{1bp}
1999 \begin{picture}(539,707)(\sf@LeftShift,\sf@DownShift)
2000 % Draw blank form
2001 \linethickness{1bp}%
2002 \put( 0, 0){\framebox(539,707){}}
2003 % Horizontal lines
2004 \linethickness{0.5bp}%
2005 \put( 0,677){\line(1,0){539}}
2006 \put( 0,635){\line(1,0){539}}
2007 \put( 0,611){\line(1,0){539}}
2008 \put(324,581){\line(1,0){215}}
2009 \put(324,551){\line(1,0){215}}
2010 \put( 0,521){\line(1,0){539}}
2011 \put(324,491){\line(1,0){215}}
2012 \put(324,461){\line(1,0){215}}
2013 \put( 0,431){\line(1,0){539}}
2014 \put( 0,372){\line(1,0){539}}
2015 \put(359,336){\line(1,0){180}}
2016 \put( 0,300){\line(1,0){539}}
2017 \ifsf@floatlongboxes\else
2018 \put( 0,252){\line(1,0){539}}
2019 \put( 0,215){\line(1,0){539}}
2020 \put( 0, 95){\line(1,0){539}}
2021 \fi
2022 \put( 0, 48){\line(1,0){539}}
2023 \put( 0, 36){\line(1,0){180}}
2024 \put(324, 24){\line(1,0){215}}
2025 % Vertical lines
2026 \put(359,707){\line(0,-1){ 30}}
2027 \put(144,635){\line(0,-1){ 24}}
2028 \put(359,635){\line(0,-1){ 24}}
2029 \put(324,611){\line(0,-1){180}}
2030 \put(359,431){\line(0,-1){131}}
2031 \put(180, 48){\line(0,-1){ 48}}
2032 \put(266, 48){\line(0,-1){ 48}}
2033 \put(324, 48){\line(0,-1){ 48}}
2034 \put( 60, 36){\line(0,-1){ 36}}
2035 \put(120, 36){\line(0,-1){ 36}}
2036 % \end{macrocode}
2037 %
2038 % \changes{v1.2}{22 Dec 2004}{Removed hard titles on the four long
2039 % boxes if `floatlingboxes' is used.}
2040 % Next, fill in the individual box titles. Note the use of the
2041 % \cmd{\sf@strut} to set the block titles a little down and to
2042 % the right of the absolute corner of the box.
2043 %
2044 % \begin{macrocode}
2045 % Title text
2046 \put( 0,677){\makebox(359, 30){%
2047 \sf@settitlefontA REPORT DOCUMENTATION PAGE}}
2048 \put(359,677){\makebox(180, 30){%
2049 \sf@settitlefontB\shortstack[c]{%
2050 Form Approved\\[-2pt]%
2051 OMB No. 0704--0188}}}
2052 \put( 3,635){\makebox(533, 42){%
2053 \sf@settitlefontC\parbox{533bp}{\raggedright
2054 The public reporting burden for this collection of information
2055 is estimated to average 1 hour per response, including the
2056 time for reviewing instructions, searching existing data
2057 sources, gathering and maintaining the data needed, and
2058 completing and reviewing the collection of information.
2059 Send comments regarding this burden estimate or any other
2060 aspect of this collection of information, including
2061 suggestions for reducing this burden to Department of
2062 Defense, Washington Headquarters Services, Directorate for
2063 Information Operations and Reports (0704--0188), 1215
2064 Jefferson Davis Highway, Suite 1204, Arlington, VA
2065 22202--4302. Respondents should be aware that
2066 notwithstanding any other provision of law, no person shall
2067 be subject to any penalty for failing to comply with a
2068 collection of information if it does not display a currently
2069 valid OMB control number.
2070 {\sf@settitlefontD
2071 PLEASE DO NOT RETURN YOUR FORM TO THE ABOVE ADDRESS.}}}}
2072 \put( 0,611){\makebox(144, 24)[tl]{%
2073 \sf@settitlefontE\sf@strut 1.\ REPORT DATE
2074 \sf@settitlefontF (DD--MM--YYYY)}}
2075 \put(144,611){\makebox(215, 24)[tl]{%
2076 \sf@settitlefontE\sf@strut 2.\ REPORT TYPE}}
2077 \put(359,611){\makebox(180, 24)[tl]{%
2078 \sf@settitlefontE\sf@strut 3.\ DATES COVERED
2079 \sf@settitlefontF (From --- To)}}
2080 \put( 0,521){\makebox(324,90)[tl]{%
2081 \sf@settitlefontE\sf@strut 4.\ TITLE AND SUBTITLE}}
2082 \put(324,581){\makebox(215, 30)[tl]{%
2083 \sf@settitlefontE\sf@strut 5a.\ CONTRACT NUMBER}}
2084 \put(324,551){\makebox(215, 30)[tl]{%
2085 \sf@settitlefontE\sf@strut 5b.\ GRANT NUMBER}}
2086 \put(324,521){\makebox(215, 30)[tl]{%
2087 \sf@settitlefontE\sf@strut 5c.\ PROGRAM ELEMENT NUMBER}}
2088 \put(324,491){\makebox(215, 30)[tl]{%
2089 \sf@settitlefontE\sf@strut 5d.\ PROJECT NUMBER}}
2090 \put(324,461){\makebox(215, 30)[tl]{%
2091 \sf@settitlefontE\sf@strut 5e.\ TASK NUMBER}}
2092 \put(324,431){\makebox(215, 30)[tl]{%
2093 \sf@settitlefontE\sf@strut 5f.\ WORK UNIT NUMBER}}
2094 \put( 0,431){\makebox(324, 90)[tl]{%
2095 \sf@settitlefontE\sf@strut 6.\ AUTHOR(S)}}
2096 \put( 0,372){\makebox(359, 59)[tl]{%
2097 \sf@settitlefontE\sf@strut
2098 7.\ PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES)}}
2099 \put(359,372){\makebox(180, 59)[tl]{%
2100 \sf@settitlefontE\shortstack[l]{%
2101 \sf@strut 8.\ PERFORMING ORGANIZATION REPORT\\[-2pt]
2102 \sf@strut\phantom{8.\ }NUMBER}}}
2103 \put( 0,300){\makebox(359, 72)[tl]{%
2104 \sf@settitlefontE\sf@strut
2105 9.\ SPONSORING / MONITORING AGENCY NAME(S) AND ADDRESS(ES)}}
2106 \put(359,336){\makebox(180, 36)[tl]{%
2107 \sf@settitlefontE\sf@strut 10.\ SPONSOR/MONITOR'S ACRONYM(S)}}
2108 \put(359,300){\makebox(180, 36)[tl]{%
2109 \sf@settitlefontE\shortstack[l]{%
2110 \sf@strut 11.\ SPONSOR/MONITOR'S REPORT\\[-3pt]
2111 \sf@strut\phantom{11.\ }NUMBER(S)}}}
2112 \ifsf@floatlongboxes\else
2113 \put( 0,252){\makebox(539, 48)[tl]{%
2114 \sf@settitlefontE\sf@strut
2115 12.\ DISTRIBUTION / AVAILABILITY STATEMENT}}
2116 \put( 0,215){\makebox(539, 37)[tl]{%
2117 \sf@settitlefontE\sf@strut 13.\ SUPPLEMENTARY NOTES}}
2118 \put( 0,95){\makebox(539,120)[tl]{%
2119 \sf@settitlefontE\sf@strut 14.\ ABSTRACT}}
2120 \put( 0, 48){\makebox(539, 46)[tl]{%
2121 \sf@settitlefontE\sf@strut 15.\ SUBJECT TERMS}}
2122 \fi
2123 \put( 0, 36){\makebox(180, 12)[tl]{%
2124 \sf@settitlefontE\sf@strut 16.\ SECURITY CLASSIFICATION OF:}}
2125 \put( 0, 0){\makebox( 60, 36)[tl]{%
2126 \sf@settitlefontE\sf@strut a.\ REPORT}}
2127 \put( 60, 0){\makebox(60, 36)[tl]{%
2128 \sf@settitlefontE\sf@strut b.\ ABSTRACT}}
2129 \put(120, 0){\makebox(60, 36)[tl]{%
2130 \sf@settitlefontE\sf@strut c.\ THIS PAGE}}
2131 \put(180, 0){\makebox( 86, 48)[tl]{%
2132 \sf@settitlefontE\shortstack[l]{%
2133 \sf@strut 17.\ LIMITATION OF\\[-2pt]
2134 \sf@strut\phantom{17.\ }ABSTRACT}}}
2135 \put(266, 0){\makebox( 68, 48)[tl]{%
2136 \sf@settitlefontE\shortstack[l]{%
2137 \sf@strut 18.\ NUMBER\\[-2pt]
2138 \sf@strut\phantom{18.\ }OF\\[-2pt]
2139 \sf@strut\phantom{18.\ }PAGES}}}
2140 \put(324, 24){\makebox(215, 24)[tl]{%
2141 \sf@settitlefontE\sf@strut 19a.\ NAME OF RESPONSIBLE PERSON}}
2142 \put(324, 0){\makebox(215, 24)[tl]{%
2143 \sf@settitlefontE\sf@strut 19b.\ TELEPHONE NUMBER
2144 \sf@settitlefontF (include area code)}}
2145 \put(405,-25){\makebox(123, 17)[bl]{%
2146 \shortstack[l]{%
2147 {{\sf@setrevfontbold Standard Form 298} \sf@setrevfont (Rev.\ 8/98)}\\[-2pt]%
2148 {\sf@setrevfont Prescribed by ANSI Std.\ Z39.18}}}}
2149 % \end{macrocode}
2150 %
2151 % \changes{v1.2}{22 Dec 2004}{If `floatlingboxes' is used, then the
2152 % four long box separator lines and titles are typset along with
2153 % the text so that they may act more dynamically.}
2154 %
2155 % Now, we add the user's entries to the form. For undefined entries,
2156 % we just add null text, the required fields are checked above and a
2157 % warning issued if any of them are empty.
2158 %
2159 % \begin{macrocode}
2160 % Fill in form
2161 \put( 4,614){\makebox(0,0)[bl]{\sf@ReportDate}}
2162 \put(148,614){\makebox(0,0)[bl]{\sf@ReportType}}
2163 \put(363,614){\makebox(0,0)[bl]{\sf@DatesCovered}}
2164 \put( 4,523){\sf@parbox( 80,324){\sf@Title}}
2165 \put(328,585){\makebox(0,0)[bl]{\sf@ContractNumber}}
2166 \put(328,555){\makebox(0,0)[bl]{\sf@GrantNumber}}
2167 \put(328,525){\makebox(0,0)[bl]{\sf@ProgramElementNumber}}
2168 \put(328,495){\makebox(0,0)[bl]{\sf@ProjectNumber}}
2169 \put(328,465){\makebox(0,0)[bl]{\sf@TaskNumber}}
2170 \put(328,435){\makebox(0,0)[bl]{\sf@WorkUnitNumber}}
2171 \put( 4,434){\sf@parbox( 80,321){\sf@Author}}
2172 \put( 4,397){\makebox(0,0)[l]{%
2173 \parbox{355bp}{\raggedright\sf@PerformingOrg}}}
2174 \put(363,372){\sf@parbox( 46,176){\sf@POReportNumber}}
2175 \put( 4,331){\makebox(0,0)[l]{%
2176 \parbox{355bp}{\raggedright \sf@SponsoringAgency}}}
2177 \put(363,349){\makebox(0,0)[l]{%
2178 \parbox{176bp}{\raggedright\sf@Acronyms}}}
2179 \put(363,304){\makebox(0,0)[bl]{%
2180 \vbox to 26bp{%
2181 \vss
2182 \noindent
2183 \parbox{176bp}{\raggedright\sf@SMReportNumber}}}}
2184 \ifsf@floatlongboxes
2185 \put( 0,49){\parbox[b]{541bp}{%
2186 \leftskip=4bp
2187 \rightskip=4bp plus 2em
2188 \vbox to 250bp{%
2189 \vbox to 0bp{%
2190 \hbox{\sf@settitlefontE\sf@strut
2191 12.\ DISTRIBUTION / AVAILABILITY STATEMENT}
2192 \vss}
2193 \vfil
2194 \sf@DistributionStatement
2195 \vfil
2196 \hrule width\linewidth height0.5bp
2197 \vbox to 0bp{%
2198 \hbox{\sf@settitlefontE\sf@strut 13.\ SUPPLEMENTARY NOTES}
2199 \vss}
2200 \vfil
2201 \sf@SupplementaryNotes
2202 \vfil
2203 \hrule width\linewidth height0.5bp
2204 \vbox to 0bp{%
2205 \hbox{\sf@settitlefontE\sf@strut 14.\ ABSTRACT}
2206 \vss}
2207 \vfil
2208 \sf@Abstract
2209 \vfil
2210 \hrule width\linewidth height0.5bp
2211 \vbox to 0bp{%
2212 \hbox{\sf@settitlefontE\sf@strut 15.\ SUBJECT TERMS}
2213 \vss}
2214 \vfil
2215 \sf@SubjectTerms
2216 \vfil}}}
2217 \else
2218 \put( 4,255){\sf@parbox( 38,532){\sf@DistributionStatement}}
2219 \put( 4,217){\sf@parbox( 25,532){\sf@SupplementaryNotes}}
2220 \put( 4, 95){\sf@parbox(110,533){\sf@Abstract}}
2221 \put( 4, 51){\sf@parbox( 36,533){\sf@SubjectTerms}}
2222 \fi
2223 \put( 30, 13){\makebox(0,0){\sf@ReportClassification}}
2224 \put( 90, 13){\makebox(0,0){\sf@AbstractClassification}}
2225 \put(150, 13){\makebox(0,0){\sf@PageClassification}}
2226 \put(223, 13){\makebox(0,0){\sf@AbstractLimitation}}
2227 \put(295, 13){\makebox(0,0){\large\sf@NumberPages}}
2228 \put(328, 33){\makebox(0,0)[l]{\sf@ResponsiblePerson}}
2229 \put(328, 9){\makebox(0,0)[l]{\sf@RPTelephone}}
2230 \end{picture}}
2231 % \end{macrocode}
2232 % \end{macro}
2233 %
2234 % \begin{macro}{\GeneralInstructions}
2235 %
2236 % The \cmd{\GeneralInstructions} command creates the General Instructions Page,
2237 % which uses a two column format. This is optionally included in some technical
2238 % reports and should be used immediately after the \cmd{\ReportDescription} command
2239 % so the General Instructions Page appears on the page immediately following the SF298
2240 % form.
2241 %
2242 % \begin{macrocode}
2243 \newcommand\GeneralInstructions[1]{%
2244 \global\let\thanks\@gobble
2245 \MakeGenInsPage{#1}
2246 \global\let\thanks\relax}
2247 % \end{macrocode}
2248 % \end{macro}
2249 %
2250 % \begin{macro}{\MakeGenInsPage}
2251 %
2252 % The \cmd{\MakeGenInsPage} command creates a new page containing
2253 % the General Instructions for the SF298 form in a two-column format.
2254 %
2255 % \begin{macrocode}
2256 \newcommand\MakeGenInsPage[1]{%
2257 % \end{macrocode}
2258 %
2259 % \begin{macrocode}
2260 \newpage
2261 \if@twoside\ifodd\c@page\else
2262 \null
2263 \thispagestyle{empty}%
2264 \newpage
2265 \fi\fi
2266 \vspace{1ex}
2267
2268 \thispagestyle{sf298FormIDStyle} % insert document code in footer
2269 % \end{macrocode}
2270 %
2271 % \begin{macrocode}
2272 \begin{#1} % set font size
2273 \noindent
2274 \fbox{\begin{minipage}{\textwidth}
2275 \vspace{3ex}
2276 \begin{center}
2277 \textbf{INSTRUCTIONS FOR COMPLETING SF 298}
2278 \end{center}
2279
2280 \vspace{1ex}
2281
2282 \setlength{\columnsep}{0.8cm}
2283 \setlength{\columnseprule}{0.2pt}
2284 \vspace{-4ex}
2285
2286 \begin{multicols}{2}
2287 \noindent
2288 \textbf{1.~REPORT DATE.} Full publication date including day, month,
2289 and year, if available. Must cite at least the year and be Year 2000
2290 compliant, \eg 30-06-1998; xx-06-1998; xx-xx-1998.\hfill
2291 \\ \\ \noindent
2292 \textbf{2.~REPORT TYPE.} State the type of report, such as final,
2293 technical, interim, memorandum, master's thesis, progress, quarterly,
2294 research, special, group study, etc.\hfill
2295 \\ \\ \noindent
2296 \textbf{3.~DATE COVERED.} Indicate the time during which the work was
2297 performed and the report was written, \eg, Jun 1997 - Jun 1998;
2298 1-10 Jun 1996; May - Nov 1998; Nov 1998.\hfill
2299 \\ \\ \noindent
2300 \textbf{4.~TITLE.} Enter title and subtitle with volume number and part
2301 number, if applicable. On classified documents, enter the title
2302 classification in parentheses.\hfill
2303 \\ \\ \noindent
2304 \textbf{5a.~CONTRACT NUMBER.} Enter all contract numbers as they
2305 appear in the report, \eg F33315-86-C-5169.\hfill
2306 \\ \\ \noindent
2307 \textbf{5b.~GRANT NUMBER.} Enter all grant numbers as they appear in the
2308 report. \eg AFOSR-82-1234.\hfill
2309 \\ \\ \noindent
2310 \textbf{5c.~PROGRAM ELEMENT NUMBER.} Enter all program element numbers
2311 as they appear in the report, \eg 61101A.\hfill
2312 \\ \\ \noindent
2313 \textbf{5e.~TASK NUMBER.} Enter all task numbers as they appear in the
2314 report, \eg 05; RF0330201; T4112.\hfill
2315 \\ \\ \noindent
2316 \textbf{5f.~WORK UNIT NUMBER.} Enter all work unit numbers as they
2317 appear in the report, \eg 001; AFAPL30480105.\hfill
2318 \\ \\ \noindent
2319 \textbf{6.~AUTHOR(S).} Enter name(s) of person(s) responsible
2320 for writing the report, performing the research, or credited with the
2321 content of the report. The form of entry is the last name, first name,
2322 middle initial, and additional qualifiers separated by commas, \eg Smith,
2323 Richard, J, Jr.\hfill
2324 \\ \\ \noindent
2325 \textbf{7.~PERFORMING ORGANIZATION NAME(S) AND ADDRESS(ES).} Self-explanatory. \hfill
2326 \vfill
2327 \columnbreak
2328
2329 \noindent
2330 \textbf{8.~PERFORMING ORGANIZATION REPORT NUMBER.} Enter all unique
2331 alphanumeric report numbers assigned by the performing organization,
2332 \eg BRL-1234; AFWL-TR-85-4017-Vol-21-PT-2.\hfill
2333 \\ \\ \noindent
2334 \textbf{9.~SPONSORING/MONITORING AGENCY NAME(S) AND ADDRESS(ES).} Enter
2335 the name and address of the organization(s) financially responsible for
2336 and monitoring the work.\hfill
2337 \\ \\ \noindent
2338 \textbf{10.~SPONSOR/MONITOR'S ACRONYM(S).} Enter, if available, \eg BRL,
2339 ARDEC, NADC.\hfill
2340 \\ \\ \noindent
2341 \textbf{11.~SPONSOR/MONITOR'S REPORT NUMBER(S).} Enter report number as
2342 assigned by the sponsoring/ monitoring agency, if available, \eg BRL-TR-829;
2343 -215.\hfill
2344 \\ \\ \noindent
2345 \textbf{12.~DISTRIBUTION/AVAILABILITY STATEMENT.} Use agency-mandated
2346 availability statements to indicate the public availability or distribution
2347 limitations of the report. If additional limitations/ restrictions or
2348 special markings are indicated, follow agency authorization procedures,
2349 \eg RD/FRD, PROPIN, ITAR, etc. Include copyright information.\hfill
2350 \\ \\ \noindent
2351 \textbf{13.~SUPPLEMENTARY NOTES.} Enter information not included elsewhere
2352 such as: prepared in cooperation with; translation of; report supersedes;
2353 old edition number, etc.\hfill
2354 \\ \\ \noindent
2355 \textbf{14.~ABSTRACT.} A brief (approximately 200 words) factual summary
2356 of the most significant information.\hfill
2357 \\ \\ \noindent
2358 \textbf{15.~SUBJECT TERMS.} Key words or phrases identifying major concepts
2359 in the report.\hfill
2360 \\ \\ \noindent
2361 \textbf{16.~SECURITY CLASSIFICATION.} Enter security classification in
2362 accordance with security classification regulations, \eg U, C, S, etc. If
2363 this form contains classified information, stamp classification level on
2364 the top and bottom of this page.\hfill
2365 \\ \\ \noindent
2366 \textbf{17.~LIMITATION OF ABSTRACT.} This block must be completed to assign
2367 a distribution limitation to the abstract. Enter UU (Unclassified Unlimited)
2368 or SAR (Same as Report). An entry in this block is necessary if the abstract
2369 is to be limited. \hfill
2370
2371 \end{multicols}
2372 \end{minipage}
2373 }
2374 \end{#1}
2375
2376 \normalsize % return font to normal size
2377 }
2378 % \end{macrocode}
2379 % \end{macro}
2380 %
2381 % \iffalse
2382 %</package>
2383 % \fi%
2384 %
2385 % \Finale
2386 %