[Bug 2384200] Review Request: python-autodocsumm - Extended sphinx autodoc including automatic autosummaries

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



https://bugzilla.redhat.com/show_bug.cgi?id=2384200



--- Comment #1 from Karolina Surma <ksurma@xxxxxxxxxx> ---
1. You can avoid bootstrapping the package by moving/adding this in the
%install section to use the just installed package to generate the
documentation (and then remove the BuildRequires on python3-autodocsumm as well
as all the bconds).

pushd docs
export PYTHONPATH=%{buildroot}%{python3_sitelib}
sphinx-build -b texinfo . texinfo
pushd texinfo
makeinfo --docbook autodocsumm.texi
install -pDm0644 autodocsumm.xml \
  %{buildroot}%{_datadir}/help/en/autodocsumm/autodocsumm.xml
popd
popd

Out of curiosity: how can you consume the autodocsumm.xml file? Is there a CLI
or GUI tool to display it nicely?

2. Delete the leftover comment: "# Fill in the actual package description to
submit package to Fedora"

3. Consider adding doc file
%doc README.rst


-- 
You are receiving this mail because:
You are always notified about changes to this product and component
You are on the CC list for the bug.
https://bugzilla.redhat.com/show_bug.cgi?id=2384200

Report this comment as SPAM: https://bugzilla.redhat.com/enter_bug.cgi?product=Bugzilla&format=report-spam&short_desc=Report%20of%20Bug%202384200%23c1

-- 
_______________________________________________
package-review mailing list -- package-review@xxxxxxxxxxxxxxxxxxxxxxx
To unsubscribe send an email to package-review-leave@xxxxxxxxxxxxxxxxxxxxxxx
Fedora Code of Conduct: https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: https://lists.fedoraproject.org/archives/list/package-review@xxxxxxxxxxxxxxxxxxxxxxx
Do not reply to spam, report it: https://pagure.io/fedora-infrastructure/new_issue




[Index of Archives]     [Fedora Users]     [Fedora Desktop]     [Fedora SELinux]     [Yosemite Conditions]     [KDE Users]

  Powered by Linux