Skip to content

Conversation

@Venefilyn
Copy link
Member

@Venefilyn Venefilyn commented Dec 16, 2025

With this we can get rid of asciidoc-py dependency altogether and
instead rely on the docs being prebundled before installation.

Fixes #22670
https://issues.redhat.com/browse/COCKPIT-1370

Signed-off-by: Freya Gustavsson [email protected]

@Venefilyn Venefilyn added the no-test For doc/workflow changes, or experiments which don't need a full CI run, label Dec 16, 2025
@Venefilyn Venefilyn force-pushed the doc/prebundle-on-rhel branch 5 times, most recently from 27b7c65 to 5a641eb Compare December 19, 2025 13:56
@Venefilyn
Copy link
Member Author

@martinpitt any hints as to how this works so we can build the docs with AsciiDoctor for RHEL and CentOS Stream without having to rely on asciidoc-py?

Copy link
Member

@martinpitt martinpitt left a comment

Choose a reason for hiding this comment

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

Thanks!

@Venefilyn Venefilyn force-pushed the doc/prebundle-on-rhel branch from 5a641eb to 469be64 Compare January 7, 2026 14:08
@Venefilyn
Copy link
Member Author

Stream likely fails due to %{centos} macro not existing, which we depend on in this PR...

error: Bad exit status from /var/tmp/rpm-tmp.zbhJ8p (%build)
    Macro expanded in comment on line 31: %{centos} explicitly

    Bad exit status from /var/tmp/rpm-tmp.zbhJ8p (%build)


RPM build errors:

@Venefilyn Venefilyn requested a review from martinpitt January 7, 2026 14:24
Copy link
Member

@martinpitt martinpitt left a comment

Choose a reason for hiding this comment

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

Thanks! I included the solution to the failed CentOS builds in a thread.

Copy link
Member

@martinpitt martinpitt left a comment

Choose a reason for hiding this comment

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

Almost!

@Venefilyn Venefilyn force-pushed the doc/prebundle-on-rhel branch from 3b442d4 to 3674ecf Compare January 7, 2026 15:44
@Venefilyn Venefilyn requested a review from martinpitt January 7, 2026 15:44
@Venefilyn
Copy link
Member Author

/packit build

@martinpitt martinpitt removed the no-test For doc/workflow changes, or experiments which don't need a full CI run, label Jan 8, 2026
@martinpitt martinpitt force-pushed the doc/prebundle-on-rhel branch 2 times, most recently from 90647fd to 7f38fce Compare January 8, 2026 06:54
@martinpitt
Copy link
Member

@Venefilyn I took the liberty to update this PR. I fixed the installation in the spec file, and also took care of the missing manpages. Now test/image-prepare -qv rhel-10-2 is happy, manpages are present, and cockpit-doc has the HTML guide.

@martinpitt martinpitt marked this pull request as ready for review January 8, 2026 06:59
@martinpitt martinpitt force-pushed the doc/prebundle-on-rhel branch from 7f38fce to 7a17a65 Compare January 8, 2026 07:27
@martinpitt
Copy link
Member

jajaja. Fixed, and took the opportunity to clean lintian a bit.

@martinpitt martinpitt force-pushed the doc/prebundle-on-rhel branch from 7a17a65 to b284b98 Compare January 8, 2026 07:31
Venefilyn and others added 2 commits January 8, 2026 08:31
With this we can get rid of asciidoc-py dependency altogether and
instead rely on the docs being prebundled before installation.

Include the built guide and manpages into the release tarball for that.

Fixes cockpit-project#22670
https://issues.redhat.com/browse/COCKPIT-1370

Signed-off-by: Freya Gustavsson <[email protected]>
Co-Authored-By: Martin Pitt <[email protected]>
These don't apply any more with the move from docbook to asciidoc.

Fixes three "unused-override" lintian infos.
@martinpitt martinpitt force-pushed the doc/prebundle-on-rhel branch from b284b98 to fd1911e Compare January 8, 2026 07:32
@martinpitt
Copy link
Member

Updated the commit message to include refs to the upstream issue and Jira ticket.

Copy link
Member

@martinpitt martinpitt left a comment

Choose a reason for hiding this comment

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

Thanks @Venefilyn ! LGTM now. As I meddled with this PR, can you please cross-check and land if you are happy?

@martinpitt martinpitt mentioned this pull request Jan 8, 2026
3 tasks
Comment on lines +222 to +230
%define manbundledir %{_builddir}/%{name}-%{version}/doc/output/man
install -D -p -m 644 %{manbundledir}/cockpit.1 %{buildroot}%{_mandir}/man1/cockpit.1
install -D -p -m 644 %{manbundledir}/cockpit-bridge.1 %{buildroot}%{_mandir}/man1/cockpit-bridge.1
install -D -p -m 644 %{manbundledir}/cockpit-desktop.1 %{buildroot}%{_mandir}/man1/cockpit-desktop.1
install -D -p -m 644 %{manbundledir}/cockpit.conf.5 %{buildroot}%{_mandir}/man5/cockpit.conf.5
install -D -p -m 644 %{manbundledir}/cockpit-ws.8 %{buildroot}%{_mandir}/man8/cockpit-ws.8
install -D -p -m 644 %{manbundledir}/cockpit-tls.8 %{buildroot}%{_mandir}/man8/cockpit-tls.8
install -D -p -m 644 %{manbundledir}/pam_ssh_add.8 %{buildroot}%{_mandir}/man8/pam_ssh_add.8
%endif
Copy link
Member Author

Choose a reason for hiding this comment

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

Is it possible for us to iterate over files and install? Or install all files somehow

Copy link
Member

Choose a reason for hiding this comment

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

@Venefilyn done in #22747

Copy link
Member Author

@Venefilyn Venefilyn left a comment

Choose a reason for hiding this comment

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

LGTM

@Venefilyn Venefilyn merged commit f1c5912 into cockpit-project:main Jan 8, 2026
91 checks passed
@Venefilyn Venefilyn deleted the doc/prebundle-on-rhel branch January 8, 2026 12:30
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.

asciidoc: issues on rhel* with the Python asciidoc version

2 participants