Bug 36270 - join(1) SYNOPSIS and usage() are misleading
Summary: join(1) SYNOPSIS and usage() are misleading
Status: Closed FIXED
Alias: None
Product: Base System
Classification: Unclassified
Component: bin (show other bugs)
Version: 4.5-STABLE
Hardware: Any Any
: Normal Affects Only Me
Assignee: freebsd-bugs (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2002-03-25 01:30 UTC by Tim J. Robbins
Modified: 2002-06-19 12:20 UTC (History)
0 users

See Also:

Attachments
file.diff (961 bytes, patch)
2002-03-25 01:30 UTC, Tim J. Robbins 		no flags Details | Diff
View All Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Tim J. Robbins 2002-03-25 01:30:00 UTC 
The SYNOPSIS section of join(1) and the usage() function in join.c
indicate that you can invoke it as "join -a 2" (for example), which does
not work due to hacks added to make obsolete syntax work.

Fix: This patch corrects the documentation. According to the SUSV3 standard,
we should accept both -a2 and -a 2, and error when -a is used without
an argument, however.

The POSIX.2 conformance claim may also need to be removed from the manual
page.
How-To-Repeat: join -a 2 foo bar
Comment 1 Tim Robbins freebsd_committer freebsd_triage 2002-04-20 03:01:45 UTC 
State Changed
From-To: open->patched

Committed.
Comment 2 Tim Robbins freebsd_committer freebsd_triage 2002-04-20 03:16:28 UTC 
On Fri, Apr 19, 2002 at 07:02:15PM -0700, tjr@FreeBSD.org wrote:

> Synopsis: join(1) SYNOPSIS and usage() are misleading
> 
> State-Changed-From-To: open->patched
> State-Changed-By: tjr
> State-Changed-When: Fri Apr 19 19:01:45 PDT 2002
> State-Changed-Why: 
> Committed.

I neglected to mention that the fix I committed was not the one suggested
in the PR, but rather the opposite. Instead of changing the synopsis
to point out that there must be no space between -a and its argument, I
made it accept it with a space (per SUSv3).
Comment 3 Tim Robbins freebsd_committer freebsd_triage 2002-06-19 12:20:02 UTC 
State Changed
From-To: patched->closed

Change has been MFC'd.