@RintaroYamada The generate-docc-reference isn't Swift Argument Parser (SAP) 1.5.0; it's only in the SAP main branch.

I just merged a new PR into main that uses SAP's main branch, so please update your fork's main & pull that into your local main.

Then the following command line should work:

swift package --allow-writing-to-package-directory generate-docc-reference

The goal is to move all the command documentation from the README.md into the Swift files under Sources/mas/Commands in the appropriate SAP constructs (in CommandConfiguration or in attributes like @Argument).

Probably best to transfer the documentation as is from README.md to the appropriate places in Swift files, then redo the documentation if it's out of date, then rewrite the documentation to make it better, if necessary. Research what fields are used to generate the docs. I assume CommandConfiguration(abstract:) & the @Argument(help:) (the latter might require using ArgumentHelp(…)).

Let me know if you have other issues.

Thanks.

Generate web documentation with SAP #866

Description

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions