shake-cvs Mailing List for Shake & Make
Status: Pre-Alpha
Brought to you by:
menelan
Menu
▾
▴
shake-cvs — CVS commits are announced on this list. Intended for developers only...
You can subscribe to this list here.
| 2003 |
Jan
|
Feb
|
Mar
(6) |
Apr
|
May
|
Jun
|
Jul
(8) |
Aug
(25) |
Sep
(89) |
Oct
|
Nov
(2) |
Dec
|
|---|
|
From: <me...@us...> - 2003-11-09 02:48:33
|
Update of /cvsroot/shake/Shake/doc/dev/design In directory sc8-pr-cvs1:/tmp/cvs-serv652/Shake/doc/dev/design Modified Files: Abstract.tex Log Message: no message Index: Abstract.tex =================================================================== RCS file: /cvsroot/shake/Shake/doc/dev/design/Abstract.tex,v retrieving revision 1.5 retrieving revision 1.6 diff -C2 -d -r1.5 -r1.6 *** Abstract.tex 17 Sep 2003 15:54:17 -0000 1.5 --- Abstract.tex 9 Nov 2003 02:48:18 -0000 1.6 *************** *** 10,14 **** This is the official Design Document for \shake - an open source, cross platform, XML based build system implemented in Python and targeted ! specifically towards C++ development. The project is \OS and is released under the GPL license. It is hosted at --- 10,14 ---- This is the official Design Document for \shake - an open source, cross platform, XML based build system implemented in Python and targeted ! specifically towards (but not restricted to) C++ development. The project is \OS and is released under the GPL license. It is hosted at |
|
From: <me...@us...> - 2003-11-09 02:48:33
|
Update of /cvsroot/shake/Shake/doc/dev/design/requirements
In directory sc8-pr-cvs1:/tmp/cvs-serv652/Shake/doc/dev/design/requirements
Modified Files:
Introduction.tex
Log Message:
no message
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/Introduction.tex,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** Introduction.tex 20 Sep 2003 16:08:47 -0000 1.4
--- Introduction.tex 9 Nov 2003 02:48:19 -0000 1.5
***************
*** 29,33 ****
The system is targetted towards developers; specifically C/C++ developers,
! but \shake may be an applicable tool in other development situations as well.
%------------------------------------------------------------------------------
--- 29,34 ----
The system is targetted towards developers; specifically C/C++ developers,
! but \shake may be an applicable tool in other development situations\footnote{
! Any situation where one has to build target files from source files.} as well.
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 11:55:00
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv5876/introduction
Modified Files:
ManagingDependencies.tex
Added Files:
MyAppDAG1.eps
Log Message:
no message
--- NEW FILE: MyAppDAG1.eps ---
%!PS-Adobe-3.0 EPSF-3.0
%%Creator: ImageMark Software Labs
%%For: () ()
%%Title: C:\Documents and Settings\Eek\Desktop\Diagram1.eps
%%CreationDate: () ()
%%BoundingBox: 0 0 488 734
%%DocumentProcessColors: Black
%%ColorUsage:Color
%%DocumentFonts: Helvetica
%%+Helvetica-Bold
%%+Helvetica-Oblique
%%+Helvetica-BoldOblique
%%+Times-Roman
%%+Times-Bold
%%+Times-Italic
%%+Times-BoldItalic
%%+Courier
%%+Courier-Bold
%%+Courier-Oblique
[...2078 lines suppressed...]
[1 2 ] 0 d
190.8000 578.0000 m
163.5500 578.0000 L
S
U
u
[] 0 d
174.3500 575.3000 m
163.5500 578.0000 L
174.3500 580.7000 L
S
U
%%PageTrailer
gsave annotatepage grestore showpage
%%Trailer
Adobe_Illustrator_AI3 /terminate get exec
Adobe_typography_AI3 /terminate get exec
Adobe_customcolor /terminate get exec
Adobe_packedarray /terminate get exec
%%EOF
Index: ManagingDependencies.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/ManagingDependencies.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** ManagingDependencies.tex 22 Sep 2003 10:38:21 -0000 1.1
--- ManagingDependencies.tex 22 Sep 2003 11:54:56 -0000 1.2
***************
*** 15,22 ****
\end{verbatim}
! Simply put, \shake is a tool for managing dependencies between dynamically
! built files and the files from which they are built. In the development
of any non-trivial project it becomes an issue to ensure that the correct
files are rebuilt based on which files have been modified.
%------------------------------------------------------------------------------
--- 15,44 ----
\end{verbatim}
! Simply put, \shake is a tool for building target files from a number of
! source files, whilst managing dependencies between the dynamically
! built files and the files from which they are built.
!
! Shake was specifically written to support C(++) development but nothing
! keeps it from being used as a general file construction/dependency management
! tool (just like \cmd{make}). The following figure (\ref{fig:intro:myappdag1})
! is an example of a simple development setup illustrating the dependencies
! between elements.
!
! \begin{figure}[ht]
! \begin{center}
! \includegraphics[scale=1]{introduction/MyAppDAG1}
! \caption{Simple dependency graph.}
! \label{fig:intro:myappdag1}
! \end{center}
! \end{figure}
!
! In the development
of any non-trivial project it becomes an issue to ensure that the correct
files are rebuilt based on which files have been modified.
+
+ Since it is far too costly (i.e. unproductive) to do a full rebuild of
+ everything everytime something is modified, one is interested in doing a
+ so-called \emph{minimal recompilation}. In other words, only recomiling the
+ files which depend on the sources that were modified.
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 11:55:00
|
Update of /cvsroot/shake/Shake/doc/dev/design/diagrams.src In directory sc8-pr-cvs1:/tmp/cvs-serv5876/diagrams.src Added Files: MyAppDAG1.igx Log Message: no message --- NEW FILE: MyAppDAG1.igx --- (This appears to be a binary file; contents omitted.) |
|
From: <me...@us...> - 2003-09-22 10:38:25
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv24857
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.13
retrieving revision 1.14
diff -C2 -d -r1.13 -r1.14
*** Shake.tex 22 Sep 2003 00:06:41 -0000 1.13
--- Shake.tex 22 Sep 2003 10:38:21 -0000 1.14
***************
*** 17,20 ****
--- 17,21 ----
\usepackage{longtable}
\usepackage{a4wide,fancyhdr}
+ \usepackage{xspace}
\title{
***************
*** 33,43 ****
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make''}
! \newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}}
! \newcommand{\MOT}{Mads Orbesen Troest}
! \newcommand{\mailMOT}{ma...@tr...}
! \newcommand{\SF}{SourceForge}
! \newcommand{\OS}{Open Source}
! \newcommand{\DAG}{directed acyclic graph}
% "Semantic" markup:
--- 34,44 ----
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make''\xspace}
! \newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}\xspace}
! \newcommand{\MOT}{Mads Orbesen Troest\xspace}
! \newcommand{\mailMOT}{ma...@tr...\xspace}
! \newcommand{\SF}{SourceForge\xspace}
! \newcommand{\OS}{Open Source\xspace}
! \newcommand{\DAG}{directed acyclic graph\xspace}
% "Semantic" markup:
|
|
From: <me...@us...> - 2003-09-22 10:38:25
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv24857/introduction
Modified Files:
Introduction.tex
Added Files:
ManagingDependencies.tex
Log Message:
no message
--- NEW FILE: ManagingDependencies.tex ---
%------------------------------------------------------------------------------
% "Shake & Make" Design Document (introduction.managingdependencies)
%------------------------------------------------------------------------------
% (A) Mads Orbesen Troest [SCC] 2003
%------------------------------------------------------------------------------
% $Header: /cvsroot/shake/Shake/doc/dev/design/introduction/ManagingDependencies.tex,v 1.1 2003/09/22 10:38:21 menelan Exp $
\section{Managing Dependencies}
\begin{verbatim}
$Revision: 1.1 $
$State: Exp $
$Date: 2003/09/22 10:38:21 $
$Author: menelan $
\end{verbatim}
Simply put, \shake is a tool for managing dependencies between dynamically
built files and the files from which they are built. In the development
of any non-trivial project it becomes an issue to ensure that the correct
files are rebuilt based on which files have been modified.
%------------------------------------------------------------------------------
\subsection{QWE}
EWQ
%------------------------------------------------------------------------------
%- EOF ------------------------------------------------------------------------
%------------------------------------------------------------------------------
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/Introduction.tex,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** Introduction.tex 22 Sep 2003 00:06:41 -0000 1.4
--- Introduction.tex 22 Sep 2003 10:38:21 -0000 1.5
***************
*** 18,22 ****
--- 18,25 ----
beheind its development.
+ \input{introduction/ManagingDependencies}
\input{introduction/ProblemWithMake}
+
+ %%% COOK: http://www.canb.auug.org.au/~millerp/cook/cook.html
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 00:06:44
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv14582
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.12
retrieving revision 1.13
diff -C2 -d -r1.12 -r1.13
*** Shake.tex 22 Sep 2003 00:03:16 -0000 1.12
--- Shake.tex 22 Sep 2003 00:06:41 -0000 1.13
***************
*** 65,69 ****
\include{introduction/Introduction}
\include{requirements/Requirements}
! %%%\include{design/Design}
%------------------------------------------------------------------------------
--- 65,69 ----
\include{introduction/Introduction}
\include{requirements/Requirements}
! \include{design/Design}
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 00:06:44
|
Update of /cvsroot/shake/Shake/doc/dev/design/design In directory sc8-pr-cvs1:/tmp/cvs-serv14582/design Added Files: .cvsignore Log Message: no message --- NEW FILE: .cvsignore --- *.dvi *.dir *.aux *.log *.toc |
|
From: <me...@us...> - 2003-09-22 00:06:44
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv14582/introduction
Modified Files:
Introduction.tex
Log Message:
no message
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/Introduction.tex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Introduction.tex 21 Sep 2003 16:12:21 -0000 1.3
--- Introduction.tex 22 Sep 2003 00:06:41 -0000 1.4
***************
*** 15,19 ****
\end{verbatim}
! XXX ToDo XXX
\input{introduction/ProblemWithMake}
--- 15,20 ----
\end{verbatim}
! This chapter introduces the reader to \shake; its concept and the incentive
! beheind its development.
\input{introduction/ProblemWithMake}
|
|
From: <me...@us...> - 2003-09-22 00:03:19
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv14133
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.11
retrieving revision 1.12
diff -C2 -d -r1.11 -r1.12
*** Shake.tex 21 Sep 2003 16:28:23 -0000 1.11
--- Shake.tex 22 Sep 2003 00:03:16 -0000 1.12
***************
*** 65,68 ****
--- 65,69 ----
\include{introduction/Introduction}
\include{requirements/Requirements}
+ %%%\include{design/Design}
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 00:03:19
|
Update of /cvsroot/shake/Shake/doc/dev/design/design
In directory sc8-pr-cvs1:/tmp/cvs-serv14133/design
Added Files:
Design.tex
Log Message:
no message
--- NEW FILE: Design.tex ---
%------------------------------------------------------------------------------
% "Shake & Make" Design Document (design)
%------------------------------------------------------------------------------
% (A) Mads Orbesen Troest [SCC] 2003
%------------------------------------------------------------------------------
% $Header: /cvsroot/shake/Shake/doc/dev/design/design/Design.tex,v 1.1 2003/09/22 00:03:16 menelan Exp $
\chapter{Design}
\begin{verbatim}
$Revision: 1.1 $
$State: Exp $
$Date: 2003/09/22 00:03:16 $
$Author: menelan $
\end{verbatim}
This chapter contains the design specification of \shake.
%%%\input{design/XXX}
%------------------------------------------------------------------------------
%- EOF ------------------------------------------------------------------------
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-22 00:02:05
|
Update of /cvsroot/shake/Shake/doc/dev/design/design In directory sc8-pr-cvs1:/tmp/cvs-serv13948/design Log Message: Directory /cvsroot/shake/Shake/doc/dev/design/design added to the repository |
|
From: <me...@us...> - 2003-09-21 16:28:36
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv28879/dev/design/introduction
Modified Files:
ProblemWithMake.tex
Log Message:
no message
Index: ProblemWithMake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/ProblemWithMake.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** ProblemWithMake.tex 21 Sep 2003 16:12:21 -0000 1.1
--- ProblemWithMake.tex 21 Sep 2003 16:28:23 -0000 1.2
***************
*** 17,21 ****
--- 17,41 ----
%------------------------------------------------------------------------------
+ \subsection{Make}
+
+ I have to admit: I \emph{hate} \cmd{make} along with its foes: \cmd{autoconf},
+ \cmd{automake}, \cmd{configure} and what not. The latter try to tame a broken
+ beast but become as loathable under its influence. The former, of course,
+ \emph{is} the broken beast.
+
+ Now, this is not to say that the \cmd{make} utility is not useful; however,
+ the extremely terse and little forgiving syntax of makefiles makes it a pain
+ to work with, even for experienced users. Also its inherent reliance on functionality provided by the
+ underlying shell makes it next to impossible to create a common build framework
+ for \OS projects being built on various operating systems that do \emph{not}
+ necessarily happen to be \texttt{posix} or have all sorts of *nix fileutils installed.
+
XXX ToDo XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{The ``Recursive Make'' problem}
+
+ See:
\URL{http://www.tip.net.au/~millerp/rmch/recu-make-cons-harm.html}
|
|
From: <me...@us...> - 2003-09-21 16:28:35
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv28879/dev/design
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** Shake.tex 21 Sep 2003 16:12:21 -0000 1.10
--- Shake.tex 21 Sep 2003 16:28:23 -0000 1.11
***************
*** 33,37 ****
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make'' }
\newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}}
\newcommand{\MOT}{Mads Orbesen Troest}
--- 33,37 ----
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make''}
\newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}}
\newcommand{\MOT}{Mads Orbesen Troest}
***************
*** 42,45 ****
--- 42,46 ----
% "Semantic" markup:
+ \newcommand{\cmd}[1]{\texttt{#1}}
\newcommand{\URL}[1]{\texttt{#1}}
\newcommand{\email}[1]{#1}
|
|
From: <me...@us...> - 2003-09-21 16:12:27
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv26324/dev/design/introduction
Modified Files:
Introduction.tex
Added Files:
ProblemWithMake.tex
Log Message:
no message
--- NEW FILE: ProblemWithMake.tex ---
%------------------------------------------------------------------------------
% "Shake & Make" Design Document (introduction.problemwithmake)
%------------------------------------------------------------------------------
% (A) Mads Orbesen Troest [SCC] 2003
%------------------------------------------------------------------------------
% $Header: /cvsroot/shake/Shake/doc/dev/design/introduction/ProblemWithMake.tex,v 1.1 2003/09/21 16:12:21 menelan Exp $
\section{The Problem with ''Make'' (and foes)}
\begin{verbatim}
$Revision: 1.1 $
$State: Exp $
$Date: 2003/09/21 16:12:21 $
$Author: menelan $
\end{verbatim}
%------------------------------------------------------------------------------
XXX ToDo XXX
\URL{http://www.tip.net.au/~millerp/rmch/recu-make-cons-harm.html}
%------------------------------------------------------------------------------
%- EOF ------------------------------------------------------------------------
%------------------------------------------------------------------------------
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/Introduction.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** Introduction.tex 21 Sep 2003 15:41:06 -0000 1.2
--- Introduction.tex 21 Sep 2003 16:12:21 -0000 1.3
***************
*** 17,21 ****
XXX ToDo XXX
! %%%\input{introduction/XXX}
%------------------------------------------------------------------------------
--- 17,21 ----
XXX ToDo XXX
! \input{introduction/ProblemWithMake}
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-21 16:12:27
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv26324/dev/design
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.9
retrieving revision 1.10
diff -C2 -d -r1.9 -r1.10
*** Shake.tex 20 Sep 2003 17:02:29 -0000 1.9
--- Shake.tex 21 Sep 2003 16:12:21 -0000 1.10
***************
*** 33,37 ****
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make''}
\newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}}
\newcommand{\MOT}{Mads Orbesen Troest}
--- 33,37 ----
% Various shorthands:
! \newcommand{\shake}{``Shake \& Make'' }
\newcommand{\shakeURL}{\URL{http://shake.sourceforge.net}}
\newcommand{\MOT}{Mads Orbesen Troest}
|
|
From: <me...@us...> - 2003-09-21 15:41:10
|
Update of /cvsroot/shake/Shake/doc/dev/design/requirements
In directory sc8-pr-cvs1:/tmp/cvs-serv21323/dev/design/requirements
Modified Files:
Requirements.tex
Log Message:
no message
Index: Requirements.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/Requirements.tex,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** Requirements.tex 17 Sep 2003 15:54:18 -0000 1.4
--- Requirements.tex 21 Sep 2003 15:41:06 -0000 1.5
***************
*** 19,31 ****
and implementation.
! \input{Requirements/Introduction}
! \input{Requirements/GeneralDescription}
! \input{Requirements/ExternalInterfaces}
! \input{Requirements/Functionality}
! \input{Requirements/NonFunctional}
%------------------------------------------------------------------------------
--- 19,31 ----
and implementation.
! \input{requirements/Introduction}
! \input{requirements/GeneralDescription}
! \input{requirements/ExternalInterfaces}
! \input{requirements/Functionality}
! \input{requirements/NonFunctional}
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-21 15:41:10
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv21323/dev/design/introduction
Modified Files:
Introduction.tex
Log Message:
no message
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/introduction/Introduction.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** Introduction.tex 20 Sep 2003 17:02:29 -0000 1.1
--- Introduction.tex 21 Sep 2003 15:41:06 -0000 1.2
***************
*** 6,10 ****
% $Header$
! \chapter{Requirements}
\begin{verbatim}
--- 6,10 ----
% $Header$
! \chapter{Introduction}
\begin{verbatim}
|
|
From: <me...@us...> - 2003-09-20 17:02:35
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv8724/dev/design
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.8
retrieving revision 1.9
diff -C2 -d -r1.8 -r1.9
*** Shake.tex 20 Sep 2003 16:08:47 -0000 1.8
--- Shake.tex 20 Sep 2003 17:02:29 -0000 1.9
***************
*** 62,67 ****
%%% ... include chapters here:
! \include{requirements/Requirements}
!
\include{requirements/Requirements}
--- 62,66 ----
%%% ... include chapters here:
! \include{introduction/Introduction}
\include{requirements/Requirements}
|
|
From: <me...@us...> - 2003-09-20 17:02:35
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction
In directory sc8-pr-cvs1:/tmp/cvs-serv8724/dev/design/introduction
Added Files:
.cvsignore Introduction.tex
Log Message:
no message
--- NEW FILE: .cvsignore ---
*.dvi
*.dir
*.aux
*.log
*.toc
--- NEW FILE: Introduction.tex ---
%------------------------------------------------------------------------------
% "Shake & Make" Design Document (introduction)
%------------------------------------------------------------------------------
% (A) Mads Orbesen Troest [SCC] 2003
%------------------------------------------------------------------------------
% $Header: /cvsroot/shake/Shake/doc/dev/design/introduction/Introduction.tex,v 1.1 2003/09/20 17:02:29 menelan Exp $
\chapter{Requirements}
\begin{verbatim}
$Revision: 1.1 $
$State: Exp $
$Date: 2003/09/20 17:02:29 $
$Author: menelan $
\end{verbatim}
XXX ToDo XXX
%%%\input{introduction/XXX}
%------------------------------------------------------------------------------
%- EOF ------------------------------------------------------------------------
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-20 17:00:31
|
Update of /cvsroot/shake/Shake/doc/dev/design/introduction In directory sc8-pr-cvs1:/tmp/cvs-serv8349/introduction Log Message: Directory /cvsroot/shake/Shake/doc/dev/design/introduction added to the repository |
Update of /cvsroot/shake/Shake/doc/dev/design/requirements
In directory sc8-pr-cvs1:/tmp/cvs-serv32457/doc/dev/design/requirements
Modified Files:
ExternalInterfaces.tex Functionality.tex
GeneralDescription.tex Introduction.tex NonFunctional.tex
Log Message:
no message
Index: ExternalInterfaces.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/ExternalInterfaces.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** ExternalInterfaces.tex 17 Sep 2003 16:11:36 -0000 1.2
--- ExternalInterfaces.tex 20 Sep 2003 16:08:47 -0000 1.3
***************
*** 19,23 ****
\subsection{User interface}
! XXX
%------------------------------------------------------------------------------
--- 19,35 ----
\subsection{User interface}
! \shake is to be a command line utility. That is, its sole user interaction
! takes place from a shell or through some third party application invoking
! Shake on behalf of the user.
!
! The CLI interface to Shake consists of arguments and switches passed to the
! program on invocation, as well as a number of XML configuration files which
! are processed by Shake.
!
! Although the Shake tool itself doesn't provide any higher level (``fancy'')
! user interface, is is the intention that input and output to/from the tool
! be structured to such a degree that it is possible to build front ends to
! the tool and/or integrate the tool in other development environments, GUI or
! otherwise.
%------------------------------------------------------------------------------
***************
*** 25,29 ****
\subsection{Hardware interfaces}
! XXX
%------------------------------------------------------------------------------
--- 37,44 ----
\subsection{Hardware interfaces}
! \shake does not communicate with any special hardware; the only components
! involved are a standard computer capable of executing Shake and a storage
! medium (typically hard drive) from which Shake reads configuration/source
! files and produces output files.
%------------------------------------------------------------------------------
***************
*** 31,35 ****
\subsection{Software interfaces}
! XXX
%------------------------------------------------------------------------------
--- 46,50 ----
\subsection{Software interfaces}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 37,41 ****
\subsection{Communications interfaces}
! XXX
%------------------------------------------------------------------------------
--- 52,56 ----
\subsection{Communications interfaces}
! XXX ToDo XXX
%------------------------------------------------------------------------------
Index: Functionality.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/Functionality.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** Functionality.tex 17 Sep 2003 15:54:17 -0000 1.1
--- Functionality.tex 20 Sep 2003 16:08:47 -0000 1.2
***************
*** 17,21 ****
%------------------------------------------------------------------------------
! XXX
%------------------------------------------------------------------------------
--- 17,21 ----
%------------------------------------------------------------------------------
! XXX ToDo XXX
%------------------------------------------------------------------------------
Index: GeneralDescription.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/GeneralDescription.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** GeneralDescription.tex 17 Sep 2003 16:17:20 -0000 1.2
--- GeneralDescription.tex 20 Sep 2003 16:08:47 -0000 1.3
***************
*** 19,23 ****
\subsection{Perspective}
! XXX
%------------------------------------------------------------------------------
--- 19,23 ----
\subsection{Perspective}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 25,29 ****
\subsection{Functionality}
! XXX
%------------------------------------------------------------------------------
--- 25,29 ----
\subsection{Functionality}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 31,35 ****
\subsection{Users}
! XXX
%------------------------------------------------------------------------------
--- 31,35 ----
\subsection{Users}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 37,41 ****
\subsection{Environment}
! XXX
%------------------------------------------------------------------------------
--- 37,41 ----
\subsection{Environment}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 43,47 ****
\subsection{Limitations}
! XXX
%------------------------------------------------------------------------------
--- 43,47 ----
\subsection{Limitations}
! XXX ToDo XXX
%------------------------------------------------------------------------------
***************
*** 49,53 ****
\subsection{Assumptions and dependencies}
! XXX
%------------------------------------------------------------------------------
--- 49,53 ----
\subsection{Assumptions and dependencies}
! XXX ToDo XXX
%------------------------------------------------------------------------------
Index: Introduction.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/Introduction.tex,v
retrieving revision 1.3
retrieving revision 1.4
diff -C2 -d -r1.3 -r1.4
*** Introduction.tex 17 Sep 2003 15:54:17 -0000 1.3
--- Introduction.tex 20 Sep 2003 16:08:47 -0000 1.4
***************
*** 61,65 ****
\subsection{References}
! This requirements specification is based on the IEEE 830-1993 standard.
The users of the system being developers, domain knowledge is achieved
--- 61,65 ----
\subsection{References}
! This requirements specification is (very loosely) based on the IEEE 830-1993 standard.
The users of the system being developers, domain knowledge is achieved
Index: NonFunctional.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/NonFunctional.tex,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** NonFunctional.tex 17 Sep 2003 16:17:20 -0000 1.2
--- NonFunctional.tex 20 Sep 2003 16:08:47 -0000 1.3
***************
*** 19,25 ****
\subsection{Performance}
! XXX
! %------------------------------------------------------------------------------
%------------------------------------------------------------------------------
--- 19,33 ----
\subsection{Performance}
! Reliability is the primary focus of the \shake project, not raw speed.
! Whereas performance should, of course, be ``reasonable'',\footnote{
! This threshold is currently "open target", i.e. a suitable
! actual requirement is yet to be specified, based on experiments with the
! performance of Shake as well of that of other build systems.} it is
! recognised from the outset that performance (in terms of the time overhead
! spent \emph{not} on actual compilation etc. but on reading configuraions,
! checking source files, etc.) may be slower than that of traditional
! make-utilities (which operate on an incomplete dependenct DAG and use file
! modification timestamps for infering dirty source files).
%------------------------------------------------------------------------------
|
|
From: <me...@us...> - 2003-09-20 16:08:54
|
Update of /cvsroot/shake/Shake/doc/dev/uml In directory sc8-pr-cvs1:/tmp/cvs-serv32457/doc/dev/uml Modified Files: Shake.xml.zip Log Message: no message Index: Shake.xml.zip =================================================================== RCS file: /cvsroot/shake/Shake/doc/dev/uml/Shake.xml.zip,v retrieving revision 1.6 retrieving revision 1.7 diff -C2 -d -r1.6 -r1.7 Binary files /tmp/cvsTMwQtd and /tmp/cvsUoqsFg differ |
|
From: <me...@us...> - 2003-09-20 16:08:53
|
Update of /cvsroot/shake/Shake/doc/dev/design
In directory sc8-pr-cvs1:/tmp/cvs-serv32457/doc/dev/design
Modified Files:
Shake.tex
Log Message:
no message
Index: Shake.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/Shake.tex,v
retrieving revision 1.7
retrieving revision 1.8
diff -C2 -d -r1.7 -r1.8
*** Shake.tex 17 Sep 2003 16:11:36 -0000 1.7
--- Shake.tex 20 Sep 2003 16:08:47 -0000 1.8
***************
*** 60,66 ****
%------------------------------------------------------------------------------
! %%% ... include chapters here!
- %- Requirements ---------------------------------------------------------------
\include{requirements/Requirements}
--- 60,67 ----
%------------------------------------------------------------------------------
! %%% ... include chapters here:
!
! \include{requirements/Requirements}
\include{requirements/Requirements}
|
|
From: <me...@us...> - 2003-09-17 16:17:24
|
Update of /cvsroot/shake/Shake/doc/dev/design/requirements
In directory sc8-pr-cvs1:/tmp/cvs-serv20687/doc/dev/design/requirements
Modified Files:
GeneralDescription.tex NonFunctional.tex
Log Message:
no message
Index: GeneralDescription.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/GeneralDescription.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** GeneralDescription.tex 17 Sep 2003 13:04:40 -0000 1.1
--- GeneralDescription.tex 17 Sep 2003 16:17:20 -0000 1.2
***************
*** 17,20 ****
--- 17,52 ----
%------------------------------------------------------------------------------
+ \subsection{Perspective}
+
+ XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{Functionality}
+
+ XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{Users}
+
+ XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{Environment}
+
+ XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{Limitations}
+
+ XXX
+
+ %------------------------------------------------------------------------------
+
+ \subsection{Assumptions and dependencies}
+
XXX
Index: NonFunctional.tex
===================================================================
RCS file: /cvsroot/shake/Shake/doc/dev/design/requirements/NonFunctional.tex,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** NonFunctional.tex 17 Sep 2003 15:54:18 -0000 1.1
--- NonFunctional.tex 17 Sep 2003 16:17:20 -0000 1.2
***************
*** 17,21 ****
--- 17,25 ----
%------------------------------------------------------------------------------
+ \subsection{Performance}
+
XXX
+
+ %------------------------------------------------------------------------------
%------------------------------------------------------------------------------
|
