dev-manual: mention that "bmap-tools" is transitional package
PATCH v2 1/1 dev-manual: mention that "bmap-tools" is transitional package
For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.
---
sorry about the earlier typo in the subject line
documentation/dev-manual/bmaptool.rst +6 -0
@@ -24,6 +24,12 @@ system image files much faster. $ bitbake bmaptool-native -caddto_recipe_sysroot + - Finally, in modern Ubuntu and Debian releases, the ``bmap-tools`` + package is a transitional package; it exists solely to ensure + backward compatibility and smooth upgrades from older installations. + You can safely remove it and install the active package, ``bmaptool``, + which contains the actual utilities for flashing block images. + Following, is an example that shows how to flash a Wic image. Realize that while this example uses a Wic image, you can use `bmaptool` to flash any type of image. Use these steps to flash an image using `bmaptool`:
Hi Robert,
Quoted 15 lines · Robert P. J. Day via lists.yoctoproject.org
For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.
Signed-off-by Robert P. J. Day <[email protected]>---
sorry about the earlier typo in the subject line
documentation/dev-manual/bmaptool.rst +0
-0
documentation/dev-manual/bmaptool.rst system image files much faster. · line 32
Quoted 9 lines
documentation/dev-manual/bmaptool.rst +6
-0@@ -24,6 +24,12 @@ system image files much faster. $ bitbake bmaptool-native -caddto_recipe_sysroot + - Finally, in modern Ubuntu and Debian releases, the ``bmap-tools`` + package is a transitional package; it exists solely to ensure + backward compatibility and smooth upgrades from older installations. + You can safely remove it and install the active package, ``bmaptool``, + which contains the actual utilities for flashing block images. +
Just list this in the first bullet point which is related to Ubuntu and Debian distributions?
I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.
Note that Fedora 43+ has bmap-tools, and Leap 16+ python3-bmap-tools/python3-bmaptools.
Cheers,
Quentin
Quoted 33 lines · Quentin Schulz
Hi Robert,
Quoted 16 lines · Robert P. J. Day via lists.yoctoproject.org
For modern Debian and Ubuntu releases, mention that the "bmap-tools" package is transitional to the newer "bmaptool" package.
Signed-off-by Robert P. J. Day <[email protected]>---
sorry about the earlier typo in the subject line
documentation/dev-manual/bmaptool.rst +0
-0documentation/dev-manual/bmaptool.rst system image files much faster. · line 33
Quoted 10 lines
documentation/dev-manual/bmaptool.rst +6
-0@@ -24,6 +24,12 @@ system image files much faster. $ bitbake bmaptool-native -caddto_recipe_sysroot + - Finally, in modern Ubuntu and Debian releases, the ``bmap-tools`` + package is a transitional package; it exists solely to ensure + backward compatibility and smooth upgrades from older installations. + You can safely remove it and install the active package, ``bmaptool``, + which contains the actual utilities for flashing block images. +Just list this in the first bullet point which is related to Ubuntu and Debian distributions?
Quoted 6 lines
I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.
Note that Fedora 43+ has bmap-tools, and Leap 16+
python3-bmap-tools/python3-bmaptools.
my patch was already merged into master-next, but i like your
suggestion so if antonin thinks it's worth it, he can revert that earlier patch and i can do it your way.
rday
Quoted 1 line · Robert P. J. Day
On Fri, 19 Jun 2026, Quentin Schulz wrote:
[...]
Quoted 15 lines
Quoted 15 lines
documentation/dev-manual/bmaptool.rst system image files much faster. · line 32
Quoted 7 lines
documentation/dev-manual/bmaptool.rst +4
-0+ - Finally, in modern Ubuntu and Debian releases, the ``bmap-tools`` + package is a transitional package; it exists solely to ensure + backward compatibility and smooth upgrades from older installations. + You can safely remove it and install the active package,``bmaptool``,
documentation/dev-manual/bmaptool.rst +2
-0+ which contains the actual utilities for flashing block images. +Just list this in the first bullet point which is related to Ubuntu and Debian distributions?
I could see switching the default package to install from bmap-tools to bmaptool and add a note (Sphinx note) that on older releases, it was named bmap-tools so install that package instead.
Quoted 6 lines
Quoted 2 lines
Note that Fedora 43+ has bmap-tools, and Leap 16+
python3-bmap-tools/python3-bmaptools.my patch was already merged into master-next, but i like your
suggestion so if antonin thinks it's worth it, he can revert that earlier patch and i can do it your way.
I dropped it, I also like Quentin's suggestion.
Thanks both,
Antonin