Bug 23809 - Misleading documentation for -mmmx/msse/...
Summary: Misleading documentation for -mmmx/msse/...
Status: RESOLVED FIXED
Alias: None
Product: gcc
Classification: Unclassified
Component: target (show other bugs)
Version: unknown
: P2 normal
Target Milestone: 4.1.0
Assignee: Not yet assigned to anyone
URL: http://gcc.gnu.org/ml/gcc/2005-10/msg...
Keywords: documentation
: 23892 (view as bug list)
Depends on:
Blocks:
 
Reported: 2005-09-10 22:03 UTC by Billy Biggs
Modified: 2005-10-23 22:58 UTC (History)
2 users (show)

See Also:
Host:
Target:
Build:
Known to work:
Known to fail:
Last reconfirmed: 2005-09-10 22:10:26


Attachments
Patch (486 bytes, patch)
2005-09-10 22:04 UTC, Billy Biggs
Details | Diff
Path (823 bytes, patch)
2005-09-10 22:12 UTC, Billy Biggs
Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Billy Biggs 2005-09-10 22:03:52 UTC
The compiler options for -mmmx, -msse, etc, serve two purposes:

  1. They allow the programmer to use the compiler built-ins for easily
     writing MMX/SSE code.
  2. They allow the compiler to use MMX/SSE instructions in generated code.

However, the documentation does not explicitly state the second point, only
the first.  This had caused much confusion in the development community, as
programmers using the MMX/SSE intrinsics often use runtime CPU detection.

The attached patch updates the documentation to be more explicit about the
effect of these options.
Comment 1 Billy Biggs 2005-09-10 22:04:30 UTC
Created attachment 9706 [details]
Patch
Comment 2 Billy Biggs 2005-09-10 22:12:30 UTC
Created attachment 9707 [details]
Path

This patch updates both the documentation of the command line options, and the
documentation for the built-ins.
Comment 3 Andrew Pinski 2005-09-11 14:18:08 UTC
Target bug and not related to the C front-end at all.
Comment 4 Andrew Pinski 2005-09-15 02:31:22 UTC
*** Bug 23892 has been marked as a duplicate of this bug. ***
Comment 5 GCC Commits 2005-10-05 08:27:48 UTC
Subject: Bug 23809

CVSROOT:	/cvs/gcc
Module name:	gcc
Changes by:	bonzini@gcc.gnu.org	2005-10-05 08:27:44

Modified files:
	gcc            : ChangeLog 
	gcc/doc        : extend.texi invoke.texi 

Log message:
	2005-10-05  Billy Biggs  <billy.biggs@gmail.com>
	Paolo Bonzini  <bonzini@gnu.org>
	
	PR target/23809
	
	* doc/extend.texi (x86 Built-ins): Document that -msse and friends
	enable the instructions and not just the built-ins.
	* doc/invoke.texi (x86 Options): Likewise.

Patches:
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/ChangeLog.diff?cvsroot=gcc&r1=2.10086&r2=2.10087
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/doc/extend.texi.diff?cvsroot=gcc&r1=1.267&r2=1.268
http://gcc.gnu.org/cgi-bin/cvsweb.cgi/gcc/gcc/doc/invoke.texi.diff?cvsroot=gcc&r1=1.682&r2=1.683

Comment 6 Paolo Bonzini 2005-10-05 08:28:22 UTC
Patch committed with some changes.