Project

General

Profile

Bug #11639

some man pages show incorrect driver locations

Added by Peter Tribble about 2 months ago. Updated about 2 months ago.

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

0%

Estimated time:
Difficulty:
Medium
Tags:

Description

Some man pages in section 7d have errors in the filename for the driver.

For example, ieee1394 has

/kernel/misc/[sparcv9|amd64/]s1394

where the / ought to be outside the [] so it applies to sparcv9 as well.

Some, like usba, say sparcv rather than sparcv9

Some, like usba, miss the leading / on the path.

And it would be a good opportunity to start clearing up the 32-bit remnants.

History

#1

Updated by Yuri Pankov about 2 months ago

There's a question if the driver location has to be in man page at all, it's helpful when?

#2

Updated by Peter Tribble about 2 months ago

There's useful information embedded in the location; not just the driver name but type, sometimes the note of platform-specific changes. And sometimes the configuration file is useful to know where to look.

Not so universally critical that we need to make a policy that every man page include it, but not so useless that it's worth eradicating.

What we shouldn't do is have information that's factually incorrect.

Also available in: Atom PDF