tex/manual/SCRAM-manual.tex

%%____________________________________________________________________ 
%% File: SCRAM-manual.tex
%%____________________________________________________________________ 
%%  
%% Author: Shaun ASHBY <Shaun.Ashby@cern.ch>
%% Update: 2005-11-02 16:58:03+0100
%% Revision: $Id: SCRAM-manual.tex,v 1.3 2005/11/08 10:16:54 sashby Exp $ 
%%
%% Copyright: 2005 (C) Shaun ASHBY
%%
%%--------------------------------------------------------------------
\documentclass[12pt,twoside]{report}
\usepackage{style}
\makeindex
\begin{document}

\parskip 2ex plus 2pt minus 1pt
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
% SCRAM manual: definitions                                        %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\newcommand{\authorname}{S.~Ashby, \textsc{CERN PH D}ept.}
\newcommand{\scrammaintainers}{S.~Ashby}
\newcommand{\thisrelease}{V1\_0\_2}
\newcommand{\lastrelease}{V1\_0\_1}
\newcommand{\scramvx}{V1\_x}
\newcommand{\scramdevelopers}{scram-developers@cern.ch}
\newcommand{\savannahURL}{http://savannah.cern.ch/projects/scram/}
\newcommand{\scram}{\texttt{scram}}
%%
\newcommand{\scramcvsrepository}{\small{
    \texttt{:pserver:anonymous@cmscvs.cern.ch:/cvs\_server/repositories/SCRAM}
    }\normalsize}
\newcommand{\spiscramcvsrepository}{\small{
    \texttt{:pserver:anonymous@spitools.cern.ch:/cvs/SPITOOLS}
    }\normalsize}
%% New environment for indenting lists:
\newenvironment{indentlist}[2]{\begin{description}}{\end{description}}
\newcommand{\indentitem}[1]{\item[#1]}
\renewcommand{\ni}{\noindent}
\newcommand{\example}[1]{\paragraph{{\sffamily #1}:}}
\newcommand{\libcrh}{$2.1.x$}
\newcommand{\lbkt}{$<$}
\newcommand{\rbkt}{$>$~}
\newcommand{\mylongrightarrow}{$\longrightarrow$}
\newcommand{\pipe}{$|$}
\begin{htmlonly}
\newcommand{\libcrh}{\texttt{2.1.x}}
\newcommand{\lbkt}{<}
\newcommand{\rbkt}{> }
\newcommand{\mylongrightarrow}{\texttt{-->}}
\newcommand{\pipe}{|}
\end{htmlonly}
\newcommand{\option}[1]{[\textit{#1}]}
\newcommand{\marg}[1]{\texttt{#1}}
\newcommand{\optionwflag}[2]{[\textbf{#1}~\textit{#2}]}
\newcommand{\flag}[1]{[\textbf{#1}]}
\newcommand{\inbrackets}[1]{$<$\texttt{#1}$>$}
\newcommand{\buildfile}{BuildFile} %% Could change this to texttt
% 
\newenvironment{scramcmd}[1]{%
  \texttt{scram #1}
}{} %
% 
\newcommand{\tagstart}[1]{\lbkt\texttt{#1}\rbkt}
\newcommand{\tagend}[1]{\lbkt/\texttt{#1}\rbkt}
%% Define a new environment for typesetting tags with blank lines above
%% and below and slightly indented:
\newenvironment{tagprint}{%
  \begin{list}{}{\item[]}}
  {\end{list}}%
%
\newenvironment{indentprint}{%
  \begin{list}{}{\item[]}}
  {\end{list}}%

%% Other shortcuts:
\newcommand{\iie}{\emph{i.e.\ }}
\newcommand{\ieg}{\emph{e.g.\ }}
\newcommand{\ietc}{\emph{etc.\ }}
\newcommand{\ie}{i.e.\ }
\newcommand{\eg}{e.g.\ }
\newcommand{\etc}{etc.\ }

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
%% Heading for title page:                                             %%
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
\pagestyle{empty}
\begin{titlepage}
  \vspace{8cm}
  \begin{latexonly}
    \begin{center}
      {\Large\bf SCRAM: \thisrelease } \\ \vspace{1cm}
    \end{center}
  \end{latexonly}
  
  % Author and contact info:                                            %%  
  \vspace{5cm}    
  \begin{center}
    \begin{indentlist}{2.5cm}{3.0cm}
      \indentitem{Documentation Author:}\authorname
      \indentitem{Release Date:}\today
    \end{indentlist}
  \end{center}
  \vspace{3cm}
  
  % A brief synopsis:                                                   %%
  
  \ni SCRAM ({\bf S}oftware {\bf C}onfiguration 
  {\bf R}elease {\bf A}nd  {\bf M}anagement) is a configuration
  management and build tool originally conceived for the software 
  development environment of a high-energy physics experiment at
  CERN. This manual is for SCRAM \thisrelease.
  \bigskip\bigskip
  \bigskip\bigskip
  \begin{center}
    \textbf{Please report bugs to \savannahURL}
  \end{center}
\end{titlepage}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
\pagestyle{plain}
\pagenumbering{roman}
\tableofcontents            % Contents
\listoffigures
\pagestyle{plain}
\pagestyle{fancy}
\pagenumbering{arabic}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% 
% SCRAM manual: scram-main. The main text.                         %
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\include{Introduction}
\include{Installation}
\include{CreatingProjects}
\include{BuildSystem}
\include{Examples}
\include{QuickHelpGuide}

\include{Appendix}
\include{ReleaseNotes}

%% Finally, the index:
%% Now the index:
\small
\printindex
\normalsize
%%
\end{document}
%%____________________________________________________________________ 
%% End of SCRAM-manual.tex
%%____________________________________________________________________ 
%%  
Revision:	1.4
Committed:	Wed Nov 9 12:46:11 2005 UTC (19 years, 6 months ago) by sashby
Content type:	application/x-tex
Branch:	MAIN
Changes since 1.3:	+5 -3 lines
Log Message:	Fix to formatting of manual so that page numbers don't disappear.
#	User	Rev	Content
1	sashby	1.1	%%____________________________________________________________________
2			%% File: SCRAM-manual.tex
3			%%____________________________________________________________________
4			%%
5			%% Author: Shaun ASHBY <Shaun.Ashby@cern.ch>
6			%% Update: 2005-11-02 16:58:03+0100
7	sashby	1.4	%% Revision: $Id: SCRAM-manual.tex,v 1.3 2005/11/08 10:16:54 sashby Exp $
8	sashby	1.1	%%
9			%% Copyright: 2005 (C) Shaun ASHBY
10			%%
11			%%--------------------------------------------------------------------
12			\documentclass[12pt,twoside]{report}
13			\usepackage{style}
14			\makeindex
15			\begin{document}
16	sashby	1.4
17	sashby	1.1	\parskip 2ex plus 2pt minus 1pt
18			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
19			% SCRAM manual: definitions %
20			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
21			\newcommand{\authorname}{S.~Ashby, \textsc{CERN PH D}ept.}
22			\newcommand{\scrammaintainers}{S.~Ashby}
23			\newcommand{\thisrelease}{V1\_0\_2}
24			\newcommand{\lastrelease}{V1\_0\_1}
25			\newcommand{\scramvx}{V1\_x}
26			\newcommand{\scramdevelopers}{scram-developers@cern.ch}
27			\newcommand{\savannahURL}{http://savannah.cern.ch/projects/scram/}
28			\newcommand{\scram}{\texttt{scram}}
29			%%
30			\newcommand{\scramcvsrepository}{\small{
31			\texttt{:pserver:anonymous@cmscvs.cern.ch:/cvs\_server/repositories/SCRAM}
32			}\normalsize}
33			\newcommand{\spiscramcvsrepository}{\small{
34			\texttt{:pserver:anonymous@spitools.cern.ch:/cvs/SPITOOLS}
35			}\normalsize}
36			%% New environment for indenting lists:
37			\newenvironment{indentlist}[2]{\begin{description}}{\end{description}}
38			\newcommand{\indentitem}[1]{\item[#1]}
39			\renewcommand{\ni}{\noindent}
40			\newcommand{\example}[1]{\paragraph{{\sffamily #1}:}}
41			\newcommand{\libcrh}{$2.1.x$}
42			\newcommand{\lbkt}{$<$}
43			\newcommand{\rbkt}{$>$~}
44			\newcommand{\mylongrightarrow}{$\longrightarrow$}
45			\newcommand{\pipe}{$\|$}
46			\begin{htmlonly}
47			\newcommand{\libcrh}{\texttt{2.1.x}}
48			\newcommand{\lbkt}{<}
49			\newcommand{\rbkt}{> }
50			\newcommand{\mylongrightarrow}{\texttt{-->}}
51			\newcommand{\pipe}{\|}
52			\end{htmlonly}
53			\newcommand{\option}[1]{[\textit{#1}]}
54			\newcommand{\marg}[1]{\texttt{#1}}
55			\newcommand{\optionwflag}[2]{[\textbf{#1}~\textit{#2}]}
56			\newcommand{\flag}[1]{[\textbf{#1}]}
57			\newcommand{\inbrackets}[1]{$<$\texttt{#1}$>$}
58			\newcommand{\buildfile}{BuildFile} %% Could change this to texttt
59			%
60			\newenvironment{scramcmd}[1]{%
61			\texttt{scram #1}
62			}{} %
63			%
64			\newcommand{\tagstart}[1]{\lbkt\texttt{#1}\rbkt}
65			\newcommand{\tagend}[1]{\lbkt/\texttt{#1}\rbkt}
66			%% Define a new environment for typesetting tags with blank lines above
67			%% and below and slightly indented:
68			\newenvironment{tagprint}{%
69			\begin{list}{}{\item[]}}
70			{\end{list}}%
71			%
72			\newenvironment{indentprint}{%
73			\begin{list}{}{\item[]}}
74			{\end{list}}%
75
76			%% Other shortcuts:
77			\newcommand{\iie}{\emph{i.e.\ }}
78			\newcommand{\ieg}{\emph{e.g.\ }}
79			\newcommand{\ietc}{\emph{etc.\ }}
80			\newcommand{\ie}{i.e.\ }
81			\newcommand{\eg}{e.g.\ }
82			\newcommand{\etc}{etc.\ }
83
84			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
85			%% Heading for title page: %%
86			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
87			\pagestyle{empty}
88			\begin{titlepage}
89	sashby	1.2	\vspace{8cm}
90			\begin{latexonly}
91			\begin{center}
92			{\Large\bf SCRAM: \thisrelease } \\ \vspace{1cm}
93			\end{center}
94			\end{latexonly}
95
96			% Author and contact info: %%
97			\vspace{5cm}
98	sashby	1.1	\begin{center}
99	sashby	1.2	\begin{indentlist}{2.5cm}{3.0cm}
100			\indentitem{Documentation Author:}\authorname
101			\indentitem{Release Date:}\today
102			\end{indentlist}
103			\end{center}
104			\vspace{3cm}
105
106			% A brief synopsis: %%
107
108			\ni SCRAM ({\bf S}oftware {\bf C}onfiguration
109			{\bf R}elease {\bf A}nd {\bf M}anagement) is a configuration
110			management and build tool originally conceived for the software
111			development environment of a high-energy physics experiment at
112			CERN. This manual is for SCRAM \thisrelease.
113			\bigskip\bigskip
114			\bigskip\bigskip
115			\begin{center}
116			\textbf{Please report bugs to \savannahURL}
117	sashby	1.1	\end{center}
118			\end{titlepage}
119
120	sashby	1.2	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
121	sashby	1.1	\pagestyle{plain}
122			\pagenumbering{roman}
123			\tableofcontents % Contents
124	sashby	1.4	\listoffigures
125			\pagestyle{plain}
126			\pagestyle{fancy}
127	sashby	1.1	\pagenumbering{arabic}
128
129	sashby	1.2	%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
130	sashby	1.1	% SCRAM manual: scram-main. The main text. %
131			%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
132
133			\include{Introduction}
134			\include{Installation}
135			\include{CreatingProjects}
136	sashby	1.3	\include{BuildSystem}
137	sashby	1.1	\include{Examples}
138			\include{QuickHelpGuide}
139	sashby	1.2
140	sashby	1.1	\include{Appendix}
141			\include{ReleaseNotes}
142
143			%% Finally, the index:
144			%% Now the index:
145			\small
146			\printindex
147			\normalsize
148			%%
149			\end{document}
150			%%____________________________________________________________________
151			%% End of SCRAM-manual.tex
152			%%____________________________________________________________________
153			%%