Bug 2185893 - Hostapd.conf man page "SEE ALSO" refers to example with incorrect path
Summary: Hostapd.conf man page "SEE ALSO" refers to example with incorrect path
Keywords:
Status: CLOSED RAWHIDE
Alias: None
Product: Fedora
Classification: Fedora
Component: hostapd
Version: 37
Hardware: All
OS: Unspecified
unspecified
low
Target Milestone: ---
Assignee: John W. Linville
QA Contact: Fedora Extras Quality Assurance
URL:
Whiteboard:
Depends On:
Blocks:
TreeView+ depends on / blocked
 
Reported: 2023-04-11 14:20 UTC by Tom Sobczynski
Modified: 2023-04-11 19:43 UTC (History)
4 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2023-04-11 19:43:51 UTC
Type: Bug
Embargoed:


Attachments (Terms of Use)
Patch for hostapd.conf.5 (503 bytes, patch)
2023-04-11 14:46 UTC, Tom Sobczynski
no flags Details | Diff

Description Tom Sobczynski 2023-04-11 14:20:15 UTC
Description of problem:

The man page for hostapd.conf contains a "SEE ALSO" item that is an absolute path to a sample hostapd.conf file:

SEE ALSO
       hostapd(8), hostapd_cli(8), /usr/share/examples/hostapd/hostapd.conf

But when Fedora packages hostapd, the destination for this example is a different location:

$ rpm -ql hostapd | grep hostapd.conf
/etc/hostapd/hostapd.conf
/usr/share/doc/hostapd/hostapd.conf

Version-Release number of selected component (if applicable):
hostapd v2.10 on Fedora 37

How reproducible:
100%

Steps to Reproduce:
1. Open the man page for hostapd.conf ($ man hostapd.conf)
2. Navigate to the "SEE ALSO" section
3. Note the path of the example config file
4. Attempt to view that config file, see that it does not exist.

Actual results:
There is no file with that path name.

Expected results:
The man page should be patched at build time to reflect the actual location of the example when the hostapd package is installed.

Additional info:

Comment 1 Tom Sobczynski 2023-04-11 14:46:18 UTC
Created attachment 1956863 [details]
Patch for hostapd.conf.5

Supplying proposed patch based on clone from https://src.fedoraproject.org/rpms/hostapd/blob/main/f/hostapd.conf.5


Note You need to log in before you can comment on or make changes to this bug.