Subject: pkg/6334: Tosha manpage misleading
To: None <gnats-bugs@gnats.netbsd.org>
From: John Ruschmeyer <jruschme@exit109.com>
List: netbsd-bugs
Date: 10/20/1998 11:41:57
>Number:         6334
>Category:       pkg
>Synopsis:       Tosha manpage misleading
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    gnats-admin (GNATS administrator)
>State:          open
>Class:          doc-bug
>Submitter-Id:   net
>Arrival-Date:   Tue Oct 20 08:50:00 1998
>Last-Modified:
>Originator:     John Ruschmeyer
>Organization:
	Many little piles
>Release:        NetBSD-current
>Environment:
	
System: NetBSD crobin 1.3.2 NetBSD 1.3.2 (CROBIN) #1: Fri Aug 28 18:19:13 EDT 1998 jruschme@crobin:/usr/src/sys/arch/sparc/compile/CROBIN sparc


>Description:
	The "NOTES" section of the manpage for tosha documents the output format,
	but does not document the fact that the output is little-endian, 
	regardless of the platform. This is potentially misleading to naive
	users on big-endian platforms (e.g., Sparc).

	FYI, little-endian is also the opposite of the "norm" for CD Audio.
>How-To-Repeat:
	Read manpage closely, attempt to use sox (without -x option) on 
	big-endian system.
>Fix:
	Add text which specifically states that the output is little-endian.
>Audit-Trail:
>Unformatted: