Bug 2259368

Summary:	blender package has no content in the blender man page
Product:	[Fedora] Fedora	Reporter:	M. Schlegel <moschlegbz>
Component:	blender	Assignee:	Luya Tshimbalanga <luya_tfz>
Status:	CLOSED ERRATA	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	medium	Docs Contact:
Priority:	unspecified
Version:	39	CC:	code, design-devel, epel-packagers-sig, luya_tfz, negativo17
Target Milestone:	---	Keywords:	Documentation
Target Release:	---
Hardware:	x86_64
OS:	Linux
Whiteboard:
Fixed In Version:	blender-4.1.1-3.fc41 blender-4.0.2-3.fc39	Doc Type:	If docs needed, set a value
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2024-04-22 00:03:16 UTC	Type:	---
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description M. Schlegel 2024-01-20 21:43:09 UTC

The 'blender' package blender-4.0.2-1.fc39.x86_64 was installed and the man page was attempted to be read:

$ man blender
 Manual page blender(1) byte 0/0 (END) (press h for help or q to quit)

but the man page was empty.  The package was checked and it was apparent the package man page is empty:

$ rpm -qlv blender | grep /man/
-rw-r--r--    1 root     root   20 Dec  9 19:00 /usr/share/man/man1/blender.1.gz

The -qlv shows the man page is 20 bytes which is the size of an 0 byte file that's been gzipped.  Directly checking by ungzipping to stdout also showed it's empty:

$ gzip -dc /usr/share/man/man1/blender.1.gz | wc -c
0

Reproducible: Always

Steps to Reproduce:
1. Install blender rpm package for 4.0.2-1.fc39
2. run "man blender"

Actual Results:  
Man page for blender has no contents

Expected Results:  
Packages should not include empty man pages or 'blender' man page should have the usual type of content expected in man pages like instructions on usage and so on.

Either do not include the blender.1.gz file at all if there's no such manual file or include related Blender content in the file.

Comment 1 Luya Tshimbalanga 2024-01-21 04:43:23 UTC

Looking at the build result, it appears the built traced back without failing


'''
Traceback (most recent call last):
  File "/builddir/build/BUILD/blender-4.0.2/doc/manpage/blender.1.py", line 227, in <module>
    main()
  File "/builddir/build/BUILD/blender-4.0.2/doc/manpage/blender.1.py", line 221, in main
    man_page_from_blender_help(fh, blender_bin, verbose)
  File "/builddir/build/BUILD/blender-4.0.2/doc/manpage/blender.1.py", line 103, in man_page_from_blender_help
    blender_info = blender_extract_info(blender_bin)
                   ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/builddir/build/BUILD/blender-4.0.2/doc/manpage/blender.1.py", line 45, in blender_extract_info
    blender_help = subprocess.run(
                   ^^^^^^^^^^^^^^^
  File "/usr/lib64/python3.12/subprocess.py", line 548, in run
    with Popen(*popenargs, **kwargs) as process:
         ^^^^^^^^^^^^^^^^^^^^^^^^^^^
  File "/usr/lib64/python3.12/subprocess.py", line 1026, in __init__
    self._execute_child(args, executable, preexec_fn, close_fds,
  File "/usr/lib64/python3.12/subprocess.py", line 1950, in _execute_child
    raise child_exception_type(errno_num, err_msg, err_filename)
FileNotFoundError: [Errno 2] No such file or directory: '/usr/bin/blender'
'''

Comment 2 Fedora Update System 2024-04-21 23:55:54 UTC

FEDORA-2024-9b34e45efc (blender-4.1.1-3.fc41, luxcorerender-2.7-0.18.beta1.fc41, and 5 more) has been submitted as an update to Fedora 41.
https://bodhi.fedoraproject.org/updates/FEDORA-2024-9b34e45efc

Comment 3 Fedora Update System 2024-04-22 00:03:16 UTC

FEDORA-2024-9b34e45efc (blender-4.1.1-3.fc41, luxcorerender-2.7-0.18.beta1.fc41, and 5 more) has been pushed to the Fedora 41 stable repository.
If problem still persists, please make note of it in this bug report.

Comment 4 Fedora Update System 2024-04-22 11:52:32 UTC

FEDORA-2024-bd77f9e670 (blender-4.0.2-3.fc39) has been submitted as an update to Fedora 39.
https://bodhi.fedoraproject.org/updates/FEDORA-2024-bd77f9e670

Comment 5 Fedora Update System 2024-04-23 02:43:08 UTC

FEDORA-2024-bd77f9e670 has been pushed to the Fedora 39 testing repository.
Soon you'll be able to install the update with the following command:
`sudo dnf upgrade --enablerepo=updates-testing --refresh --advisory=FEDORA-2024-bd77f9e670`
You can provide feedback for this update here: https://bodhi.fedoraproject.org/updates/FEDORA-2024-bd77f9e670

See also https://fedoraproject.org/wiki/QA:Updates_Testing for more information on how to test updates.

Comment 6 Fedora Update System 2024-05-01 02:25:51 UTC

FEDORA-2024-bd77f9e670 (blender-4.0.2-3.fc39) has been pushed to the Fedora 39 stable repository.
If problem still persists, please make note of it in this bug report.