BSD 4_3 release

[unix-history] / usr / man / man1 / as.1

diff --git a/usr/man/man1/as.1 b/usr/man/man1/as.1
index 32332b4..2eefd0d 100644 (file)
--- a/usr/man/man1/as.1
+++ b/usr/man/man1/as.1
@@ -1,34 +1,84 @@
-.TH AS 1 VAX-11
-.UC
+.\" Copyright (c) 1980 Regents of the University of California.
+.\" All rights reserved.  The Berkeley software License Agreement
+.\" specifies the terms and conditions for redistribution.
+.\"
+.\"    @(#)as.1        6.3 (Berkeley) 5/8/86
+.\"
+.TH AS 1 "May 8, 1986"
+.UC 4

 .SH NAME
 .SH NAME

-as \- assembler
+as \- VAX-11 assembler

 .SH SYNOPSIS
 .B as
 [
 .SH SYNOPSIS
 .B as
 [

+.B \-a1-16
+] [
+[

 .B \-d124
 ] [
 .B \-L
 ] [
 .B \-d124
 ] [
 .B \-L
 ] [

+.B \-W
+] [
+.B \-V
+] [
+.B \-J
+] [
+.B \-R
+] [
+.B \-t
+directory
+] [

 .B \-o
 objfile ] [ name ... ]
 .SH DESCRIPTION
 .I As
 assembles the named files, or the standard input if no file name is specified.
 .B \-o
 objfile ] [ name ... ]
 .SH DESCRIPTION
 .I As
 assembles the named files, or the standard input if no file name is specified.

-The optional argument
+The available flags are:
+.TP
+.B \-a
+Specifies the alignment of procedures and data blocks.
+It is given as a power of two; thus an alignment of 3
+causes alignment on an eight byte boundary.
+The default is
+.B \-a2.
+.TP

 .B \-d
 .B \-d

-may be used to specify the number of bytes to be assembled for offsets
-which involve forward or external references, which have sizes unspecified
+Specifies the number of bytes to be assembled for offsets
+which involve forward or external references, and which have sizes unspecified

 in the assembly language.
 in the assembly language.

-The default is four bytes,
-i.e.,
-.B \-d4 \&.
+The default is 
+.B \-d4.
+.TP
+.B \-L
+Save defined labels beginning with a `L', which are normally discarded
+to save space in the resultant symbol table.
+The compilers generate such temporary labels.
+.TP
+.B \-V
+Use virtual memory for some intermediate storage,
+rather than a temporary file.
+.TP
+.B \-W
+Do not complain about errors.
+.TP
+.B \-J
+Use long branches to resolve jumps when byte-displacement branches are
+insufficient.  This must be used when a compiler-generated assembly contains
+branches of more than 32k bytes.
+.TP
+.B \-R
+Make initialized data segments read-only, by concatenating them to
+the text segments.
+This obviates the need to run editor scripts on assembly
+code to make initialized data read-only and shared.
+.TP
+.B \-t
+Specifies a directory to receive the temporary file, other than
+the default /tmp.
+.PP

 All undefined symbols in the assembly
 are treated as global.
 All undefined symbols in the assembly
 are treated as global.

-Normally all labels which begin with a `L' are discarded to save space in
-the resultant output file; the compilers generate such temporary labels.
-The
-.B \-L
-option causes these labels to not be discarded.

 .PP
 The output of the assembly is left on the file
 .I objfile;
 .PP
 The output of the assembly is left on the file
 .I objfile;


@@ -36,23 +86,24 @@ if that is omitted,
 .I a.out
 is used.
 .SH FILES
 .I a.out
 is used.
 .SH FILES

-.ta \w'/tmp/a[ab][a\-h]t\(**\ \ 'u
-/tmp/as\(**    temporary
-.br
-/tmp/a[ab][a\-h]t\(**  temporary
+.ta 1.5i
+/tmp/as\(**    default temporary files

 .br
 .br

-a.out          object
+a.out          default resultant object file

 .SH "SEE ALSO"
 ld(1),
 nm(1),
 adb(1),
 .SH "SEE ALSO"
 ld(1),
 nm(1),
 adb(1),

-sdb(1),
+dbx(1),

 a.out(5)
 .br
 Auxiliary documentation
 .I Assembler Reference Manual.
 .SH AUTHORS
 a.out(5)
 .br
 Auxiliary documentation
 .I Assembler Reference Manual.
 .SH AUTHORS

-John F. Resier
+John F. Reiser

 .br
 Robert R. Henry
 .SH BUGS
 .br
 Robert R. Henry
 .SH BUGS

+.B \-J
+should be eliminated; the assembler should automatically choose among
+byte, word and long branches.