docs: add package.{extra-patches,cargo-toml-patch-comments} settings

This commit is contained in:
Fabio Valentini 2024-03-08 15:56:24 +01:00
parent d5fd8f9517
commit 8b378c5b0e
No known key found for this signature in database
GPG key ID: 5AC5F572E5D410AF

View file

@ -46,17 +46,20 @@ This table contains settings that affect RPM metadata.
generated if there are any "bin" (or "cdylib") targets. The default is to generated if there are any "bin" (or "cdylib") targets. The default is to
fall back to the name of the current crate ("%{crate}"). fall back to the name of the current crate ("%{crate}").
*cargo-install-bin*::
This setting controls whether binary targets are installed by the
%cargo_install macro. Setting "false" for this key causes "bin" targets not
to be installed to %{_bindir} even if a "bin" target is auto-detected or the
crate defines any "bin" target explicitly. The default value is "true".
*cargo-install-lib*:: *cargo-install-lib*::
This setting controls whether library sources are installed by the This setting controls whether library sources are installed by the
%cargo_install macro. Setting "false" for this key causes crate sources not %cargo_install macro. Setting "false" for this key causes crate sources not
to be installed to %{crate_instdir} even if a library target is auto-detected to be installed to %{crate_instdir} even if a library target is auto-detected
or the crate defines a [lib] target explicitly. The default value is "true". or the crate defines a [lib] target explicitly. The default value is "true".
*cargo-install-bin*:: *cargo-toml-patch-comments*::
This setting controls whether binary targets are installed by the This setting allows persisting comments that are associated with manually created patches for Cargo.toml (i.e. by running "rust2rpm -p"). The setting accepts a list of strings. Elements of the array are treated as individual comments, and individual comments are formatted and line-wrapped to 80 characters.
%cargo_install macro. Setting "false" for this key causes "bin" targets not
to be installed to %{_bindir} even if a "bin" target is auto-detected or the
crate defines any "bin" target explicitly. The default value is "true".
*extra-sources*:: *extra-sources*::
This setting can be used to specify additional Sources to be included in the This setting can be used to specify additional Sources to be included in the
@ -64,8 +67,10 @@ This table contains settings that affect RPM metadata.
with three properties - "number", "file", and "comments". The integer "number" with three properties - "number", "file", and "comments". The integer "number"
is used to set a predictable number of the Source file in the spec, the "file" is used to set a predictable number of the Source file in the spec, the "file"
is expected to be a string that contains an URL or a plain file name, and is expected to be a string that contains an URL or a plain file name, and
"comments" is an array of strings which are prepended to the Source line as "comments" is an array of strings that are formatted in the same way as the "cargo-toml-patch-comments" setting.
comment lines.
*extra-patches*::
This setting is similar to "extra-sources" but allows specifying additional Patch files instead of Source files.
*extra-files*:: *extra-files*::
This setting allows injecting additional files into the "%files" section of This setting allows injecting additional files into the "%files" section of