Changes
-
The
generate-manual
plugin now defaults to creating single page manuals. The--single-page
flag has been replaced with--multi-page
to restore the previous default functionality. (#472)Migration: Update scripts that invoked
generate-manual
without--single-page
to include--multi-page
and update scripts that invokedgenerate-manual
with--single-page
to omit the flag. -
The "experimental" prefix from the
generate-manual
plugin has been removed. (#475)Migration: Update scripts to invoke the
generate-manual
plugin viaswift package generate-manual
instead ofswift package plugin experimental-generate-manual
.
Fixes
- The
generate-manual
plugin is correctly declared as a product, making the plugin visible to clients. (#456) - The
generate-manual
plugin's--authors
arguments are now correctly passed to the underlying generation tool. (#471) - Manuals generated by the
generate-manual
plugin now include the option's value names and do not include value names for flags. (#473) - Built-in flags such as
--help
and--version
are now correctly marked as optional fixing some generated content which indicated the flags are always required. (#474) - Value descriptions are now correctly derived for types which are
ExpressibleByArgument
andRawRepresentable
byString
. Help menus will now display valid default values for such types. (#476)
The 1.1.4 release includes contributions from @ian-twilightcoder, @MarcoEidinger, and @rauhul. Thank you!