Update from branch

book.toml

@@ -15,6 +15,8 @@ mathjax-support = true
 additional-css = ["ferris.css"]
 additional-js = ["ferris.js"]
 heading-split-level = 2
+default-theme = "light"
+preferred-default-theme = "light"
 
 [output.html.fold]
 enable = false # whether or not to enable section folding

src/SUMMARY.md

@@ -101,15 +101,53 @@ Intro to testing
 Gui stuff
 -->
 
-# Modern Java
 
 - [Prelude](./prelude.md)
   - [Asking for Help](./prelude/asking_for_help.md)
   - [Toy Problems](./prelude/toy_problems.md)
   - [Lies](./prelude/lies.md)
   - [AI](./prelude/ai.md)
   - [Java](./prelude/java.md)
-- [Getting Started](./getting_started.md)
+
+# The Computing Environment
+
+- [Hardware](./hardware.md)
+  - [CPU](./hardware/cpu.md)
+  - [RAM](./hardware/ram.md)
+  - [Hard Drives](./hardware/hard_drives.md)
+  - [Motherboard](./hardware/motherboard.md)
+- [Operating Systems](./operating_systems.md)
+  - [Personal Computers](./operating_systems/personal_computers.md)
+  - [Servers](./operating_systems/servers.md)
+  - [Mobile Phones](./operating_systems/mobile_phones.md)
+  - [Game Consoles](./operating_systems/game_consoles.md)
+  - [Abstractions](./operating_systems/abstractions.md)
+  - [Defaults](./operating_systems/defaults.md)
+
+# Modern Java
+
+- [Set Up Your Computer](./text_editors/set_up_your_computer.md)
+  - [Text Editors](./text_editors.md)
+  - [IDEs](./text_editors/ides.md)
+  - [VSCodium](./text_editors/vscodium.md)
+  - [Install VSCodium](./text_editors/install_vscodium.md)
+  - [Install Java](./text_editors/install_java.md)
+- [The Terminal](./the_terminal.md)
+  - [Bash](./the_terminal/bash.md)
+  - [Windows Subsystem for Linux](./the_terminal/windows_subsystem_for_linux.md)
+  - [Chromebooks and School Computers](./the_terminal/chromebooks_and_school_computers.md)
+  - [Commands](./the_terminal/commands.md)
+  - [Directories](./the_terminal/directories.md)
+  - [Listing Files](./the_terminal/listing_files.md)
+  - [Creating Directories](./the_terminal/creating_directories.md)
+  - [Changing Directories](./the_terminal/changing_directories.md)
+  - [Creating Files](./the_terminal/creating_files.md)
+  - [Run Java Programs](./the_terminal/run_java_programs.md)
+  - [Getting Used to it](./the_terminal/getting_used_to_it.md)
+  - [Challenges](./the_terminal/challenges.md)
+
+
+<!-- - [Getting Started](./getting_started.md) -->
 - [First Steps](./first_steps.md)
   - [Comments](./first_steps/comments.md)
   - [Semicolons](./first_steps/semicolon.md)
@@ -445,7 +483,7 @@ Gui stuff
 # Projects
 
 <!-- chicken nugget number type things come up when dispensing change -->
-- [Tic-Tac-Toe]()
+- [Tic-Tac-Toe](./projects/tic_tac_toe.md)
 
 
 # Concepts
@@ -458,35 +496,6 @@ Gui stuff
   - [Practice](./code_is_read_more_than_written/practice.md)
 
 
-
-# The Computing Environment
-
-- [Hardware](./hardware.md)
-  - [CPU](./hardware/cpu.md)
-  - [RAM](./hardware/ram.md)
-  - [Hard Drives](./hardware/hard_drives.md)
-  - [Motherboard](./hardware/motherboard.md)
-- [Operating Systems](./operating_systems.md)
-  - [Personal Computers](./operating_systems/personal_computers.md)
-  - [Servers](./operating_systems/servers.md)
-  - [Mobile Phones](./operating_systems/mobile_phones.md)
-  - [Game Consoles](./operating_systems/game_consoles.md)
-  - [Abstractions](./operating_systems/abstractions.md)
-  - [Defaults](./operating_systems/defaults.md)
-- [The Terminal](./the_terminal.md)
-  - [Bash](./the_terminal/bash.md)
-  - [Windows Subsystem for Linux](./the_terminal/windows_subsystem_for_linux.md)
-  - [Chromebooks and School Computers](./the_terminal/chromebooks_and_school_computers.md)
-  - [Commands](./the_terminal/commands.md)
-  - [Directories](./the_terminal/directories.md)
-  - [Listing Files](./the_terminal/listing_files.md)
-  - [Creating Directories](./the_terminal/creating_directories.md)
-  - [Changing Directories](./the_terminal/changing_directories.md)
-  - [Creating Files](./the_terminal/creating_files.md)
-  - [Run Java Programs](./the_terminal/run_java_programs.md)
-  - [Getting Used to it](./the_terminal/getting_used_to_it.md)
-
-
 # Control Flow IV
 
 - [Exceptions II](./exceptions_ii.md)
@@ -551,7 +560,7 @@ Gui stuff
   - [Optimized Implementation](./growable_arrays/optimized_implementation.md)
   - [Challenges](./growable_arrays/challenges.md)
 
-# Interactive Programs II
+# Interactive Programs III
 
 - [Command Line Arguments](./command_line_arguments.md)
   - [Accessing Arguments](./command_line_arguments/accessing_arguments.md)
@@ -613,7 +622,7 @@ Gui stuff
   - [Challenges](./integers_ii/challenges.md)
 
 
-# Interactive Programs III
+# Interactive Programs IV
 
 - [Files](./files.md)
   - [Paths](./files/paths.md)
@@ -874,10 +883,9 @@ Make them do one. -->
   - [Arguments](./lambdas/arguments.md)
   - [Return](./lambdas/return.md)
   - [Method References](./lambdas/method_references.md)
+  - [Constructor References](./lambdas/constructor_references.md)
   - [Inference](./lambdas/inference.md)
   - [Built-In Functional Interfaces](./lambdas/built_in_functional_interfaces.md)
-  - [Runnable](./lambdas/runnable.md)
-  - [Function](./lambdas/function.md)
   - [Checked Exceptions](./lambdas/checked_exceptions.md)
   - [Challenges](./lambdas/challenges.md)
 
@@ -953,7 +961,11 @@ TODO: Wait for hermetic java
   - [Collectors](./streams/collectors.md)
   - [Purpose](./streams/purpose.md)
   - [Challenges](./streams/challenges.md)
+
+
 <!--
+Make a challenge where the solution is to write normal code.
+
 - [Regular Expressions 🚧](./regular_expressions.md)
   - [Theoretical Basis](./regular_expressions/theoretical_basis.md)
   - [Pattern](./regular_expressions/pattern.md)
@@ -964,14 +976,26 @@ TODO: Wait for hermetic java
   - [Matcher]()
   - [Pathological Cases]()
   - [Power]()
+
+# Interactive Programs IV
+
+- [Files II](./files_ii.md)
+  - [List Files](./files_ii/list_files.md)
+  - [Read Lines](./files_ii/read_lines.md)
+  - [InputStream](./files_ii/input_stream.md)
+  - [OutputStream](./files_ii/output_stream.md)
+  - [Reader](./files_ii/reader.md)
+  - [Writer](./files_ii/writer.md)
   -->
 
+
 # Conclusion
 
 - [What Now?](./conclusion/what_now.md)
 
 
 <!-- 
+
 - [Strings III 🚧]()
 
 Streams II

src/conclusion/what_now.md

@@ -142,12 +142,12 @@ most employable one of the many HTTP server options out there.
 ### Desktop Applications
 
 If you want to learn how to make desktop applications in Java you have basically
-three paths.
+two paths.
 
 Path #1 is to learn Java Swing. This is an old crusty GUI framework that is kinda difficult to use
 but has the pro of coming with Java and being able to run on every potato in existence.
 
-[Docs for `java.desktop` (Swing) here](https://docs.oracle.com/en/java/javase/24/docs/api/jdk.httpserver/module-summary.html)
+[Docs for `java.desktop` (Swing) here](https://docs.oracle.com/en/java/javase/24/docs/api/java.desktop/module-summary.html)
 
 Path #2 is the learn JavaFX. By all accounts JavaFX is better software than Swing, but it was cursed
 by coming out at a point in history where desktop apps were no longer big business to develop. It
@@ -187,7 +187,8 @@ learned JavaScript that is a good one to touch next.
 
 There are languages out there like TypeScript that compile to JavaScript -
 and you can find some projects out there that do much the same for Java -
-but just practically speaking learning JavaScript
+but just practically speaking learning JavaScript is going to be something
+you have to do at some point if you get into making websites.
 
 ### C#
 
@@ -226,10 +227,10 @@ you do to make a full app in it, but it can't hurt.
 
 [Kotlin Android Tutorial here](https://kotlinlang.org/docs/android-overview.html)
 
-If you want to make Desktop or Mobile apps in Kotlin it is probably also worth checking out
-Jetpack Compose.
+If you want to make Desktop, Mobile, or Web apps in Kotlin it is probably also worth checking out
+Jetbrains Compose Multiplatfrom.
 
-[Getting Started for Jetpack Compose here](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-create-first-app.html)
+[Getting Started for Jetbrains Compose Multiplatfrom here](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-create-first-app.html)
 
 
 ### Others
@@ -261,4 +262,7 @@ context for quite yet:
 
 * Rust
 * Zig
+* Clojure
+
+
 [^wasm]: Fight me, WebAssembly fans.

src/easy_vs_simple.md

@@ -0,0 +1 @@
+# Easy vs. Simple

src/exceptions_ii/unchecked_exceptions.md

@@ -1,6 +1,6 @@
 # Unchecked Exceptions
 
-When a part of your code might throw a "unchecked" exception, other
+When a part of your code might throw an "unchecked" exception, other
 parts of your code do not need to account for that possibility.
 
 ```java

src/files_ii.md

@@ -0,0 +1 @@
+# Files II

src/files_ii/challenges.md

@@ -0,0 +1 @@
+# Challenges

src/files_ii/input_stream.md

@@ -0,0 +1 @@
+# InputStream

src/files_ii/lines.md

@@ -0,0 +1 @@
+# Lines

src/files_ii/list_directory.md

@@ -0,0 +1 @@
+# Paths

src/files_ii/list_files.md

@@ -0,0 +1 @@
+# List Files

src/files_ii/list_files_in_a_directory.md

@@ -0,0 +1 @@
+# Paths

src/files_ii/output_stream.md

@@ -0,0 +1 @@
+# OutputStream

src/files_ii/paths.md

@@ -0,0 +1 @@
+# Paths

src/files_ii/read_lines.md

@@ -0,0 +1 @@
+# Read Lines

src/files_ii/reader.md

@@ -0,0 +1 @@
+# Reader

src/files_ii/writer.md

@@ -0,0 +1 @@
+# Writer

src/first_steps.md

@@ -4,7 +4,7 @@
 <img src="/first_steps/header.png" height="200px"/>
 
 
-If you made it through the [Getting Started section](./getting_started/hello_world.md) you've successfully run this program.
+If you made it through the ["Set Up Your Computer" section](./text_editors/set_up_your_computer.md) you've successfully run this program.
 
 ```java
 void main() {
@@ -36,7 +36,7 @@ IO.println("Hello, World!");
 
 This bit of magic here - `IO.println` - is a "statement" that "prints" the text inside the `(` and `)` as well as a "new line" to the screen.
 
-**print** with new **l**i**n**e.
+The "`IO`" part stands for "Input/Output" then it is **print** with new **l**i**n**e.
 
 If you were to replace it with `IO.print`, then the output would lack that new line. This makes the following program be functionally identical to the first.
 

src/getting_started.md

@@ -1,6 +1,21 @@
 # Getting Started
 
-There are a lot of ways to "get set up" to run Java code.
+There are a lot of ways to "get set up" to run Java code. 
+
+
+
+For the first chunk of this book it will only matter that you have the
+ability to run Java code. The guides below will be aiming to get you 
+to that point.
+
+After the section 
+
+## Chromebooks / Mobile Phones
+
+
+
+One is to get set up "for real." This means Java is fully set up on your system
+and all the comman
 
 For at least the first chunk of this, you should be able to get away with using
 the editor on [https://run.mccue.dev](https://run.mccue.dev). That might be the easiest.
@@ -21,6 +36,9 @@ Download the "JDK MSI" from [adoptium.net](https://adoptium.net/temurin/releases
 
 Run the installer, selecting all the default options.
 
+Then you should download 
+
+
 ## Mac OS
 
 Download the "JDK .pkg" from [adoptium.net](https://adoptium.net/temurin/releases/?version=25&os=mac).

src/hardware.md

@@ -1,10 +1,10 @@
 # Hardware
 <img src="/hardware/header.png" height="200px"/>
 
-That was a long stretch of Java, so I think you've earned a bit of a detour into
+Before we get into Java, It might be helpful to take a detour into
 general computing knowledge.
 
-I won't be offended if you skim or skip these sections. Depending on who you are,
+I won't be offended if you skim or skip this and the next section. Depending on who you are,
 this might be a bit obvious.
 
 First lets cover hardware. The actual physical components that make up your computer.

src/interfaces.md

@@ -5,7 +5,7 @@
 
 Generics let you write code that doesn't care
 what is different between different things - you would accept a `String`
-or an `Integer`, doesn't matter what is diferent between them.
+or an `Integer`, doesn't matter what is different between them.
 
 Interfaces do a related thing. They let you write code that takes advantage
 of commonalities.

src/lambdas.md

@@ -12,7 +12,7 @@ interface Band {
     void playHitSong();
 }
 
-class Starcadian implements Bank {
+class Starcadian implements Band {
     @Override
     public void playHitSong() {
         IO.println("ultralove");

src/lambdas/constructor_references.md

@@ -0,0 +1,25 @@
+# Constructor References
+
+You can make a reference to the constructor
+of a class by using `::new`.
+
+```java,no_run
+// interface Supplier<T> {
+//    T get();
+// }
+
+Supplier<ArrayList<String>> listSupplier =
+    ArrayList::new;
+```
+
+This will try and select a constructor overload that
+matches the method expected on the interface.
+
+If you need to pass arguments to the constructor then
+you should use a regular lambda.
+
+```java,no_run
+Supplier<ArrayList<String>> listSupplier = () -> {
+    return new ArrayList<>(10);
+};
+```

src/packaging/jar_files.md

@@ -11,5 +11,5 @@ just that at a high level it's all just files in a ZIP.
 [^compression]: This bundling up also generally includes "compression," where
 the single file might be smaller than the combined sizes of its components. Most people don't
 need to think about this nowadays. Class files are small and hard drives are big.
-I say that knowing full well that 145GB of the 500GB hard drive my work laptop is Baldurs Gate 3.
+I say that knowing full well that 145GB of the 500GB hard drive on my work laptop is Baldurs Gate 3.
 I have 4GB left.

src/projects/buy_now_pay_later.md

@@ -5,7 +5,7 @@
 People exchange money for goods and/or services.
 
 Some of these purchases are non-essential. This means that they are,
-strictly speaking, optional. Ordering extra guacamole at a restraunt,
+strictly speaking, optional. Ordering extra guacamole at a restaurant,
 buying a brand new pair of shoes, and buying a diamond ring are all
 examples of non-essential spending.