diff options
author | Tim Northover <tnorthover@apple.com> | 2014-06-13 14:24:23 +0000 |
---|---|---|
committer | Tim Northover <tnorthover@apple.com> | 2014-06-13 14:24:23 +0000 |
commit | 6eaf840a3dc4fbbc0cf195e23c9d6bd3d91fabe8 (patch) | |
tree | 89f998d2630f87b0ae6b7b8745bd5d75fd79da6b /docs | |
parent | ab47c159b00f2c0e8613dbd0480e6368811067af (diff) | |
download | llvm-6eaf840a3dc4fbbc0cf195e23c9d6bd3d91fabe8.tar.gz llvm-6eaf840a3dc4fbbc0cf195e23c9d6bd3d91fabe8.tar.bz2 llvm-6eaf840a3dc4fbbc0cf195e23c9d6bd3d91fabe8.tar.xz |
Docs: remove extra {} around result types.
It makes the types look like they're single-element structures. And
when we have instructions that *do* result in a struct, that can get
confusing rather quickly.
git-svn-id: https://llvm.org/svn/llvm-project/llvm/trunk@210905 91177308-0d34-0410-b5e6-96231b3b80d8
Diffstat (limited to 'docs')
-rw-r--r-- | docs/LangRef.rst | 194 |
1 files changed, 97 insertions, 97 deletions
diff --git a/docs/LangRef.rst b/docs/LangRef.rst index 80bcb53a82..cb94d3967b 100644 --- a/docs/LangRef.rst +++ b/docs/LangRef.rst @@ -117,8 +117,8 @@ And the hard way: .. code-block:: llvm - %0 = add i32 %X, %X ; yields {i32}:%0 - %1 = add i32 %0, %0 ; yields {i32}:%1 + %0 = add i32 %X, %X ; yields i32:%0 + %1 = add i32 %0, %0 ; yields i32:%1 %result = add i32 %1, %1 This last way of multiplying ``%X`` by 8 illustrates several important @@ -3577,9 +3577,9 @@ Example: .. code-block:: llvm %retval = invoke i32 @Test(i32 15) to label %Continue - unwind label %TestCleanup ; {i32}:retval set + unwind label %TestCleanup ; i32:retval set %retval = invoke coldcc i32 %Testfnptr(i32 15) to label %Continue - unwind label %TestCleanup ; {i32}:retval set + unwind label %TestCleanup ; i32:retval set .. _i_resume: @@ -3668,10 +3668,10 @@ Syntax: :: - <result> = add <ty> <op1>, <op2> ; yields {ty}:result - <result> = add nuw <ty> <op1>, <op2> ; yields {ty}:result - <result> = add nsw <ty> <op1>, <op2> ; yields {ty}:result - <result> = add nuw nsw <ty> <op1>, <op2> ; yields {ty}:result + <result> = add <ty> <op1>, <op2> ; yields ty:result + <result> = add nuw <ty> <op1>, <op2> ; yields ty:result + <result> = add nsw <ty> <op1>, <op2> ; yields ty:result + <result> = add nuw nsw <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3707,7 +3707,7 @@ Example: .. code-block:: llvm - <result> = add i32 4, %var ; yields {i32}:result = 4 + %var + <result> = add i32 4, %var ; yields i32:result = 4 + %var .. _i_fadd: @@ -3719,7 +3719,7 @@ Syntax: :: - <result> = fadd [fast-math flags]* <ty> <op1>, <op2> ; yields {ty}:result + <result> = fadd [fast-math flags]* <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3746,7 +3746,7 @@ Example: .. code-block:: llvm - <result> = fadd float 4.0, %var ; yields {float}:result = 4.0 + %var + <result> = fadd float 4.0, %var ; yields float:result = 4.0 + %var '``sub``' Instruction ^^^^^^^^^^^^^^^^^^^^^ @@ -3756,10 +3756,10 @@ Syntax: :: - <result> = sub <ty> <op1>, <op2> ; yields {ty}:result - <result> = sub nuw <ty> <op1>, <op2> ; yields {ty}:result - <result> = sub nsw <ty> <op1>, <op2> ; yields {ty}:result - <result> = sub nuw nsw <ty> <op1>, <op2> ; yields {ty}:result + <result> = sub <ty> <op1>, <op2> ; yields ty:result + <result> = sub nuw <ty> <op1>, <op2> ; yields ty:result + <result> = sub nsw <ty> <op1>, <op2> ; yields ty:result + <result> = sub nuw nsw <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3798,8 +3798,8 @@ Example: .. code-block:: llvm - <result> = sub i32 4, %var ; yields {i32}:result = 4 - %var - <result> = sub i32 0, %val ; yields {i32}:result = -%var + <result> = sub i32 4, %var ; yields i32:result = 4 - %var + <result> = sub i32 0, %val ; yields i32:result = -%var .. _i_fsub: @@ -3811,7 +3811,7 @@ Syntax: :: - <result> = fsub [fast-math flags]* <ty> <op1>, <op2> ; yields {ty}:result + <result> = fsub [fast-math flags]* <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3841,8 +3841,8 @@ Example: .. code-block:: llvm - <result> = fsub float 4.0, %var ; yields {float}:result = 4.0 - %var - <result> = fsub float -0.0, %val ; yields {float}:result = -%var + <result> = fsub float 4.0, %var ; yields float:result = 4.0 - %var + <result> = fsub float -0.0, %val ; yields float:result = -%var '``mul``' Instruction ^^^^^^^^^^^^^^^^^^^^^ @@ -3852,10 +3852,10 @@ Syntax: :: - <result> = mul <ty> <op1>, <op2> ; yields {ty}:result - <result> = mul nuw <ty> <op1>, <op2> ; yields {ty}:result - <result> = mul nsw <ty> <op1>, <op2> ; yields {ty}:result - <result> = mul nuw nsw <ty> <op1>, <op2> ; yields {ty}:result + <result> = mul <ty> <op1>, <op2> ; yields ty:result + <result> = mul nuw <ty> <op1>, <op2> ; yields ty:result + <result> = mul nsw <ty> <op1>, <op2> ; yields ty:result + <result> = mul nuw nsw <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3895,7 +3895,7 @@ Example: .. code-block:: llvm - <result> = mul i32 4, %var ; yields {i32}:result = 4 * %var + <result> = mul i32 4, %var ; yields i32:result = 4 * %var .. _i_fmul: @@ -3907,7 +3907,7 @@ Syntax: :: - <result> = fmul [fast-math flags]* <ty> <op1>, <op2> ; yields {ty}:result + <result> = fmul [fast-math flags]* <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3934,7 +3934,7 @@ Example: .. code-block:: llvm - <result> = fmul float 4.0, %var ; yields {float}:result = 4.0 * %var + <result> = fmul float 4.0, %var ; yields float:result = 4.0 * %var '``udiv``' Instruction ^^^^^^^^^^^^^^^^^^^^^^ @@ -3944,8 +3944,8 @@ Syntax: :: - <result> = udiv <ty> <op1>, <op2> ; yields {ty}:result - <result> = udiv exact <ty> <op1>, <op2> ; yields {ty}:result + <result> = udiv <ty> <op1>, <op2> ; yields ty:result + <result> = udiv exact <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -3978,7 +3978,7 @@ Example: .. code-block:: llvm - <result> = udiv i32 4, %var ; yields {i32}:result = 4 / %var + <result> = udiv i32 4, %var ; yields i32:result = 4 / %var '``sdiv``' Instruction ^^^^^^^^^^^^^^^^^^^^^^ @@ -3988,8 +3988,8 @@ Syntax: :: - <result> = sdiv <ty> <op1>, <op2> ; yields {ty}:result - <result> = sdiv exact <ty> <op1>, <op2> ; yields {ty}:result + <result> = sdiv <ty> <op1>, <op2> ; yields ty:result + <result> = sdiv exact <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4024,7 +4024,7 @@ Example: .. code-block:: llvm - <result> = sdiv i32 4, %var ; yields {i32}:result = 4 / %var + <result> = sdiv i32 4, %var ; yields i32:result = 4 / %var .. _i_fdiv: @@ -4036,7 +4036,7 @@ Syntax: :: - <result> = fdiv [fast-math flags]* <ty> <op1>, <op2> ; yields {ty}:result + <result> = fdiv [fast-math flags]* <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4063,7 +4063,7 @@ Example: .. code-block:: llvm - <result> = fdiv float 4.0, %var ; yields {float}:result = 4.0 / %var + <result> = fdiv float 4.0, %var ; yields float:result = 4.0 / %var '``urem``' Instruction ^^^^^^^^^^^^^^^^^^^^^^ @@ -4073,7 +4073,7 @@ Syntax: :: - <result> = urem <ty> <op1>, <op2> ; yields {ty}:result + <result> = urem <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4105,7 +4105,7 @@ Example: .. code-block:: llvm - <result> = urem i32 4, %var ; yields {i32}:result = 4 % %var + <result> = urem i32 4, %var ; yields i32:result = 4 % %var '``srem``' Instruction ^^^^^^^^^^^^^^^^^^^^^^ @@ -4115,7 +4115,7 @@ Syntax: :: - <result> = srem <ty> <op1>, <op2> ; yields {ty}:result + <result> = srem <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4160,7 +4160,7 @@ Example: .. code-block:: llvm - <result> = srem i32 4, %var ; yields {i32}:result = 4 % %var + <result> = srem i32 4, %var ; yields i32:result = 4 % %var .. _i_frem: @@ -4172,7 +4172,7 @@ Syntax: :: - <result> = frem [fast-math flags]* <ty> <op1>, <op2> ; yields {ty}:result + <result> = frem [fast-math flags]* <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4200,7 +4200,7 @@ Example: .. code-block:: llvm - <result> = frem float 4.0, %var ; yields {float}:result = 4.0 % %var + <result> = frem float 4.0, %var ; yields float:result = 4.0 % %var .. _bitwiseops: @@ -4221,10 +4221,10 @@ Syntax: :: - <result> = shl <ty> <op1>, <op2> ; yields {ty}:result - <result> = shl nuw <ty> <op1>, <op2> ; yields {ty}:result - <result> = shl nsw <ty> <op1>, <op2> ; yields {ty}:result - <result> = shl nuw nsw <ty> <op1>, <op2> ; yields {ty}:result + <result> = shl <ty> <op1>, <op2> ; yields ty:result + <result> = shl nuw <ty> <op1>, <op2> ; yields ty:result + <result> = shl nsw <ty> <op1>, <op2> ; yields ty:result + <result> = shl nuw nsw <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4262,9 +4262,9 @@ Example: .. code-block:: llvm - <result> = shl i32 4, %var ; yields {i32}: 4 << %var - <result> = shl i32 4, 2 ; yields {i32}: 16 - <result> = shl i32 1, 10 ; yields {i32}: 1024 + <result> = shl i32 4, %var ; yields i32: 4 << %var + <result> = shl i32 4, 2 ; yields i32: 16 + <result> = shl i32 1, 10 ; yields i32: 1024 <result> = shl i32 1, 32 ; undefined <result> = shl <2 x i32> < i32 1, i32 1>, < i32 1, i32 2> ; yields: result=<2 x i32> < i32 2, i32 4> @@ -4276,8 +4276,8 @@ Syntax: :: - <result> = lshr <ty> <op1>, <op2> ; yields {ty}:result - <result> = lshr exact <ty> <op1>, <op2> ; yields {ty}:result + <result> = lshr <ty> <op1>, <op2> ; yields ty:result + <result> = lshr exact <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4311,10 +4311,10 @@ Example: .. code-block:: llvm - <result> = lshr i32 4, 1 ; yields {i32}:result = 2 - <result> = lshr i32 4, 2 ; yields {i32}:result = 1 - <result> = lshr i8 4, 3 ; yields {i8}:result = 0 - <result> = lshr i8 -2, 1 ; yields {i8}:result = 0x7F + <result> = lshr i32 4, 1 ; yields i32:result = 2 + <result> = lshr i32 4, 2 ; yields i32:result = 1 + <result> = lshr i8 4, 3 ; yields i8:result = 0 + <result> = lshr i8 -2, 1 ; yields i8:result = 0x7F <result> = lshr i32 1, 32 ; undefined <result> = lshr <2 x i32> < i32 -2, i32 4>, < i32 1, i32 2> ; yields: result=<2 x i32> < i32 0x7FFFFFFF, i32 1> @@ -4326,8 +4326,8 @@ Syntax: :: - <result> = ashr <ty> <op1>, <op2> ; yields {ty}:result - <result> = ashr exact <ty> <op1>, <op2> ; yields {ty}:result + <result> = ashr <ty> <op1>, <op2> ; yields ty:result + <result> = ashr exact <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4362,10 +4362,10 @@ Example: .. code-block:: llvm - <result> = ashr i32 4, 1 ; yields {i32}:result = 2 - <result> = ashr i32 4, 2 ; yields {i32}:result = 1 - <result> = ashr i8 4, 3 ; yields {i8}:result = 0 - <result> = ashr i8 -2, 1 ; yields {i8}:result = -1 + <result> = ashr i32 4, 1 ; yields i32:result = 2 + <result> = ashr i32 4, 2 ; yields i32:result = 1 + <result> = ashr i8 4, 3 ; yields i8:result = 0 + <result> = ashr i8 -2, 1 ; yields i8:result = -1 <result> = ashr i32 1, 32 ; undefined <result> = ashr <2 x i32> < i32 -2, i32 4>, < i32 1, i32 3> ; yields: result=<2 x i32> < i32 -1, i32 0> @@ -4377,7 +4377,7 @@ Syntax: :: - <result> = and <ty> <op1>, <op2> ; yields {ty}:result + <result> = and <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4414,9 +4414,9 @@ Example: .. code-block:: llvm - <result> = and i32 4, %var ; yields {i32}:result = 4 & %var - <result> = and i32 15, 40 ; yields {i32}:result = 8 - <result> = and i32 4, 8 ; yields {i32}:result = 0 + <result> = and i32 4, %var ; yields i32:result = 4 & %var + <result> = and i32 15, 40 ; yields i32:result = 8 + <result> = and i32 4, 8 ; yields i32:result = 0 '``or``' Instruction ^^^^^^^^^^^^^^^^^^^^ @@ -4426,7 +4426,7 @@ Syntax: :: - <result> = or <ty> <op1>, <op2> ; yields {ty}:result + <result> = or <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4463,9 +4463,9 @@ Example: :: - <result> = or i32 4, %var ; yields {i32}:result = 4 | %var - <result> = or i32 15, 40 ; yields {i32}:result = 47 - <result> = or i32 4, 8 ; yields {i32}:result = 12 + <result> = or i32 4, %var ; yields i32:result = 4 | %var + <result> = or i32 15, 40 ; yields i32:result = 47 + <result> = or i32 4, 8 ; yields i32:result = 12 '``xor``' Instruction ^^^^^^^^^^^^^^^^^^^^^ @@ -4475,7 +4475,7 @@ Syntax: :: - <result> = xor <ty> <op1>, <op2> ; yields {ty}:result + <result> = xor <ty> <op1>, <op2> ; yields ty:result Overview: """"""""" @@ -4513,10 +4513,10 @@ Example: .. code-block:: llvm - <result> = xor i32 4, %var ; yields {i32}:result = 4 ^ %var - <result> = xor i32 15, 40 ; yields {i32}:result = 39 - <result> = xor i32 4, 8 ; yields {i32}:result = 12 - <result> = xor i32 %V, -1 ; yields {i32}:result = ~%V + <result> = xor i32 4, %var ; yields i32:result = 4 ^ %var + <result> = xor i32 15, 40 ; yields i32:result = 39 + <result> = xor i32 4, 8 ; yields i32:result = 12 + <result> = xor i32 %V, -1 ; yields i32:result = ~%V Vector Operations ----------------- @@ -4782,7 +4782,7 @@ Syntax: :: - <result> = alloca [inalloca] <type> [, <ty> <NumElements>] [, align <alignment>] ; yields {type*}:result + <result> = alloca [inalloca] <type> [, <ty> <NumElements>] [, align <alignment>] ; yields type*:result Overview: """"""""" @@ -4824,10 +4824,10 @@ Example: .. code-block:: llvm - %ptr = alloca i32 ; yields {i32*}:ptr - %ptr = alloca i32, i32 4 ; yields {i32*}:ptr - %ptr = alloca i32, i32 4, align 1024 ; yields {i32*}:ptr - %ptr = alloca i32, align 1024 ; yields {i32*}:ptr + %ptr = alloca i32 ; yields i32*:ptr + %ptr = alloca i32, i32 4 ; yields i32*:ptr + %ptr = alloca i32, i32 4, align 1024 ; yields i32*:ptr + %ptr = alloca i32, align 1024 ; yields i32*:ptr .. _i_load: @@ -4910,9 +4910,9 @@ Examples: .. code-block:: llvm - %ptr = alloca i32 ; yields {i32*}:ptr - store i32 3, i32* %ptr ; yields {void} - %val = load i32* %ptr ; yields {i32}:val = i32 3 + %ptr = alloca i32 ; yields i32*:ptr + store i32 3, i32* %ptr ; yields void + %val = load i32* %ptr ; yields i32:val = i32 3 .. _i_store: @@ -4924,8 +4924,8 @@ Syntax: :: - store [volatile] <ty> <value>, <ty>* <pointer>[, align <alignment>][, !nontemporal !<index>] ; yields {void} - store atomic [volatile] <ty> <value>, <ty>* <pointer> [singlethread] <ordering>, align <alignment> ; yields {void} + store [volatile] <ty> <value>, <ty>* <pointer>[, align <alignment>][, !nontemporal !<index>] ; yields void + store atomic [volatile] <ty> <value>, <ty>* <pointer> [singlethread] <ordering>, align <alignment> ; yields void Overview: """"""""" @@ -4989,9 +4989,9 @@ Example: .. code-block:: llvm - %ptr = alloca i32 ; yields {i32*}:ptr - store i32 3, i32* %ptr ; yields {void} - %val = load i32* %ptr ; yields {i32}:val = i32 3 + %ptr = alloca i32 ; yields i32*:ptr + store i32 3, i32* %ptr ; yields void + %val = load i32* %ptr ; yields i32:val = i32 3 .. _i_fence: @@ -5003,7 +5003,7 @@ Syntax: :: - fence [singlethread] <ordering> ; yields {void} + fence [singlethread] <ordering> ; yields void Overview: """"""""" @@ -5046,8 +5046,8 @@ Example: .. code-block:: llvm - fence acquire ; yields {void} - fence singlethread seq_cst ; yields {void} + fence acquire ; yields void + fence singlethread seq_cst ; yields void .. _i_cmpxchg: @@ -5059,7 +5059,7 @@ Syntax: :: - cmpxchg [weak] [volatile] <ty>* <pointer>, <ty> <cmp>, <ty> <new> [singlethread] <success ordering> <failure ordering> ; yields { <ty>, i1 } + cmpxchg [weak] [volatile] <ty>* <pointer>, <ty> <cmp>, <ty> <new> [singlethread] <success ordering> <failure ordering> ; yields { ty, i1 } Overview: """"""""" @@ -5127,7 +5127,7 @@ Example: loop: %cmp = phi i32 [ %orig, %entry ], [%old, %loop] %squared = mul i32 %cmp, %cmp - %val_success = cmpxchg i32* %ptr, i32 %cmp, i32 %squared acq_rel monotonic ; yields { i32, i1 } + %val_success = cmpxchg i32* %ptr, i32 %cmp, i32 %squared acq_rel monotonic ; yields { i32, i1 } %value_loaded = extractvalue { i32, i1 } %val_success, 0 %success = extractvalue { i32, i1 } %val_success, 1 br i1 %success, label %done, label %loop @@ -5145,7 +5145,7 @@ Syntax: :: - atomicrmw [volatile] <operation> <ty>* <pointer>, <ty> <value> [singlethread] <ordering> ; yields {ty} + atomicrmw [volatile] <operation> <ty>* <pointer>, <ty> <value> [singlethread] <ordering> ; yields ty Overview: """"""""" @@ -5206,7 +5206,7 @@ Example: .. code-block:: llvm - %old = atomicrmw add i32* %ptr, i32 1 acquire ; yields {i32} + %old = atomicrmw add i32* %ptr, i32 1 acquire ; yields i32 .. _i_getelementptr: @@ -5940,7 +5940,7 @@ Syntax: :: - <result> = icmp <cond> <ty> <op1>, <op2> ; yields {i1} or {<N x i1>}:result + <result> = icmp <cond> <ty> <op1>, <op2> ; yields i1 or <N x i1>:result Overview: """"""""" @@ -6031,7 +6031,7 @@ Syntax: :: - <result> = fcmp <cond> <ty> <op1>, <op2> ; yields {i1} or {<N x i1>}:result + <result> = fcmp <cond> <ty> <op1>, <op2> ; yields i1 or <N x i1>:result Overview: """"""""" @@ -6336,7 +6336,7 @@ Example: call void %foo(i8 97 signext) %struct.A = type { i32, i8 } - %r = call %struct.A @foo() ; yields { 32, i8 } + %r = call %struct.A @foo() ; yields { i32, i8 } %gr = extractvalue %struct.A %r, 0 ; yields i32 %gr1 = extractvalue %struct.A %r, 1 ; yields i8 %Z = call void @foo() noreturn ; indicates that %foo never returns normally @@ -8498,7 +8498,7 @@ Examples: .. code-block:: llvm - %r2 = call float @llvm.fmuladd.f32(float %a, float %b, float %c) ; yields {float}:r2 = (a * b) + c + %r2 = call float @llvm.fmuladd.f32(float %a, float %b, float %c) ; yields float:r2 = (a * b) + c Half Precision Floating Point Intrinsics ---------------------------------------- |