Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Fix pull-request.yml build errors by addressing Sphinx warnings and adding missing label definition #508

Merged
merged 3 commits into from
Feb 21, 2025

Conversation

cgturner1
Copy link
Contributor

@cgturner1 cgturner1 commented Feb 19, 2025

This pull request addresses the build errors caused by Sphinx warnings and a missing label definition in the documentation. The following changes have been made:

  1. Update link to for intel_modular_firmware_paths:

    • Updated the link from intel_firmware_paths to intel_modular_firmware_paths in developer_guides/firmware/llext_modules.rst to resolve the docs build error.
    • Commit: dc0495a
  2. Remove deprecated display_version configuration:

    • Removed the display_version option from html_theme_options in conf.py as it was deprecated in sphinx-rtd-theme since v3.0.0.
    • Commit: eec6e47
  3. Remove unused html_theme_path configuration:

    • Removed the unused html_theme_path configuration from conf.py to get rid of the deprecation warning.
    • Commit: 36eafc1

These changes should resolve the build errors and ensure that the documentation builds successfully without warnings.

Changes

  • developer_guides/firmware/llext_modules.rst: Fixed link to intel_modular_firmware_paths.
  • conf.py: Removed deprecated display_version configuration and unused html_theme_path configuration.

Signed-off-by

Christopher Turner [email protected]

Per build warning;
WARNING: Calling get_html_theme_path is deprecated.
If you are calling it to define html_theme_path, you are safe to remove that code.

So removing the code to get rid of warning.

Signed-off-by: Christopher Turner <[email protected]>
the option for display_version for the sphinx-rtd-theme
was deprecated since v3.0.0

Signed-off-by: Christopher Turner <[email protected]>
@cgturner1 cgturner1 changed the title [DNM] fix workflow Fix pull-request.yml build errors by addressing Sphinx warnings and adding missing label definition Feb 19, 2025
@cgturner1 cgturner1 marked this pull request as ready for review February 19, 2025 19:03
@cgturner1 cgturner1 requested a review from lyakh February 19, 2025 19:06
@@ -76,6 +76,7 @@ modules don't have to use "tristate" in their Kconfig entries.

Installation
************
.. _intel_firmware_paths:
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no, it isn't supposed to be here, it was removed by 0576be4#diff-8a57b48ec6926ea189c9ca3cf80b81def022dd4d1a55c6be760f6892d92255d8L165

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

that commit removed it from getting_started/intel_debug/introduction.rst not from the llext_modules.rst.

I guess the link in line 81/82 should be changed to _intel_modular_firmware_paths

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

thanks for taking a look hadn't seen the history (should've double checked that) will make the necessary changes then

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ok updated with the link to intel_modular_firmware_paths and removed previous changes that were incorrect

…mware paths

update broken link to Intel firmware paths in llext_modules.rst from
intel_firmware_paths to intel_modular_firmware_paths to point to
correct location and fix doc build errors.

Signed-off-by: Christopher Turner <[email protected]>
@lgirdwood lgirdwood merged commit c7bf0c1 into thesofproject:master Feb 21, 2025
4 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants