Update ns32k docs.
authorDoug Evans <dje@google.com>
Wed, 5 Nov 1997 00:15:22 +0000 (00:15 +0000)
committerDoug Evans <dje@google.com>
Wed, 5 Nov 1997 00:15:22 +0000 (00:15 +0000)
gas/doc/internals.texi

index a2d2a756c4976ce6270b3a739b96e209fc8b51fc..40fcfe5434bd738a1a1b78cf652e57b3ce4b040e 100644 (file)
@@ -469,7 +469,8 @@ This normally indicates the symbol to use when relaxing the frag according to
 @item fr_opcode
 Points to the lowest-addressed byte of the opcode, for use in relaxation.
 
-@item fr_pcrel_adjust
+@item fr_opcode_frag
+@itemx fr_opcode_offset
 @itemx fr_bsr
 These fields are only used in the NS32k configuration.  But since @code{struct
 frag} is defined before the CPU-specific header files are included, they must
@@ -511,6 +512,13 @@ The variable characters are to be repeated @code{fr_offset} times.  If
 @code{fr_offset} is 0, this frag has a length of @code{fr_fix}.  Most frags
 have this type.
 
+@item rs_leb128
+This state is used to implement the DWARF ``little endian base 128'' 
+variable length number format.  The @code{fr_symbol} is always an expression
+symbol, as constant expressions are emitted directly.  The @code{fr_offset}
+field is used during relaxation to hold the previous size of the number so
+that we can determine if the fragment changed size.
+
 @item rs_machine_dependent
 Displacement relaxation is to be done on this frag.  The target is indicated by
 @code{fr_symbol} and @code{fr_offset}, and @code{fr_subtype} indicates the
@@ -621,18 +629,18 @@ second switches on the entire target to set the shell variable @code{fmt}.
 
 The configure script uses the value of @code{cpu_type} to select two files in
 the @file{config} directory: @file{tc-@var{CPU}.c} and @file{tc-@var{CPU}.h}.
-The configuration process will create symlinks to these files from
-@file{targ-cpu.c} and @file{targ-cpu.h} in the build directory.
+The configuration process will create a file named @file{targ-cpu.h} in the
+build directory which includes @file{tc-@var{CPU}.h}.
 
 The configure script also uses the value of @code{fmt} to select two files:
 @file{obj-@var{fmt}.c} and @file{obj-@var{fmt}.h}.  The configuration process
-will create symlinks to these files from @file{obj-format.h} and
-@file{obj-format.c}.
+will create a file named @file{obj-format.h} in the build directory which
+includes @file{obj-@var{fmt}.h}.
 
 You can also set the emulation in the configure script by setting the @code{em}
 variable.  Normally the default value of @samp{generic} is fine.  The
-configuration process will create a symlink from @file{targ-env.h} to
-@file{te-@var{em}.h}.
+configuration process will create a file named @file{targ-env.h} in the build
+directory which includes @file{te-@var{em}.h}.
 
 Porting GAS to a new CPU requires writing the @file{tc-@var{CPU}} files.
 Porting GAS to a new object file format requires writing the
@@ -895,7 +903,7 @@ GAS will call it at the end of the assembly.
 
 @item md_flush_pending_output
 @cindex md_flush_pending_output
-If you define this macro, GAS will it each time it skips any space because of a
+If you define this macro, GAS will call it each time it skips any space because of a
 space filling or alignment or data allocation pseudo-op.
 
 @item TC_PARSE_CONS_EXPRESSION
@@ -990,7 +998,7 @@ then discard this space when relaxing the section.
 @cindex md_convert_frag
 GAS will call this for each rs_machine_dependent fragment.
 The instruction is completed using the data from the relaxation pass.
-It may also create an necessary relocations.
+It may also create any necessary relocations.
 @xref{Relaxation}.
 
 @item md_apply_fix
@@ -1047,7 +1055,7 @@ If you define this macro, GAS will call it each time a label is defined.
 
 @item md_section_align
 @cindex md_section_align
-GAS will call this function for each section at the end of the assemebly, to
+GAS will call this function for each section at the end of the assembly, to
 permit the CPU backend to adjust the alignment of a section.
 
 @item tc_frob_section
@@ -1075,6 +1083,33 @@ completed, but before the relocations have been generated.
 @item tc_frob_file_after_relocs
 If you define this macro, GAS will call it after the relocs have been
 generated.
+
+@item LISTING_HEADER
+A string to use on the header line of a listing.  The default value is simply
+@code{"GAS LISTING"}.
+
+@item LISTING_WORD_SIZE
+The number of bytes to put into a word in a listing.  This affects the way the
+bytes are clumped together in the listing.  For example, a value of 2 might
+print @samp{1234 5678} where a value of 1 would print @samp{12 34 56 78}.  The
+default value is 4.
+
+@item LISTING_LHS_WIDTH
+The number of words of data to print on the first line of a listing for a
+particular source line, where each word is @code{LISTING_WORD_SIZE} bytes.  The
+default value is 1.
+
+@item LISTING_LHS_WIDTH_SECOND
+Like @code{LISTING_LHS_WIDTH}, but applying to the second and subsequent line
+of the data printed for a particular source line.  The default value is 1.
+
+@item LISTING_LHS_CONT_LINES
+The maximum number of continuation lines to print in a listing for a particular
+source line.  The default value is 4.
+
+@item LISTING_RHS_WIDTH
+The maximum number of characters to print from one line of the input file.  The
+default value is 100.
 @end table
 
 @node Object format backend
@@ -1228,7 +1263,7 @@ the value to be stored is outside the range accessible by the current
 addressing mode.  The @code{fr_symbol} field of the frag indicates what symbol
 is to be accessed; the @code{fr_offset} field is added in.
 
-If the @code{fr_pcrel_adjust} field is set, which currently should only happen
+If the @code{TC_PCREL_ADJUST} macro is defined, which currently should only happen
 for the NS32k family, the @code{TC_PCREL_ADJUST} macro is called on the frag to
 compute an adjustment to be made to the displacement.
 
This page took 0.033932 seconds and 4 git commands to generate.