1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
/* NSC -- new Scala compiler
* Copyright 2005-2006 LAMP/EPFL
* @author Stephane Micheloud
*/
//$Id: $
package man.man1
object scala extends Command {
import ManPage._
protected val cn = new Error().getStackTrace()(0).getClassName()
val name = Section("NAME",
MBold(command) & " " & NDash & " Launcher for the " &
Link("Scala 2", "http://scala.epfl.ch/") & " language")
val synopsis = Section("SYNOPSIS",
CmdLine(" [ " & Argument("options") & " ] " &
Argument("class file") & " [ " & Argument("args") & " ]"))
val parameters = Section("PARAMETERS",
DefinitionList(
Definition(
Mono(Argument("options")),
"Command line options. See " & Link(Bold("OPTIONS"), "#options") &
" below."),
Definition(
Mono(Argument("class file")),
"Name of the class to be invoked."),
Definition(
Mono(Argument("args")),
"Program arguments passed to the main function.")))
val description = Section("DESCRIPTION",
"The " & MBold(command) & " utility launches a Scala application. " &
"It does this by starting a Java runtime environment, loading a " &
"specified class, and invoking that class's " & Bold("main") &
" method. The method must have the following signature:",
BlockQuote(Mono(Bold("def") & " main(args: Array[String]): Unit")),
"The method must return a " & Bold("Unit") & " value, and it must " &
"accept a " & Bold("String") & " array as a parameter. By default, " &
"the first non-option argument is the name of the class to be invoked. "&
"A fully-qualified class name should be used.",
"The Scala runtime searches for the startup class, and other classes " &
"used, in three sets of locations: the bootstrap class path, the " &
"installed extensions, and the user class path.")
val options = Section("OPTIONS",
"The launcher has a set of standard options that are supported on the " &
"current runtime environment and will be supported in future releases. " &
"An additional set of non-standard options are specific to the current " &
"virtual machine implementation and are subject to change in the future. " &
"Non-standard options begin with " & CmdOption("X") & ".",
Section("Standard Options",
DefinitionList(
Definition(
CmdOption("cp") & "| " & CmdOption("classpath", Argument("path")),
"Specify where to find user class files (on Unix-based systems " &
"a colon-separated list of paths, on Windows-based systems, a " &
"semicolon-separate list of paths)."),
Definition(
CmdOption("D", Argument("name") & "=" & Argument("value")),
"Set a system property."),
Definition(
CmdOption("verbose", "[:class|gc|jni]"),
"Enable verbose output."),
Definition(
CmdOption("showversion"),
"Print product version and continue."),
Definition(
CmdOption("version"),
"Print product version and exit."),
Definition(
CmdOption("help"),
"Print this help message."))),
Section("Non-Standard Options",
"Same options as the " & MBold("java") & " command."))
val environment = Section("ENVIRONMENT",
DefinitionList(
Definition(
MBold("JAVACMD"),
"Specify the " & MBold("java") & " command to be used " &
"for running the Scala commands")))
val examples = Section("EXAMPLES",
DefinitionList(
Definition(
"Execute a Scala program generated in the current directory",
CmdLine("hello.HelloWorld")),
Definition(
"Execute a Scala program generated in a user-defined " &
"directory " & Bold("classes"),
CmdLine(CmdOption("classpath", "classes") & "hello.HelloWorld")),
Definition(
"Execute a Scala program using a user-defined " & MBold("java") & " " &
"command",
MBold("env JAVACMD") & Mono("=/usr/local/bin/cacao ") &
CmdLine(CmdOption("classpath", "classes") & "hello.HelloWorld"))))
val exitStatus = Section("EXIT STATUS",
MBold(command) & " returns a zero exit status if it succeeds. " &
"Non zero is returned in case of failure.")
val seeAlso = Section("SEE ALSO",
Link(Bold("scalac") & "(1)", "scalac.html") & ", " &
Link(Bold("scaladoc") & "(1)", "scaladoc.html") & ", " &
Link(Bold("scalaint") & "(1)", "scalaint.html") & ", " &
Link(Bold("scalascript") & "(1)", "scalascript.html"))
def manpage = new Document {
title = command
date = "April 29, 2005"
author = "Stephane Micheloud"
version = "0.1"
sections = List(
name,
synopsis,
parameters,
description,
options,
environment,
examples,
exitStatus,
authors,
bugs,
copyright,
seeAlso)
}
}
|