add /TextBuffer to disambiguate links to other package

Author: DivineDominion

Sources/DeclarativeTextKit/Documentation.docc/Documentation.md

@@ -48,18 +48,9 @@ If the affected text buffer supports undo/redo (like the default text views do),
 
 ### Buffers
 
-A `Buffer` is an abstraction of textual content and a selection. Its ``Buffer/evaluate(_:)-7jmtt`` is the simplest entry point to the DSL.
+While a ``/TextBuffer/Buffer``  is an abstraction of textual content and a selection, a `ModifiableBuffer` offers declarative modifications. Its ``ModifiableBuffer/evaluate(_:)-44ndq`` is the simplest entry point to the DSL.
 
-- ``Buffer``
-- ``InMemoryBuffer``
-- ``MutableStringBuffer``
-- ``Undoable``
-
-### Platform-Specific Buffer Adapters
-
-Text Kit's text views behave as buffers, but offer a much wider surface API to perform layout and typesetting. Opposed to these, a `Buffer` is a lightweight API to perform changes like a user would in an interactive text view, which we expose as adapters.
-
-- ``NSTextViewBuffer``
+- ``ModifiableBuffer``
 
 ### Buffer Mutations in the Domain-Specific Language
 

Sources/DeclarativeTextKit/Documentation.docc/Runtime.md

@@ -16,7 +16,7 @@ try buffer.evaluate {
 }
 ```
 
-1. ``Buffer/evaluate(_:)-7jmtt`` is called
+1. ``/TextBuffer/Buffer/evaluate(_:)-7jmtt`` is called
 2. the ``ModificationBuilder``-annotated block is executed:
     1. ``Identity/init()`` is called to create the value,
     2. ``ModificationBuilder/buildPartialBlock(first:)-6xgr4`` is called with the ``Identity`` value as a parameter -- that's the overload that takes a `some ModificationSequence.Element`.

Sources/DeclarativeTextKit/Expression/If.swift

@@ -6,7 +6,7 @@ import TextBuffer
 ///
 /// ## Motivation for an ``If`` type in spite of Swift Result Builder's capabilities
 ///
-/// If you think of ``Buffer/evaluate(_:)-7jmtt`` as the "run time", Swift Result Builder's `buildOptional` and `buildEither` check their condition at "compile time". That means you cannot form conditions on ``AffectedRange``.
+/// If you think of ``/TextBuffer/Buffer/evaluate(_:)-7jmtt`` as the "run time", Swift Result Builder's `buildOptional` and `buildEither` check their condition at "compile time". That means you cannot form conditions on ``AffectedRange``.
 ///
 /// This is a confusing limitation, and brings with it potentially dangerous (as in: crashing) situations.
 ///

Sources/DeclarativeTextKit/Expression/IfLet.swift

@@ -8,7 +8,7 @@ import TextBuffer
 ///
 /// ## Motivation for an ``IfLet`` type in spite of Swift Result Builder's capabilities
 ///
-/// If you think of ``Buffer/evaluate(_:)-7jmtt`` as the "run time", Swift Result Builder's `buildOptional` and `buildEither` check their condition at "compile time". That means you cannot form conditions on ``AffectedRange``.
+/// If you think of ``/TextBuffer/Buffer/evaluate(_:)-7jmtt`` as the "run time", Swift Result Builder's `buildOptional` and `buildEither` check their condition at "compile time". That means you cannot form conditions on ``AffectedRange``.
 ///
 /// This is a confusing limitation, and brings with it potentially dangerous (as in: crashing) situations.
 ///

Sources/DeclarativeTextKit/Expression/Modification/Insert/Insert.swift

@@ -2,7 +2,7 @@
 
 import TextBuffer
 
-/// Represents insertion of text into a ``Buffer``.
+/// Represents insertion of text into a ``/TextBuffer/Buffer``.
 ///
 /// ## Inserting in Multiple Locations at Once
 ///

Sources/DeclarativeTextKit/Expression/Modification/Insert/Insertable.swift

@@ -2,7 +2,7 @@
 
 import TextBuffer
 
-/// Inserts itself into a ``Buffer`` at time of evaluation.
+/// Inserts itself into a ``/TextBuffer/Buffer`` at time of evaluation.
 public protocol Insertable {
     func insert(
         in buffer: Buffer,

Sources/DeclarativeTextKit/Expression/Modification/Insert/Line.swift

@@ -11,7 +11,7 @@ public struct Line: Insertable {
 
     public let content: Buffer.Content
 
-    /// Whether to insert a newline at the end of a ``Buffer``.
+    /// Whether to insert a newline at the end of a ``/TextBuffer/Buffer``.
     ///
     /// For whole text documents, this will ensure that the document's last character is a newline.
     public let insertFinalNewline: Bool = true
@@ -59,7 +59,7 @@ public struct Line: Insertable {
 extension Line {
     /// Ensures its ``content`` is prepended by newline characters (left).
     ///
-    /// At the ``Buffer``'s zero location or start position, does not prepend a newline.
+    /// At the ``/TextBuffer/Buffer``'s zero location or start position, does not prepend a newline.
     public struct StartsWithNewlineIfNeeded: Insertable {
         public let content: Buffer.Content
 
@@ -92,11 +92,11 @@ extension Line {
 
     /// Ensures its ``content`` is appended by a newline characters (right).
     ///
-    /// At the ``Buffer``'s end position, appends a newline if ``insertFinalNewline`` is `true` so that documents end with a line break.
+    /// At the ``/TextBuffer/Buffer``'s end position, appends a newline if ``insertFinalNewline`` is `true` so that documents end with a line break.
     public struct EndsWithNewlineIfNeeded: Insertable {
         public let content: Buffer.Content
 
-        /// Whether to insert a newline at the end of a ``Buffer``.
+        /// Whether to insert a newline at the end of a ``/TextBuffer/Buffer``.
         ///
         /// For whole text documents, this will ensure that the document's last character is a newline.
         public let insertFinalNewline: Bool = true

Sources/DeclarativeTextKit/Expression/Modification/Insert/Word.swift

@@ -4,7 +4,7 @@ import TextBuffer
 
 /// Ensures its ``content`` is enclosed by space characters left and right upon insertion, otherwise inserting a ``Word/space`` character as separator where needed.
 ///
-/// Does not insert a space at the ``Buffer``'s zero location (or start position), nor at its end.
+/// Does not insert a space at the ``/TextBuffer/Buffer``'s zero location (or start position), nor at its end.
 public struct Word: Insertable {
     /// Space character inserted around ``content`` as needed.
     public static let space: Buffer.Content = " "
@@ -54,7 +54,7 @@ extension Word {
 
     /// Ensures its ``content`` is preceded by any whitespace characters (to the left), otherwise inserting a ``Word/space`` character.
     ///
-    /// At the ``Buffer``'s zero location or start position, does not prepend a space.
+    /// At the ``/TextBuffer/Buffer``'s zero location or start position, does not prepend a space.
     public struct StartsWithSpaceIfNeeded: Insertable {
         public let content: Buffer.Content
 
@@ -87,7 +87,7 @@ extension Word {
 
     /// Ensures its ``content`` is followed by any whitespace characters (to the right), otherwise inserting a ``Word/space`` character.    ///
     ///
-    /// At the ``Buffer``'s end position, does not append a space.
+    /// At the ``/TextBuffer/Buffer``'s end position, does not append a space.
     public struct EndsWithSpaceIfNeeded: Insertable {
         public let content: Buffer.Content
 

Sources/DeclarativeTextKit/Expression/Modification/Modifying.swift

@@ -2,10 +2,10 @@
 
 import TextBuffer
 
-/// Marks a ``Buffer/Range`` as to-be-modified in a range. Depending on the buffer a modification group is applied to, supports grouping of actions like undo, automatic text layout, and ensures that the underlying buffer is editable.
+/// Marks a ``/TextBuffer/Buffer/Range`` as to-be-modified in a range. Depending on the buffer a modification group is applied to, supports grouping of actions like undo, automatic text layout, and ensures that the underlying buffer is editable.
 ///
-/// - For undo support, see ``Undoable``.
-/// - For AppKit-compatible `NSTextViewDelegate` calls (that can prevent changes within the range), see ``NSTextViewBuffer``.
+/// - For undo support, see ``/TextBuffer/Undoable``.
+/// - For AppKit-compatible `NSTextViewDelegate` calls (that can prevent changes within the range), see ``/TextBuffer/NSTextViewBuffer``.
 ///
 /// You use ``Modifying`` to combine and group either
 /// - multiple ``Modification``s  like ``Insert`` and ``Delete`` at multiple locations into one block,

Sources/DeclarativeTextKit/Expression/Modification/ScopedBufferSlice.swift

@@ -2,7 +2,7 @@
 
 import TextBuffer
 
-/// View into a ``Buffer`` that ensures all read and write operations work on the scoped subrange.
+/// View into a ``/TextBuffer/Buffer`` that ensures all read and write operations work on the scoped subrange.
 ///
 /// > Note: Range finders like ``lineRange(for:)`` and ``wordRange(for:)`` are limiting the input to the scoped subrange as well, but the result may exceed the scoped range and extend to content from the base buffer. This ensures that ``Select`` as a terminal command with a scope of ``LineRange`` or ``WordRange`` work as expected.
 @usableFromInline
@@ -27,7 +27,7 @@ where Base: Buffer {
 
     private(set) var scopedRange: Base.Range
 
-    /// - Throws: ``BufferAccessFailure`` if `scopedRange` is outside of `base.range`
+    /// - Throws: ``/TextBuffer/BufferAccessFailure`` if `scopedRange` is outside of `base.range`
     @usableFromInline
     init(
         base: Base,
@@ -153,7 +153,7 @@ where Base: Buffer {
         return try base.modifying(affectedRange: scopedRange, block)
     }
 
-    // Specialized overload required to avoid stack overflow from infinitely calling ``Buffer``'s implementation from its protocol extension.
+    // Specialized overload required to avoid stack overflow from infinitely calling ``/TextBuffer/Buffer``'s implementation from its protocol extension.
     @discardableResult
     @usableFromInline
     func evaluate(