• Home
  • History
  • Annotate
Name Date Size #Lines LOC

..07-May-2022-

config/H03-May-2022-374,223283,417

doc/H07-May-2022-65,62053,413

po/H03-May-2022-242,644191,608

testsuite/H03-May-2022-2,198,7172,123,389

.gitignoreH A D08-Jul-202189 107

CONTRIBUTORSH A D08-Jul-20215.2 KiB11787

COPYINGH A D08-Jul-202134.3 KiB675553

ChangeLogH A D18-Jul-202186.1 KiB2,4341,947

ChangeLog-0001H A D08-Jul-2021263.2 KiB7,7075,827

ChangeLog-0203H A D08-Jul-2021267 KiB7,5185,870

ChangeLog-2004H A D08-Jul-2021102.6 KiB2,6942,135

ChangeLog-2005H A D08-Jul-2021153.1 KiB4,2703,309

ChangeLog-2006H A D08-Jul-202199.4 KiB2,7632,135

ChangeLog-2007H A D08-Jul-202187 KiB2,6451,967

ChangeLog-2008H A D08-Jul-202161.8 KiB1,8841,363

ChangeLog-2009H A D08-Jul-202195.4 KiB2,9192,213

ChangeLog-2010H A D08-Jul-202175.1 KiB2,2911,647

ChangeLog-2011H A D08-Jul-202169.6 KiB2,0981,564

ChangeLog-2012H A D08-Jul-202163.7 KiB1,9671,467

ChangeLog-2013H A D08-Jul-202173 KiB2,1061,586

ChangeLog-2014H A D08-Jul-202166.9 KiB1,8901,461

ChangeLog-2015H A D08-Jul-202168.3 KiB2,0441,535

ChangeLog-2016H A D08-Jul-2021225.7 KiB6,0254,966

ChangeLog-2017H A D08-Jul-2021171.4 KiB4,4203,680

ChangeLog-2018H A D08-Jul-2021217 KiB5,8875,000

ChangeLog-2019H A D08-Jul-2021189.8 KiB4,8854,086

ChangeLog-2020H A D08-Jul-2021221.9 KiB6,1204,997

ChangeLog-9295H A D08-Jul-2021500.6 KiB13,13110,000

ChangeLog-9697H A D08-Jul-2021212.4 KiB5,9734,337

ChangeLog-9899H A D08-Jul-2021168.6 KiB4,8743,517

MAINTAINERSH A D08-Jul-2021259 85

Makefile.amH A D08-Jul-202117 KiB632501

Makefile.inH A D18-Jul-202160.2 KiB1,7331,528

NEWSH A D08-Jul-202130.7 KiB907570

READMEH A D08-Jul-20216.2 KiB171126

acinclude.m4H A D08-Jul-20213 KiB9594

aclocal.m4H A D18-Jul-202143.5 KiB1,2091,100

app.cH A D08-Jul-202135.2 KiB1,4841,078

as.cH A D08-Jul-202141.2 KiB1,4851,094

as.hH A D08-Jul-202116.7 KiB623356

asintl.hH A D08-Jul-20212 KiB5728

atof-generic.cH A D08-Jul-202118.2 KiB636400

bignum.hH A D08-Jul-20211.6 KiB439

bit_fix.hH A D08-Jul-20211.9 KiB4813

cgen.cH A D08-Jul-202131.6 KiB1,066680

cgen.hH A D08-Jul-20213.6 KiB10644

compress-debug.cH A D08-Jul-20212.5 KiB9856

compress-debug.hH A D08-Jul-20211.4 KiB4010

cond.cH A D08-Jul-202114.3 KiB583432

config.inH A D18-Jul-20218 KiB328232

configureH A D18-Jul-2021468.6 KiB16,53013,805

configure.acH A D08-Jul-202129.3 KiB1,051924

configure.comH A D08-Jul-20217.6 KiB281224

configure.tgtH A D08-Jul-202113.7 KiB461385

debug.cH A D08-Jul-20212.6 KiB10677

dep-in.sedH A D08-Jul-2021921 5349

depend.cH A D08-Jul-20214.6 KiB208126

dw2gencfi.cH A D08-Jul-202161.2 KiB2,5952,118

dw2gencfi.hH A D08-Jul-20215.3 KiB205131

dwarf2dbg.cH A D08-Jul-202177 KiB2,9492,034

dwarf2dbg.hH A D08-Jul-20214.3 KiB12343

ecoff.cH A D08-Jul-2021146.5 KiB5,2133,423

ecoff.hH A D08-Jul-20213.9 KiB11344

ehopt.cH A D08-Jul-202115 KiB573360

emul-target.hH A D08-Jul-20211.6 KiB6133

emul.hH A D08-Jul-20211.5 KiB4419

expr.cH A D08-Jul-202162.7 KiB2,4351,844

expr.hH A D08-Jul-20216.8 KiB19481

flonum-copy.cH A D08-Jul-20212.2 KiB7140

flonum-konst.cH A D08-Jul-20218.1 KiB228151

flonum-mult.cH A D08-Jul-20214.9 KiB188107

flonum.hH A D08-Jul-20214 KiB10220

frags.cH A D08-Jul-202116.1 KiB567344

frags.hH A D08-Jul-20215.2 KiB16478

gdbinit.inH A D08-Jul-2021491 3929

hash.cH A D08-Jul-20211.7 KiB5627

hash.hH A D08-Jul-20213.1 KiB11871

input-file.cH A D08-Jul-20215.8 KiB260164

input-file.hH A D08-Jul-20212.3 KiB668

input-scrub.cH A D08-Jul-202114.7 KiB523332

itbl-lex-wrapper.cH A D08-Jul-20211 KiB262

itbl-lex.cH A D18-Jul-202148.1 KiB1,9271,219

itbl-lex.hH A D08-Jul-2021897 243

itbl-lex.lH A D08-Jul-20212 KiB10679

itbl-ops.cH A D08-Jul-202123.1 KiB886553

itbl-ops.hH A D08-Jul-20212.8 KiB10158

itbl-parse.cH A D18-Jul-202159.8 KiB2,0281,225

itbl-parse.hH A D18-Jul-20212.6 KiB10251

itbl-parse.yH A D08-Jul-202110.8 KiB458184

listing.cH A D08-Jul-202138.1 KiB1,6661,180

listing.hH A D08-Jul-20212 KiB6737

literal.cH A D08-Jul-20213 KiB9344

macro.cH A D08-Jul-202132 KiB1,4141,099

macro.hH A D08-Jul-20215.3 KiB187112

makefile.vmsH A D08-Jul-20212.4 KiB8044

messages.cH A D08-Jul-202111.4 KiB453282

obj.hH A D08-Jul-20212.9 KiB8754

output-file.cH A D08-Jul-20212 KiB7338

output-file.hH A D08-Jul-20211,021 263

read.cH A D08-Jul-2021151.1 KiB6,3544,692

read.hH A D08-Jul-20217.4 KiB222169

remap.cH A D08-Jul-20212.4 KiB8646

sb.cH A D08-Jul-20215.2 KiB235138

sb.hH A D08-Jul-20212.5 KiB7123

stabs.cH A D08-Jul-202117.9 KiB706469

stamp-h.inH A D08-Jul-202110 21

subsegs.cH A D08-Jul-20218.3 KiB335213

subsegs.hH A D08-Jul-20214 KiB12045

symbols.cH A D08-Jul-202185.2 KiB3,4382,519

symbols.hH A D08-Jul-20217.8 KiB217149

tc.hH A D08-Jul-20212.5 KiB8451

write.cH A D08-Jul-202186.1 KiB3,2192,398

write.hH A D08-Jul-20215.6 KiB18987

README

1		README for GAS
2
3A number of things have changed since version 1 and the wonderful
4world of gas looks very different.  There's still a lot of irrelevant
5garbage lying around that will be cleaned up in time.  Documentation
6is scarce, as are logs of the changes made since the last gas release.
7My apologies, and I'll try to get something useful.
8
9Unpacking and Installation - Summary
10====================================
11
12See ../binutils/README.
13
14To build just the assembler, make the target all-gas.
15
16Documentation
17=============
18
19The GAS release includes texinfo source for its manual, which can be processed
20into `info' or `dvi' forms.
21
22The DVI form is suitable for printing or displaying; the commands for doing
23this vary from system to system.  On many systems, `lpr -d' will print a DVI
24file.  On others, you may need to run a program such as `dvips' to convert the
25DVI file into a form your system can print.
26
27If you wish to build the DVI file, you will need to have TeX installed on your
28system.  You can rebuild it by typing:
29
30	cd gas/doc
31	make as.dvi
32
33The Info form is viewable with the GNU Emacs `info' subsystem, or the
34stand-alone `info' program, available as part of the GNU Texinfo distribution.
35To build the info files, you will need the `makeinfo' program.  Type:
36
37	cd gas/doc
38	make info
39
40Specifying names for hosts and targets
41======================================
42
43   The specifications used for hosts and targets in the `configure'
44script are based on a three-part naming scheme, but some short
45predefined aliases are also supported.  The full naming scheme encodes
46three pieces of information in the following pattern:
47
48     ARCHITECTURE-VENDOR-OS
49
50   For example, you can use the alias `sun4' as a HOST argument or in a
51`--target=TARGET' option.  The equivalent full name is
52`sparc-sun-sunos4'.
53
54   The `configure' script accompanying GAS does not provide any query
55facility to list all supported host and target names or aliases.
56`configure' calls the Bourne shell script `config.sub' to map
57abbreviations to full names; you can read the script, if you wish, or
58you can use it to test your guesses on abbreviations--for example:
59
60     % sh config.sub i386v
61     i386-unknown-sysv
62     % sh config.sub i786v
63     Invalid configuration `i786v': machine `i786v' not recognized
64
65
66`configure' options
67===================
68
69   Here is a summary of the `configure' options and arguments that are
70most often useful for building GAS.  `configure' also has several other
71options not listed here.
72
73     configure [--help]
74               [--prefix=DIR]
75               [--srcdir=PATH]
76               [--host=HOST]
77               [--target=TARGET]
78               [--with-OPTION]
79               [--enable-OPTION]
80
81You may introduce options with a single `-' rather than `--' if you
82prefer; but you may abbreviate option names if you use `--'.
83
84`--help'
85     Print a summary of the options to `configure', and exit.
86
87`-prefix=DIR'
88     Configure the source to install programs and files under directory
89     `DIR'.
90
91`--srcdir=PATH'
92     Look for the package's source code in directory DIR.  Usually
93     `configure' can determine that directory automatically.
94
95`--host=HOST'
96     Configure GAS to run on the specified HOST.  Normally the
97     configure script can figure this out automatically.
98
99     There is no convenient way to generate a list of all available
100     hosts.
101
102`--target=TARGET'
103     Configure GAS for cross-assembling programs for the specified
104     TARGET.  Without this option, GAS is configured to assemble .o files
105     that run on the same machine (HOST) as GAS itself.
106
107     There is no convenient way to generate a list of all available
108     targets.
109
110`--enable-OPTION'
111     These flags tell the program or library being configured to
112     configure itself differently from the default for the specified
113     host/target combination.  See below for a list of `--enable'
114     options recognized in the gas distribution.
115
116`configure' accepts other options, for compatibility with configuring
117other GNU tools recursively; but these are the only options that affect
118GAS or its supporting libraries.
119
120The `--enable' options recognized by software in the gas distribution are:
121
122`--enable-targets=...'
123     This causes one or more specified configurations to be added to those for
124     which BFD support is compiled.  Currently gas cannot use any format other
125     than its compiled-in default, so this option is not very useful.
126
127`--enable-bfd-assembler'
128     This causes the assembler to use the new code being merged into it to use
129     BFD data structures internally, and use BFD for writing object files.
130     For most targets, this isn't supported yet.  For most targets where it has
131     been done, it's already the default.  So generally you won't need to use
132     this option.
133
134Compiler Support Hacks
135======================
136
137On a few targets, the assembler has been modified to support a feature
138that is potentially useful when assembling compiler output, but which
139may confuse assembly language programmers.  If assembler encounters a
140.word pseudo-op of the form symbol1-symbol2 (the difference of two
141symbols), and the difference of those two symbols will not fit in 16
142bits, the assembler will create a branch around a long jump to
143symbol1, and insert this into the output directly before the next
144label: The .word will (instead of containing garbage, or giving an
145error message) contain (the address of the long jump)-symbol2.  This
146allows the assembler to assemble jump tables that jump to locations
147very far away into code that works properly.  If the next label is
148more than 32K away from the .word, you lose (silently); RMS claims
149this will never happen.  If the -K option is given, you will get a
150warning message when this happens.
151
152
153REPORTING BUGS IN GAS
154=====================
155
156Bugs in gas should be reported to:
157
158   bug-binutils@gnu.org.
159
160They may be cross-posted to gcc-bugs@gnu.org if they affect the use of
161gas with gcc.  They should not be reported just to gcc-bugs, since not
162all of the maintainers read that list.
163
164See ../binutils/README for what we need in a bug report.
165
166Copyright (C) 2012-2021 Free Software Foundation, Inc.
167
168Copying and distribution of this file, with or without modification,
169are permitted in any medium without royalty provided the copyright
170notice and this notice are preserved.
171