Re: [docs] should YP docs host_packages_scripts have symlinks for debian?

[Quentin Schulz <quentin.schulz@cherry.de>]

Hi Robert,

On 1/6/26 9:45 PM, Robert P. J. Day via lists.yoctoproject.org wrote:
> 
>    i noticed when updating my yocto-docs checkout and trying to build
> on debian 13 that i was missing the debian package
> python3-sphinx-copybutton. fair enough, but in the
> host_packages_scripts directory:
> 
> https://git.yoctoproject.org/yocto-docs/tree/documentation/tools/host_packages_scripts
> 
> there is no explicit debian_docs.sh script, while there are symlinks
> for other distros to cover the bases.
> 
>    would it make sense for there to be actual debian-flavoured host
> package scripts, and symlinks for debian-derived distros? so the
> debian scripts would be the *actual* scripts, and the ubuntu versions
> would be symlinks? for consistency.
> 

Well... The thing is that each separate file is included by the docs for 
the respective distro installation steps. Ubuntu and Debian share the 
same instructions so they share the same file.

The files in documentation/tools aren't really for outside consumption. 
Check from the docs directly (where the instructions would be there and 
if outdated must be updated) or use the container for building the docs 
(documentation/tools/build-docs-container <container-image> <make 
command>, which use the proper file automatically).

Cheers,
Quentin