Skip to content

Commit 634c6d2

Browse files
committed
fix stale documentation labels after example conversions
1 parent ca7d11e commit 634c6d2

6 files changed

Lines changed: 18 additions & 17 deletions

File tree

README.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -230,30 +230,30 @@ Start here depending on what you need:
230230
| Java | Released | Package | Highlights |
231231
|---|---|---|---|
232232
| 1 | Jan 1996 / Feb 1997 | [`java01`](src/main/java/net/jrodolfo/java_evolution/java01/README.md) | Object-Oriented Foundations, Interfaces, Checked Exceptions, Threads, `java.io`, Inner Classes, Reflection, Serialization, JDBC, RMI, and JavaBeans examples |
233-
| 2 | Dec 1998 | [`java02`](src/main/java/net/jrodolfo/java_evolution/java02/README.md) | Collections Framework, Sorting, `strictfp`, Swing and Java 2D examples, Security notes |
233+
| 2 | Dec 1998 | [`java02`](src/main/java/net/jrodolfo/java_evolution/java02/README.md) | Collections Framework, Sorting, `strictfp`, Swing, Java 2D, and Security Policy examples |
234234
| 3 | May 2000 | [`java03`](src/main/java/net/jrodolfo/java_evolution/java03/README.md) | Dynamic Proxy, Timer, Shutdown Hooks and JNDI examples, Legacy Integration notes |
235235
| 4 | Feb 2002 | [`java04`](src/main/java/net/jrodolfo/java_evolution/java04/README.md) | Assertions, Regex, NIO, Logging, Chained Exceptions, XML, and Security examples, Preferences notes |
236236
| 5 | Sep 2004 | [`java05`](src/main/java/net/jrodolfo/java_evolution/java05/README.md) | Generics, Enhanced For Loop, Autoboxing, Enums, Varargs, Static Import, Annotations, Concurrency Utilities |
237237
| 6 | Dec 2006 | [`java06`](src/main/java/net/jrodolfo/java_evolution/java06/README.md) | Navigable Collections, Monitoring/MXBeans example, Scripting/Compiler/Console/Web-Service explanatory modules |
238238
| 7 | Jul 2011 | [`java07`](src/main/java/net/jrodolfo/java_evolution/java07/README.md) | Try-With-Resources, Multi-Catch, Diamond Operator, String Switch, NIO.2, Fork/Join, `invokedynamic` example |
239239
| 8 | Mar 2014 | [`java08`](src/main/java/net/jrodolfo/java_evolution/java08/README.md) | Lambdas, Streams, Optional, Method References, CompletableFuture, Default Methods, Date/Time API |
240-
| 9 | Sep 2017 | [`java09`](src/main/java/net/jrodolfo/java_evolution/java09/README.md) | Collection Factories, Optional/Stream Enhancements, Private Interface Methods, Process API, StackWalker, Modules notes |
240+
| 9 | Sep 2017 | [`java09`](src/main/java/net/jrodolfo/java_evolution/java09/README.md) | Collection Factories, Optional/Stream Enhancements, Private Interface Methods, Process API, StackWalker, Module System example |
241241
| 10 | Mar 2018 | [`java10`](src/main/java/net/jrodolfo/java_evolution/java10/README.md) | `var`, Unmodifiable Collectors, `Optional.orElseThrow()` |
242242
| 11 | Sep 2018 | [`java11`](src/main/java/net/jrodolfo/java_evolution/java11/README.md) | String APIs, Files read/write string, HTTP Client, `Predicate.not`, lambda `var`, `Optional.isEmpty` |
243243
| 12 | Mar 2019 | [`java12`](src/main/java/net/jrodolfo/java_evolution/java12/README.md) | Switch Expressions preview, `Collectors.teeing`, `String.indent`, `Files.mismatch`, Compact Number Format |
244244
| 13 | Sep 2019 | [`java13`](src/main/java/net/jrodolfo/java_evolution/java13/README.md) | Text Blocks preview, switch `yield` preview, `FileSystems.newFileSystem(Path)` |
245245
| 14 | Mar 2020 | [`java14`](src/main/java/net/jrodolfo/java_evolution/java14/README.md) | Switch Expressions final, Helpful NullPointerExceptions, Records preview, Pattern Matching for `instanceof` preview |
246246
| 15 | Sep 2020 | [`java15`](src/main/java/net/jrodolfo/java_evolution/java15/README.md) | Text Blocks final, Sealed Classes preview, Hidden Classes example |
247247
| 16 | Mar 2021 | [`java16`](src/main/java/net/jrodolfo/java_evolution/java16/README.md) | Records final, Pattern Matching for `instanceof` final, `Stream.toList`, Unix-domain socket example |
248-
| 17 | Sep 2021 | [`java17`](src/main/java/net/jrodolfo/java_evolution/java17/README.md) | Sealed Classes final, Pattern Matching for switch preview, Random Generator API, `HexFormat`, Strong Encapsulation explanatory module |
248+
| 17 | Sep 2021 | [`java17`](src/main/java/net/jrodolfo/java_evolution/java17/README.md) | Sealed Classes final, Pattern Matching for switch preview, Random Generator API, `HexFormat`, Strong Encapsulation example |
249249
| 18 | Mar 2022 | [`java18`](src/main/java/net/jrodolfo/java_evolution/java18/README.md) | UTF-8 default charset, Simple Web Server example, JavaDoc snippets example, Internet-Address Resolution SPI example |
250250
| 19 | Sep 2022 | [`java19`](src/main/java/net/jrodolfo/java_evolution/java19/README.md) | Virtual Threads preview, Record Patterns preview, Pattern Matching switch preview, Structured Concurrency notes, FFM notes |
251-
| 20 | Mar 2023 | [`java20`](src/main/java/net/jrodolfo/java_evolution/java20/README.md) | Record Patterns second preview, Pattern Matching switch fourth preview, Scoped Values/Structured Concurrency/FFM/Vector notes |
251+
| 20 | Mar 2023 | [`java20`](src/main/java/net/jrodolfo/java_evolution/java20/README.md) | Record Patterns second preview, Pattern Matching switch fourth preview, Vector API example, Scoped Values/Structured Concurrency/FFM notes |
252252
| 21 | Sep 2023 | [`java21`](src/main/java/net/jrodolfo/java_evolution/java21/README.md) | Virtual Threads final, Record Patterns final, Pattern Matching for switch final, Sequenced Collections, KEM example |
253253
| 22 | Mar 2024 | [`java22`](src/main/java/net/jrodolfo/java_evolution/java22/README.md) | Unnamed Variables and Patterns final, FFM executable native example, Stream Gatherers explanatory module, Class-File API explanatory module |
254-
| 23 | Sep 2024 | [`java23`](src/main/java/net/jrodolfo/java_evolution/java23/README.md) | Markdown Documentation Comments module, Primitive Patterns preview module, Module Imports preview module, ZGC Generational Mode notes |
254+
| 23 | Sep 2024 | [`java23`](src/main/java/net/jrodolfo/java_evolution/java23/README.md) | Markdown Documentation Comments, Unsafe Memory-Access, and ZGC examples, preview notes |
255255
| 24 | Mar 2025 | [`java24`](src/main/java/net/jrodolfo/java_evolution/java24/README.md) | Stream Gatherers final, Class-File API, Security Manager/AOT/runtime modules, post-quantum crypto examples, preview bridge modules |
256-
| 25 | Sep 2025 | [`java25`](src/main/java/net/jrodolfo/java_evolution/java25/README.md) | Scoped Values final, Flexible Constructor Bodies final, Module Imports, KDF, and Compact Source Files examples, JFR/AOT/GC notes |
256+
| 25 | Sep 2025 | [`java25`](src/main/java/net/jrodolfo/java_evolution/java25/README.md) | Scoped Values final, Flexible Constructor Bodies final, Module Imports, KDF, Compact Source Files, JFR, AOT, and Object Headers examples, GC notes |
257257
| 26 | Mar 2026 | [`java26`](src/main/java/net/jrodolfo/java_evolution/java26/README.md) | HTTP/3 notes, Final Field restrictions, Applet API removal, AOT Object Caching, G1, PEM/Structured Concurrency/Lazy Constants/Vector/Primitive Patterns notes |
258258

259259
## How To Study This Repository

docs/glossary.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,8 +19,8 @@ This glossary explains acronyms and recurring terms used across the repository.
1919
| CPU | Central Processing Unit | The processor running Java code. It appears in discussions about platform architecture, virtual threads, and vector computation. |
2020
| CSS | Cascading Style Sheets | A web styling language mentioned when examples use embedded text formats. |
2121
| DHKEM | Diffie-Hellman Key Encapsulation Mechanism | The KEM algorithm name used by the Java 21 example with X25519 keys. |
22-
| DNS | Domain Name System | The naming system that resolves host names to network addresses; relevant to the Java 18 `InetAddress` resolver SPI notes. |
23-
| DOM | Document Object Model | A tree-oriented XML API. In the Java 4 XML notes, DOM contrasts with streaming or event-oriented XML processing. |
22+
| DNS | Domain Name System | The naming system that resolves host names to network addresses; relevant to the Java 18 `InetAddress` resolver SPI example. |
23+
| DOM | Document Object Model | A tree-oriented XML API. In the Java 4 XML example, DOM contrasts with streaming or event-oriented XML processing. |
2424
| EE | Enterprise Edition | Usually appears as Java EE, the older enterprise Java platform name relevant to migration from older JDKs. |
2525
| FFM | Foreign Function and Memory | Java APIs for calling native code and working with memory outside the Java heap. |
2626
| GC | Garbage Collection | JVM memory management that finds and reclaims objects the application no longer uses. |
@@ -81,11 +81,11 @@ This glossary explains acronyms and recurring terms used across the repository.
8181
| RISC | Reduced Instruction Set Computer | A processor design style referenced by the ARM acronym. |
8282
| RMI | Remote Method Invocation | A Java distributed-object technology mentioned as background when discussing native calls and remote procedure styles. |
8383
| RPC | Remote Procedure Call | A style of calling code across process or network boundaries; useful contrast for local native calls through FFM. |
84-
| SAX | Simple API for XML | An event-driven XML parsing API. In the Java 4 XML notes, SAX is useful contrast to DOM because it streams parser events instead of building a full tree. |
84+
| SAX | Simple API for XML | An event-driven XML parsing API. In the Java 4 XML example, SAX is useful contrast to DOM because it streams parser events instead of building a full tree. |
8585
| SDKMAN | Software Development Kit Manager | A tool commonly used on Linux/macOS to install and switch between JDK versions. |
8686
| SE | Standard Edition | Java Standard Edition, the core Java platform specification for the language, JVM, and standard APIs. |
8787
| SHA-256 | Secure Hash Algorithm 256-bit | A cryptographic hash function used as the hash primitive in `HKDF-SHA256`. |
88-
| SIMD | Single Instruction, Multiple Data | A processor execution model where one operation applies to multiple data values at once; relevant to the Vector API notes. |
88+
| SIMD | Single Instruction, Multiple Data | A processor execution model where one operation applies to multiple data values at once; relevant to the Vector API examples. |
8989
| SPI | Service Provider Interface | An extension point that lets libraries or runtime components plug in implementations, such as the Java 18 `InetAddress` resolver SPI. |
9090
| SQL | Structured Query Language | A database query language often embedded in Java strings or text blocks. |
9191
| Spring Boot | Spring Boot | The lightweight application shell and Maven parent used by this project. |
@@ -95,6 +95,6 @@ This glossary explains acronyms and recurring terms used across the repository.
9595
| VM | Virtual Machine | A general term for a runtime or machine abstraction; in this project it usually appears as part of JVM discussions. |
9696
| X25519 | X25519 elliptic-curve Diffie-Hellman function | The key-agreement key type used by the Java 21 DHKEM example. |
9797
| XML | Extensible Markup Language | A structured text data format often embedded in Java strings or text blocks. |
98-
| XSLT | Extensible Stylesheet Language Transformations | An XML transformation language. In the Java 4 XML notes, XSLT represents the transformation side of the standard XML-processing stack. |
99-
| ZGC | Z Garbage Collector | A low-latency garbage collector discussed in Java runtime and GC notes. |
98+
| XSLT | Extensible Stylesheet Language Transformations | An XML transformation language. In the Java 4 XML example, XSLT represents the transformation side of the standard XML-processing stack. |
99+
| ZGC | Z Garbage Collector | A low-latency garbage collector demonstrated by the Java 23 ZGC example and discussed in later Java runtime and GC notes. |
100100
| ZIP | ZIP archive format | A compressed archive format used in examples that treat archives as filesystems. |

docs/interview-guide.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -158,6 +158,7 @@ Records model data concisely, sealed classes model closed hierarchies, record pa
158158
Repo paths:
159159

160160
```text
161+
src/main/java/net/jrodolfo/java_evolution/java17
161162
src/main/java/net/jrodolfo/java_evolution/java18
162163
src/main/java/net/jrodolfo/java_evolution/java19
163164
src/main/java/net/jrodolfo/java_evolution/java20

docs/jep-index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ Java 1-7 predate the modern JEP process used elsewhere in this index. Their entr
2626
| [What's New in JDK 1.1](https://courses.cs.washington.edu/courses/cse341/99wi/java/tutorial/post1.0/whatsnew/index.html) | Inner classes, reflection, serialization, JDBC, RMI, JavaBeans, AWT updates, JAR files, JNI, internationalization | Final, Examples |
2727
| [JavaBeans specification](https://www.oracle.com/java/technologies/javase/javabeans-spec.html) | JavaBeans component conventions | Final, Executable Example |
2828
| [Object Serialization FAQ](https://www.oracle.com/java/technologies/javase/serializationfaq-jsp.html) | Object serialization | Final, Executable Example |
29-
| [Java language enhancements history](https://docs.oracle.com/javase/8/docs/technotes/guides/language/enhancements.html) | `strictfp` and assertions | Final, Notes and Executable Example |
29+
| [Java language enhancements history](https://docs.oracle.com/javase/8/docs/technotes/guides/language/enhancements.html) | `strictfp` and assertions | Final, Executable Examples |
3030
| [Java 2 platform documentation](https://docs.oracle.com/cd/E19683-01/806-7930/features-2d/index.html) | Java 2D | Final, Executable Example |
3131
| [J2SE 1.4 new features and enhancements](https://download.oracle.com/otn_hosted_doc/jdeveloper/904preview/jdk14doc/docs/relnotes/features.html) | NIO, regular expressions, XML/JAXP, integrated security APIs, logging, preferences, chained exceptions | Final, Examples and Preferences Notes |
3232
| [Oracle J2SE 5.0 new features](https://docs.oracle.com/javase/1.5.0/docs/relnotes/features.html) | Generics, enhanced for loop, autoboxing, enums, varargs, static import, annotations, concurrency utilities | Final, Example |
@@ -112,7 +112,7 @@ Java 1-7 predate the modern JEP process used elsewhere in this index. Their entr
112112
| [JEP 395](https://openjdk.org/jeps/395) | Records | Final |
113113
| [JEP 394](https://openjdk.org/jeps/394) | Pattern Matching for instanceof | Final |
114114
| [JEP 397](https://openjdk.org/jeps/397) | Sealed Classes | Second Preview |
115-
| [JEP 380](https://openjdk.org/jeps/380) | Unix-Domain Socket Channels | Final, Explanatory Module |
115+
| [JEP 380](https://openjdk.org/jeps/380) | Unix-Domain Socket Channels | Final, Executable Example |
116116
| [JEP 338](https://openjdk.org/jeps/338) | Vector API | Incubator, Notes |
117117
| [JEP 389](https://openjdk.org/jeps/389) | Foreign Linker API | Incubator, Notes |
118118
| [JEP 393](https://openjdk.org/jeps/393) | Foreign-Memory Access API | Third Incubator, Notes |
@@ -124,7 +124,7 @@ Java 1-7 predate the modern JEP process used elsewhere in this index. Their entr
124124
| [JEP 409](https://openjdk.org/jeps/409) | Sealed Classes | Final |
125125
| [JEP 406](https://openjdk.org/jeps/406) | Pattern Matching for switch | Preview |
126126
| [JEP 356](https://openjdk.org/jeps/356) | Enhanced Pseudo-Random Number Generators | Final |
127-
| [JEP 403](https://openjdk.org/jeps/403) | Strongly Encapsulate JDK Internals | Runtime, Explanatory Module |
127+
| [JEP 403](https://openjdk.org/jeps/403) | Strongly Encapsulate JDK Internals | Runtime, Executable Example |
128128

129129
## Java 18
130130

src/main/java/net/jrodolfo/java_evolution/java23/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -134,7 +134,7 @@ mvn -Dtest=FlexibleConstructorBodiesSecondPreviewNotesTest,StreamGatherersSecond
134134
mvn -Dtest=ScopedValuesThirdPreviewNotesTest,StructuredConcurrencyThirdPreviewNotesTest,UnsafeMemoryAccessDeprecationExamplesTest,ZgcGenerationalModeExamplesTest test
135135
```
136136

137-
This package is notes-heavy because many Java 23 topics are preview, runtime, or tooling features. After this package, continue with Java 24 to see stream gatherers and the Class-File API reach final status.
137+
After this package, continue with Java 24 to see Stream Gatherers and the Class-File API reach final status.
138138

139139
## References
140140

src/main/java/net/jrodolfo/java_evolution/java24/quantum_resistant_crypto/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -36,7 +36,7 @@ private key + message -> signature
3636
public key + message + signature -> valid or invalid
3737
```
3838

39-
The KEM example relates directly to the Java 21 `javax.crypto.KEM` example. Java 21 standardized the KEM API shape. Java 24 added post-quantum KEM algorithms that can use that API.
39+
The KEM example relates directly to the Java 21 [`javax.crypto.KEM` example](../../java21/key_encapsulation/README.md). Java 21 standardized the KEM API shape. Java 24 added post-quantum KEM algorithms that can use that API.
4040

4141
## Java APIs Used Here
4242

0 commit comments

Comments
 (0)