You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
When the Swift toolchain is installed to / or /usr/libexec (as is done with Debian and Fedora distributions), the docc binary throws a permissions issue when attempting to preview or generate documentation:
However, if the Swift toolchain and docc are installed to a directory under the user, like in the user's home directory or via Swiftly, then it works perfectly fine:
xtremek@Winter ~/t/swift-async-algorithms (main)> ls -la $(which docc)
lrwxrwxrwx 1 xtremek xtremek 32 Jan 4 15:36 ~/.local/bin/docc -> ~/.local/bin/swiftly*
xtremek@Winter ~/t/swift-async-algorithms (main)> ~/.local/bin/docc preview
Input: ~/tmp/swift-async-algorithms
Template: ~/.local/share/swiftly/toolchains/6.0.3/usr/share/docc/render
========================================
Starting Local Preview Server
Address: http://localhost:8080/documentation/validation
========================================
Any ideas why this happens? It makes it impossible to have Swift installed to the system and then use docc to preview and generate documentation, for example in a CI environment...
Checklist
If possible, I've reproduced the issue using the main branch of this package.
Description
When the Swift toolchain is installed to
/
or/usr/libexec
(as is done with Debian and Fedora distributions), thedocc
binary throws a permissions issue when attempting to preview or generate documentation:However, if the Swift toolchain and
docc
are installed to a directory under the user, like in the user's home directory or via Swiftly, then it works perfectly fine:Any ideas why this happens? It makes it impossible to have Swift installed to the system and then use docc to preview and generate documentation, for example in a CI environment...
Checklist
main
branch of this package.Expected Behavior
Running
docc convert
ordocc preview
when the Swift toolchain is installed to a system directory withroot
permissions works.Actual behavior
Running
docc convert
ordocc preview
when the Swift toolchain is installed to a system directory withroot
permissions throws a permissions error:Error: Error Domain=NSCocoaErrorDomain Code=513 "You don’t have permission."
Steps To Reproduce
docc preview
from the system directory.Swift-DocC Version Information
Swift 6.0.3 Release
Swift Compiler Version Information
The text was updated successfully, but these errors were encountered: