mirror of
https://github.com/QuantumLeaps/qpcpp.git
synced 2025-01-14 05:42:57 +08:00
79 lines
3.8 KiB
Plaintext
79 lines
3.8 KiB
Plaintext
/*! @page gs Getting Started
|
|
|
|
@section gs_help Using the QP™ Help
|
|
<p>You can use this QP™ Help in various ways: either sequentially from beginning to end or just by quickly locating the interesting topic.
|
|
</p>
|
|
|
|
@image html qp_help_using.jpg "QP Documentation View Features"
|
|
|
|
|
|
<div class="separate"></div>
|
|
@subsection gs_help_seq Reading QP™ Help Sequentially
|
|
You can move from topic to topic by means of the <span class="strong underline">Next:</span> link at the bottom of each page.
|
|
|
|
|
|
<div class="separate"></div>
|
|
@subsection gs_help_random Quickly Locating a Topic of Interest
|
|
You can use the following elements:
|
|
|
|
- the @ref gs_tree_view "Tree View" pane on the left-hand side of the browser;
|
|
|
|
- the **Table of Contents** box in the top-right corner of the page;
|
|
|
|
- the **Search** box in the upper-right corner of the browser window
|
|
|
|
|
|
<div class="separate"></div>
|
|
@subsection gs_tree_view Using the Tree View
|
|
The *Tree View* pane on the left-hand side of the browser displays the hierarchical Table of Contents, which can be either **linked-to** or **unlinked-from** the *Current Topic* displayed on the right-hand side. You can toggle between the two modes by pressing the **Link/Unlink Current Topic** icon at the top of the *Tree View* pane.
|
|
|
|
<img src="img/tree-view_linked.png" style="float:left; margin-right:10px;">
|
|
When the *Tree View* is **linked** to the Current Topic, the *Tree View* will always follow the currently viewed topic, by expanding and highlighting the pertinent section of the hierarchical Table of Contents.
|
|
|
|
<div style="clear:both;"></div>
|
|
<img src="img/tree-view_unlinked.png" style="float:left; margin-right:10px;">
|
|
When the *Tree View* is **unlinked** from the Current Topic, the *Tree View* will show only the explicitly selected section of the hierarchical Table of Contents and will **not** follow the topics activated by internal documentation links.
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
@section gs_an Getting Started with QP/C++ App Note
|
|
The Quantum Leaps Application Note <a class="extern" target="_blank" href="http://www.state-machine.com/doc/AN_Getting_Started_with_QPC.pdf"><strong>Getting Started with QP/C++</strong></a> provides step-by-step instructions on how to download, install, and get started with QP/C++ quickly.
|
|
|
|
@htmlonly
|
|
<div class="image">
|
|
<a target="_blank" href="http://www.state-machine.com/doc/AN_Getting_Started_with_QPCpp.pdf"><img border="0" src="img/AN_Getting_Started_with_QPCpp.jpg" title="Download PDF"></a>
|
|
<div class="caption">
|
|
Application Note: Getting Started with QP/C++
|
|
</div>
|
|
</div>
|
|
@endhtmlonly
|
|
|
|
|
|
------------------------------------------------------------------------------
|
|
@section gs_files Directories and Files
|
|
|
|
The following annotated directory tree lists the top-level directories provided in the standard QP/C++ distribution.
|
|
|
|
<ul class="tag">
|
|
<li><span class="img folder">qpc/</span>
|
|
</li>
|
|
<ul class="tag">
|
|
<li><span class="img folder">3rd_party/</span> — Third-Party code used in the QP/C++ @ref ports "ports" and @ref exa "examples"
|
|
</li>
|
|
<li><span class="img folder">examples/</span> — @ref exa "QP/C++ Examples"
|
|
</li>
|
|
<li><span class="img folder">ports/</span> — @ref ports "QP/C++ Ports"
|
|
</li>
|
|
<li><span class="img folder">include/</span> — Platform-independent QP/C++ API (see <a href="dir_d44c64559bbebec7f509842c48db8b23.html"><strong>include</strong></a>)
|
|
</li>
|
|
<li><span class="img folder">source/</span> — Platform-independent QP/C++ source code (see @ref <a href="dir_b2f33c71d4aa5e7af42a1ca61ff5af1b.html"><strong>source</strong></a>)
|
|
</li>
|
|
</ul>
|
|
</ul>
|
|
|
|
@note
|
|
The standard QP/C++ distribution contains many @ref exa "Example Projects", which are specifically designed to help you learn to use QP/C++ and to serve you as starting points for your own projects.
|
|
|
|
@next{struct}
|
|
*/
|