Skip to content

Add debugging.md #2620

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 4 commits into from
Sep 5, 2019
Merged

Add debugging.md #2620

merged 4 commits into from
Sep 5, 2019

Conversation

r-barnes
Copy link
Contributor

One of the challenges I encountered getting spun up doing stuff with ArrayFire was figuring out how to debug it. Perhaps gathering some advice about this into a document would help?

This is what I've got so far, but maybe others will have thoughts.

(I'm not sure how to incorporate the markdown into the build.)

@9prady9
Copy link
Member

9prady9 commented Aug 22, 2019

Please apply this diff to enable this page in documentation under "Tutorials" section

diff --git a/docs/layout.xml b/docs/layout.xml
index d2f18bc3..724b44f2 100644
--- a/docs/layout.xml
+++ b/docs/layout.xml
@@ -17,6 +17,7 @@
       <tab type="user" url="\ref indexing" visible="yes" title="Indexing"/>
       <tab type="user" url="\ref timing" visible="yes" title="Timing ArrayFire"/>
       <tab type="user" url="\ref configuring_environment" visible="yes" title="Configuring ArrayFire Environment"/>
+      <tab type="user" url="\ref debugging" visible="yes" title="Debugging ArrayFire Code"/>
       <tab type="usergroup" url="\ref page_gfor" visible="yes" title="GFOR Usage"/>
     </tab>
     <tab type="modules" visible="yes" title="Functions" intro="Documentation grouped according to category:"/>

Copy link
Member

@9prady9 9prady9 left a comment

Choose a reason for hiding this comment

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

The entire page should basically look like a hierarchy of sections. Something like the following:

  • Using Environment Variables

  • Tips in Language Bindings

    • C++
    • Python

I am not sure about the tips for language bindings in here - especially python or another like rust. May be they should go into their own documentation.

Copy link
Member

@9prady9 9prady9 left a comment

Choose a reason for hiding this comment

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

@r-barnes I took the liberty of pushing hyperlink changes. I needed to rebase from current master as well. Thank you for the changes.

@9prady9 9prady9 merged commit 4b1d52b into arrayfire:master Sep 5, 2019
@r-barnes
Copy link
Contributor Author

r-barnes commented Sep 5, 2019

Thanks. Sorry for dropping the ball on this: I've been on vacation the past few days.

@r-barnes r-barnes deleted the richard/debug_doc branch September 5, 2019 15:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants