Skip to content

Commit 1706a37

Browse files
committed
Merge pull request scala#5005 from janekdb/2.11.x-man-page-scalac
Document -Xxml:coalescing in scalac man page
2 parents 5ccda53 + 5bcc722 commit 1706a37

File tree

1 file changed

+26
-25
lines changed

1 file changed

+26
-25
lines changed

src/manual/scala/man1/scalac.scala

Lines changed: 26 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -5,10 +5,6 @@
55

66
package scala.man1
77

8-
/**
9-
* @author Stephane Micheloud
10-
* @version 1.0
11-
*/
128
object scalac extends Command {
139
import _root_.scala.tools.docutil.ManPage._
1410

@@ -77,7 +73,7 @@ object scalac extends Command {
7773
SeqPara(
7874
"Specify where to find user class files (on Unix-based systems " &
7975
"a colon-separated list of paths, on Windows-based systems, a " &
80-
"semicolon-separate list of paths). This does not override the " &
76+
"semicolon-separated list of paths). This does not override the " &
8177
"built-in (" & Mono("\"boot\"") & ") search path.",
8278
"The default class path is the current directory. Setting the " &
8379
Mono("CLASSPATH") & " variable or using the " & Mono("-classpath") & " " &
@@ -153,7 +149,7 @@ object scalac extends Command {
153149
"Specify location(s) of source files."),
154150
Definition(
155151
CmdOptionBound("target:", "{jvm-1.5,jvm-1.6,jvm-1.7,jvm-1.8}"),
156-
SeqPara(
152+
SeqPara(
157153
Mono("\"jvm-1.5\"") & " target JVM 1.5 (deprecated),",
158154
Mono("\"jvm-1.6\"") & " target JVM 1.6 (default),",
159155
Mono("\"jvm-1.7\"") & " target JVM 1.7,",
@@ -196,7 +192,7 @@ object scalac extends Command {
196192
Definition(
197193
CmdOption("Xcheckinit"),
198194
"Wrap field accessors to throw an exception on uninitialized access."),
199-
Definition(
195+
Definition(
200196
CmdOption("Xdev"),
201197
"Enable warnings for developers working on the Scala compiler"),
202198
Definition(
@@ -212,7 +208,7 @@ object scalac extends Command {
212208
Definition(
213209
CmdOption("Xfatal-warnings"),
214210
"Fail the compilation if there are any warnings."),
215-
Definition(
211+
Definition(
216212
CmdOption("Xfull-lubs"),
217213
"Retain pre 2.10 behavior of less aggressive truncation of least upper bounds."),
218214
Definition(
@@ -224,25 +220,25 @@ object scalac extends Command {
224220
Definition(
225221
CmdOption("Xlint"),
226222
"Enable recommended additional warnings."),
227-
Definition(
223+
Definition(
228224
CmdOption("Xlog-free-terms"),
229225
"Print a message when reification creates a free term."),
230-
Definition(
226+
Definition(
231227
CmdOption("Xlog-free-types"),
232228
"Print a message when reification resorts to generating a free type."),
233-
Definition(
229+
Definition(
234230
CmdOption("Xlog-implicit-conversions"),
235231
"Print a message whenever an implicit conversion is inserted."),
236232
Definition(
237233
CmdOption("Xlog-implicits"),
238234
"Show more detail on why some implicits are not applicable."),
239-
Definition(
235+
Definition(
240236
CmdOption("Xlog-reflective-calls"),
241237
"Print a message when a reflective method call is generated."),
242-
Definition(
238+
Definition(
243239
CmdOptionBound("Xmacro-settings:", Argument("option")),
244240
"Custom settings for macros."),
245-
Definition(
241+
Definition(
246242
CmdOption("Xmain-class", Argument("path")),
247243
"Class for manifest's Main-Class entry (only useful with -d <jar>)."),
248244
Definition(
@@ -254,7 +250,7 @@ object scalac extends Command {
254250
Definition(
255251
CmdOption("Xno-forwarders"),
256252
"Do not generate static forwarders in mirror classes."),
257-
Definition(
253+
Definition(
258254
CmdOption("Xno-patmat-analysis"),
259255
"Don't perform exhaustivity/unreachability analysis. Also, ignore " & MItalic("@switch") & " annotation."),
260256
Definition(
@@ -312,15 +308,20 @@ object scalac extends Command {
312308
Definition(
313309
CmdOptionBound("Xsource:", Argument("version")),
314310
"Treat compiler input as Scala source for the specified version, see SI-8126."),
315-
Definition(
311+
Definition(
316312
CmdOption("Xsource-reader", Argument("classname")),
317313
"Specify a custom method for reading source files."),
318-
Definition(
314+
Definition(
319315
CmdOption("Xstrict-inference"),
320316
"Don't infer known-unsound types."),
321317
Definition(
322318
CmdOption("Xverify"),
323319
"Verify generic signatures in generated bytecode (asm backend only)."),
320+
Definition(
321+
CmdOptionBound("Xxml:", "{coalescing}"),
322+
SeqPara(
323+
"Configure XML parsing.",
324+
Mono("\"coalescing\"") & " convert PCData to Text and coalesce sibling nodes (default in 2.11).")),
324325
Definition(
325326
CmdOption("Y"),
326327
"Print a synopsis of private options.")
@@ -335,34 +336,34 @@ object scalac extends Command {
335336
Definition(
336337
MItalic("namer"),
337338
"resolve names, attach symbols to named trees"),
338-
Definition(
339+
Definition(
339340
MItalic("packageobjects"),
340341
"load package objects"),
341-
Definition(
342+
Definition(
342343
MItalic("typer"),
343344
"the meat and potatoes: type the trees"),
344345
Definition(
345346
MItalic("patmat"),
346347
"translate match expressions"),
347-
Definition(
348+
Definition(
348349
MItalic("superaccessors"),
349350
"add super accessors in traits and nested classes"),
350-
Definition(
351+
Definition(
351352
MItalic("extmethods"),
352353
"add extension methods for inline classes"),
353-
Definition(
354+
Definition(
354355
MItalic("pickler"),
355356
"serialize symbol tables"),
356357
Definition(
357358
MItalic("refchecks"),
358359
"reference/override checking, translate nested objects"),
359-
Definition(
360+
Definition(
360361
MItalic("selectiveanf"),
361362
"ANF pre-transform for " & MItalic("@cps") & " (CPS plugin)"),
362-
Definition(
363+
Definition(
363364
MItalic("selectivecps"),
364365
MItalic("@cps") & "-driven transform of selectiveanf assignments (CPS plugin)"),
365-
Definition(
366+
Definition(
366367
MItalic("uncurry"),
367368
"uncurry, translate function values to anonymous classes"),
368369
Definition(

0 commit comments

Comments
 (0)