`--enable-inherited-docs` flag is undocumented

[apple]

`--enable-inherited-docs` flag is undocumented

[NachoSoto]

I wonder if this flag is being sent directly to Docc, but even in that case it appears that Docc isn't parsing that flag either? I can't find any references to it in the source.

[NachoSoto]

Unless the flag is generated automatically?

I suppose that's the case, but I'm still confused because there are no docs about this flag.

[theMomax]

All flags that do not receive special handling are passed through to the docc invocation. I could verify that docc received the --enable-inherited-docs as expected with a recent nightly toolchain (2022-12-15). If you can still observe the error when using this toolchain the problem is likely with swift-docc itself.

FYI, you can obtain the help for this plugin using swift package plugin generate-documentation -h. Unfortunately, it does not work when omitting the plugin subcommand. However, this issue can only be solved in SwiftPM.

[ethan-kusters]

I suppose that's the case, but I'm still confused because there are no docs about this flag.

The Swift-DocC plugin just transparently passes through the flag documentation provided by docc --help so we'll need to resolve this over there.

[d-ronnqvist]

This flag is documented in docc but the Swift-DocC plugin doesn't display all the command line option groups.

I opened a #72 to present all the command line options from DocC in the plugin's help text.