Skip to content

Add Doxygen API docs #314

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 41 commits into from
Sep 2, 2021
Merged
Show file tree
Hide file tree
Changes from 16 commits
Commits
Show all changes
41 commits
Select commit Hold shift + click to select a range
0c9f2e3
added doxygen generated files
jmklix Aug 23, 2021
0224a20
move doxygen output to docs folder for github pages
jmklix Aug 23, 2021
21b8ad7
Set theme jekyll-theme-cayman
jmklix Aug 23, 2021
c92fe84
add index.html file to redirect to subfolder
jmklix Aug 23, 2021
a39c346
Merge branch 'doxygen' of https://github.com/aws/aws-iot-device-sdk-c…
jmklix Aug 23, 2021
e66813c
Merge branch 'main' of https://github.com/aws/aws-iot-device-sdk-cpp-…
jmklix Aug 23, 2021
ddf74cd
remove doxygen folder
jmklix Aug 25, 2021
9543c24
enable recursive docs generation
jmklix Aug 25, 2021
0e16276
exclude crt from doxygen
jmklix Aug 25, 2021
9c39892
regen docs
jmklix Aug 25, 2021
f160384
remove generation on tests and readd crt docs
jmklix Aug 25, 2021
1f54e4c
readd docs
jmklix Aug 25, 2021
c1b204c
readd index.html
jmklix Aug 25, 2021
95b7225
remove more tests from doc generation
jmklix Aug 25, 2021
bef0f02
simplify exclusion list
jmklix Aug 25, 2021
51f9968
add api link to docs
jmklix Aug 26, 2021
f83b731
fix readme links
jmklix Aug 26, 2021
eb31743
regen docs
jmklix Aug 26, 2021
3eef6fe
attempt to fix samples link in doxygen
jmklix Aug 26, 2021
a47809b
attempt 3 to fix links
jmklix Aug 26, 2021
74b5d20
remove @ref
jmklix Aug 26, 2021
409d9df
make revisions from PR and add new landing page
jmklix Aug 27, 2021
b496f7c
add mainpage.md
jmklix Aug 28, 2021
3232990
modify index.html to point to generated mainpage
jmklix Aug 28, 2021
41559cf
attempt to remove C classes
jmklix Aug 28, 2021
c8e80e5
add android to filter
jmklix Aug 30, 2021
224a5d3
exclude common
jmklix Aug 30, 2021
fb85910
filter crt
jmklix Aug 30, 2021
6b66c82
edit filter
jmklix Aug 30, 2021
f71e6d1
edit filtered list
jmklix Aug 30, 2021
ea664d2
removed crt docs
jmklix Aug 30, 2021
8052887
restructure docs folder and make python generation script
jmklix Sep 1, 2021
002de9f
fix mainpage
jmklix Sep 1, 2021
0bc070b
regen docs
jmklix Sep 1, 2021
9185b53
fix mainpage
jmklix Sep 1, 2021
a380025
rename mainpage to mainpage.md
jmklix Sep 1, 2021
0e3fba4
move doc gen files to doccrs
jmklix Sep 1, 2021
f197aa5
enable EXTRACT_ALL and CREATE_SUBDIRS
jmklix Sep 2, 2021
d056a02
disable CREATE_SUBDIRS
jmklix Sep 2, 2021
e37abb4
add links for aws-crt-cpp on mainpage
jmklix Sep 2, 2021
d932f88
Merge branch 'main' into doxygen
jmklix Sep 2, 2021
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
The diff you're trying to view is too large. We only load the first 3000 changed files.
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,6 +76,7 @@ The best way to interact with our team is through GitHub. You can [open an issue
Please make sure to check out our resources too before opening an issue:

* Our [FAQ](FAQ.md)
* [API Docs](https://aws.github.io/aws-iot-device-sdk-cpp-v2/)
* Our [Developer Guide](https://docs.aws.amazon.com/iot/latest/developerguide/what-is-aws-iot.html) ([source](https://github.com/awsdocs/aws-iot-docs))
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

it would be great to get comments on the generated service code, like we have in python. But that requires touching the code generators, which is not trivial. But we should do it some day

* Check for similar [Issues](https://github.com/aws/aws-iot-device-sdk-cpp-v2/issues)
* [AWS IoT Core Documentation](https://docs.aws.amazon.com/iot/)
Expand Down
79 changes: 79 additions & 0 deletions docs/html/____init_____8py.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,79 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.2"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>AWS IoT Device SDK C++ v2: crt/aws-crt-cpp/crt/aws-c-common/verification/cbmc/litani/lib/__init__.py File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">AWS IoT Device SDK C++ v2<span id="projectnumber">&#160;1.14.0</span>
</div>
<div id="projectbrief">AWS IoT Device SDK C++ v2</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.2 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_affb495f978f3575eca2eeb81eb7736b.html">crt</a></li><li class="navelem"><a class="el" href="dir_eb065311872385a3a1227a6ede2c108c.html">aws-crt-cpp</a></li><li class="navelem"><a class="el" href="dir_c68d83f7493c97e50c45ec06f21e3081.html">crt</a></li><li class="navelem"><a class="el" href="dir_fab3a90bc3065fb2d7dcf327c1e16d97.html">aws-c-common</a></li><li class="navelem"><a class="el" href="dir_c606023e394e67ada440211e2f8acca4.html">verification</a></li><li class="navelem"><a class="el" href="dir_1acb4cd0f3c55772b34625105e6c8d18.html">cbmc</a></li><li class="navelem"><a class="el" href="dir_ca4d48a85c7f6785431233cf6627c0ae.html">litani</a></li><li class="navelem"><a class="el" href="dir_91ddff65ed513634821dab33a7c57579.html">lib</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="headertitle"><div class="title">__init__.py File Reference</div></div>
</div><!--header-->
<div class="contents">
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.2
</small></address>
</body>
</html>
113 changes: 113 additions & 0 deletions docs/html/_api_8cpp.html
Original file line number Diff line number Diff line change
@@ -0,0 +1,113 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head>
<meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/>
<meta http-equiv="X-UA-Compatible" content="IE=11"/>
<meta name="generator" content="Doxygen 1.9.2"/>
<meta name="viewport" content="width=device-width, initial-scale=1"/>
<title>AWS IoT Device SDK C++ v2: crt/aws-crt-cpp/source/Api.cpp File Reference</title>
<link href="tabs.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="jquery.js"></script>
<script type="text/javascript" src="dynsections.js"></script>
<link href="search/search.css" rel="stylesheet" type="text/css"/>
<script type="text/javascript" src="search/searchdata.js"></script>
<script type="text/javascript" src="search/search.js"></script>
<link href="doxygen.css" rel="stylesheet" type="text/css" />
</head>
<body>
<div id="top"><!-- do not remove this div, it is closed by doxygen! -->
<div id="titlearea">
<table cellspacing="0" cellpadding="0">
<tbody>
<tr style="height: 56px;">
<td id="projectalign" style="padding-left: 0.5em;">
<div id="projectname">AWS IoT Device SDK C++ v2<span id="projectnumber">&#160;1.14.0</span>
</div>
<div id="projectbrief">AWS IoT Device SDK C++ v2</div>
</td>
</tr>
</tbody>
</table>
</div>
<!-- end header part -->
<!-- Generated by Doxygen 1.9.2 -->
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
var searchBox = new SearchBox("searchBox", "search",'Search','.html');
/* @license-end */
</script>
<script type="text/javascript" src="menudata.js"></script>
<script type="text/javascript" src="menu.js"></script>
<script type="text/javascript">
/* @license magnet:?xt=urn:btih:d3d9a9a6595521f9666a5e94cc830dab83b65699&amp;dn=expat.txt MIT */
$(function() {
initMenu('',true,false,'search.php','Search');
$(document).ready(function() { init_search(); });
});
/* @license-end */
</script>
<div id="main-nav"></div>
<!-- window showing the filter options -->
<div id="MSearchSelectWindow"
onmouseover="return searchBox.OnSearchSelectShow()"
onmouseout="return searchBox.OnSearchSelectHide()"
onkeydown="return searchBox.OnSearchSelectKey(event)">
</div>

<!-- iframe showing the search results (closed by default) -->
<div id="MSearchResultsWindow">
<iframe src="javascript:void(0)" frameborder="0"
name="MSearchResults" id="MSearchResults">
</iframe>
</div>

<div id="nav-path" class="navpath">
<ul>
<li class="navelem"><a class="el" href="dir_affb495f978f3575eca2eeb81eb7736b.html">crt</a></li><li class="navelem"><a class="el" href="dir_eb065311872385a3a1227a6ede2c108c.html">aws-crt-cpp</a></li><li class="navelem"><a class="el" href="dir_21df4b5f3bc78585b5795fff97334c8c.html">source</a></li> </ul>
</div>
</div><!-- top -->
<div class="header">
<div class="summary">
<a href="#namespaces">Namespaces</a> &#124;
<a href="#func-members">Functions</a> </div>
<div class="headertitle"><div class="title">Api.cpp File Reference</div></div>
</div><!--header-->
<div class="contents">
<div class="textblock"><code>#include &lt;<a class="el" href="_api_8h_source.html">aws/crt/Api.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="_stl_allocator_8h_source.html">aws/crt/StlAllocator.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="aws-crt-cpp_2include_2aws_2crt_2external_2c_j_s_o_n_8h_source.html">aws/crt/external/cJSON.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="_tls_options_8h_source.html">aws/crt/io/TlsOptions.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="auth_8h_source.html">aws/auth/auth.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="ref__count_8h_source.html">aws/common/ref_count.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="http_8h_source.html">aws/http/http.h</a>&gt;</code><br />
<code>#include &lt;<a class="el" href="mqtt_8h_source.html">aws/mqtt/mqtt.h</a>&gt;</code><br />
</div><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="namespaces" name="namespaces"></a>
Namespaces</h2></td></tr>
<tr class="memitem:namespace_aws"><td class="memItemLeft" align="right" valign="top">namespace &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws.html">Aws</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:namespace_aws_1_1_crt"><td class="memItemLeft" align="right" valign="top">namespace &#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html">Aws::Crt</a></td></tr>
<tr class="separator:"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table><table class="memberdecls">
<tr class="heading"><td colspan="2"><h2 class="groupheader"><a id="func-members" name="func-members"></a>
Functions</h2></td></tr>
<tr class="memitem:a070ad73c54333c051188bf6e0dd6ac6c"><td class="memItemLeft" align="right" valign="top">static void *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#a070ad73c54333c051188bf6e0dd6ac6c">Aws::Crt::s_cJSONAlloc</a> (size_t sz)</td></tr>
<tr class="separator:a070ad73c54333c051188bf6e0dd6ac6c"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a27de811f7c8f5a54fd7255da88cc8acb"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#a27de811f7c8f5a54fd7255da88cc8acb">Aws::Crt::s_cJSONFree</a> (void *ptr)</td></tr>
<tr class="separator:a27de811f7c8f5a54fd7255da88cc8acb"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a1a323010caf6386d86f1377ff1133e60"><td class="memItemLeft" align="right" valign="top">static void&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#a1a323010caf6386d86f1377ff1133e60">Aws::Crt::s_initApi</a> (Allocator *allocator)</td></tr>
<tr class="separator:a1a323010caf6386d86f1377ff1133e60"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a381b8c42c48a6a9408017d273d660dda"><td class="memItemLeft" align="right" valign="top"><a class="el" href="crt_2aws-crt-cpp_2include_2aws_2crt_2_exports_8h.html#a0a3f6c46aee6b588ce99a142cdb22d1d">AWS_CRT_CPP_API</a> const char *&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#a381b8c42c48a6a9408017d273d660dda">Aws::Crt::ErrorDebugString</a> (int <a class="el" href="structerror.html">error</a>) noexcept</td></tr>
<tr class="separator:a381b8c42c48a6a9408017d273d660dda"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:aec41cfe367315d4e4e1712f19e3d3061"><td class="memItemLeft" align="right" valign="top"><a class="el" href="crt_2aws-crt-cpp_2include_2aws_2crt_2_exports_8h.html#a0a3f6c46aee6b588ce99a142cdb22d1d">AWS_CRT_CPP_API</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#aec41cfe367315d4e4e1712f19e3d3061">Aws::Crt::LastError</a> () noexcept</td></tr>
<tr class="separator:aec41cfe367315d4e4e1712f19e3d3061"><td class="memSeparator" colspan="2">&#160;</td></tr>
<tr class="memitem:a09743b0ee6cb7e924ce2107ec8f81de6"><td class="memItemLeft" align="right" valign="top"><a class="el" href="crt_2aws-crt-cpp_2include_2aws_2crt_2_exports_8h.html#a0a3f6c46aee6b588ce99a142cdb22d1d">AWS_CRT_CPP_API</a> int&#160;</td><td class="memItemRight" valign="bottom"><a class="el" href="namespace_aws_1_1_crt.html#a09743b0ee6cb7e924ce2107ec8f81de6">Aws::Crt::LastErrorOrUnknown</a> () noexcept</td></tr>
<tr class="separator:a09743b0ee6cb7e924ce2107ec8f81de6"><td class="memSeparator" colspan="2">&#160;</td></tr>
</table>
</div><!-- contents -->
<!-- start footer part -->
<hr class="footer"/><address class="footer"><small>
Generated by&#160;<a href="https://www.doxygen.org/index.html"><img class="footer" src="doxygen.svg" width="104" height="31" alt="doxygen"/></a> 1.9.2
</small></address>
</body>
</html>
Loading