]> thyrsus.com Git - mad.git/commitdiff
Get rid of double dashes.
authorEric S. Raymond <esr@thyrsus,com>
Fri, 9 Apr 2004 17:04:17 +0000 (17:04 +0000)
committerEric S. Raymond <esr@thyrsus,com>
Fri, 9 Apr 2004 17:04:17 +0000 (17:04 +0000)
doc/mad-manual.xml

index 30aeb4b7a6318cbb7e68781f2e3438b534d0f39c..fff13eeb70d79364e6a734cee761e383b616bce6 100644 (file)
 <!ENTITY scriptS "<emphasis>S</emphasis>">
 <!ENTITY scriptV "<emphasis>V</emphasis>">
 <!ENTITY scriptl "<emphasis>l</emphasis>">
+
+<!-- hack to defeat Emacs's special handling of dash-dash -->
+<!ENTITY dd "--">
+
 ]>
 <book>
 <preface><title>Notes from the 21st century</title>
@@ -3234,7 +3238,7 @@ linkend='internal_and_external'/>.  Throughout this section a
 single-valued function will be called a "function", and a function
 with multiple outputs and/or multiple exits will be called a
 "procedure".  For the purposes of this manual a recursive function is
-one whose definition contains calls for the function being defined --
+one whose definition contains calls for the function being defined &dd;
 or calls for functions which ultimately call the one being defined.
 Recursive functions have the same structure as other functions
 although, in general, they will include statements of the type
@@ -3247,6 +3251,11 @@ III.</para>
 
 <sect3 id='external_functions'><title>External Function Definitions</title>
 
+<!--
+In the original, "variables and functions in the main program" was
+typoed as "variables and function in the main program" (incorrect
+singular).
+-->
 <para>These statements define functions not yet available in the
 language or as standard package programs ("subroutines").  The
 designatyion "EXTERNAL" implies that the statements which follow are
@@ -3256,7 +3265,7 @@ be considered an entirely separate program, and must have its own
 DIMENSION and MODE declaration, etc.)  The word "EXTERNAL" also
 implies that occurrences of variables and functions in the current
 function definition program have no relation whatever with occurrences
-of similarly named variables and function [typo] in the main program
+of similarly named variables and functions in the main program
 (or other definition programs), and no difficulties will be
 encountered because of the use of similar names.  The modes of the
 arguments (if other than the normal mode), must be declared in the
@@ -3972,7 +3981,8 @@ linear equations in n unknowns, assuming that one does not encounter a
 zero on the main diagonal of the coefficient matrix during the
 solution process.</para>
 
-<para><emphasis>Analysis</emphasis>: We shall use a Jordan Elimation [typo?]
+<!-- The original had a typo, "Elimation" for "Elimination" -->
+<para><emphasis>Analysis</emphasis>: We shall use a Jordan Elimination
 Method, in which each diagonal coefficient is used to "clear" all
 other coefficients in its column to zero by appropriate
 multiplications and subtractions. Since we shall divide the "clearing
@@ -4322,7 +4332,7 @@ again.</para>
 <para>Problem: Mortgage Payment.  The type of mortgage we consider is
 the fixed principle type for which each installment consists of an
 interest payment, a fixed amount to be deducted from the outstanding
-principal, and an additional amount to be placed in escrow--to be used
+principal, and an additional amount to be placed in escrow&dd;to be used
 to make insurance and tax payments.</para>
  
 <!-- The original says "interest rage" and "nortage number" --> 
@@ -4713,8 +4723,8 @@ even though no error exists in the later statement.</para>
 
 <para>The printed diagnostic comment may very often have an alternative or
 ambiguous form.  This results from the fact that it is frequently not
-possible to determine what form was intended--merely that the present
-structure is not admissible--and therefore some of the alternative
+possible to determine what form was intended&dd;merely that the present
+structure is not admissible&dd;and therefore some of the alternative
 possibilities are suggested by the comment.</para>
 
 </sect1>
@@ -4727,12 +4737,12 @@ MAD.</para>
 <!-- beiginpage IV.3 -->
 
 <!-- the original had a tyo, "Probram" for "Program" -->
-<para>Subroutines which are written for use by MAD programs--whether
+<para>Subroutines which are written for use by MAD programs&dd;whether
 written in MAD as functions or in SAP<footnote><para>SAP is the SHARE
-Assembly Program [typo] which permits the writing of actual machine
-instructions in symbolic form.</para></footnote>--must be relocatable
+Assembly Program which permits the writing of actual machine
+instructions in symbolic form.</para></footnote>&dd;must be relocatable
 and must operate from the calling sequences the translator produces.
-Consider, for example the function call --FN. (A,B,C)--which might
+Consider, for example the function call - FN. (A,B,C) - which might
 appear in the body of a statement. Assume that B is an array which has
 an associated dimension vector BDIM.  Using SAP notation for
 illustrative purposes, the calling sequence produced would be</para>
@@ -4744,7 +4754,7 @@ illustrative purposes, the calling sequence produced would be</para>
                TXH     C
 </programlisting>
 
-<para>Input-output routines utilize two types of parameters--the
+<para>Input-output routines utilize two types of parameters&dd;the
 regional and single variable types.  In addition an error return is
 given as well as a format specification location.  The parameter
 operation code used is TXI and the end of the parameter list is
@@ -4780,13 +4790,13 @@ DELTA, Z(10)...Z(20)).  The calling sequence would be</para>
 <!-- beginpage IV.4 -->
 
 <para>It is important to notice that in this example, as well as in the
-first, the parameters--if executed as instructions--would produce no
+first, the parameters&dd;if executed as instructions&dd;would produce no
 operation.</para>
 
 <para>It is beyond the scope of this manual to discuss the structure of
 relocatble programs (see IBM FORTRAN II Manual).  It is suficient to
-say that a relocatable program must contain--in adidtion to the actual
-instructions in the program--information as to which addresses must be
+say that a relocatable program must contain&dd;in adidtion to the actual
+instructions in the program&dd;information as to which addresses must be
 relocated at the time of loading for execution and which addresses
 must not.  In addition, the first card (or record) of such programs
 must contain information about the size of the program, the number of