/[dtapublic]/pubs/books/ucbka/trunk/c_vct0/c_vct0.tex
ViewVC logotype

Diff of /pubs/books/ucbka/trunk/c_vct0/c_vct0.tex

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 139 by dashley, Thu Oct 6 23:27:41 2016 UTC revision 140 by dashley, Mon Jul 3 01:59:16 2017 UTC
# Line 1  Line 1 
1  %$Header: /uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions/c_vct0.tex 3     12/31/00 7:42p Dashley1 $  %$Header$
2    
3  \chapter{\cvctzerolongtitle{}}  \chapter{\cvctzerolongtitle{}}
4    
5  \label{cvct0}  \label{cvct0}
6    
7  \beginchapterquote{``\ldots{} Beauty is the first test:  there is no permanent  \beginchapterquote{``\ldots{} Beauty is the first test:  there is no permanent
8                     place in the world for ugly mathematics.''}                     place in the world for ugly mathematics.''}
9                     {G.H. Hardy \cite{bibref:b:mathematiciansapology:1940},                     {G.H. Hardy \cite{bibref:b:mathematiciansapology:1940},
10                     p.85}                     p.85}
11    
12  \section{Introduction}  \section{Introduction}
13  %Section Tag: INT  %Section Tag: INT
14  This chapter documents the Tcl/Tk extensions present in IjuScripter and IjuConsole  This chapter documents the Tcl/Tk extensions present in IjuScripter and IjuConsole
15  designed to allow a script to determine the version of IjuScripter or IjuConsole under  designed to allow a script to determine the version of IjuScripter or IjuConsole under
16  which it is running.  At present, there is only one such command, \emph{vcinfo}.  which it is running.  At present, there is only one such command, \emph{vcinfo}.
17    
18    
19  \section{vcinfo}  \section{vcinfo}
20    
21  \begin{tclcommandname}{vcinfo}%  \begin{tclcommandname}{vcinfo}%
22  retrieves embedded static version and version control information for IjuScripter or IjuConsole.  retrieves embedded static version and version control information for IjuScripter or IjuConsole.
23  This allows a script to determine which executable and which version it is  This allows a script to determine which executable and which version it is
24  running under.  running under.
25  \end{tclcommandname}  \end{tclcommandname}
26    
27  \begin{tclcommandsynopsis}  \begin{tclcommandsynopsis}
28  \tclcommandsynopsisline{vcinfo}{-ijutoolsversion}  \tclcommandsynopsisline{vcinfo}{-ijutoolsversion}
29  \tclcommandsynopsisline{vcinfo}{?-crconly? -fileversion filename}  \tclcommandsynopsisline{vcinfo}{?-crconly? -fileversion filename}
30  \tclcommandsynopsisline{vcinfo}{?-crconly? -extensionversion extensionname}  \tclcommandsynopsisline{vcinfo}{?-crconly? -extensionversion extensionname}
31  \tclcommandsynopsisline{vcinfo}{-buildmanifest}  \tclcommandsynopsisline{vcinfo}{-buildmanifest}
32  \end{tclcommandsynopsis}  \end{tclcommandsynopsis}
33    
34  \begin{tclcommanddescription}  \begin{tclcommanddescription}
35  The \emph{vcinfo} command returns information about the version of the  The \emph{vcinfo} command returns information about the version of the
36  IjuScripter or IjuConsole executable program, about the version of  IjuScripter or IjuConsole executable program, about the version of
37  a specific source file, or [collectively] about the version of all files  a specific source file, or [collectively] about the version of all files
38  which [directly] contribute to the behavior of an embedded Tcl extension.  which [directly] contribute to the behavior of an embedded Tcl extension.
39  This command can be used to interactively  This command can be used to interactively
40  inquire about the version of the executable program or certain of its  inquire about the version of the executable program or certain of its
41  components.  components.
42    
43  Most commonly, this command is used to help assure reproducibility  Most commonly, this command is used to help assure reproducibility
44  of a script's behavior by coding a script so that it will  of a script's behavior by coding a script so that it will
45  run only under a specific version(s) of executable.  run only under a specific version(s) of executable.
46    
47  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-ijutoolsversion}}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-ijutoolsversion}}
48  Returns a string identifying the version number of the IjuScripter or IjuConsole  Returns a string identifying the version number of the IjuScripter or IjuConsole
49  executable.  The string will be of the form ``vm.nx'', where \emph{v} is the letter  executable.  The string will be of the form ``vm.nx'', where \emph{v} is the letter
50  ``v'', \emph{m} is the major version number, \emph{n} is the minor version number, and  ``v'', \emph{m} is the major version number, \emph{n} is the minor version number, and
51  \emph{x} is an optional lower-case letter identifying a service release which fixes defects  \emph{x} is an optional lower-case letter identifying a service release which fixes defects
52  but adds no new functionality.  but adds no new functionality.
53    
54  For example, a return value of ``v1.03'' would identify version 1.03.  A return  For example, a return value of ``v1.03'' would identify version 1.03.  A return
55  value of ``v1.03c'' would identify the third service release to version 1.03; with  value of ``v1.03c'' would identify the third service release to version 1.03; with
56  the service release designed to correct defects present in version 1.03b, but adding  the service release designed to correct defects present in version 1.03b, but adding
57  no new functionality.  no new functionality.
58  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
59    
60  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-fileversion filename}}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-fileversion filename}}
61  (Not yet implemented.)  Returns a string with version control information for the file  (Not yet implemented.)  Returns a string with version control information for the file
62  \emph{filename}, which must be part of the IjuScripter or IjuConsole build.  \emph{filename}, which must be part of the IjuScripter or IjuConsole build.
63  An error is generated if a \emph{filename} which is not part of the build  An error is generated if a \emph{filename} which is not part of the build
64  is supplied.  This form of the \emph{vcinfo} command is not normally used from a script.  is supplied.  This form of the \emph{vcinfo} command is not normally used from a script.
65  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
66    
67  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-crconly -fileversion filename}}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-crconly -fileversion filename}}
68  (Not yet implemented.)  Returns the CRC32 of the the string result of the command above.    (Not yet implemented.)  Returns the CRC32 of the the string result of the command above.  
69  Note that the value returned is the CRC of the version control information embedded in the file  Note that the value returned is the CRC of the version control information embedded in the file
70  rather than the CRC of the file.  rather than the CRC of the file.
71  \emph{filename} must be part of the IjuScripter or IjuConsole build, and  \emph{filename} must be part of the IjuScripter or IjuConsole build, and
72  an error is generated if a \emph{filename} which is not part of the build is supplied.  an error is generated if a \emph{filename} which is not part of the build is supplied.
73  This form is  This form is
74  useful because it supplies a terse result of eight hexadecimal digits which can easily  useful because it supplies a terse result of eight hexadecimal digits which can easily
75  establish with a probability of about $1-2^{-32}$ that two versions of IjuScripter or IjuConsole  establish with a probability of about $1-2^{-32}$ that two versions of IjuScripter or IjuConsole
76  have the same file component; or establish with unity probability that they do not.  have the same file component; or establish with unity probability that they do not.
77  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
78    
79  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-extensionversion extensionname}}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-extensionversion extensionname}}
80  (Not yet implemented.)  Returns a string with version control information for all  (Not yet implemented.)  Returns a string with version control information for all
81  files which contribute directly to the behavior of the Tcl extension \emph{extensionname},  files which contribute directly to the behavior of the Tcl extension \emph{extensionname},
82  which must be part of the IjuScripter or IjuConsole static build.  which must be part of the IjuScripter or IjuConsole static build.
83  An error is generated if an \emph{extensionname} which is not part of the build  An error is generated if an \emph{extensionname} which is not part of the build
84  is supplied.  is supplied.
85  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
86    
87  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}
88        {-crconly -extensionversion extensionname}}        {-crconly -extensionversion extensionname}}
89  (Not yet implemented.)  Returns the CRC32 of the the string result of the command above.    (Not yet implemented.)  Returns the CRC32 of the the string result of the command above.  
90  Note that the value returned is the CRC of the version control information embedded in the file(s)  Note that the value returned is the CRC of the version control information embedded in the file(s)
91  rather than the CRC(s) of the file(s).  rather than the CRC(s) of the file(s).
92  \emph{extensionname} must be part of the IjuScripter or IjuConsole build, and  \emph{extensionname} must be part of the IjuScripter or IjuConsole build, and
93  an error is generated if an \emph{extensionname} which is not part of the build is supplied.  an error is generated if an \emph{extensionname} which is not part of the build is supplied.
94  This form is  This form is
95  useful because it supplies a terse result of eight hexadecimal digits which can easily  useful because it supplies a terse result of eight hexadecimal digits which can easily
96  establish with a probability of about $1-2^{-32}$ that two versions of IjuScripter or IjuConsole  establish with a probability of about $1-2^{-32}$ that two versions of IjuScripter or IjuConsole
97  have the same extension component; or establish with unity probability that they do not.  have the same extension component; or establish with unity probability that they do not.
98  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
99    
100  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-crconly -buildmanifest}}  \begin{tclcommandinternaldescription}{\tclcommanddescsynopsisline{vcinfo}{-crconly -buildmanifest}}
101  (Not yet implemented.)  Returns the full combined build manifest of IjuScripter and IjuConsole.  (Not yet implemented.)  Returns the full combined build manifest of IjuScripter and IjuConsole.
102  This includes size and CRC information for every file involved in the build.  This form  This includes size and CRC information for every file involved in the build.  This form
103  of \emph{vcinfo} is provided for assistance in defect diagnosis.  of \emph{vcinfo} is provided for assistance in defect diagnosis.
104  \end{tclcommandinternaldescription}  \end{tclcommandinternaldescription}
105    
106  \end{tclcommanddescription}  \end{tclcommanddescription}
107    
108  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%  %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
109  \noindent\begin{figure}[!b]  \noindent\begin{figure}[!b]
110  \noindent\rule[-0.25in]{\textwidth}{1pt}  \noindent\rule[-0.25in]{\textwidth}{1pt}
111  \begin{tiny}  \begin{tiny}
112  \begin{verbatim}  \begin{verbatim}
113  $Workfile: c_vct0.tex $  $Workfile: c_vct0.tex $
114  $Archive: /uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions/c_vct0.tex $  $Archive: /uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions/c_vct0.tex $
115  $Revision: 3 $  $Revision: 3 $
116  $Author: Dashley1 $  $Author: Dashley1 $
117  $Date: 12/31/00 7:42p $  $Date: 12/31/00 7:42p $
118  $Modtime: 12/24/00 2:59a $  $Modtime: 12/24/00 2:59a $
119  \end{verbatim}  \end{verbatim}
120  \end{tiny}  \end{tiny}
121  \noindent\rule[0.25in]{\textwidth}{1pt}  \noindent\rule[0.25in]{\textwidth}{1pt}
122  \end{figure}  \end{figure}
123    
124  %$History: c_vct0.tex $  %$History: c_vct0.tex $
125  %  %
126  % *****************  Version 3  *****************  % *****************  Version 3  *****************
127  % User: Dashley1     Date: 12/31/00   Time: 7:42p  % User: Dashley1     Date: 12/31/00   Time: 7:42p
128  % Updated in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions  % Updated in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions
129  %  %
130  % *****************  Version 2  *****************  % *****************  Version 2  *****************
131  % User: Dashley1     Date: 12/22/00   Time: 12:57a  % User: Dashley1     Date: 12/22/00   Time: 12:57a
132  % Updated in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions  % Updated in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions
133  % Tcl automated method of build refined.  % Tcl automated method of build refined.
134  %  %
135  % *****************  Version 1  *****************  % *****************  Version 1  *****************
136  % User: David Ashley Date: 11/29/00   Time: 7:14p  % User: David Ashley Date: 11/29/00   Time: 7:14p
137  % Created in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions  % Created in $/uC Software Multi-Volume Book (A)/Chapter, VCT0, Version Control Extensions
138  % Initial check-in.  % Initial check-in.
139  %  %
140  %End of file C_VCT0.TEX  %End of file C_VCT0.TEX

Legend:
Removed from v.139  
changed lines
  Added in v.140

dashley@gmail.com
ViewVC Help
Powered by ViewVC 1.1.25