| 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 |
% |