Sync (#30)

* more sections

* First feedback round

* Update prelude.md

* ...

* Spelling fix

Co-Authored-By: Firas Regaieg <37019463+firasrg@users.noreply.github.com>

* Arguments chapter

* More Challenges

* Run prettier

* user input

* October 14th, #1

* Array challenges

* Delete challenges

* Null

* ...

* Update null_as_absence.md

* Delete out.json

* Fix quotes

* Add first no_runs

* Fix number example

* ...

* Write more of the classes section

* Constructors

* Clean up getting started a little

* Use a duke

* Don't link anywhere yet

* Increase lines needed to show a duke

* Fix field access section

* ...

* ...

* ...

* ...

* ...

* switch and enums

---------

Co-authored-by: Firas Regaieg <37019463+firasrg@users.noreply.github.com>

Author: bowbahdoe

book.toml

@@ -16,18 +16,10 @@ additional-js = ["ferris.js"]
 enable = true # whether or not to enable section folding
 level = 0     # the depth to start folding
 
-[preprocessor.features]
-command = "python3 features.py"
-# Going to start writing the rest of the book
-# Assuming this is true
-toplevel_anonymous_class = true
-# Not ready
-simple_io = false
-# Turn on when Java 21 released
-java_21 = false
-
 [output.html.playground]
 editable = true
 
 [output.html.code.hidelines]
 java = "~"
+[output.html.code.hidelines]
+java = "~"

features.py

@@ -1,66 +1,65 @@
 var ferrisTypes = [
-    {
-      attr: 'does_not_compile',
-      title: 'This code does not compile!'
-    },
-    {
-      attr: 'panics',
-      title: 'This code will crash!'
-    },
-    {
-      attr: 'not_desired_behavior',
-      title: 'This code does not produce the desired behavior.'
-    }
-  ]
-  
-  document.addEventListener('DOMContentLoaded', () => {
-    for (var ferrisType of ferrisTypes) {
-      attachFerrises(ferrisType)
-    }
-  })
-  
-  function attachFerrises(type) {
-    var elements = document.getElementsByClassName(type.attr)
-  
-    for (var codeBlock of elements) {
-      var lines = codeBlock.innerText.replace(/\n$/, '').split(/\n/).length
-      var size = 'large'
-      if (lines < 4) {
-        size = 'small'
-      }
-  
-      var container = prepareFerrisContainer(codeBlock, size == 'small')
-      container.appendChild(createFerris(type, size))
-    }
+  {
+    attr: 'does_not_compile',
+    title: 'This code does not compile!'
+  },
+  {
+    attr: 'panics',
+    title: 'This code will crash!'
+  },
+  {
+    attr: 'not_desired_behavior',
+    title: 'This code does not produce the desired behavior.'
+  }
+]
+
+document.addEventListener('DOMContentLoaded', () => {
+  for (var ferrisType of ferrisTypes) {
+    attachFerrises(ferrisType)
   }
-  
-  function prepareFerrisContainer(element, useButtons) {
-    var foundButtons = element.parentElement.querySelector('.buttons')
-    if (useButtons && foundButtons) {
-      return foundButtons
+})
+
+function attachFerrises(type) {
+  var elements = document.getElementsByClassName(type.attr)
+
+  for (var codeBlock of elements) {
+    var lines = codeBlock.innerText.replace(/\n$/, '').split(/\n/).length
+    var size = 'large'
+    if (lines < 5) {
+      size = 'small'
     }
-  
-    var div = document.createElement('div')
-    div.classList.add('ferris-container')
-  
-    element.parentElement.insertBefore(div, element)
-  
-    return div
+
+    var container = prepareFerrisContainer(codeBlock, size == 'small')
+    container.appendChild(createFerris(type, size))
   }
-  
-  function createFerris(type, size) {
-    var a = document.createElement('a')
-    a.setAttribute('href', 'ch00-00-introduction.html#ferris')
-    a.setAttribute('target', '_blank')
-  
-    var img = document.createElement('img')
-    img.setAttribute('src', '../img/' + type.attr + '.svg')
-    img.setAttribute('title', type.title)
-    img.classList.add('ferris')
-    img.classList.add('ferris-' + size)
-  
-    a.appendChild(img)
-  
-    return a
+}
+
+function prepareFerrisContainer(element, useButtons) {
+  var foundButtons = element.parentElement.querySelector('.buttons')
+  if (useButtons && foundButtons) {
+    return foundButtons
   }
-  
+
+  var div = document.createElement('div')
+  div.classList.add('ferris-container')
+
+  element.parentElement.insertBefore(div, element)
+
+  return div
+}
+
+function createFerris(type, size) {
+  var a = document.createElement('a')
+  // a.setAttribute('href', 'ch00-00-introduction.html#ferris')
+  a.setAttribute('target', '_blank')
+
+  var img = document.createElement('img')
+  img.setAttribute('src', '../img/' + type.attr + '.svg')
+  img.setAttribute('title', type.title)
+  img.classList.add('ferris')
+  img.classList.add('ferris-' + size)
+
+  a.appendChild(img)
+
+  return a
+}

ferris.js

@@ -99,13 +99,16 @@
   - [If](./branching_logic/if.md)
   - [Nested Ifs](./branching_logic/nested_ifs.md)
   - [Else](./branching_logic/else.md)
+  - [Else](./branching_logic/else.md)
   - [Else If](./branching_logic/else_if.md)
   - [Relation to Delayed Assignment](./branching_logic/relation_to_delayed_assignment.md)
   - [Scoped Variables](./branching_logic/scoped_variables.md)
+  - [Scoped Variables](./branching_logic/scoped_variables.md)
   - [Conditional Operator](./branching_logic/conditional_operator.md)
   - [Boolean Expressions](./branching_logic/boolean_expressions.md)
   - [Challenges](./branching_logic/challenges.md)
 
+
 - [Loops](./loops.md)
   - [While](./loops/while.md)
   - [Endless Loops](./loops/endless_loops.md)
@@ -169,6 +172,7 @@
   - [Scope](./methods/scope.md)
   - [main](./methods/main.md)
   - [Challenges](./methods/challenges.md)
+
 - [Arguments](./arguments.md)
 
   - [Declaration](./arguments/declaration.md)
@@ -180,26 +184,23 @@
   - [Inferred Types](./arguments/inferred_types.md)
   - [Challenges](./arguments/challenges.md)
 
-- [Return](./return_values.md)
-  - [Return Values](./return_values/return_values.md)
-  - [Conversion](./return_values/conversion.md)
+- [Return Values](./return_values.md)
+  - [Declaration](./return_values/declaration.md)
+  - [Return Statement](./return_values/return_statement.md)
+  - [Exhaustiveness](./return_values/exhaustiveness.md)
   - [void](./return_values/void.md)
+  - [Return in void methods](./return_values/return_in_void_methods.md)
+  - [Conversion](./return_values/conversion.md)
   - [Unreachable Statements](./return_values/unreachable_statements.md)
-  - [Pure Functions](./return_values/pure_functions.md)
-  - [Impure Functions](./return_values/impure_functions.md)
 
 # Data Types III
 
-- [Identity Types](./identity_types.md)
-  - [Comparison with ==](./identity_types/comparison_with_equalsequals.md)
-- [Primitive Types](./primitive_types.md)
 - [null](./null.md)
   - [Null as Absence](./null/null_as_absence.md)
+  - [Null as Unknown](./null/null_as_unknown.md)
   - [Checking for null](./null/checking_for_null.md)
-  - [Field Access](./null/field_access.md)
-  - [Instance Methods](./null/instance_methods.md)
+  - [NullPointerException](./null/null_pointer_exception.md)
 - [Boxed Primitives](./boxed_primitives.md)
-  - [Primitive Types](./boxed_primitives/primitive_types.md)
   - [Integer](./boxed_primitives/integer.md)
   - [Double](./boxed_primitives/double.md)
   - [Character](./boxed_primitives/character.md)
@@ -208,39 +209,100 @@
   - [Boxing Conversion](./boxed_primitives/boxing_conversion.md)
   - [Arrays of Boxed Primitives](./boxed_primitives/arrays_of_boxed_primitives.md)
   - [Challenges](./boxed_primitives/challenges.md)
+  - [Challenges](./boxed_primitives/challenges.md)
 - [Arrays II](./arrays_ii.md)
+  - [Initializion with Size](./arrays_ii/initialization_with_size.md)
   - [Default Values](./arrays_ii/default_values.md)
-  - [Populate Array]()
+  - [Populate Arrays](./arrays_ii/populate_arrays.md)
 
 # Code Structure II
 
 - [Classes](./classes.md)
-
+  - [The meaning of the word Class](./classes/the_meaning_of_the_word_class.md)
   - [Class Declaration](./classes/class_declaration.md)
-  - [User Defined Types](./classes/user_defined_types.md)
-  - [Naming Classes](./classes/naming_classes.md)
-  - [Field Declaration](./classes/field_declaration.md)
-  - [Field Access](./classes/field_access)
-  - [Naming Fields](./classes/naming_fields.md)
-  - [new](./classes/new.md)
-  - [Zero Values](./classes/zero_values.md)
+  - [Naming](./classes/naming.md)
+  - [Instances](./classes/instances.md)
+  - [Fields](./classes/fields.md)
+  - [Field Initialization](./classes/field_initialization.md)
+  - [Field Access](./classes/field_access.md)
+  - [Field Default Values](./classes/field_default_values.md)
   - [Aliasing](./classes/aliasing.md)
-  - [null](./classes/null.md)
+  - [Return Multiple Values](./classes/return_multiple_values.md)
 
-- [Constructors](./constructors.md)
+- [Instance Methods](./instance_methods.md)
+  - [Invocation](./instance_methods/invocation.md)
+  - [Arguments](./instance_methods/arguments.md)
+  - [Field Access](./instance_methods/field_access.md)
+  - [Field Updates](./instance_methods/field_updates.md)
+  - [Derived Values](./instance_methods/derived_values.md)
+  - [Invoke Other Methods](./instance_methods/invoke_other_methods.md)
+  - [this](./instance_methods/this.md)
+  - [Disambiguation](./instance_methods/disambiguation.md)
+  - [Clarity](./instance_methods/clarity.md)
+
+# Data Types IV
+
+- [Enums](./enums.md)
+  - [Declaration](./enums/declaration.md)
+  - [Variants](./enums/variants.md)
+  - [Naming](./enums/naming.md)
+  - [Usage](./enums/usage.md)
+  - [Equality](./enums/equality.md)
+  - [Comparison to boolean](./enums/comparison_to_boolean.md)
+
+# Control Flow III
+
+- [Exceptions](./exceptions.md)
+  - [throw](./exceptions/throw.md)
+  - [Messages](./exceptions/messages.md)
+  - [Stack Traces](./exceptions/stack_traces.md)
+  - [try/catch](./exceptions/try_catch.md)
+- [Switch](./switch.md)
+  - [Case and Default](./switch/case_and_default.md)
+  - [Strings](./switch/strings.md)
+  - [ints](./switch/ints.md)
+  - [Enums](./switch/enums.md)
+  - [Omitted Default](./switch/omitted_default.md)
+  - [Exhaustiveness](./switch/exhaustiveness.md)
+  - [Combining Cases](./switch/combining_cases.md)
+  - [null](./switch/null.md)
+
+# Code Structure III
 
-  - [this](./constructors/this.md)
+- [Constructors](./constructors.md)
+  - [Declaration](./constructors/declaration.md)
   - [The Default Constructor](./constructors/the_default_constructor.md)
+  - [Arguments](./constructors/arguments.md)
   - [Final Fields](./constructors/final_fields.md)
-  - [Multiple Constructors](./constructors/multiple_constructors.md)
+  - [Invariants](./constructors/invariants.md)
+  - [Overloads](./constructors/overloads.md)
+  - [Delegation](./constructors/delegation.md)
+
+
+
+<!--
+
+- [Strings II](./strings_ii.md)
+  - [length]()
+  - [equals]()
+  - [charAt]()
+  - [equalsIgnoreCase]()
+  
+- [Multiple Source Files]()
+  - [Why]()
+  - [How]()
+  - [Restrictions]()
+- [The Main Class]()
+  - [The Implicit Main Class]()
+
+
+- [Multiple Files]()
+- [The Implicit Main Class]()
+- [Private]()
+
+## Data Types IV
 
-- [Instance Methods](./instance_methods.md)
 
-  - [Declaration](./instance_methods/declaration.md)
-  - [Invocation](./instance_methods/invocation.md)
-  - [this](./instance_methods/this.md)
-  - [Aliasing](./instance_methods/aliasing.md)
-  - [Derived Values](./instance_methods/derived_values.md)
 
 - [Documentation]()
   - [Documentation Comments]()
@@ -253,7 +315,6 @@
 - [Primitive Classes](./classes/primitive_classes.md)
 - [Reference Classes](./classes/reference_classes.md)
 
-<!--
 Arrays
 copy an array (System.arrayCopy, for loop)
 Generics