should YP docs host_packages_scripts have symlinks for debian?

should YP docs host_packages_scripts have symlinks for debian?

[Robert P. J. Day]

  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.

rday

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

[Quentin Schulz]

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