Skip to content

Commit ed33a41

Browse files
adriaanmadriaanm
committed
Create gh-pages branch via GitHub
0 parents  commit ed33a41

File tree

5 files changed

+505
-0
lines changed

5 files changed

+505
-0
lines changed

‎index.html

Lines changed: 163 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,163 @@
1+
<!doctype html>
2+
<html>
3+
<head>
4+
<meta charset="utf-8">
5+
<meta http-equiv="X-UA-Compatible" content="chrome=1">
6+
<title>Scala by scala</title>
7+
8+
<link rel="stylesheet" href="stylesheets/styles.css">
9+
<link rel="stylesheet" href="stylesheets/pygment_trac.css">
10+
<meta name="viewport" content="width=device-width, initial-scale=1, user-scalable=no">
11+
<!--[if lt IE 9]>
12+
<script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
13+
<![endif]-->
14+
</head>
15+
<body>
16+
<div class="wrapper">
17+
<header>
18+
<h1>Scala</h1>
19+
<p>Documentation on the development of the Scala compiler and standard library.</p>
20+
21+
<p class="view"><a href="https://github.com/scala/scala">View the Project on GitHub <small>scala/scala</small></a></p>
22+
23+
24+
<ul>
25+
<li><a href="https://github.com/scala/scala/zipball/master">Download <strong>ZIP File</strong></a></li>
26+
<li><a href="https://github.com/scala/scala/tarball/master">Download <strong>TAR Ball</strong></a></li>
27+
<li><a href="https://github.com/scala/scala">View On <strong>GitHub</strong></a></li>
28+
</ul>
29+
</header>
30+
<section>
31+
<h1>
32+
<a name="more-information" class="anchor" href="#more-information"><span class="octicon octicon-link"></span></a>More information</h1>
33+
34+
<ul>
35+
<li><a href="http://www.scala-lang.org">The official Scala website</a></li>
36+
<li><a href="http://docs.scala-lang.org">Scala documentation</a></li>
37+
<li><a href="https://issues.scala-lang.org">Report a bug or request a feature</a></li>
38+
<li><a href="https://scala-webapps.epfl.ch/jenkins/">Scala Jenkins dashboard</a></li>
39+
<li>Scala mailing lists:
40+
41+
<ul>
42+
<li><a href="https://groups.google.com/group/scala-user">Users of Scala</a></li>
43+
<li><a href="https://groups.google.com/group/scala-language">Scala language discussion</a></li>
44+
<li><a href="https://groups.google.com/group/scala-internals">Compiler and standard library development</a></li>
45+
<li><a href="https://groups.google.com/group/scala-sips">Scala Improvement Process</a></li>
46+
<li><a href="https://groups.google.com/group/scala-debate">Debate</a></li>
47+
<li><a href="https://groups.google.com/group/scala-announce">Announcements</a></li>
48+
</ul>
49+
</li>
50+
</ul><h1>
51+
<a name="building" class="anchor" href="#building"><span class="octicon octicon-link"></span></a>Building</h1>
52+
53+
<p>Run <code>ant build-opt</code> to build an optimized version of the compiler.
54+
Verify your build using <code>ant test-opt</code>.</p>
55+
56+
<p>The Scala build system is based on Apache Ant. Most required pre-compiled
57+
libraries are part of the repository (in 'lib/'). The following however is
58+
assumed to be installed on the build machine:</p>
59+
60+
<h2>
61+
<a name="requirements" class="anchor" href="#requirements"><span class="octicon octicon-link"></span></a>Requirements</h2>
62+
63+
<ul>
64+
<li>A Java runtime environment (JRE) or SDK 1.6 or above.</li>
65+
<li>Apache Ant version 1.8.0 or above.</li>
66+
<li>bash (via cygwin for windows)</li>
67+
<li>curl</li>
68+
</ul><h1>
69+
<a name="contributing" class="anchor" href="#contributing"><span class="octicon octicon-link"></span></a>Contributing</h1>
70+
71+
<p>We ask all contributors <a href="http://typesafe.com/contribute/cla/scala">sign the Scala Contributor License Agreement</a>,
72+
which allows us to ensure that all code submitted to the project is unencumbered by copyrights or patents.</p>
73+
74+
<p>Please follow the guidelines outlined in our (Pull Request Policy)[<a href="https://github.com/scala/scala/wiki/Pull-Request-Policy">https://github.com/scala/scala/wiki/Pull-Request-Policy</a>].</p>
75+
76+
<h2>
77+
<a name="repository-structure" class="anchor" href="#repository-structure"><span class="octicon octicon-link"></span></a>Repository structure</h2>
78+
79+
<pre><code>scala/
80+
+--build.xml The main Ant build script, see also under src/build.
81+
+--lib/ Pre-compiled libraries for the build.
82+
+--pull-binary-libs.sh Pulls binary artifacts from remote repository.
83+
+--src/ All the source files of Scala.
84+
+--test/ The Scala test suite.
85+
+--build/ [Generated] Build products output directory for ant.
86+
+--dist/ [Generated] The destination folder for Scala distributions.
87+
</code></pre>
88+
89+
<h2>
90+
<a name="tips-and-tricks" class="anchor" href="#tips-and-tricks"><span class="octicon octicon-link"></span></a>Tips and tricks</h2>
91+
92+
<p>Here are some common commands. Most ant targets offer a <code>-opt</code> variant that runs under <code>-optimise</code>.</p>
93+
94+
<ul>
95+
<li><p><code>./pull-binary-libs.sh</code> downloads all binary artifacts associated with this commit.
96+
This requires internet access to <a href="http://typesafe.artifactoryonline.com/typesafe">http://typesafe.artifactoryonline.com/typesafe</a>.</p></li>
97+
<li><p><code>ant -p</code> prints out information about the commonly used ant targets. The interested
98+
developer can find the rest in the XML files.</p></li>
99+
<li>
100+
<p><code>ant</code> or <code>ant build</code>: A quick compilation (to quick) of your changes using the locker compiler.</p>
101+
102+
<ul>
103+
<li>This will rebuild all quick if locker changed.</li>
104+
<li>This will also rebuild locker if starr changed.</li>
105+
</ul>
106+
</li>
107+
<li><p><code>ln -s build/quick/bin qbin</code> (once):</p></li>
108+
<li><p><code>ant &amp;&amp; qbin/scalac -d sandbox sandbox/test.scala &amp;&amp; qbin/scala -cp sandbox Test</code>
109+
Incrementally builds quick, and then uses it to compile and run the file
110+
<code>sandbox/test.scala</code>. This is a typical debug cycle.</p></li>
111+
<li>
112+
<p><code>ant test</code> tests that your code is working and fit to be committed.</p>
113+
114+
<ul>
115+
<li>Runs the test suite and bootstrapping test on quick.</li>
116+
<li>You can run the suite only (skipping strap) with 'ant test.suite'.</li>
117+
</ul>
118+
</li>
119+
<li><p><code>ant docs</code> generates the HTML documentation for the library from the sources using the
120+
scaladoc tool in quick. Note: on most machines this requires more heap than
121+
is allocate by default. You can adjust the parameters with ANT_OPTS.
122+
Example command line::
123+
<code>ANT_OPTS = "-Xms512M -Xmx2048M -Xss1M -XX:MaxPermSize=128M" ant docs</code></p></li>
124+
<li><p><code>ant dist</code> builds a distribution in 'dists/latest'.</p></li>
125+
<li><p><code>ant all.clean</code> Removes all build files and all distributions.</p></li>
126+
</ul><h1>
127+
<a name="bootstrapping-soon-to-be-legacy" class="anchor" href="#bootstrapping-soon-to-be-legacy"><span class="octicon octicon-link"></span></a>Bootstrapping (soon to be legacy)</h1>
128+
129+
<p>In order to guarantee the bootstrapping of the Scala compiler, SABBUS builds
130+
Scala in layers. Each layer is a complete compiled Scala compiler and library.
131+
A superior layer is always compiled by the layer just below it. Here is a short
132+
description of the four layers that SABBUS uses, from bottom to top:</p>
133+
134+
<ul>
135+
<li><p><code>starr</code>: the stable reference Scala release which is shared by all the
136+
developers. It is found in the repository as 'lib/scala-compiler.jar' and
137+
'lib/scala-library.jar'. Any committable source code must be compiled directly
138+
by starr to guarantee the bootstrapping of the compiler.</p></li>
139+
<li><p><code>locker</code>: the local reference which is compiled by starr and is the work
140+
compiler in a typical development cycle. When it has been built once, it is
141+
“frozen” in this state. Updating it to fit the current source code must be
142+
explicitly requested (see below).</p></li>
143+
<li><p><code>quick</code>: the layer which is incrementally built when testing changes in the
144+
compiler or library. This is considered an actual new version when locker is
145+
up-to-date in relation to the source code.</p></li>
146+
<li><p><code>strap</code>: a test layer used to check stability of the build.</p></li>
147+
</ul><p>SABBUS compiles, for each layer, the Scala library first and the compiler next.
148+
That means that any changes in the library can immediately be used in the
149+
compiler without an intermediate build. On the other hand, if building the
150+
library requires changes in the compiler, a new locker must be built if
151+
bootstrapping is still possible, or a new starr if it is not.</p>
152+
153+
<p>Use <code>ant replacelocker</code> to "unfreeze" locker by updating it to match the current source code.</p>
154+
</section>
155+
<footer>
156+
<p>This project is maintained by <a href="https://github.com/scala">scala</a></p>
157+
<p><small>Hosted on GitHub Pages &mdash; Theme by <a href="https://github.com/orderedlist">orderedlist</a></small></p>
158+
</footer>
159+
</div>
160+
<script src="javascripts/scale.fix.js"></script>
161+
162+
</body>
163+
</html>

‎javascripts/scale.fix.js

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
var metas = document.getElementsByTagName('meta');
2+
var i;
3+
if (navigator.userAgent.match(/iPhone/i)) {
4+
for (i=0; i<metas.length; i++) {
5+
if (metas[i].name == "viewport") {
6+
metas[i].content = "width=device-width, minimum-scale=1.0, maximum-scale=1.0";
7+
}
8+
}
9+
document.addEventListener("gesturestart", gestureStart, false);
10+
}
11+
function gestureStart() {
12+
for (i=0; i<metas.length; i++) {
13+
if (metas[i].name == "viewport") {
14+
metas[i].content = "width=device-width, minimum-scale=0.25, maximum-scale=1.6";
15+
}
16+
}
17+
}

‎params.json

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
{"name":"Scala","tagline":"Documentation on the development of the Scala compiler and standard library.","body":"# More information\r\n - [The official Scala website](http://www.scala-lang.org)\r\n - [Scala documentation](http://docs.scala-lang.org)\r\n - [Report a bug or request a feature](https://issues.scala-lang.org)\r\n - [Scala Jenkins dashboard](https://scala-webapps.epfl.ch/jenkins/)\r\n - Scala mailing lists:\r\n - [Users of Scala](https://groups.google.com/group/scala-user)\r\n - [Scala language discussion](https://groups.google.com/group/scala-language)\r\n - [Compiler and standard library development](https://groups.google.com/group/scala-internals)\r\n - [Scala Improvement Process](https://groups.google.com/group/scala-sips)\r\n - [Debate](https://groups.google.com/group/scala-debate)\r\n - [Announcements](https://groups.google.com/group/scala-announce)\r\n\r\n\r\n# Building\r\nRun `ant build-opt` to build an optimized version of the compiler.\r\nVerify your build using `ant test-opt`.\r\n\r\nThe Scala build system is based on Apache Ant. Most required pre-compiled\r\nlibraries are part of the repository (in 'lib/'). The following however is\r\nassumed to be installed on the build machine:\r\n\r\n## Requirements\r\n - A Java runtime environment (JRE) or SDK 1.6 or above.\r\n - Apache Ant version 1.8.0 or above.\r\n - bash (via cygwin for windows)\r\n - curl\r\n\r\n# Contributing\r\nWe ask all contributors [sign the Scala Contributor License Agreement](http://typesafe.com/contribute/cla/scala),\r\nwhich allows us to ensure that all code submitted to the project is unencumbered by copyrights or patents.\r\n\r\nPlease follow the guidelines outlined in our (Pull Request Policy)[https://github.com/scala/scala/wiki/Pull-Request-Policy].\r\n\r\n## Repository structure\r\n\r\n```\r\nscala/\r\n+--build.xml The main Ant build script, see also under src/build.\r\n+--lib/ Pre-compiled libraries for the build.\r\n+--pull-binary-libs.sh Pulls binary artifacts from remote repository.\r\n+--src/ All the source files of Scala.\r\n+--test/ The Scala test suite.\r\n+--build/ [Generated] Build products output directory for ant.\r\n+--dist/ [Generated] The destination folder for Scala distributions.\r\n```\r\n\r\n## Tips and tricks\r\nHere are some common commands. Most ant targets offer a `-opt` variant that runs under `-optimise`.\r\n\r\n - `./pull-binary-libs.sh` downloads all binary artifacts associated with this commit.\r\n This requires internet access to http://typesafe.artifactoryonline.com/typesafe.\r\n\r\n - `ant -p` prints out information about the commonly used ant targets. The interested\r\n developer can find the rest in the XML files.\r\n\r\n - `ant` or `ant build`: A quick compilation (to quick) of your changes using the locker compiler.\r\n - This will rebuild all quick if locker changed.\r\n - This will also rebuild locker if starr changed.\r\n\r\n - `ln -s build/quick/bin qbin` (once):\r\n - `ant && qbin/scalac -d sandbox sandbox/test.scala && qbin/scala -cp sandbox Test`\r\n Incrementally builds quick, and then uses it to compile and run the file\r\n `sandbox/test.scala`. This is a typical debug cycle.\r\n\r\n - `ant test` tests that your code is working and fit to be committed.\r\n - Runs the test suite and bootstrapping test on quick.\r\n - You can run the suite only (skipping strap) with 'ant test.suite'.\r\n\r\n - `ant docs` generates the HTML documentation for the library from the sources using the\r\n scaladoc tool in quick. Note: on most machines this requires more heap than\r\n is allocate by default. You can adjust the parameters with ANT_OPTS.\r\n Example command line::\r\n `ANT_OPTS = \"-Xms512M -Xmx2048M -Xss1M -XX:MaxPermSize=128M\" ant docs`\r\n\r\n - `ant dist` builds a distribution in 'dists/latest'.\r\n\r\n - `ant all.clean` Removes all build files and all distributions.\r\n\r\n\r\n# Bootstrapping (soon to be legacy)\r\n\r\nIn order to guarantee the bootstrapping of the Scala compiler, SABBUS builds\r\nScala in layers. Each layer is a complete compiled Scala compiler and library.\r\nA superior layer is always compiled by the layer just below it. Here is a short\r\ndescription of the four layers that SABBUS uses, from bottom to top:\r\n\r\n - `starr`: the stable reference Scala release which is shared by all the\r\n developers. It is found in the repository as 'lib/scala-compiler.jar' and\r\n 'lib/scala-library.jar'. Any committable source code must be compiled directly\r\n by starr to guarantee the bootstrapping of the compiler.\r\n\r\n - `locker`: the local reference which is compiled by starr and is the work\r\n compiler in a typical development cycle. When it has been built once, it is\r\n “frozen” in this state. Updating it to fit the current source code must be\r\n explicitly requested (see below).\r\n\r\n - `quick`: the layer which is incrementally built when testing changes in the\r\n compiler or library. This is considered an actual new version when locker is\r\n up-to-date in relation to the source code.\r\n\r\n - `strap`: a test layer used to check stability of the build.\r\n\r\nSABBUS compiles, for each layer, the Scala library first and the compiler next.\r\nThat means that any changes in the library can immediately be used in the\r\ncompiler without an intermediate build. On the other hand, if building the\r\nlibrary requires changes in the compiler, a new locker must be built if\r\nbootstrapping is still possible, or a new starr if it is not.\r\n\r\nUse `ant replacelocker` to \"unfreeze\" locker by updating it to match the current source code.\r\n","google":"","note":"Don't delete this file! It's used internally to help with page regeneration."}

‎stylesheets/pygment_trac.css

Lines changed: 69 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,69 @@
1+
.highlight { background: #ffffff; }
2+
.highlight .c { color: #999988; font-style: italic } /* Comment */
3+
.highlight .err { color: #a61717; background-color: #e3d2d2 } /* Error */
4+
.highlight .k { font-weight: bold } /* Keyword */
5+
.highlight .o { font-weight: bold } /* Operator */
6+
.highlight .cm { color: #999988; font-style: italic } /* Comment.Multiline */
7+
.highlight .cp { color: #999999; font-weight: bold } /* Comment.Preproc */
8+
.highlight .c1 { color: #999988; font-style: italic } /* Comment.Single */
9+
.highlight .cs { color: #999999; font-weight: bold; font-style: italic } /* Comment.Special */
10+
.highlight .gd { color: #000000; background-color: #ffdddd } /* Generic.Deleted */
11+
.highlight .gd .x { color: #000000; background-color: #ffaaaa } /* Generic.Deleted.Specific */
12+
.highlight .ge { font-style: italic } /* Generic.Emph */
13+
.highlight .gr { color: #aa0000 } /* Generic.Error */
14+
.highlight .gh { color: #999999 } /* Generic.Heading */
15+
.highlight .gi { color: #000000; background-color: #ddffdd } /* Generic.Inserted */
16+
.highlight .gi .x { color: #000000; background-color: #aaffaa } /* Generic.Inserted.Specific */
17+
.highlight .go { color: #888888 } /* Generic.Output */
18+
.highlight .gp { color: #555555 } /* Generic.Prompt */
19+
.highlight .gs { font-weight: bold } /* Generic.Strong */
20+
.highlight .gu { color: #800080; font-weight: bold; } /* Generic.Subheading */
21+
.highlight .gt { color: #aa0000 } /* Generic.Traceback */
22+
.highlight .kc { font-weight: bold } /* Keyword.Constant */
23+
.highlight .kd { font-weight: bold } /* Keyword.Declaration */
24+
.highlight .kn { font-weight: bold } /* Keyword.Namespace */
25+
.highlight .kp { font-weight: bold } /* Keyword.Pseudo */
26+
.highlight .kr { font-weight: bold } /* Keyword.Reserved */
27+
.highlight .kt { color: #445588; font-weight: bold } /* Keyword.Type */
28+
.highlight .m { color: #009999 } /* Literal.Number */
29+
.highlight .s { color: #d14 } /* Literal.String */
30+
.highlight .na { color: #008080 } /* Name.Attribute */
31+
.highlight .nb { color: #0086B3 } /* Name.Builtin */
32+
.highlight .nc { color: #445588; font-weight: bold } /* Name.Class */
33+
.highlight .no { color: #008080 } /* Name.Constant */
34+
.highlight .ni { color: #800080 } /* Name.Entity */
35+
.highlight .ne { color: #990000; font-weight: bold } /* Name.Exception */
36+
.highlight .nf { color: #990000; font-weight: bold } /* Name.Function */
37+
.highlight .nn { color: #555555 } /* Name.Namespace */
38+
.highlight .nt { color: #000080 } /* Name.Tag */
39+
.highlight .nv { color: #008080 } /* Name.Variable */
40+
.highlight .ow { font-weight: bold } /* Operator.Word */
41+
.highlight .w { color: #bbbbbb } /* Text.Whitespace */
42+
.highlight .mf { color: #009999 } /* Literal.Number.Float */
43+
.highlight .mh { color: #009999 } /* Literal.Number.Hex */
44+
.highlight .mi { color: #009999 } /* Literal.Number.Integer */
45+
.highlight .mo { color: #009999 } /* Literal.Number.Oct */
46+
.highlight .sb { color: #d14 } /* Literal.String.Backtick */
47+
.highlight .sc { color: #d14 } /* Literal.String.Char */
48+
.highlight .sd { color: #d14 } /* Literal.String.Doc */
49+
.highlight .s2 { color: #d14 } /* Literal.String.Double */
50+
.highlight .se { color: #d14 } /* Literal.String.Escape */
51+
.highlight .sh { color: #d14 } /* Literal.String.Heredoc */
52+
.highlight .si { color: #d14 } /* Literal.String.Interpol */
53+
.highlight .sx { color: #d14 } /* Literal.String.Other */
54+
.highlight .sr { color: #009926 } /* Literal.String.Regex */
55+
.highlight .s1 { color: #d14 } /* Literal.String.Single */
56+
.highlight .ss { color: #990073 } /* Literal.String.Symbol */
57+
.highlight .bp { color: #999999 } /* Name.Builtin.Pseudo */
58+
.highlight .vc { color: #008080 } /* Name.Variable.Class */
59+
.highlight .vg { color: #008080 } /* Name.Variable.Global */
60+
.highlight .vi { color: #008080 } /* Name.Variable.Instance */
61+
.highlight .il { color: #009999 } /* Literal.Number.Integer.Long */
62+
63+
.type-csharp .highlight .k { color: #0000FF }
64+
.type-csharp .highlight .kt { color: #0000FF }
65+
.type-csharp .highlight .nf { color: #000000; font-weight: normal }
66+
.type-csharp .highlight .nc { color: #2B91AF }
67+
.type-csharp .highlight .nn { color: #000000 }
68+
.type-csharp .highlight .s { color: #A31515 }
69+
.type-csharp .highlight .sc { color: #A31515 }

0 commit comments

Comments
 (0)