<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://bugzilla.yoctoproject.org/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.6"
          urlbase="https://bugzilla.yoctoproject.org/"
          
          maintainer="it-coreprojects-helpdesk@linuxfoundation.org"
>

    <bug>
          <bug_id>15834</bug_id>
          
          <creation_ts>2025-04-17 07:18:47 +0000</creation_ts>
          <short_desc>Building documentation from a release tarball fails</short_desc>
          <delta_ts>2026-02-13 09:14:47 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>9</classification_id>
          <classification>Documentation</classification>
          <product>General Docs</product>
          <component>docs-general</component>
          <version>unspecified</version>
          <rep_platform>x86</rep_platform>
          <op_sys>Multiple</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords></keywords>
          <priority>Medium</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>6.0 M4</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Antonin Godard">antonin.godard</reporter>
          <assigned_to name="Antonin Godard">antonin.godard</assigned_to>
          
          
          
          <cf_os>---</cf_os>
          <cf_regression_type>---</cf_regression_type>
          
          <cf_docchange>Yes (doc changes required)</cf_docchange>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>101663</commentid>
    <comment_count>0</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-04-17 07:18:47 +0000</bug_when>
    <thetext>When building from a release tarball (for example from https://downloads.yoctoproject.org/releases/yocto/yocto-5.1/poky-8f01ae5c7cba251ed25c80f0141a950ebc8a5f73.tar.bz2), going in poky/documentation and running `make html` prints:

  ./set_versions.py
  Please run &apos;git fetch --tags&apos; before building the documentation
  make: *** [Makefile:72: html] Error 1

Because our build scripts rely on Git to build the documentation.

NB: The bitbake documentation does not have that problem.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>101671</commentid>
    <comment_count>1</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2025-04-17 14:49:20 +0000</bug_when>
    <thetext>After triage meeting we decided to not support building the docs from tarballs, but make the build print a message saying we don&apos;t support building without a Git repo.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>104289</commentid>
    <comment_count>2</comment_count>
    <who name="Antonin Godard">antonin.godard</who>
    <bug_when>2026-02-13 09:14:47 +0000</bug_when>
    <thetext>We now explicitly say that we don&apos;t support building without Git:
https://git.yoctoproject.org/yocto-docs/commit/?id=f40dc0b42e5e66c5b4618063f8fea72e9f8e4d7c

Moving to Resolved Fixed.</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>