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` - Combinators: `map`, `filter`, `reduce`, `each`
- Manipulation: `concat`, `reverse`, `transpose`, `window` - 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 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 ### 4.2 Arithmetic Operators
@ -61,7 +61,7 @@ Basic arithmetic operations work on numeric types:
2 10 ^ // => 1024 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 ### 4.3 Comparison Operators
@ -83,7 +83,7 @@ Comparison operations return boolean values:
10 5 < // => false 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 ### 4.4 Logical Operators
@ -105,7 +105,7 @@ false not // => true
5 0 and // => 0 (falsy) 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 ### 4.5 Bitwise Operators
@ -128,6 +128,6 @@ Bitwise operations work on integer types:
4 2 shl // => 16 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 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 ### 7.2 Unions
@ -74,9 +74,9 @@ Option::None // Creates Option::None
"error" Result::Err // Creates Result::Err("error") "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 ### 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]] [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 - **Functions** are user-defined procedures that use operators
- Operators and functions cannot share names - 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 ### 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) 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 ### 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] [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 (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: `::Addable` pushes the identifier `Addable` onto the stack
- Example: `::Point` pushes the identifier `Point` 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 ### 2.3 Literals

View File

@ -32,7 +32,7 @@ You can explicitly annotate literal types:
**Pointer 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. > **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 - `::Number` - Composite numeric operations
- And many more... - 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 ### 9.2 Defining Traits
@ -95,7 +95,7 @@ Traits can have methods or be empty (marker traits). Empty traits are typically
} ::Rectangle impl } ::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 ### 9.4 Trait Inheritance
@ -171,7 +171,7 @@ Traits can be used as type constraints in function signatures:
### 9.6 Standard Traits Overview ### 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**: **Stack Operations**:
- `::Stackable` - Fundamental stack manipulation (dup, drop, swap, over, rot, pick, roll, depth) - `::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 - `::Identifier` - Marks identifiers
- `::Implementable` - Meta-trait for defining language constructs (trait, impl, inher) - `::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 } ::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 ### 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 "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 ### 8.3 Type Tuples