Skip to content

Commit 4a68309

Browse files
committed
Deploying to main from @ openqasm/openqasm@d263d39 🚀
1 parent dfc8cbf commit 4a68309

25 files changed

+66
-71
lines changed

_sources/grammar/index.rst.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
1-
OpenQasm 3.0 Grammar
1+
OpenQASM 3.0 Grammar
22
====================
33

4-
OpenQasm 3.0 Grammar specification based in ANTLR_ parser generator.
4+
OpenQASM 3.0 Grammar specification based in ANTLR_ parser generator.
55

66
The ANTLR grammar is intended to serve as the official reference grammar for OpenQASM3 and defines
77
the set of syntactically valid statements in the language. ANTLR is used because it provides a

_sources/intro.rst.txt

Lines changed: 5 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -41,11 +41,12 @@ Version 3.0 of the OpenQASM specification aims to extend OpenQASM to include:
4141
Scope
4242
-----
4343

44-
This document aims to define the OpenQASM language itself, but it does not attempt to fully explain
45-
the motivation for various design choices. A forthcoming paper will provide this background. This
46-
document also does not seek to define the execution environment that accepts OpenQASM as an input.
47-
For the previous versions of OpenQASM please read arXiv:1707.03429_.
44+
This document defines the OpenQASM language specification while the motivation behind
45+
its design choices is discussed in detail in arXiv:2104.14722_. Furthermore, the
46+
specification does not define the execution environment that accepts OpenQASM as input.
47+
For information about previous versions of OpenQASM, please refer to arXiv:1707.03429_.
4848

49+
.. _arXiv:2104.14722: https://arxiv.org/abs/2104.14722
4950
.. _arXiv:1707.03429: https://arxiv.org/abs/1707.03429
5051

5152
Implementation Details

_sources/language/index.rst.txt

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -12,10 +12,7 @@ Statements are separated by semicolons and whitespace is ignored.
1212
In other respects, OpenQASM possesses a dual nature as an assembly language and
1313
as a hardware description language.
1414

15-
Appendix `[app:summary] <#app:summary>`__ summarizes the
16-
language statements, Appendix `[app:grammar] <#app:grammar>`__ specifies
17-
the grammar, and Appendix `[app:semantics] <#app:semantics>`__ gives formal
18-
semantics.
15+
The OpenQASM grammar specifications can be found at `[OpenQASM 3.0 Grammar] <../grammar/index.html>`__.
1916

2017
.. toctree::
2118

_sources/language/openpulse.rst.txt

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
OpenPulse Grammar
22
=================
33

4-
*The OpenPulse grammar is still in active development and is liable to change. If you are working on an implementation and find this specification unclear or not supporting your use-cases, please join our community effort to improve pulse-level support in OpenQasm.*
4+
*The OpenPulse grammar is still in active development and is liable to change. If you are working on an implementation and find this specification unclear or not supporting your use-cases, please join our community effort to improve pulse-level support in OpenQASM.*
55

66
OpenQASM allows users to provide the target system's implementation of quantum operations
77
with ``cal`` and ``defcal`` blocks . Calibration grammars are open to extension for system implementors. In

genindex.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -221,7 +221,7 @@ <h3>Navigation</h3>
221221
<ul>
222222
<li class="toctree-l1"><a class="reference internal" href="intro.html">Introduction</a></li>
223223
<li class="toctree-l1"><a class="reference internal" href="language/index.html">Language</a></li>
224-
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQasm 3.0 Grammar</a></li>
224+
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQASM 3.0 Grammar</a></li>
225225
<li class="toctree-l1"><a class="reference internal" href="release_notes.html">Release Notes</a></li>
226226
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
227227
</ul>

grammar/index.html

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@
55
<meta charset="utf-8" />
66
<meta name="viewport" content="width=device-width, initial-scale=1.0" /><meta name="generator" content="Docutils 0.19: https://docutils.sourceforge.io/" />
77

8-
<title>OpenQasm 3.0 Grammar &#8212; OpenQASM Live Specification documentation</title>
8+
<title>OpenQASM 3.0 Grammar &#8212; OpenQASM Live Specification documentation</title>
99
<link rel="stylesheet" type="text/css" href="../_static/pygments.css?v=d1102ebc" />
1010
<link rel="stylesheet" type="text/css" href="../_static/alabaster.css?v=12dfc556" />
1111
<link rel="stylesheet" type="text/css" href="../_static/colors.css?v=3aae764c" />
@@ -34,8 +34,8 @@
3434
<div class="body" role="main">
3535

3636
<section id="openqasm-3-0-grammar">
37-
<h1>OpenQasm 3.0 Grammar<a class="headerlink" href="#openqasm-3-0-grammar" title="Link to this heading"></a></h1>
38-
<p>OpenQasm 3.0 Grammar specification based in <a class="reference external" href="https://www.antlr.org/">ANTLR</a> parser generator.</p>
37+
<h1>OpenQASM 3.0 Grammar<a class="headerlink" href="#openqasm-3-0-grammar" title="Link to this heading"></a></h1>
38+
<p>OpenQASM 3.0 Grammar specification based in <a class="reference external" href="https://www.antlr.org/">ANTLR</a> parser generator.</p>
3939
<p>The ANTLR grammar is intended to serve as the official reference grammar for OpenQASM3 and defines
4040
the set of syntactically valid statements in the language. ANTLR is used because it provides a
4141
human-readable EBNF format that is computer-validatable. It provides an auto-generated parser that is
@@ -563,7 +563,7 @@ <h3>Navigation</h3>
563563
<ul class="current">
564564
<li class="toctree-l1"><a class="reference internal" href="../intro.html">Introduction</a></li>
565565
<li class="toctree-l1"><a class="reference internal" href="../language/index.html">Language</a></li>
566-
<li class="toctree-l1 current"><a class="current reference internal" href="#">OpenQasm 3.0 Grammar</a></li>
566+
<li class="toctree-l1 current"><a class="current reference internal" href="#">OpenQASM 3.0 Grammar</a></li>
567567
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
568568
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
569569
</ul>

index.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -131,9 +131,9 @@ <h1>OpenQASM Live Specification<a class="headerlink" href="#openqasm-version-spe
131131
</li>
132132
</ul>
133133
</li>
134-
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQasm 3.0 Grammar</a></li>
134+
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQASM 3.0 Grammar</a></li>
135135
<li class="toctree-l1"><a class="reference internal" href="release_notes.html">Release Notes</a><ul>
136-
<li class="toctree-l2"><a class="reference internal" href="release_notes.html#spec-v3-1-0-19">spec/v3.1.0-19</a><ul>
136+
<li class="toctree-l2"><a class="reference internal" href="release_notes.html#spec-v3-1-0-20">spec/v3.1.0-20</a><ul>
137137
<li class="toctree-l3"><a class="reference internal" href="release_notes.html#new-features">New Features</a></li>
138138
<li class="toctree-l3"><a class="reference internal" href="release_notes.html#upgrade-notes">Upgrade Notes</a></li>
139139
<li class="toctree-l3"><a class="reference internal" href="release_notes.html#bug-fixes">Bug Fixes</a></li>
@@ -217,7 +217,7 @@ <h3>Navigation</h3>
217217
<ul>
218218
<li class="toctree-l1"><a class="reference internal" href="intro.html">Introduction</a></li>
219219
<li class="toctree-l1"><a class="reference internal" href="language/index.html">Language</a></li>
220-
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQasm 3.0 Grammar</a></li>
220+
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQASM 3.0 Grammar</a></li>
221221
<li class="toctree-l1"><a class="reference internal" href="release_notes.html">Release Notes</a></li>
222222
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
223223
</ul>

intro.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -67,10 +67,10 @@ <h2>Design Goals<a class="headerlink" href="#design-goals" title="Link to this h
6767
</section>
6868
<section id="scope">
6969
<h2>Scope<a class="headerlink" href="#scope" title="Link to this heading"></a></h2>
70-
<p>This document aims to define the OpenQASM language itself, but it does not attempt to fully explain
71-
the motivation for various design choices. A forthcoming paper will provide this background. This
72-
document also does not seek to define the execution environment that accepts OpenQASM as an input.
73-
For the previous versions of OpenQASM please read <a class="reference external" href="https://arxiv.org/abs/1707.03429">arXiv:1707.03429</a>.</p>
70+
<p>This document defines the OpenQASM language specification while the motivation behind
71+
its design choices is discussed in detail in <a class="reference external" href="https://arxiv.org/abs/2104.14722">arXiv:2104.14722</a>. Furthermore, the
72+
specification does not define the execution environment that accepts OpenQASM as input.
73+
For information about previous versions of OpenQASM, please refer to <a class="reference external" href="https://arxiv.org/abs/1707.03429">arXiv:1707.03429</a>.</p>
7474
</section>
7575
<section id="implementation-details">
7676
<h2>Implementation Details<a class="headerlink" href="#implementation-details" title="Link to this heading"></a></h2>
@@ -161,7 +161,7 @@ <h3>Navigation</h3>
161161
</ul>
162162
</li>
163163
<li class="toctree-l1"><a class="reference internal" href="language/index.html">Language</a></li>
164-
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQasm 3.0 Grammar</a></li>
164+
<li class="toctree-l1"><a class="reference internal" href="grammar/index.html">OpenQASM 3.0 Grammar</a></li>
165165
<li class="toctree-l1"><a class="reference internal" href="release_notes.html">Release Notes</a></li>
166166
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
167167
</ul>

language/classical.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -729,7 +729,7 @@ <h3>Navigation</h3>
729729
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
730730
</ul>
731731
</li>
732-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
732+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
733733
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
734734
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
735735
</ul>

language/comments.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -111,7 +111,7 @@ <h3>Navigation</h3>
111111
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
112112
</ul>
113113
</li>
114-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
114+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
115115
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
116116
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
117117
</ul>

language/delays.html

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -89,13 +89,13 @@ <h1>Circuit timing<a class="headerlink" href="#circuit-timing" title="Link to th
8989
program.</p>
9090
<figure class="align-default" id="id2">
9191
<span id="fig-alignment"></span><div class="figure-content" style="display: flex; gap: 2rem 0; flex-direction: row; justify-content: center; align-items: baseline; flex-wrap: wrap;">
92-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
92+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
9393
<img alt="../_images/d1.svg" src="../_images/d1.svg" /><p class="caption">
9494
<span class="caption-number">
9595
a</p>
9696
</span>
9797
</div>
98-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
98+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
9999
<img alt="../_images/d2.svg" src="../_images/d2.svg" /><p class="caption">
100100
<span class="caption-number">
101101
b</p>
@@ -185,13 +185,13 @@ <h2>Delays (and other duration-based instructions)<a class="headerlink" href="#d
185185
gate commutation is prohibited (Figure <a class="reference internal" href="#fig-delaycommute"><span class="std std-numref">Fig. 5</span></a>b).</p>
186186
<figure class="align-default" id="id3">
187187
<span id="fig-delaycommute"></span><div class="figure-content" style="display: flex; gap: 2rem 0; flex-direction: row; justify-content: center; align-items: baseline; flex-wrap: wrap;">
188-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
188+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
189189
<img alt="../_images/d3.svg" src="../_images/d3.svg" /><p class="caption">
190190
<span class="caption-number">
191191
a</p>
192192
</span>
193193
</div>
194-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
194+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
195195
<img alt="../_images/d4.svg" src="../_images/d4.svg" /><p class="caption">
196196
<span class="caption-number">
197197
b</p>
@@ -211,13 +211,13 @@ <h2>Delays (and other duration-based instructions)<a class="headerlink" href="#d
211211
</figure>
212212
<figure class="align-default" id="id4">
213213
<span id="fig-dcg"></span><div class="figure-content" style="display: flex; gap: 2rem 0; flex-direction: row; justify-content: center; align-items: baseline; flex-wrap: wrap;">
214-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
214+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
215215
<img alt="../_images/d5.svg" src="../_images/d5.svg" /><p class="caption">
216216
<span class="caption-number">
217217
a</p>
218218
</span>
219219
</div>
220-
<div class="figure-item" style="max-height: 10rem; width: 50%; display: flex; flex-direction: column;">
220+
<div class="figure-item" style="max-height: 13rem; width: 50%; display: flex; flex-direction: column;">
221221
<img alt="../_images/d6.svg" src="../_images/d6.svg" /><p class="caption">
222222
<span class="caption-number">
223223
b</p>
@@ -234,7 +234,7 @@ <h2>Delays (and other duration-based instructions)<a class="headerlink" href="#d
234234
</figure>
235235
<figure class="align-default" id="id5">
236236
<span id="fig-dd"></span><div class="figure-content" style="display: flex; gap: 2rem 0; flex-direction: row; justify-content: center; align-items: center; flex-wrap: wrap;">
237-
<div class="figure-item" style="max-height: 10rem; width: 100%; display: flex; flex-direction: column;">
237+
<div class="figure-item" style="max-height: 13rem; width: 100%; display: flex; flex-direction: column;">
238238
<img alt="../_images/d7.svg" src="../_images/d7.svg" /></div>
239239
</div>
240240
<figcaption>
@@ -421,7 +421,7 @@ <h3>Navigation</h3>
421421
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
422422
</ul>
423423
</li>
424-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
424+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
425425
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
426426
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
427427
</ul>

language/directives.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -238,7 +238,7 @@ <h3>Navigation</h3>
238238
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
239239
</ul>
240240
</li>
241-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
241+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
242242
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
243243
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
244244
</ul>

language/gates.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -403,7 +403,7 @@ <h3>Navigation</h3>
403403
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
404404
</ul>
405405
</li>
406-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
406+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
407407
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
408408
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
409409
</ul>

language/index.html

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -42,10 +42,7 @@
4242
Statements are separated by semicolons and whitespace is ignored.</p>
4343
<p>In other respects, OpenQASM possesses a dual nature as an assembly language and
4444
as a hardware description language.</p>
45-
<p>Appendix <a class="reference external" href="#app:summary">[app:summary]</a> summarizes the
46-
language statements, Appendix <a class="reference external" href="#app:grammar">[app:grammar]</a> specifies
47-
the grammar, and Appendix <a class="reference external" href="#app:semantics">[app:semantics]</a> gives formal
48-
semantics.</p>
45+
<p>The OpenQASM grammar specifications can be found at <a class="reference external" href="../grammar/index.html">[OpenQASM 3.0 Grammar]</a>.</p>
4946
<div class="toctree-wrapper compound">
5047
<ul>
5148
<li class="toctree-l1"><a class="reference internal" href="comments.html">Comments</a></li>
@@ -263,7 +260,7 @@ <h3>Navigation</h3>
263260
<li class="toctree-l2"><a class="reference internal" href="openpulse.html">OpenPulse Grammar</a></li>
264261
</ul>
265262
</li>
266-
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQasm 3.0 Grammar</a></li>
263+
<li class="toctree-l1"><a class="reference internal" href="../grammar/index.html">OpenQASM 3.0 Grammar</a></li>
267264
<li class="toctree-l1"><a class="reference internal" href="../release_notes.html">Release Notes</a></li>
268265
<li class="toctree-l1"><a class="reference external" href="https://github.com/openqasm/openqasm/">GitHub</a></li>
269266
</ul>

0 commit comments

Comments
 (0)