From b359f0ac4ef16f90256c1f8c1467022fee8110cd Mon Sep 17 00:00:00 2001 From: s3cody Date: Tue, 21 Jul 2026 09:05:37 +0000 Subject: [PATCH] docs: clarify supported delta patch format --- docs/packaging/deltas.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/docs/packaging/deltas.mdx b/docs/packaging/deltas.mdx index 5440c7b..6c71b1e 100644 --- a/docs/packaging/deltas.mdx +++ b/docs/packaging/deltas.mdx @@ -10,6 +10,8 @@ If you don't have the latest local release, eg. you're running in CI, you can us Delta packages use [Zstandard](https://github.com/facebook/zstd) to create binary patches of individual files in your package. Due to limitations of Zstandard, no single file can be bigger than 2 GB. +Zstandard (`.zsdiff`) is the only supported non-empty patch format. If Velopack cannot create a Zstandard patch, delta generation fails instead of producing a delta that clients cannot apply. Legacy `.bsdiff` and MSDelta patches are not supported and fail during patching with an `Unsupported patch format` error; publish a full package or regenerate the delta with a current version of `vpk`. + ## Optimising for size The default parameters picked for patch generation are to provide a good balance of size and speed. If you would like to optimize for size, you can do this with the `--delta BestSize` argument.