meson/docs/markdown/snippets/deprecate_build_target_jar.md

## Deprecate 'jar' as a build_target type

The point of `build_target()` is that what is produced can be conditionally
changed. However, `jar()` has a significant number of non-overlapping arguments
from other build_targets, including the kinds of sources it can include. Because
of this crafting a `build_target` that can be used as a Jar and as something
else is incredibly hard to do. As such, it has been deprecated, and using
`jar()` directly is recommended.
interpreter: deprecate 'jar' value of build_target(target_type) Jar has a very low set of overlap with other target types, including that jar sources must be .java, and no other target allows .java sources. As such, the difficulty in crafting a useful `build_target` invocation that allows both `jar` and anything else is high, and the usefulness is dubious. Just use `jar()` directly instead. This depends on the changes to make all of the jar() specific keyword arguments be handled by typed_kwargs so that the deprecation messages are correct and consistent. 2023-07-20 04:22:20 +08:00			`## Deprecate 'jar' as a build_target type`

			The point of `build_target()` is that what is produced can be conditionally
			changed. However, `jar()` has a significant number of non-overlapping arguments
			`from other build_targets, including the kinds of sources it can include. Because`
			of this crafting a `build_target` that can be used as a Jar and as something
			`else is incredibly hard to do. As such, it has been deprecated, and using`
docs: fix typo in previous commit 2023-07-21 02:45:30 +08:00			`jar()` directly is recommended.