Skip to content

merging two documentation archives failing with reports of overlapping data (Swift 6.2) #1322

@heckj

Description

@heckj

Description

Using article-only docc catalogs, I attempted to merge two archives that I created to provide a combined collection for publication with a GitHub hosting solution.

However, the docc merge command failed, reporting overlapping content.

In the example that I created to illustrate this, the report is:

Error: Input archives contain overlapping data

'anotherexample.doccarchive' and 'example.doccarchive' both contain '/data/documentation/documentation/'

So this is possibly related to #1321

Checklist

  • If possible, I've reproduced the issue using the main branch of this package.
  • This issue hasn't been addressed in an existing GitHub issue.

Expected Behavior

docc merge should generate a new, combined archive that can be presented for static hosting

Actual behavior

Error: Input archives contain overlapping data

Steps To Reproduce

git clone https://github.com/heckj/article-only-docc
cd article-only-docc
xcrun docc convert Example.docc -o example.doccarchive
xcrun docc convert AnotherExample.docc -o anotherexample.doccarchive
xcrun docc merge example.doccarchive anotherexample.doccarchive

Swift-DocC Version Information

6.2.1

Swift Compiler Version Information

Apple Swift version 6.2.1 (swiftlang-6.2.1.4.2 clang-1700.4.4.1)
Target: arm64-apple-macosx26.0
/Applications/Xcode-26.1-beta2.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/swift-help intro

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions