Project

General

Profile

Bug #10229

Some man pages have incorrect cross-references

Added by Peter Tribble 8 months ago. Updated 8 months ago.

Status:
Closed
Priority:
Low
Assignee:
Category:
manpage - manual pages
Start date:
2019-01-14
Due date:
% Done:

100%

Estimated time:
(Total: 0.00 h)
Difficulty:
Bite-size
Tags:
needs-triage

Description

It's relatively easy to pick out the cross-references (Xr) for man pages in mdoc and verify them.

The following fail and can be easily fixed:

./man7d/usba.7d:.Xr Intro 9S) - extraneous )
./man3proc/Pgrab_error.3proc:.Xr Pfgrab_core 3PROC, - space before the ,
./man3head/endian.h.3head:.Xr endian 3C. - space before the .
./man3c/byteorder.3c:.Xr getservent 3NSL . - is in man3socket
./man3c/byteorder.3c:.Xr getservent 3NSL , - is in man3socket
./man9/iport.9:.Xr scsi_hba_tgtmap_destroy 9F - no such page
./man9/iport.9:.Xr scsi_hba_tgtmap_destroy 9F , - no such page
(exists, it's just not installed)
./man3c/memset_s.3c:.Xr set_constraint_handler 3C - should be set_constraint_handler_s
./man3proc/Psignal.3proc:.Xr signal.h 3HEAD. - space before the .
./man5/pam_timestamp.5:.Xr syslog 3 - is in section 3C
./man9f/usba_hubdi_bind_root_hub.9f:.Xr usb_dev_Descr 9S - usb_dev_descr
./man9e/usba_hcdi.9e:.Xr usba_hubdi_bind_root_hub 9F. - space before the .
./man9s/qinit.9s:.Xr STREAMS Programming Guide - .%T not .Xr
./man9s/qinit.9s:.Xr Writing Device Drivers - .%T not .Xr
./man9e/usba_hcdi.9e:Xr usba_hcdi_bind_root_hub 9F . - leading . ?
- I think it's usba_hubdi_bind_root_hub
./man3lib/libproc.3lib:.Pq Xr CTF 4 - should be ctf


Subtasks

Bug #10232: beastie.4th manpage not shippedClosedAndy Fiddaman

Actions

History

#1

Updated by Electric Monk 8 months ago

  • Status changed from New to Closed

git commit 9f17ecf0b8fdc59cfa903ceb6a96046b0f2d8201

commit  9f17ecf0b8fdc59cfa903ceb6a96046b0f2d8201
Author: Peter Tribble <peter.tribble@gmail.com>
Date:   2019-01-16T20:27:32.000Z

    10229 Some man pages have incorrect cross-references
    Reviewed by: Robert Mustacchi <rm@joyent.com>
    Reviewed by: Gergő Mihály Doma <domag02@gmail.com>
    Approved by: Dan McDonald <danmcd@joyent.com>

Also available in: Atom PDF