Skip to content

Cross-file reference anchor mismatches #54

@lefticus

Description

@lefticus

Problem

Internal link definitions point to anchors that don't exist in the files, causing broken cross-references. These appear to be cross-file references that were incorrectly defined as internal references.

Affected Files and Broken References

temp.md (3 broken references)

1. term.incomplete.type (lines 7757, used at lines 951, 4949)

  • Defined as: [term.incomplete.type]: #term.incomplete.type
  • But anchor <a id="term.incomplete.type"> does NOT exist in temp.md
  • Should likely point to intro.md or basic.md

2. term.odr.use (line 7758, used at lines 5058, 7795)

  • Defined as: [term.odr.use]: #term.odr.use
  • But anchor <a id="term.odr.use"> does NOT exist in temp.md
  • Should likely point to basic.md

3. implimits (line 7690, used at line 5214)

  • Defined as: [implimits]: #implimits
  • But anchor <a id="implimits"> does NOT exist in temp.md
  • Should point to implementation limits section (likely support.md or intro.md)

strings.md (4 broken references)

1. char.traits.req (line 4063, used at line 41)

  • Defined as: [char.traits.req]: #char.traits.req
  • But the actual anchor in strings.md is: <a id="char.traits.require"> (line 39)
  • Mismatch: .req vs .require

2. string.view.compare (line 4093, used at line 819)

  • Defined as: [string.view.compare]: #string.view.compare
  • But anchor <a id="string.view.compare"> does NOT exist in strings.md
  • Section may have different name or be in different file

3. string.view.comparison.overloads (line 4094, used at line 1051)

  • Defined as: [string.view.comparison.overloads]: #string.view.comparison.overloads
  • But anchor does NOT exist in strings.md

4. strings.summary (line 4096, used at line 12)

  • Defined as: [strings.summary]: #strings.summary
  • But anchor does NOT exist in strings.md
  • Should likely be in a different file or different section name

Impact

Major - Broken internal links make navigation difficult. Users clicking these references will get "not found" errors or jump to wrong locations. This affects usability significantly.

Fix Required

  1. For temp.md: Update link definitions to point to correct files:

    • [term.incomplete.type]: basic.md#term.incomplete.type
    • [term.odr.use]: basic.md#term.odr.use
    • [implimits]: support.md#implimits (or wherever it actually is)
  2. For strings.md:

    • Fix char.traits.reqchar.traits.require
    • Identify correct file/anchor for string.view.compare
    • Identify correct file/anchor for string.view.comparison.overloads
    • Identify correct file/anchor for strings.summary

This likely requires improvements to label_indexer.py to properly track which file defines each label.

Metadata

Metadata

Assignees

No one assigned

    Labels

    cross-referencesCross-reference and linking issuesmajorMajor priority issue

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions