Remove source comments and DocC

Author: coenttb

.github/repro/cross-package/base/Package.swift

@@ -1,7 +1,5 @@
 // swift-tools-version: 6.3.3
-// Base package for the cross-package debug-info-mangler repro.
-// Provides the spec namespace root + the load-bearing namespace TYPEALIAS
-// (mirrors swift-pdf-standard's `public typealias PDF = ISO_32000`).
+
 import PackageDescription
 
 let package = Package(

.github/repro/cross-package/base/Sources/BasePDF/BasePDF.swift

@@ -1,10 +1,3 @@
-// Mirrors swift-pdf-standard's namespace shape:
-// a spec-named enum namespace re-exposed through a public typealias.
-// The typealias is a load-bearing repro ingredient: the existential
-// `any PDF.HTML.Style.Modifier` written through it carries TypeAliasType
-// sugar at the namespace root, which is what the 6.3.3 Windows (+Asserts)
-// debug-info mangler chokes on (isActuallyCanonicalOrNull, AST/Type.h:421).
-
 public enum ISO_32000 {}
 
 extension ISO_32000 {

.github/repro/cross-package/crash/Package.swift

@@ -1,10 +1,5 @@
 // swift-tools-version: 6.3.3
-// Crash package for the cross-package debug-info-mangler repro.
-// Extends the OTHER package's typealias-sugared namespace with nested
-// protocols and forms their existentials at a debug-info-emitting site
-// (mirrors swift-pdf-html-render). Cross-PACKAGE is a load-bearing
-// ingredient per swiftlang/swift#86202: the same shape cross-module
-// within one package does not crash.
+
 import PackageDescription
 
 let package = Package(

.github/repro/cross-package/crash/Sources/CrashModule/CrashModule.swift

@@ -1,18 +1,3 @@
-// Mirrors swift-pdf-html-render's crash shape at
-// PDF.HTML.Context+Rendering.swift:267/:283:
-// - `PDF` below is the OTHER package's typealias for ISO_32000
-//   (TypeAliasType sugar at the namespace root of every written type here);
-// - `HTML`/`Style`/`Style.Context` are enums extending that sugared root;
-// - `Modifier` protocols are SE-0404 nested, PLAIN (no ~Copyable, no
-//   recursion, no associated types);
-// - the existentials form via explicit `as? any …` downcasts from `Any`
-//   whose local bindings receive debug info (-Onone -g).
-//
-// Expected on Windows Swift 6.3.3 (+Asserts), `swift build -c debug`:
-//   Assertion failed: isActuallyCanonicalOrNull() &&
-//   "Forming a CanType out of a non-canonical type!", AST/Type.h:421
-//   ... While mangling type for debugger type 'any PDF.HTML.Style.Modifier'
-
 public import BasePDF
 
 extension PDF {
@@ -52,7 +37,7 @@ extension PDF.HTML {
         }
 
         public mutating func apply(inlineStyle property: Any) -> Bool {
-            // Unwrap Optional if needed (mirrors the production dataflow).
+
             let unwrapped: Any
             let mirror = Mirror(reflecting: property)
             if mirror.displayStyle == .optional {

.github/repro/cross-package/crash/Sources/RespellModule/RespellModule.swift

@@ -1,12 +1,3 @@
-// A″ fix-shape validation: IDENTICAL to CrashModule except the two
-// existential downcasts (and only those) are respelled through the
-// CANONICAL namespace root `ISO_32000` instead of the `PDF` typealias.
-// Declarations still extend via the `PDF` alias (declaration parity with
-// production). If this target is CLEAN on Windows 6.3.3 while CrashModule
-// fires, the typealias sugar in the WRITTEN type at the downcast site is
-// the trigger, and the production fix is a one-token respell at
-// PDF.HTML.Context+Rendering.swift:267/:283.
-
 public import BasePDF
 
 extension PDF {
@@ -57,7 +48,6 @@ extension PDF.HTML {
 
             var handled = false
 
-            // Canonical-root spelling — the only difference from CrashModule.
             if let modifier = unwrapped as? any ISO_32000.HTML.Style.Modifier {
                 modifier.apply(to: &pdf, configuration: configuration)
                 handled = true

.github/repro/noncanonical-existential-debuginfo.swift

@@ -1,23 +1,3 @@
-// Minimal reproducer — Swift 6.3.3 Windows (+Asserts) debug-info-mangler ICE
-// on a plain nested-namespace protocol existential.
-//
-// Classification: ICE (assertion) during IRGen debug-info type mangling.
-// Environment:    Windows (windows-msvc), Swift 6.3.3 (+Asserts), -Onone -g.
-//                 macOS toolchains are non-asserts; the assertion cannot fire there.
-// Command:        swiftc -Onone -g -c noncanonical-existential-debuginfo.swift -o repro.o
-// Observed:       Assertion failed: isActuallyCanonicalOrNull() &&
-//                 "Forming a CanType out of a non-canonical type!", AST/Type.h:421
-//                 while mangling debugger type 'any PDF.HTML.Style.Modifier'.
-// Expected:       Clean compile.
-//
-// Shape mirrored from swift-pdf-html-render's PDF.HTML.Context.apply(inlineStyle:)
-// (PDF.HTML.Context+Rendering.swift:267/:283): SE-0404 protocols nested in a
-// three-level enum namespace, an `Any` value unwrapped via Mirror, then explicit
-// `as? any …Modifier` downcasts whose local bindings receive debug info. The
-// protocols are PLAIN — no ~Copyable, no recursion, no associated types.
-//
-// TRACKING: swift-institute/Issues — swift-issue-noncanonical-existential-windows-debuginfo-ice
-
 public enum PDF {
     public enum HTML {
         public enum Style {
@@ -58,7 +38,7 @@ extension PDF.HTML {
         public init() {}
 
         public mutating func apply(inlineStyle property: Any) -> Bool {
-            // Unwrap Optional if needed (mirrors the production dataflow).
+
             let unwrapped: Any
             let mirror = Mirror(reflecting: property)
             if mirror.displayStyle == .optional {

.gitignore

@@ -21,7 +21,6 @@
 /Sources/**
 !/Sources/**/
 !/Sources/**/*.swift
-!/Sources/**/*.docc/**
 /Tests/**
 !/Tests/**/
 !/Tests/**/*.swift

Sources/PDF/PDF.docc/PDF.md

@@ -1,5 +1,3 @@
-// exports.swift
-
 @_exported public import File_System
 @_exported public import HTML
 @_exported public import Kernel

Sources/PDF/exports.swift

@@ -1,5 +1,3 @@
-// PDF Tests.swift
-
 import Foundation
 import PDF
 import Testing
@@ -10,8 +8,6 @@ extension PDF {
     }
 }
 
-// MARK: - Markdown to PDF Tests
-
 extension PDF.Test.Unit {
     @Suite
     struct `Markdown to PDF` {