Skip to content
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

Update View documentation #21

Closed
wants to merge 1 commit into from

Conversation

crtrott
Copy link
Member

@crtrott crtrott commented May 16, 2022

No description provided.

@@ -41,8 +41,10 @@ Template parameters other than `DataType` are optional, but ordering is enforced
### Enums

* `rank`: rank of the view (i.e. the dimensionality).
* `Rank`: rank of the view (i.e. the dimensionality) (use `rank` instead).
Copy link
Member

Choose a reason for hiding this comment

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

Do you really want to document something we don't want people to use?

reference_type operator[] (const IntType& i) const
```
Returns a value of `reference_type` which may or not be referenceable itself.
See notes on `reference_type` for properties of the return type.
Copy link
Member

Choose a reason for hiding this comment

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

Say it is only available for rank-1 views

* `HostMirror`: compatible view type with the same `DataType` and `LayoutType` stored in host accessible memory space.
* `non_const_type`: this view type with all template parameters explicitly defined.
* `host_mirror_type`: compatible view type with the same `DataType` and `LayoutType` stored in host accessible memory space.
* `HostMirror`: compatible view type with the same `DataType` and `LayoutType` stored in host accessible memory space (use `host_mirror_type` instead).
Copy link
Member

Choose a reason for hiding this comment

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

Same question about documenting deprecated things

@fnrizzi
Copy link
Collaborator

fnrizzi commented Jun 24, 2022

please update this so that you use the sphinx branch

Copy link
Contributor

@masterleinad masterleinad left a comment

Choose a reason for hiding this comment

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

Target the new directories.

@PhilMiller PhilMiller changed the title Update View documentaiton Update View documentation Aug 1, 2022
@crtrott
Copy link
Member Author

crtrott commented Sep 1, 2022

Closing in favor of #155

@crtrott crtrott closed this Sep 1, 2022
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.

4 participants