date and time created 88/10/21 13:47:49 by bostic

[unix-history] / usr / src / old / as.vax / PSD.doc / asdocs1.me

diff --git a/usr/src/old/as.vax/PSD.doc/asdocs1.me b/usr/src/old/as.vax/PSD.doc/asdocs1.me
index 676a627..cbe69e8 100644 (file)
--- a/usr/src/old/as.vax/PSD.doc/asdocs1.me
+++ b/usr/src/old/as.vax/PSD.doc/asdocs1.me
@@ -1,13 +1,12 @@
 .\"
 .\"

-.\" Copyright (c) 1982 Regents of the University of California
-.\"
-.\" @(#)asdocs1.me 1.1 %G%
+.\"    Copyright (c) 1982 Regents of the University of California
+.\"    @(#)asdocs1.me 1.7 %G%

 .\"
 .EQ
 delim $$
 .EN
 .(l C
 .\"
 .EQ
 delim $$
 .EN
 .(l C

-.i "\*(VX Assembler Reference Manual"
+.i "\*(VS \*(AM"

 .sp 2.0v
 John F. Reiser
 Bell Laboratories,
 .sp 2.0v
 John F. Reiser
 Bell Laboratories,


@@ -27,7 +26,7 @@ Berkeley, CA  94720
 November 5, 1979
 .sp 1.0v
 .i Revised
 November 5, 1979
 .sp 1.0v
 .i Revised

-August 11, 1982
+\*(TD

 .)l
 .SH 1 Introduction
 .pp
 .)l
 .SH 1 Introduction
 .pp


@@ -44,10 +43,9 @@ This document is intended only for the writer of a compiler or a maintainer
 of the assembler.
 .SH 2 "Assembler Revisions since November 5, 1979"
 .pp
 of the assembler.
 .SH 2 "Assembler Revisions since November 5, 1979"
 .pp

-These are the major changes to
+There has been one major change to

 .i as 
 .i as 

-since the last release:
-.ip -
+since the last release.

 .i As
 has been updated to assemble the new instructions and
 data formats for
 .i As
 has been updated to assemble the new instructions and
 data formats for


@@ -56,31 +54,13 @@ and
 .q H
 floating point numbers,
 as well as the new queue instructions.
 .q H
 floating point numbers,
 as well as the new queue instructions.

+.SH 2 "Features Supported, but No Longer Encouraged as of \*(TD"
+.pp
+These feature(s) in
+.i as
+are supported, but no longer encouraged.

 .ip -
 .ip -

-.i As
-no longer supports the colon operator for initializing fields.
-.ip -
-.i As
-no longer supports the
-.b stab
-directive.
-.ip -
-A new keyword,
-.b .global
-has been added
-to augment the keyword
-.b .globl .
-.ip -
-.i As
-accepts and can generate a
-.i "binary symbolic"
-intermediate representation of the assembly code.
-This standard, efficient format is
-intended to be used with assembly code optimizers
-and newer compilers.
-This intermediate form is documented in the appendix.
-(These additional producers and consumers
-have not yet been implemented.)
+The colon operator for field initialization is likely to disappear.

 .SH 1 "Usage"
 .pp
 .i As
 .SH 1 "Usage"
 .pp
 .i As


@@ -207,7 +187,7 @@ If file arguments occur,
 then the input is taken sequentially from the files
 $name sub 1$,
 $name sub 2~...~name sub n$
 then the input is taken sequentially from the files
 $name sub 1$,
 $name sub 2~...~name sub n$

-This is not to say that the files are assembled seperately;
+This is not to say that the files are assembled separately;

 $name sub 1$ is effectively concatenated to $name sub 2$,
 so multiple definitions cannot occur amongst the input sources.
 .pp
 $name sub 1$ is effectively concatenated to $name sub 2$,
 so multiple definitions cannot occur amongst the input sources.
 .pp


@@ -245,7 +225,7 @@ and
 dollar
 .q "\*(DL" ).
 The first character may not be numeric.
 dollar
 .q "\*(DL" ).
 The first character may not be numeric.

-Identifier may be (practically) arbitrary long;
+Identifiers may be (practically) arbitrary long;

 all characters are significant.
 .SH 2 "Constants"
 .SH 3 "Scalar constants"
 all characters are significant.
 .SH 2 "Constants"
 .SH 3 "Scalar constants"


@@ -260,7 +240,7 @@ In addition,
 .i As
 supports 64 and 128 bit integers 
 only so they can be used as immediate constants
 .i As
 supports 64 and 128 bit integers 
 only so they can be used as immediate constants

-or to fill intialized data space.
+or to fill initialized data space.

 .i As
 can not perform arithmetic on constants larger than 32 bits.
 .pp
 .i As
 can not perform arithmetic on constants larger than 32 bits.
 .pp


@@ -301,8 +281,8 @@ Using the meta notation that
 .q "fFdDhHgG" ),
 [expe] is a exponent delimiter and type specification character (\c,
 .q "eEfFdDhHgG" ),
 .q "fFdDhHgG" ),
 [expe] is a exponent delimiter and type specification character (\c,
 .q "eEfFdDhHgG" ),

-$x sup roman "*"$ means 0 or more occurances of $x$,
-$x sup +$ means 1 or more occurances of $x$,
+$x sup roman "*"$ means 0 or more occurences of $x$,
+$x sup +$ means 1 or more occurences of $x$,

 then the general lexical form of a floating point number is:
 .ce 1
 0[expe]([+-])$roman "[dec]" sup +$(.)($roman "[dec]" sup roman "*"$)([expt]([+-])($roman "dec]" sup +$))
 then the general lexical form of a floating point number is:
 .ce 1
 0[expe]([+-])$roman "[dec]" sup +$(.)($roman "[dec]" sup roman "*"$)([expt]([+-])($roman "dec]" sup +$))


@@ -367,7 +347,7 @@ a 32 bit scalar quantity may also be used.
 .SH 3 "String Constants"
 .pp
 A string constant is defined using
 .SH 3 "String Constants"
 .pp
 A string constant is defined using

-the same syntax and semantics as the \*(CL langauge uses.
+the same syntax and semantics as the \*(CL language uses.

 Strings begin and end with a
 .q "''"
 (double quote).
 Strings begin and end with a
 .q "''"
 (double quote).


@@ -398,7 +378,7 @@ introduces a comment,
 which extends through the end of the line on which it appears.
 Comments starting in column 1,
 having the format
 which extends through the end of the line on which it appears.
 Comments starting in column 1,
 having the format

-.q "# $expression~~string$"
+.q "# $expression~~string$" ,

 are interpreted as an indication that the assembler is now assembling
 file
 .i string
 are interpreted as an indication that the assembler is now assembling
 file
 .i string


@@ -412,7 +392,7 @@ and
 preprocessor directives.
 (Note that there may not be an assembler comment starting in column
 1 if the assembler source is given to the \*(CL preprocessor,
 preprocessor directives.
 (Note that there may not be an assembler comment starting in column
 1 if the assembler source is given to the \*(CL preprocessor,

-as it will be intrepreted by the preprocessor in a way not intended.)
+as it will be interpreted by the preprocessor in a way not intended.)

 Comments are otherwise ignored by the assembler.
 .SH 2 "\*(CL Style Comments"
 .pp
 Comments are otherwise ignored by the assembler.
 .SH 2 "\*(CL Style Comments"
 .pp