Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.
RHEL Engineering is moving the tracking of its product development work on RHEL 6 through RHEL 9 to Red Hat Jira (issues.redhat.com). If you're a Red Hat customer, please continue to file support cases via the Red Hat customer portal. If you're not, please head to the "RHEL project" in Red Hat Jira and file new tickets here. Individual Bugzilla bugs in the statuses "NEW", "ASSIGNED", and "POST" are being migrated throughout September 2023. Bugs of Red Hat partners with an assigned Engineering Partner Manager (EPM) are migrated in late September as per pre-agreed dates. Bugs against components "kernel", "kernel-rt", and "kpatch" are only migrated if still in "NEW" or "ASSIGNED". If you cannot log in to RH Jira, please consult article #7032570. That failing, please send an e-mail to the RH Jira admins at rh-issues@redhat.com to troubleshoot your issue as a user management inquiry. The email creates a ServiceNow ticket with Red Hat. Individual Bugzilla bugs that are migrated will be moved to status "CLOSED", resolution "MIGRATED", and set with "MigratedToJIRA" in "Keywords". The link to the successor Jira issue will be found under "Links", have a little "two-footprint" icon next to it, and direct you to the "RHEL project" in Red Hat Jira (issue links are of type "https://issues.redhat.com/browse/RHEL-XXXX", where "X" is a digit). This same link will be available in a blue banner at the top of the page informing you that that bug has been migrated.

Bug 2129895

Summary: [DDF] The Examples in the RHEL ipa(1) man page show "ipa help commands" with content for "ipa halp topics" and "ipa hel
Product: Red Hat Enterprise Linux 8 Reporter: Direct Docs Feedback <ddf-bot>
Component: ipaAssignee: Florence Blanc-Renaud <frenaud>
Status: CLOSED ERRATA QA Contact: ipa-qe <ipa-qe>
Severity: unspecified Docs Contact:
Priority: high    
Version: 8.0CC: ftrivino, john.abbott, rcritten, rhel-docs, rjeffman, sumenon, tscherf
Target Milestone: rcKeywords: Triaged
Target Release: ---Flags: pm-rhel: mirror+
Hardware: All   
OS: All   
Whiteboard:
Fixed In Version: ipa-4.9.10-8.module+el8.8.0+17351+9a3fb056 Doc Type: If docs needed, set a value
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: 2023-05-16 08:29:08 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 Direct Docs Feedback 2022-09-26 14:56:57 UTC
The Examples in the RHEL ipa(1) man page show "ipa help commands" with content for "ipa halp topics" and "ipa hel user" as part of the description - please fix the formatting.

Reported by: johnabbottdhc

https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/8/html/managing_idm_users_groups_hosts_and_access_control_rules/introduction-to-the-ipa-command-line-utilities_managing-users-groups-hosts#annotations:7638e4b5-bc47-49f8-905c-dd8924ab0fd7

Comment 1 John Abbott 2022-09-26 15:05:52 UTC
This is what the man page (man ipa) looks like:
EXAMPLES
       ipa help commands
              Display a list of available commands ipa help topics Display a high-level list of help topics ipa help user Display
              documentation and list of commands in the "user" topic.
______________________________
This should be three examples:
       ipa help commands
               ...
       ipa help topics
               ...
       ipa help user
               ....

Comment 3 Rob Crittenden 2022-09-29 15:13:27 UTC
Re-assigning to ipa product since the man page is provided by the package.

Comment 4 Florence Blanc-Renaud 2022-09-29 15:43:37 UTC
Upstream ticket:
https://pagure.io/freeipa/issue/9252

Comment 5 Florence Blanc-Renaud 2022-09-30 13:17:00 UTC
Fixed upstream
master:
https://pagure.io/freeipa/c/cca7a7cd77daca3148f56718496b273d743dda54

Comment 6 Florence Blanc-Renaud 2022-10-03 05:50:13 UTC
Fixed upstream
ipa-4-9:
https://pagure.io/freeipa/c/64ef2b9c07ec0b1b316555739ff9f98229258838

Fixed upstream
ipa-4-10:
https://pagure.io/freeipa/c/1546c0b206e02902b4aba631ee83f2f7ba5acb1f

Comment 11 Sudhir Menon 2022-12-09 14:02:42 UTC
[root@server ~]# cat /etc/redhat-release 
Red Hat Enterprise Linux release 8.8 Beta (Ootpa)

[root@server ~]# rpm -q ipa-server
ipa-server-4.9.10-8.module+el8.8.0+17351+9a3fb056.x86_64

#man ipa

EXAMPLES
       ipa help commands
              Display a list of available commands

       ipa help topics
              Display a high-level list of help topics

       ipa help user
              Display documentation and list of commands in the "user" topic.

Comment 14 errata-xmlrpc 2023-05-16 08:29:08 UTC
Since the problem described in this bug report should be
resolved in a recent advisory, it has been closed with a
resolution of ERRATA.

For information on the advisory (idm:client and idm:DL1 bug fix and enhancement update), and where to find the updated
files, follow the link below.

If the solution does not work for you, open a new bug report.

https://access.redhat.com/errata/RHBA-2023:2794