Project

General

Profile

Bug #11586

NAME field in man pages should match what's installed

Added by Peter Tribble 27 days ago. Updated 27 days ago.

Status:
New
Priority:
Normal
Assignee:
Category:
manpage - manual pages
Start date:
Due date:
% Done:

0%

Estimated time:
Difficulty:
Medium
Tags:

Description

The items listed in the NAME section of a man page should be useful as an argument to the man command - in other words, there should be an installed man page for everything listed under NAME.

See #10857 for an example, and a script to find candidates. This gives:

Missing: Pconent.3proc
Missing: Psecflags_free.3proc
Missing: amd_17h_events.3cpc
Missing: isgraph_l
Missing: devid_str_from_path.3devid
Missing: iswascii_l.3c
Missing: /usr/lib/mailwrapper.1m
Missing: proc_arg_xrgab.3proc
Missing: proc_get_pstatus.3proc
Missing: pthrad_mutexattr_setrobust.3c
Missing: strftime_l
Missing: tss_destroy.3c
Missing: usb_ep_xdescr_t.9s
Missing: usba_hcdi_pipe_rest.9e
Missing: usba_hubdi_bus_ops.9f
Missing: wcscoll_l

These are trivial omissions or typos.

The script linked to in #10857 also reports the following, which are slightly separate and I will declare them out of scope for this particular bug:

Missing: amd_17h_events.3cpc

Autogenerated by cpcgen, so not a simple manpage.

Missing: roff.5

Delivered as mandoc_roff.5

Missing: vi.1
Missing: view.1

We ship vi as a has/bin, so this is reported because of that split.

Missing: zfs
Missing: program.1m

This is because the man page for the "zfs program" subcommand is called zfs-program.

Multiple in section 3m and 3mvec - handle those separately.

History

#1

Updated by Peter Tribble 27 days ago

Catching up with some recent changes adds:

Missing: ofmt_print_header.3ofmt
Missing: ofmt_set_fs.3ofmt

Also available in: Atom PDF