Merge branch 'kevin0110w-newBranchKW'

nygrenh · nygrenh · commit 98d0c8f3f4c6 · 2020-01-29T10:17:02.000+02:00
diff --git a/data/part-2/1-problems-and-patterns.md b/data/part-2/1-problems-and-patterns.md
@@ -81,7 +81,7 @@ public class Program {
 
 <!-- Ohjelmissa tulee usein laskea asioita kuten lukujen keskiarvoa tai lukujen summaa. Ratkaisumalli tällaisissa ohjelmissa on seuraava. -->
 
-We quite often need to calculate something in a program, such as an average or a sum. The solution patter to solve such problems is as follows.
+We quite often need to calculate something in a program, such as an average or a sum. The solution pattern to solve such problems is as follows.
 
 <!-- 1. Määrittele laskemiseen tarvittavat syötteet ja luo niitä varten muuttujat. Ohjelman syötteitä ovat laskemisessa käytettävät arvot. Syötteiden tyypit tunnistaa tyypillisesti ongelma-alueen kuvauksesta.
 1. Selvitä tehtävä laskuoperaatio ja luo laskuoperaation tulokselle muuttuja. Tee ohjelman syötteiden perusteella lasku, jonka arvo asetetaan laskuoperaation tulokselle varattuun muuttujaan. Myös laskuoperaation tuloksen tyypin tunnistaa ongelma-alueen kuvauksesta.
@@ -93,7 +93,7 @@ We quite often need to calculate something in a program, such as an average or a
 
 <!-- Esimerkiksi ongelman _Tee ohjelma, jonka avulla voidaan laskea kahden kokonaisluvun summa_. ratkaisumalli on seuraava. -->
 
-For example, the solution patter for the problem _Create a program to calculate the sum of two integers_ is the following.
+For example, the solution pattern for the problem _Create a program to calculate the sum of two integers_ is the following.
 
 <!-- ```java
 // Määritellään syötteet ja luodaan niitä varten muuttujat
@@ -122,7 +122,7 @@ System.out.println("The sum of " + first + " and " + second + " is " + sum);
 
 <!-- Sekä lukemista että laskemista sisältävä ohjelma yhdistää edelliset ratkaisumallit. Kahden käyttäjältä pyydetyn luvun tulon laskeva ohjelma on seuraavanlainen. -->
 
-A program that both reads and calculates combines both of these patterns. One that calculates the product of two integers provided by the use looks like this:
+A program that both reads and calculates combines both of these patterns. One that calculates the product of two integers provided by the user looks like this:
 
 <!-- ```java
 // Tuodaan Scanner-apuväline ohjelman tietoon
@@ -316,7 +316,7 @@ Here are a few examples:
 
 <!-- Ongelmat sisältävät usein vaihtoehtoista toiminnallisuutta. Tällaisen toteuttamiseen käytetään ehtolauseita. Ehtolause alkaa `if`-komennosta, jota seuraa suluissa oleva lauseke. Lauseke evaluoituu joko todeksi tai epätodeksi. Mikäli lauseke evaluoituu todeksi, suoritetaan ehtolauseen lohko, joka on rajattuna aaltosuluilla. -->
 
-Problems often contain some alternative functionality, and in such case we use conditional statements. A Conditional statement starts with an `if` command followed by an expression in parentheses. The expression evaluates to either true or false. If it evaluates true, the following block delimited by curly brackets gets executed.
+Problems often contain some alternative functionality, and in such case we use conditional statements. A conditional statement starts with an `if` command followed by an expression in parentheses. The expression evaluates to either true or false. If it evaluates true, the following block delimited by curly brackets gets executed.
 
 <!-- ```java
 // jos luku on suurempi kuin viisi
diff --git a/data/part-2/2-repeating.md b/data/part-2/2-repeating.md
@@ -53,7 +53,7 @@ System.out.println("The sum of the numbers is " + sum);
 ```
 
 <!-- Hoitaa asian, mutta ei kovin tyylikkäästi. Entä jos ohjelman pitäisi lukea sata tai vaikkapa tuhat lukua ja tulostaa niiden summa? Entä jos ohjelman pitäisi lukea kolme lukua? -->
-It does the job, but not elegantly. What if the program had to read a hundred, or perhaps a thousand, numbers and print their sum? What if the program had to read three numbers only?
+It does the job, but not elegantly. What if the program had to read a hundred, or perhaps a thousand numbers and print their sum? What if the program had to read three numbers only?
 
 <!-- Tämän ongelman voi ratkaista toistolauseella, joka pitää kirjaa sekä summasta että lukemiskerroista. Viiden luvun summan tulostava toistolauseella toteutettava ohjelma näyttää seuraavalta. -->
 The problem can be solved with a loop, which keeps track of both the sum and the number of times input has been read. The program that prints the sum of five numbers now looks as follows
@@ -151,7 +151,7 @@ Breaking out of the loop occurs when a user enters a specified input or whenever
 Users can also be asked for input within a loop. The variables that are commonly used in loops (such as Scanner readers) are defined before the loop, whereas variables (such as the value read from the user) that are specific to the loop are defined within it.
 
 <!-- Alla olevassa esimerkissä ohjelma kysyy käyttäjältä pitäisikö toistolauseesta poistua. Mikäli käyttäjä syöttää merkkijonon "k", ohjelman suoritus siirtyy toistolausetta seuraavaan komentoon, jonka suorittamisen jälkeen ohjelman suoritus päättyy. -->
-In the example below, the program asks the user whether to exit the loop or not. If the user inputs the string "k", the execution of the program moves to the command following the loop block, after which the execution of the program ends.
+In the example below, the program asks the user whether to exit the loop or not. If the user inputs the string "y", the execution of the program moves to the command following the loop block, after which the execution of the program ends.
 
 ```java
 Scanner scanner = new Scanner(System.in);
@@ -252,6 +252,7 @@ Write a program according to the preceding example that asks a user to input val
 
 <sample-output>
 
+Give a number:
 **5**
 Give a number:
 **744**
@@ -328,7 +329,7 @@ while (true) {
 <programming-exercise name="Only positives" tmcname='part02-Part02_07.OnlyPositives'>
 
 <!-- Kirjoita ohjelma, joka kysyy käyttäjältä lukuja. Mikäli luku on negatiivinen (eli pienempi kuin nolla), käyttäjälle tulostetaan viesti "Epäkelpo luku" ja käyttäjältä kysytään uutta lukua. Jos taas luku on nolla, lukujen lukeminen lopetetaan ja ohjelma poistuu toistolauseesta. Mikäli luku on positiivinen, ohjelma tulostaa luvun toisen potenssin. -->
-Write a program that asks a user for numbers. If the number is negative (smaller than zero), the program prints for user "unfit number" and asks the user for a new number. If the number is zero, the program exits the loop. If the number is positive, the program prints the number power of two.
+Write a program that asks a user for numbers. If the number is negative (smaller than zero), the program prints for user "Unsuitable number" and asks the user for a new number. If the number is zero, the program exits the loop. If the number is positive, the program prints the number power of two.
 
 <sample-output>
 
diff --git a/data/part-2/3-more-loops.md b/data/part-2/3-more-loops.md
@@ -35,7 +35,7 @@ Next, we'll come to know a few other ways to implement loops.
 So far we have been using a loop with the boolean 'true' in its paranthesis, so the loop continues forever (or until the loop is ended with the `break` command ).
 
 <!-- Toistolauseen sulut sisältävät oikeastaan ehtolausekkeen, aivan samalla tavalla kuin `if`-komentoa seuraavat sulut. Arvon `true` voi korvata lausekkeella, joka evaluoidaan ohjelman suorituksen yhteydessä. Lauseke määritellään täsmälleen samalla tavalla kuin ehtolauseen lauseke. -->
-Actually the paranthesis of a loop contain a conditional expression, or a condition, just like the paranthesis of an `if` statement. The `true` value can be replaced with an expression, which is evaluated as the program is executed. The expression is defined the same way as the condition of a conditional statement.
+Actually the paranthesis of a loop can contain a conditional expression, or a condition, just like the paranthesis of an `if` statement. The `true` value can be replaced with an expression, which is evaluated as the program is executed. The expression is defined the same way as the condition of a conditional statement.
 
 <!-- Seuraavassa esimerkissä tulostetaan luvut 1, 2, ..., 5.  Kun `luku`-muuttujan arvo on yli 5, `while`-ehto ei ole enää voimassa ja toistaminen lopetetaan. -->
 The following code prints the numbers 1,2,...,5. When the value of the variable `number` is more than 5, the `while`-condition evaluates to false and the execution ends.
@@ -131,7 +131,7 @@ We will continue practicing loops in the following exercises. You can use either
 <programming-exercise name='Counting' tmcname='part02-Part02_14.Counting'>
 
 <!-- Kirjoita ohjelma, joka lukee käyttäjältä kokonaisluvun. Tämän jälkeen ohjelma tulostaa luvut nollasta käyttäjän syöttämään lukuun. Voit olettaa, että käyttäjä syöttää aina positiivisen luvun. Alla on muutamia esimerkkejä ohjelman toivotusta toiminnasta. -->
-Write a program that reads an integer from the user. Then the program prints numbers from 0 to the number given by the user. You can assume that the user always gives a positive number. Below is some examples of the wanted functionality.
+Write a program that reads an integer from the user. Then the program prints numbers from 0 to the number given by the user. You can assume that the user always gives a positive number. Below are some examples of the wanted functionality.
 
 <sample-output>
 
@@ -279,9 +279,9 @@ int number = 1;
 
 while (number != 2) {
     System.out.println(number);
-    luku = 2;
+    number = 2;
     System.out.println(number);
-    luku = 1;
+    number = 1;
 }
 ```
 
diff --git a/data/part-2/4-methods.md b/data/part-2/4-methods.md
@@ -450,7 +450,7 @@ Greetings!
 
 <!-- Aivan kuten Javan valmista `System.out.println()`-metodia kutsuttaessa, voi oman metodin kutsussa parametrina antaa lausekkeen. -->
 
-Just like when calling the predefined method `System.out.println`, you can pass an expression as a paratmeter.
+Just like when calling the predefined method `System.out.println`, you can pass an expression as a parameter.
 
 <!-- ```java
 public static void main(String[] args) {
@@ -626,7 +626,7 @@ sum(3, 5);
 int number1 = 2;
 int number2 = 4;
 
-summa(number1, number2);
+sum(number1, number2);
 ```
 
 <!-- <sample-output>
@@ -884,7 +884,7 @@ The parameter `number` is copied for the method's use, i.e., a new variable call
 
 <!-- Metodin määrittelyssä kerrotaan palauttaako metodi arvon. Jos metodi palauttaa arvon, tulee metodimäärittelyn yhteydessä kertoa palautettavan arvon tyyppi. Muulloin määrittelyssä käytetään avainsanaa `void`. Tähän mennessä tekemämme metodit ovat määritelty avainsanaa `void` käyttäen eli eivät ole palauttaneet arvoa. -->
 
-The definition of a method tells whether that method returns a value or not. If it does, the method definition has to include type of the return value. Otherwise the keyword `void` is used in the definition. The methods we've created so far have been defined with the keyword `void`, i.e., they've returned no values.
+The definition of a method tells whether that method returns a value or not. If it does, the method definition has to include the type of the return value. Otherwise the keyword `void` is used in the definition. The methods we've created so far have been defined with the keyword `void`, i.e., they've returned no values.
 
 <!-- ```java
 public static **void** kasvataKolmella() {
@@ -1089,7 +1089,7 @@ public static int functioningMethod(int parameter) {
 
     System.out.println("The number received as parameter is ten or lesser.");
 
-    return parametri;
+    return parameter;
 }
 ```
 
@@ -1109,6 +1109,16 @@ public static void jakolasku(int osoittaja, int nimittaja) {
 }
 ``` -->
 
+```java
+public static void division(int numerator, int denominator) {
+    if (denominator == 0) {
+        System.out.println("Can not divide by 0!");
+        return;
+    }
+
+    System.out.println("" + numerator + " / " + denominator + " = " + (1.0 * numerator / denominator));
+}
+```
 
 <!--  Muuttujien määrittely metodien sisällä -->
 
@@ -1308,7 +1318,7 @@ When the execution of the method reaches the statement `return first + second;`,
 
 <!-- Metodin kutsutaan seuraavasti. Alla metodia käytetään laskemaan luvut 2 ja 7 yhteen. Metodikutsusta saatava paluuarvo asetetaan muuttujaan `lukujenSumma`: -->
 
-The method is called in the following way. Below, the method is used to add the numbers 2 and 7 together. The value resuting from the method call is placed into the variable `sumOfNumbers`.
+The method is called in the following way. Below, the method is used to add the numbers 2 and 7 together. The value resulting from the method call is placed into the variable `sumOfNumbers`.
 
 <!-- ```java
 int lukujenSumma = summa(2, 7);
@@ -1469,11 +1479,7 @@ Sum: 14
 
 <!-- **Huom:** kun tehtävässä sanotaan että metodin pitää _palauttaa_ jotain, tarkoittaa tämä sitä että metodissa tulee olla määritelty paluutyyppi ja `return`-komento jolla haluttu asia palautetaan. Metodi ei itse tulosta (eli käytä komentoa `System.out.println(..)`), tulostuksen hoitaa metodin kutsuja, eli tässä tapauksessa pääohjelma. -->
 
-<<<<<<< HEAD:data/part-2/4-methods.md
 **NB:** when an exercise describes a method that should _return_ something, this means that the type of the return value must be declared in the method definition, and that the method contains a `return` command that returns the wanted data. The method itself will print nothing (i.e. will not use the command `System.out.println`) - that task is left to the method caller, which in this case is the main program.
-=======
-**N.B.:** when an exercise describes a method that should _return_ something, this means that the type of the return value must be declared in the method definition, and that the method contains a `return` command that returns the desired data. The method itself will print nothing (i.e. will not use the command `System.out.println`) - that task is left to the method's caller, which in this case is the main program.
->>>>>>> 73493be24544e9825a3a481cd6d5905f4653274f:data/osa-2/4-metodit.md
 
 </programming-exercise>
 
@@ -1663,7 +1669,7 @@ How does the computer remember where to return after the execution of a method?
 
 <!-- Java-lähdekoodin suoritusympäristö pitää kirjaa suoritettavasta metodista kutsupinossa. **Kutsupino** sisältää kehyksiä, joista jokainen sisältää tiedon kyseisen metodin sisäisistä muuttujista sekä niiden arvoista. Kun metodia kutsutaan, kutsupinoon luodaan uusi kehys, joka sisältää metodin sisältämät muuttujat. Kun metodin suoritus loppuu, metodiin liittyvä kehys poistetaan kutsupinosta, jolloin suoritusta jatketaan kutsupinon edeltävästä metodista. -->
 
-The environment that executes Java source code keeps track of the method being executed in the call stack. **The call stack** contains frames, each of which includes information about a specific method's internal variables and their values. When a method is called, a new frame containing its variables is created in the call stack. When the execution of a method ends, the frame relating tt method is removed from the call stack, which leads to execution resuming at the previous method of the stack.
+The environment that executes Java source code keeps track of the method being executed in the call stack. **The call stack** contains frames, each of which includes information about a specific method's internal variables and their values. When a method is called, a new frame containing its variables is created in the call stack. When the execution of a method ends, the frame relating to a method is removed from the call stack, which leads to execution resuming at the previous method of the stack.
 
 <!-- Alla olevan visualisaation oikealla laidalla näytetään kutsupinon toimintaa. Metodikutsun yhteydessä kutsupinoon luodaan uusi kehys, joka poistetaan metodikutsusta poistuttaessa. -->
 
