aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDoug Evans <dje@google.com>1997-11-05 00:15:22 +0000
committerDoug Evans <dje@google.com>1997-11-05 00:15:22 +0000
commit86cb8d868dc566fb7813a7478b32c1e77f632836 (patch)
treedc66adfd0aa0a488aba08c26386f29f3dd68f905
parent525d929e4947c625f79ad3c2e02272f8db2c9f8c (diff)
downloadgdb-86cb8d868dc566fb7813a7478b32c1e77f632836.zip
gdb-86cb8d868dc566fb7813a7478b32c1e77f632836.tar.gz
gdb-86cb8d868dc566fb7813a7478b32c1e77f632836.tar.bz2
Update ns32k docs.
-rw-r--r--gas/doc/internals.texi57
1 files changed, 46 insertions, 11 deletions
diff --git a/gas/doc/internals.texi b/gas/doc/internals.texi
index a2d2a75..40fcfe5 100644
--- a/gas/doc/internals.texi
+++ b/gas/doc/internals.texi
@@ -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.