Skip to content

Update all Oracle JavaSE reference links in documentation #791

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jan 9, 2020
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion content/api_en/arrayCopy.xml
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Copies an array (or part of an array) to another array. The <b>src</b> array is
<br />
The simplified version with only two arguments &mdash; <b>arrayCopy(src, dst)</b> &mdash; copies an entire array to another of the same size. It is equivalent to <b>arrayCopy(src, 0, dst, 0, src.length)</b>.<br />
<br />
Using this function is far more efficient for copying array data than iterating through a <b>for()</b> loop and copying each element individually. This function only copies references, which means that for most purposes it only copies one-dimensional arrays (a single set of brackets). If used with a two (or three or more) dimensional array, it will only copy the references at the first level, because a two dimensional array is simply an "array of arrays". This does not produce an error, however, because this is often the desired behavior. Internally, this function calls Java's <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/System.html#arraycopy(java.lang.Object, int, java.lang.Object, int, int)">System.arraycopy()</a> method, so most things that apply there are inherited.
Using this function is far more efficient for copying array data than iterating through a <b>for()</b> loop and copying each element individually. This function only copies references, which means that for most purposes it only copies one-dimensional arrays (a single set of brackets). If used with a two (or three or more) dimensional array, it will only copy the references at the first level, because a two dimensional array is simply an "array of arrays". This does not produce an error, however, because this is often the desired behavior. Internally, this function calls Java's <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/System.html#arraycopy-java.lang.Object-int-java.lang.Object-int-int-">System.arraycopy()</a> method, so most things that apply there are inherited.
]]></description>

</root>
2 changes: 1 addition & 1 deletion content/api_en/include/ArrayList.xml
Original file line number Diff line number Diff line change
Expand Up @@ -64,7 +64,7 @@ An <b>ArrayList</b> stores a variable number of objects. This is similar to maki
<br />
An ArrayList is a resizable-array implementation of the Java List interface. It has many methods used to control and search its contents. For example, the length of the <b>ArrayList</b> is returned by its <b>size()</b> method, which is an integer value for the total number of elements in the list. An element is added to an <b>ArrayList</b> with the <b>add()</b> method and is deleted with the <b>remove()</b> method. The <b>get()</b> method returns the element at the specified position in the list. (See the above example for context.)<br />
<br />
For a list of the numerous <b>ArrayList</b> features, please read the <a href="http://download.oracle.com/javase/1,5.0/docs/api/java/util/ArrayList.html">Java reference description</a>.
For a list of the numerous <b>ArrayList</b> features, please read the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/ArrayList.html">Java reference description</a>.
]]></description>

<syntax></syntax>
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/include/HashMap.xml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ println("Casey is " + val);
<description><![CDATA[
A <b>HashMap</b> stores a collection of objects, each referenced by a key. This is similar to an <b>Array</b>, only instead of accessing elements with a numeric index, a <b>String</b> is used. (If you are familiar with associative arrays from other languages, this is the same idea.) The above example covers basic use, but there's a more extensive example included with the Processing examples. In addition, for simple pairings of Strings and integers, Strings and floats, or Strings and Strings, you can now use the simpler IntDict, FloatDict, and StringDict classes.<br />
<br />
For a list of the numerous <b>HashMap</b> features, please read the <a href="http://download.oracle.com/javase/6/docs/api/java/util/HashMap.html">Java reference description</a>.
For a list of the numerous <b>HashMap</b> features, please read the <a href="https://docs.oracle.com/javase/8/docs/api/java/util/HashMap.html">Java reference description</a>.
]]></description>

<syntax></syntax>
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/include/String.xml
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ To compare the contents of two Strings, use the <b>equals()</b> method, as in <b
<br />
Because a String is defined between double quotation marks, to include such marks within the String itself you must use the <b>&#92;</b> (backslash) character. (See the third example above.) This is known as an <em>escape sequence</em>. Other escape sequences include <b>&#92;t</b> for the tab character and <b>&#92;n</b> for new line. Because backslash is the escape character, to include a single backslash within a String, you must use two consecutive backslashes, as in: <b>&#92;&#92;</b><br />
<br />
There are more string methods than those linked from this page. Additional documentation is located online in the <a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html">official Java documentation</a>.
There are more string methods than those linked from this page. Additional documentation is located online in the <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html">official Java documentation</a>.
]]></description>

<syntax></syntax>
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/include/class.xml
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ class HLine {
</example>

<description><![CDATA[
Keyword used to indicate the declaration of a class. A class is a composite of fields (data) and methods (functions that are a part of the class) which may be instantiated as objects. The first letter of a class name is usually uppercase to separate it from other kinds of variables. A related tutorial on <a href="http://download.oracle.com/javase/tutorial/java/concepts/index.html" target="_blank">Object-Oriented Programming</a> is hosted on the Oracle website.
Keyword used to indicate the declaration of a class. A class is a composite of fields (data) and methods (functions that are a part of the class) which may be instantiated as objects. The first letter of a class name is usually uppercase to separate it from other kinds of variables. A related tutorial on <a href="https://docs.oracle.com/javase/tutorial/java/concepts/index.html" target="_blank">Object-Oriented Programming</a> is hosted on the Oracle website.
]]></description>

<syntax>
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/include/float.xml
Original file line number Diff line number Diff line change
Expand Up @@ -41,7 +41,7 @@ Data type for floating-point numbers, e.g. numbers that have a decimal point.<br
<br />
Floats are not precise, so adding small values (such as 0.0001) may not always increment precisely due to rounding errors. If you want to increment a value in small intervals, use an <b>int</b>, and divide by a <b>float</b> value before using it. (See the second example above.)<br />
<br />
Floating-point numbers can be as large as 3.40282347E+38 and as low as -3.40282347E+38. They are stored as 32 bits (4 bytes) of information. The <b>float</b> data type is inherited from Java; you can read more about the technical details <a href="http://download.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html">here</a> and <a href="http://docs.oracle.com/javase/specs/jls/se7/html/jls-4.html#jls-4.2.3">here</a>.<br />
Floating-point numbers can be as large as 3.40282347E+38 and as low as -3.40282347E+38. They are stored as 32 bits (4 bytes) of information. The <b>float</b> data type is inherited from Java; you can read more about the technical details <a href="https://docs.oracle.com/javase/tutorial/java/nutsandbolts/datatypes.html">here</a> and <a href="https://docs.oracle.com/javase/specs/jls/se8/html/jls-4.html#jls-4.2.3">here</a>.<br />
<br />
Processing supports the <b>double</b> datatype from Java as well. However, none of the Processing functions use <b>double</b> values, which use more memory and are typically overkill for most work created in Processing. We do not plan to add support for <b>double</b> values, as doing so would require increasing the number of API functions significantly.
]]></description>
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/keyCode.xml
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ When checking for these keys, it can be useful to first check if the key is code
<br /><br />
The keys included in the ASCII specification (BACKSPACE, TAB, ENTER, RETURN, ESC, and DELETE) do not require checking to see if the key is coded; for those keys, you should simply use the <b>key</b> variable directly (and not <b>keyCode</b>). If you're making cross-platform projects, note that the ENTER key is commonly used on PCs and Unix, while the RETURN key is used on Macs. Make sure your program will work on all platforms by checking for both ENTER and RETURN.
<br /><br />
For those familiar with Java, the values for UP and DOWN are simply shorter versions of Java's <b>KeyEvent.VK_UP</b> and <b>KeyEvent.VK_DOWN</b>. Other <b>keyCode</b> values can be found in the Java <a href="http://download.oracle.com/javase/6/docs/api/java/awt/event/KeyEvent.html">KeyEvent</a> reference.
For those familiar with Java, the values for UP and DOWN are simply shorter versions of Java's <b>KeyEvent.VK_UP</b> and <b>KeyEvent.VK_DOWN</b>. Other <b>keyCode</b> values can be found in the Java <a href="https://docs.oracle.com/javase/8/docs/api/java/awt/event/KeyEvent.html">KeyEvent</a> reference.
<br /><br />
There are issues with how <b>keyCode</b> behaves across different renderers and operating systems. Watch out for unexpected behavior as you switch renderers and operating systems and you are using keys are aren't mentioned in this reference entry.
<br /><br />
Expand Down
2 changes: 1 addition & 1 deletion content/api_en/match.xml
Original file line number Diff line number Diff line change
Expand Up @@ -51,7 +51,7 @@ To use the function, first check to see if the result is null. If the result is
<br />
If there are groups (specified by sets of parentheses) in the regular expression, then the contents of each will be returned in the array. Element [0] of a regular expression match returns the entire matching string, and the match groups start at element [1] (the first group is [1], the second [2], and so on).<br />
<br />
The syntax can be found in the reference for Java's <a href="http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html">Pattern</a> class. For regular expression syntax, read the <a href="http://download.oracle.com/javase/tutorial/essential/regex/">Java Tutorial</a> on the topic.
The syntax can be found in the reference for Java's <a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html">Pattern</a> class. For regular expression syntax, read the <a href="https://docs.oracle.com/javase/tutorial/essential/regex/">Java Tutorial</a> on the topic.
]]></description>

</root>
2 changes: 1 addition & 1 deletion content/api_en/matchAll.xml
Original file line number Diff line number Diff line change
Expand Up @@ -33,7 +33,7 @@ To use the function, first check to see if the result is null. If the result is
<br />
If there are groups (specified by sets of parentheses) in the regular expression, then the contents of each will be returned in the array. Assuming a loop with counter variable i, element [i][0] of a regular expression match returns the entire matching string, and the match groups start at element [i][1] (the first group is [i][1], the second [i][2], and so on).<br />
<br />
The syntax can be found in the reference for Java's <a href="http://docs.oracle.com/javase/6/docs/api/java/util/regex/Pattern.html">Pattern</a> class. For regular expression syntax, read the <a href="http://download.oracle.com/javase/tutorial/essential/regex/">Java Tutorial</a> on the topic.
The syntax can be found in the reference for Java's <a href="https://docs.oracle.com/javase/8/docs/api/java/util/regex/Pattern.html">Pattern</a> class. For regular expression syntax, read the <a href="https://docs.oracle.com/javase/tutorial/essential/regex/">Java Tutorial</a> on the topic.
]]></description>

</root>
Original file line number Diff line number Diff line change
Expand Up @@ -110,7 +110,7 @@ class BezierCurve {
if (index < 0) {
// if the index is negative, exact length is not in the table,
// but it tells us where it should be in the table
// see http://docs.oracle.com/javase/7/docs/api/java/util/Arrays.html#binarySearch(float[], float)
// see https://docs.oracle.com/javase/8/docs/api/java/util/Arrays.html#binarySearch-float:A-float-

// interpolate two surrounding indexes
int nextIndex = -(index + 1);
Expand Down
2 changes: 1 addition & 1 deletion content/static/tutorials/arraylist/index.html
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
In truth, we could use a simple array to manage our Particle objects. Some particle systems might have a fixed number of particles, and arrays are magnificently efficient in those instances. Processing also offers expand(), contract(), subset(), splice() and other methods for resizing arrays. However, for these examples, the Java class ArrayList (found in the java.util package: http://download.oracle.com/javase/6/docs/api/java/util/ArrayList.html) will prove to be the best solution.

Using an ArrayList is conceptually similar to a standard array, but the syntax is different. Here is some code (that assumes the existence of a generic Particle class) demonstrating identical results: first with an array, and second with an ArrayList.
In truth, we could use a simple array to manage our Particle objects. Some particle systems might have a fixed number of particles, and arrays are magnificently efficient in those instances. Processing also offers expand(), contract(), subset(), splice() and other methods for resizing arrays. However, for these examples, the Java class ArrayList (found in the java.util package: https://docs.oracle.com/javase/8/docs/api/java/util/ArrayList.html) will prove to be the best solution.

Using an ArrayList is conceptually similar to a standard array, but the syntax is different. Here is some code (that assumes the existence of a generic Particle class) demonstrating identical results: first with an array, and second with an ArrayList.

// THE STANDARD ARRAY WAY
int total = 10;
Expand Down
4 changes: 2 additions & 2 deletions content/static/tutorials/data/index-old.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ <h3 style="line-height: 0.7em;"><em>Daniel Shiffman</em></h3>
<h3>Manipulating Strings</h3>

<p>
In <a href="http://processing.org/learning/text/">Strings and Drawing Text</a>, we touched on a few of the basic functions available in the Java String class, such as charAt(), toUpperCase(), equals(), and length(). These functions are documented on the Processing reference page for Strings. Nevertheless, in order to perform some more advanced data parsing techniques, we'll need to explore some additional String manipulation functions <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html">documented in the Java API</a>.
In <a href="http://processing.org/learning/text/">Strings and Drawing Text</a>, we touched on a few of the basic functions available in the Java String class, such as charAt(), toUpperCase(), equals(), and length(). These functions are documented on the Processing reference page for Strings. Nevertheless, in order to perform some more advanced data parsing techniques, we'll need to explore some additional String manipulation functions <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html">documented in the Java API</a>.
</p>

<p>
Expand Down Expand Up @@ -518,7 +518,7 @@ <h3>Threads</h3>

<p>Two examples that follow this methodology can be found under Topics --> Advanced Data in the Processing examples.</p>

<p>While using the thread() function is a very simple way of getting an independent thread, it should be noted that it is somewhat limited. Being able to make a thread object is a great deal more powerful, and this can be done by extending the Java <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/Thread.html">Thread</a> class.</p>
<p>While using the thread() function is a very simple way of getting an independent thread, it should be noted that it is somewhat limited. Being able to make a thread object is a great deal more powerful, and this can be done by extending the Java <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/Thread.html">Thread</a> class.</p>


</td>
Expand Down
2 changes: 1 addition & 1 deletion content/static/tutorials/data/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ <h3 style="line-height: 0.7em;"><em>Daniel Shiffman</em></h3>
<h3>Manipulating Strings</h3>

<p>
In <a href="http://processing.org/learning/text/">Strings and Drawing Text</a>, we touched on a few of the basic functions available in the Java <tt>String</tt>, such as <tt>charAt()</tt>, <tt>toUpperCase()</tt>, <tt>equals()</tt>, and <tt>length()</tt>. These functions are documented on the Processing reference page for Strings. Nevertheless, in order to perform some more advanced data parsing techniques, we'll need to explore some additional String manipulation functions <a href="http://docs.oracle.com/javase/6/docs/api/java/lang/String.html">documented in the Java API</a>.
In <a href="http://processing.org/learning/text/">Strings and Drawing Text</a>, we touched on a few of the basic functions available in the Java <tt>String</tt>, such as <tt>charAt()</tt>, <tt>toUpperCase()</tt>, <tt>equals()</tt>, and <tt>length()</tt>. These functions are documented on the Processing reference page for Strings. Nevertheless, in order to perform some more advanced data parsing techniques, we'll need to explore some additional String manipulation functions <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html">documented in the Java API</a>.
<br /><br />
Let's take a closer look at the following two String functions: <tt>indexOf()</tt> and <tt>substring()</tt>.<br /><br />
<tt>indexOf()</tt> locates a sequence of characters within a string. It takes one argument — a search string — and returns a numeric value that corresponds to the first occurrence of the search string inside of the <tt>String</tt> object being searched.<br />
Expand Down
2 changes: 1 addition & 1 deletion content/static/tutorials/text/index.html
Original file line number Diff line number Diff line change
Expand Up @@ -32,7 +32,7 @@ <h3>Where do we find documentation for the String class?</h3>
</p>

<p class="txt">
This page only covers some of the available methods of the String class. The full documentation can be found on java's <a href="http://download.oracle.com/javase/6/docs/api/java/lang/String.html">String</a> page.
This page only covers some of the available methods of the String class. The full documentation can be found on java's <a href="https://docs.oracle.com/javase/8/docs/api/java/lang/String.html">String</a> page.
</p>


Expand Down