Added hyperlinks to normal sections

This commit is contained in:
Kyler Olsen 2025-10-28 00:51:14 -06:00
parent e267b9ddde
commit 140106bc9e
9 changed files with 23 additions and 23 deletions

View File

@ -107,6 +107,6 @@ The standard library provides I/O, string operations, type conversions, and util
- Combinators: `map`, `filter`, `reduce`, `each`
- Manipulation: `concat`, `reverse`, `transpose`, `window`
> **Complete Reference**: See Appendix A for the full standard library reference with all functions, signatures, and examples.
> **Complete Reference**: See [Appendix A](./standard_library.html) for the full standard library reference with all functions, signatures, and examples.
---

View File

@ -36,7 +36,7 @@ roll // ( n times -- ) Rotate n items, times times
1 2 3 depth // => 1 2 3 3
```
> **Implementation Details**: Stack operations implement the `::Stackable` trait. See Appendix B for the complete trait definition.
> **Implementation Details**: Stack operations implement the `::Stackable` trait. See [Appendix B](./complete_trait_reference.html) for the complete trait definition.
### 4.2 Arithmetic Operators
@ -61,7 +61,7 @@ Basic arithmetic operations work on numeric types:
2 10 ^ // => 1024
```
> **Implementation Details**: Arithmetic operators implement the `::Addable`, `::Multiplyable`, `::Exponentiable`, and `::Logarithmic` traits. See Appendix B for complete trait definitions and Appendix C for the full operator reference.
> **Implementation Details**: Arithmetic operators implement the `::Addable`, `::Multiplyable`, `::Exponentiable`, and `::Logarithmic` traits. See [Appendix B](./complete_trait_reference.html) for complete trait definitions and [Appendix C](./complete_operator_reference.html) for the full operator reference.
### 4.3 Comparison Operators
@ -83,7 +83,7 @@ Comparison operations return boolean values:
10 5 < // => false
```
> **Implementation Details**: Comparison operators implement the `::Orderable` and `::Equatable` traits. See Appendix B for complete trait definitions.
> **Implementation Details**: Comparison operators implement the `::Orderable` and `::Equatable` traits. See [Appendix B](./complete_trait_reference.html) for complete trait definitions.
### 4.4 Logical Operators
@ -105,7 +105,7 @@ false not // => true
5 0 and // => 0 (falsy)
```
> **Implementation Details**: Logical operators implement the `::Logical` trait. See Appendix B for the complete trait definition and truthiness rules.
> **Implementation Details**: Logical operators implement the `::Logical` trait. See [Appendix B](./complete_trait_reference.html) for the complete trait definition and truthiness rules.
### 4.5 Bitwise Operators
@ -128,6 +128,6 @@ Bitwise operations work on integer types:
4 2 shl // => 16
```
> **Implementation Details**: Bitwise operators implement the `::Bitwise` trait. See Appendix B for the complete trait definition.
> **Implementation Details**: Bitwise operators implement the `::Bitwise` trait. See [Appendix B](./complete_trait_reference.html) for the complete trait definition.
---

View File

@ -45,7 +45,7 @@ point ::x get // Get x field (consumes point and ::x)
point dup ::x get 2 * over ::y get + // (point.x * 2) + point.y
```
> **Note**: Structs can be generic. See Section 10.3 for details on generic data structures.
> **Note**: Structs can be generic. See [Section 10.3](./generic_programming.html#103-generic-data-structures) for details on generic data structures.
### 7.2 Unions
@ -74,9 +74,9 @@ Option::None // Creates Option::None
"error" Result::Err // Creates Result::Err("error")
```
**Pattern Matching**: Unions are typically used with pattern matching (Section 6.5) to handle different variants.
**Pattern Matching**: Unions are typically used with pattern matching ([Section 6.5](./control_flow.html#65-pattern-matching)) to handle different variants.
> **Note**: Unions can be generic. See Section 10.3 for details on generic data structures.
> **Note**: Unions can be generic. See [Section 10.3](./generic_programming.html#103-generic-data-structures) for details on generic data structures.
### 7.3 Enums
@ -151,6 +151,6 @@ These operations take TokenString arguments containing function bodies:
[1 2 3 4] 2 window // Sliding window: [[1 2] [2 3] [3 4]]
```
> **Implementation Details**: Array operations implement various traits including `::ArrayOf<T>`, `::Selectable<T>`, `::Sliceable`, and `::Sized`. See Appendix B for complete trait definitions and Appendix A for the full array operation reference.
> **Implementation Details**: Array operations implement various traits including `::ArrayOf<T>`, `::Selectable<T>`, `::Sliceable`, and `::Sized`. See [Appendix B](./complete_trait_reference.html) for complete trait definitions and [Appendix A](./standard_library.html) for the full array operation reference.
---

View File

@ -15,7 +15,7 @@ Functions differ from operators:
- **Functions** are user-defined procedures that use operators
- Operators and functions cannot share names
> **Related**: See Section 1 "Operators vs Functions" for a complete explanation of the distinction.
> **Related**: See [Section 1 "Operators vs Functions"](./overview.html#operators-vs-functions) for a complete explanation of the distinction.
### 5.2 Defining Functions
@ -39,9 +39,9 @@ The function signature specifies stack effects (what is consumed and produced),
10 3 divmod // => 3 1 (quotient remainder)
```
**Function Bodies**: The `{ }` braces contain a TokenString that is parsed as the function body when the function is defined. See Section 5.5 for details on TokenStrings.
**Function Bodies**: The `{ }` braces contain a TokenString that is parsed as the function body when the function is defined. See [Section 5.5](./functions.html#55-token-strings) for details on TokenStrings.
> **Related**: See Section 10.2 for generic functions with type parameters.
> **Related**: See [Section 10.2](./generic_programming.html#102-generic-functions) for generic functions with type parameters.
### 5.3 Calling Functions
@ -133,6 +133,6 @@ The `lambda` operator converts a TokenString into a callable code block that can
[1 2 3 4] double map // => [2 4 6 8]
```
> **Related**: See Section 11.1 for the `eval` operator used to execute lambdas.
> **Related**: See [Section 11.1](advanced_topics.html#111-dynamic-code-evaluation) for the `eval` operator used to execute lambdas.
---

View File

@ -173,6 +173,6 @@ When inheriting from generic traits, you must either:
(Multiplyable -- Multiplyable) { dup * } ::square fn
```
> **Future Enhancement**: See Appendix F for planned type parameter enforcement at parse time.
> **Future Enhancement**: See [Appendix F](./memory_management.html) for planned type parameter enforcement at parse time.
---

View File

@ -24,7 +24,7 @@ Next: Primitive Types
- Example: `::Addable` pushes the identifier `Addable` onto the stack
- Example: `::Point` pushes the identifier `Point` onto the stack
> **Advanced Usage**: See Section 11.2 for complete identifier literal rules and context-dependent behavior.
> **Advanced Usage**: See [Section 11.2](./advanced_topics.html#112-identifier-literals) for complete identifier literal rules and context-dependent behavior.
### 2.3 Literals

View File

@ -32,7 +32,7 @@ You can explicitly annotate literal types:
**Pointer Types**
Raw pointers (`ptr`) are a future feature. See Appendix F for the planned pointer type system.
Raw pointers (`ptr`) are a future feature. See [Appendix F](./memory_management.html) for the planned pointer type system.
> **Related**: See Section 8 for the complete type system, including composite types and type inference.

View File

@ -27,7 +27,7 @@ The language provides many built-in traits:
- `::Number` - Composite numeric operations
- And many more...
> **Complete Reference**: See Appendix B for all standard trait definitions with complete documentation.
> **Complete Reference**: See [Appendix B](./complete_trait_reference.html) for all standard trait definitions with complete documentation.
### 9.2 Defining Traits
@ -95,7 +95,7 @@ Traits can have methods or be empty (marker traits). Empty traits are typically
} ::Rectangle impl
```
> **More Examples**: See Appendix G for complete implementation examples and tutorials.
> **More Examples**: See [Appendix G](./examples_and_tutorials.html) for complete implementation examples and tutorials.
### 9.4 Trait Inheritance
@ -171,7 +171,7 @@ Traits can be used as type constraints in function signatures:
### 9.6 Standard Traits Overview
This section provides a brief overview of all standard traits. For complete definitions with all methods and documentation, see Appendix B.
This section provides a brief overview of all standard traits. For complete definitions with all methods and documentation, see [Appendix B](./complete_trait_reference.html).
**Stack Operations**:
- `::Stackable` - Fundamental stack manipulation (dup, drop, swap, over, rot, pick, roll, depth)
@ -213,6 +213,6 @@ This section provides a brief overview of all standard traits. For complete defi
- `::Identifier` - Marks identifiers
- `::Implementable` - Meta-trait for defining language constructs (trait, impl, inher)
> **Complete Reference**: See Appendix B for full trait definitions with all methods, examples, and implementation details.
> **Complete Reference**: See [Appendix B](./complete_trait_reference.html) for full trait definitions with all methods, examples, and implementation details.
---

View File

@ -51,7 +51,7 @@ The language distinguishes between types (what things are) and traits (how thing
} ::Point impl
```
> **Related**: See Section 9 for the complete trait system and Appendix B for all standard trait definitions.
> **Related**: See [Section 9](trait_system.html) for the complete trait system and [Appendix B](./complete_trait_reference.html) for all standard trait definitions.
### 8.2 Type Inference
@ -86,7 +86,7 @@ parse // May need type context to know what to parse to
"hello" identity // T inferred as String
```
> **Related**: See Section 10 for generic programming and type parameter inference.
> **Related**: See [Section 10](./generic_programming.html) for generic programming and type parameter inference.
### 8.3 Type Tuples