← Back to branch summary

~ubuntu-branches/debian/sid/gcc-4.8/sid

« back to all changes in this revision

Viewing changes to .svn/pristine/31/31364ddb6be7e6613d1e4e7b218162a1ff734c70.svn-base

  • Committer: Package Import Robot
  • Author(s): Matthias Klose
  • Date: 2014-12-19 19:48:34 UTC
  • Revision ID: package-import@ubuntu.com-20141219194834-4dz1q7rrn5pad823
Tags: 4.8.4-1
* GCC 4.8.4 release.
  - Fix PR target/61407 (darwin), PR middle-end/58624 (ice),
    PR sanitizer/64265 (wrong code).
* Require recent binutils to pass go test failures.

Show diffs side-by-side

added added

removed removed

Lines of Context:
.svn/pristine/31/31364ddb6be7e6613d1e4e7b218162a1ff734c70.svn-base
 
1
# DP: Replace documentation with stub.
 
2
 
 
3
--- a/src/gcc/d/gdc.texi        2013-04-08 11:21:37.000000000 +0100
 
4
+++ b/src/gcc/d/gdc.texi        2013-04-10 16:09:21.497798648 +0100
 
5
@@ -1,7 +1,10 @@
 
6
-\input texinfo @c -*-texinfo-*-
 
7
-@setfilename gdc.info
 
8
-@settitle The GNU D Compiler
 
9
+\input texinfo  @c -*-texinfo-*-
 
10
+@c %**start of header
 
11
 
 
12
+@settitle The GNU Compiler Collection (GCC)
 
13
+
 
14
+@c Create a separate index for command line options.
 
15
+@defcodeindex op
 
16
 @c Merge the standard indexes into a single one.
 
17
 @syncodeindex fn cp
 
18
 @syncodeindex vr cp
 
19
@@ -9,327 +12,30 @@
 
20
 @syncodeindex pg cp
 
21
 @syncodeindex tp cp
 
22
 
 
23
-@include gcc-common.texi
 
24
+@paragraphindent 1
 
25
 
 
26
-@c Copyright years for this manual.
 
27
-@set copyrights-d 2011, 2012
 
28
+@c %**end of header
 
29
 
 
30
 @copying
 
31
-@c man begin COPYRIGHT
 
32
-Copyright @copyright{} @value{copyrights-d} Free Software Foundation, Inc.
 
33
-
 
34
-Permission is granted to copy, distribute and/or modify this document
 
35
-under the terms of the GNU Free Documentation License, Version 1.3 or
 
36
-any later version published by the Free Software Foundation; with no
 
37
-Invariant Sections, the Front-Cover Texts being (a) (see below), and
 
38
-with the Back-Cover Texts being (b) (see below).
 
39
-A copy of the license is included in the
 
40
-@c man end
 
41
-section entitled ``GNU Free Documentation License''.
 
42
-@ignore
 
43
-@c man begin COPYRIGHT
 
44
-man page gfdl(7).
 
45
-@c man end
 
46
-@end ignore
 
47
-
 
48
-@c man begin COPYRIGHT
 
49
-
 
50
-(a) The FSF's Front-Cover Text is:
 
51
-
 
52
-     A GNU Manual
 
53
-
 
54
-(b) The FSF's Back-Cover Text is:
 
55
-
 
56
-     You have freedom to copy and modify this GNU Manual, like GNU
 
57
-     software.  Copies published by the Free Software Foundation raise
 
58
-     funds for GNU development.
 
59
-@c man end
 
60
+The current documentation is licensed under the same terms as the Debian packaging.
 
61
 @end copying
 
62
-
 
63
-@ifinfo
 
64
-@format
 
65
-@dircategory Software development
 
66
+@ifnottex
 
67
+@dircategory Programming
 
68
 @direntry
 
69
-* gdc - A GCC-based compiler for the D language
 
70
+* gdc: (gdc).                  The GNU Compiler Collection (gdc).
 
71
 @end direntry
 
72
-@end format
 
73
-
 
74
-@insertcopying
 
75
-@end ifinfo
 
76
-
 
77
-@titlepage
 
78
-@title The GNU D Compiler
 
79
-@versionsubtitle
 
80
-@author David Friedman, Iain Buclaw
 
81
-
 
82
-@page
 
83
-@vskip 0pt plus 1filll
 
84
-Published by the Free Software Foundation @*
 
85
-51 Franklin Street, Fifth Floor@*
 
86
-Boston, MA 02110-1301, USA@*
 
87
 @sp 1
 
88
-@insertcopying
 
89
-@end titlepage
 
90
+@end ifnottex
 
91
+
 
92
+@summarycontents
 
93
 @contents
 
94
 @page
 
95
 
 
96
 @node Top
 
97
 @top Introduction
 
98
-
 
99
-This manual describes how to use @command{gdc}, the GNU compiler for
 
100
-the o programming language.  This manual is specifically about
 
101
-@command{gdc}.  For more information about the D programming
 
102
-language in general, including language specifications and standard
 
103
-package documentation, see @uref{http://dlang.org/}.
 
104
-
 
105
-@menu
 
106
-* Copying::                     The GNU General Public License.
 
107
-* GNU Free Documentation License::
 
108
-                                How you can share and copy this manual.
 
109
-* Invoking gdc::                How to run gdc.
 
110
-* Index::                       Index.
 
111
-@end menu
 
112
-
 
113
-
 
114
-@include gpl_v3.texi
 
115
-
 
116
-@include fdl.texi
 
117
-
 
118
-
 
119
-@node Invoking gdc
 
120
-@chapter Invoking gdc
 
121
-
 
122
-@c man title gdc A GCC-based compiler for the D language
 
123
-
 
124
-@ignore
 
125
-@c man begin SYNOPSIS gdc
 
126
-gdc [@option{-c}]
 
127
-    [@option{-g}] [@option{-pg}] [@option{-O}@var{level}]
 
128
-    [@option{-I}@var{dir}@dots{}] [@option{-L}@var{dir}@dots{}]
 
129
-    [@option{-o} @var{outfile}] @var{infile}@dots{}
 
130
-
 
131
-For any given input file, the file name suffix determines what kind of
 
132
-compilation is done:
 
133
-
 
134
-@table @gcctabopt
 
135
-@item @var{file}.d
 
136
-D source files.
 
137
-
 
138
-@item @var{file}.di
 
139
-D interface files.
 
140
-
 
141
-@item @var{file}.o
 
142
-Object files to link in.
 
143
-
 
144
-@item @var{file}.a
 
145
-Library files to link in
 
146
-@end table
 
147
-
 
148
-@c man end
 
149
-@c man begin SEEALSO
 
150
-gpl(7), gfdl(7), fsf-funding(7), gcc(1)
 
151
-and the Info entries for @file{gdc} and @file{gcc}.
 
152
-@c man end
 
153
-@end ignore
 
154
-
 
155
-@c man begin DESCRIPTION gdc
 
156
-
 
157
-The @command{gdc} command is a frontend to @command{gcc} and
 
158
-supports many of the same options.  @xref{Option Summary, , Option
 
159
-Summary, gcc, Using the GNU Compiler Collection (GCC)}.  This manual
 
160
-only documents the options specific to @command{gdc}.
 
161
-Most of these have both positive and negative forms; the negative
 
162
-form of -ffoo would be -fno-foo.
 
163
-This manual documents only one of these two forms, whichever one is
 
164
-not the default.
 
165
-
 
166
-The @command{gdc} command may be used to compile D source code into
 
167
-an object file, link a collection of object files together, or do both
 
168
-in sequence.
 
169
-
 
170
-Only the most useful options are listed here; see below for the
 
171
-remainder.
 
172
-
 
173
-@c man end
 
174
-
 
175
-@c man begin OPTIONS gdc
 
176
-
 
177
-@table @gcctabopt
 
178
-@item -frelease
 
179
-@cindex @option{-frelease}
 
180
-Compile release version.
 
181
-
 
182
-@item -funittest
 
183
-@cindex @option{-funittest}
 
184
-Compile in unittest code.
 
185
-
 
186
-@item -fno-assert
 
187
-@cindex @option{-fno-assert}
 
188
-Turn off code generation for runtime assert()'s.
 
189
-
 
190
-@item -fno-invariants
 
191
-@cindex @option{-fno-invariants}
 
192
-Turn off code generation for runtime invariant()'s.
 
193
-
 
194
-@item -fno-in
 
195
-@cindex @option{-fno-in}
 
196
-Turn off code generation for runtime in() contracts.
 
197
-
 
198
-@item -fno-out
 
199
-@cindex @option{-fno-out}
 
200
-Turn off code generation for runtime out() contracts.
 
201
-
 
202
-@item -fno-bounds-check
 
203
-@cindex @option{-fno-bounds-check}
 
204
-Turns off array bounds checking for all functions.
 
205
-
 
206
-@item -fno-builtin
 
207
-@cindex @option{-fno-builtin}
 
208
-Don't recognize built-in functions that do not begin with
 
209
-@samp{__builtin_} as prefix.
 
210
-
 
211
-@item -fno-emit-moduleinfo
 
212
-@cindex @option{-fno-emit-moduleinfo}
 
213
-Turns off generation of module information and related functions.
 
214
-
 
215
-@item -fd-verbose
 
216
-@cindex @option{-fd-verbose}
 
217
-Print information about D language processing to stdout.
 
218
-
 
219
-@item -fproperty
 
220
-@cindex @option{-fproperty}
 
221
-For D2, enforce @@property syntax.
 
222
-
 
223
-@item -fd-vtls
 
224
-@cindex @option{-fd-vtls}
 
225
-List all variables going into thread local storage.
 
226
-
 
227
-@item -fignore-unknown-pragmas
 
228
-@cindex @option{-fignore-unknown-pragmas}
 
229
-Ignore unsupported pragmas.
 
230
-
 
231
-@item -fsplit-dynamic-arrays
 
232
-@cindex @option{-fsplit-dynamic-arrays}
 
233
-Split dynamic arrays into length and pointer when passing to functions.
 
234
-
 
235
-@item -femit-templates
 
236
-@cindex @option{-femit-templates}
 
237
-Control template emission behaviour.
 
238
-
 
239
-Turning on this option will emit all templates, but make them private
 
240
-to the translation unit. The executable will have multiple copies
 
241
-of code and data.
 
242
-
 
243
-Turning off this option will tell the compiler to not emit templates
 
244
-at all.
 
245
-
 
246
-The default behaviour is to emit templates, but only if the compiler
 
247
-determines that it needs to.
 
248
-
 
249
-@item -fdebug=@var{opt}
 
250
-@cindex @option{-fdebug}
 
251
-Compile in debug code into the program.
 
252
-
 
253
-These are supported options:
 
254
-
 
255
-@table @samp
 
256
-@item level
 
257
-Compile in debug code <= level.
 
258
-
 
259
-@item ident
 
260
-Compile in debug code identified by ident.
 
261
-@end table
 
262
-
 
263
-@item -fdeps=@var{filename}
 
264
-@cindex @option{-fdeps}
 
265
-Write module dependencies to filename.
 
266
-
 
267
-@item -fmake-deps=@var{filename}
 
268
-@cindex @option{-fmake-deps}
 
269
-Write makefile dependency output to the given file.
 
270
-
 
271
-@item -fmake-mdeps=@var{filename}
 
272
-@cindex @option{-fmake-mdeps}
 
273
-Like -fmake-deps=@var{filename} but ignore system header files.
 
274
-
 
275
-@item -fonly=@var{filename}
 
276
-@cindex @option{-fonly}
 
277
-Process all modules specified on the command line,
 
278
-but only generate code for the module specified by the argument.
 
279
-
 
280
-@item -fversion=@var{opt}
 
281
-@cindex @option{-fversion}
 
282
-Compile in version code into the program.
 
283
-
 
284
-These are the supported options:
 
285
-
 
286
-@table @samp
 
287
-@item level
 
288
-Compile in version code >= level.
 
289
-
 
290
-@item ident
 
291
-Compile in debug code identified by ident.
 
292
-@end table
 
293
-
 
294
-@item -fintfc
 
295
-@cindex @option{-fintfc}
 
296
-Generate D interface files.
 
297
-
 
298
-@item -fintfc-dir=@var{directory}
 
299
-@cindex @option{-fintfc-dir}
 
300
-Write D interface files to @var{directory}.
 
301
-
 
302
-@item -fintfc-file=@var{filename}
 
303
-@cindex @option{-fintfc-file}
 
304
-Write D interface file to @var{filename}.
 
305
-
 
306
-@item -fdoc
 
307
-@cindex @option{-fdoc}
 
308
-Generate documentation.
 
309
-
 
310
-@item -fdoc-dir=@var{directory}
 
311
-@cindex @option{-fdoc-dir}
 
312
-Write documentation file in @var{directory}.
 
313
-
 
314
-@item -fdoc-file=@var{filename}
 
315
-@cindex @option{-fdoc-file}
 
316
-Write documentation file to @var{filename}.
 
317
-
 
318
-@item -fdoc-inc=@var{filename}
 
319
-@cindex @option{-fdoc-inc}
 
320
-Include a Ddoc macro file.
 
321
-
 
322
-@item -fXf=@var{filename}
 
323
-@cindex @option{-fXf}
 
324
-Write JSON file to filename.
 
325
-
 
326
-@item -fdump-source
 
327
-@cindex @option{fdump-source}
 
328
-Dump decoded UTF-8 text from source.
 
329
-
 
330
-@item -Wcast-result
 
331
-@cindex @option{Wcast-result}
 
332
-Warn about casts that will produce a null or nil result.
 
333
-
 
334
-@item -Werror
 
335
-@cindex @option{Werror}
 
336
-Make all warnings into errors.
 
337
-
 
338
-@item -Wno-deprecated
 
339
-@cindex @option{Wno-deprecated}
 
340
-Do not warn about usage of deprecated features.
 
341
-
 
342
-@item -Wunknown-pragmas
 
343
-@cindex @option{Wunknown-pragmas}
 
344
-Warn when a pragma is encountered that is not understood by GDC.
 
345
-@end table
 
346
-
 
347
-@c man end
 
348
-
 
349
-@node Index
 
350
-@unnumbered Index
 
351
-
 
352
-@printindex cp
 
353
-
 
354
+@cindex introduction
 
355
+The official GNU compilers' documentation is released under the terms
 
356
+of the GNU Free Documentation License with cover texts. This has been
 
357
+considered non free by the Debian Project. Thus you will find it in the
 
358
+non-free section of the Debian archive.
 
359
 @bye
 
360
-