Bug 2104778

Summary:	The man pages ar garbeled
Product:	[Fedora] Fedora	Reporter:	Villy Kruse <ppywlkiqletw>
Component:	pesign	Assignee:	Peter Jones <pjones>
Status:	CLOSED ERRATA	QA Contact:	Fedora Extras Quality Assurance <extras-qa>
Severity:	unspecified	Docs Contact:
Priority:	unspecified
Version:	36	CC:	fmartine, mjg59, pjones, rharwood
Target Milestone:	---
Target Release:	---
Hardware:	Unspecified
OS:	Unspecified
Whiteboard:
Fixed In Version:	pesign-115-2.fc36	Doc Type:	---
Doc Text:		Story Points:	---
Clone Of:		Environment:
Last Closed:	2022-07-16 01:22:27 UTC	Type:	Bug
Regression:	---	Mount Type:	---
Documentation:	---	CRM:
Verified Versions:		Category:	---
oVirt Team:	---	RHEL 7.3 requirements from Atomic Host:
Cloudforms Team:	---	Target Upstream Version:
Embargoed:

Description Villy Kruse 2022-07-07 06:27:05 UTC

Description of problem:

Running man pesign looks something like thid

()
()

 | | | is a command line tool  for  manipulating  signatures  and
cryptographic digests of UEFI applications.  Input PE for signing
Output PE for signing Overwrite existing file specified with  Use
the NSS Database in default: Use the NSS token named Use the cer‐
tificate called in the NSS  Database  Signature  number,  indexed

... etc.

Version-Release number of selected component (if applicable):

pesign-115-1.fc36.x86_64

How reproducible:

Walways

Steps to Reproduce:
1.man pesign
2.
3.

Same for all the other man pages.

Actual results:

Unreadable text

Expected results:

Readable man page

Additional info:

The mdoc files in the sources are all OK.  Running for example

  man src/pesign.1.mdoc

gives the desired result.
There is no need to process the mdoc files using mandoc.

Comment 1 Fedora Update System 2022-07-07 21:24:11 UTC

FEDORA-2022-2317a67b99 has been submitted as an update to Fedora 36. https://bodhi.fedoraproject.org/updates/FEDORA-2022-2317a67b99

Comment 2 Fedora Update System 2022-07-08 01:15:46 UTC

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

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

Comment 3 Villy Kruse 2022-07-08 06:58:50 UTC

mandoc has almost no effect.  The "-man" flags is the input format, and if you specify "-mdoc" you do get a conversion to man format..   Yhe man command itself doesn't care if the man page is in mdoc or man format.

Also. try run mandoc -T lint src/pesign.1.mdoc


vek@newbox pesign]$ mandoc -man -T man -Ios=Linux src/pesign.1.mdoc | diff -u src/pesign.1.mdoc -
--- src/pesign.1.mdoc	2022-06-17 18:29:58.800922860 +0200
+++ -	2022-07-08 08:53:15.165028779 +0200
@@ -276,7 +276,7 @@
 
 .Rs
 .%A K. Moriarty
-.%A M. Nyström
+.%A M. Nystr\[u00F6]m
 .%A S. Parkinson
 .%A A. Rusch
 .%A M. Scott
@@ -295,8 +295,8 @@
 .Re
 
 .Rs
-.%A M. Nyström
-.%B PKCS #15—A Cryptographic-Token Information Format Standard
+.%A M. Nystr\[u00F6]m
+.%B PKCS #15\[u2014]A Cryptographic-Token Information Format Standard
 .%I RSA Laboratories
 .%D 1999
 .%U https://www.usenix.org/legacy/events/smartcard99/full_papers/nystrom/nystrom.pdf\ \&
[vek@newbox pesign]$

Comment 4 Fedora Update System 2022-07-16 01:22:27 UTC

FEDORA-2022-2317a67b99 has been pushed to the Fedora 36 stable repository.
If problem still persists, please make note of it in this bug report.