Added documentation to Context methods.

[Superhepper]

• Added documentation to the Context methods so that
  they at least have some small documentation.

Signed-off-by: Jesper Brynolf jesper.brynolf@gmail.com

[ionut-arm]

LGTM, are you intending to add references to the spec?

[Superhepper]

I am not sure. I might. But most of all I am going to add some examples before this is done.

[Superhepper]

Do you think the links to the specifications are a good thing?

[puiterwijk]

Do you think the links to the specifications are a good thing?

I don't think that that makes a lot of sense. The Context layer is pretty hard to use for the non-initiated, and the functions are named close enough for the initiated to find them I think.
The abstraction layer should be such that you don't need the specifications, and then sending people there would be detrimental to adoption, I think, as it would mean that they get sent to highly complicated documents to use simple things.

[puiterwijk]

I think that we could do with a higher level crates that are more of the abstraction type of code, but I think that that should be separate endeavours.
I've already done that at some places, like e.g. https://github.com/fedora-iot/rust-tpm2-policy for policy abstraction (though for now it's still lacking a lot of policies, and documentation).

[ionut-arm]

I'm ok with it either way, whether the references to the spec are there or not, I'm just glad we have code examples now

[puiterwijk]

I'm ok with it either way, whether the references to the spec are there or not, I'm just glad we have code examples now

Oh, absolutely! Thanks @Superhepper for the code examples and documentation!

[Superhepper]

I think this PR is finished now. Even though the documentation of Context is not finished it contains a couple a good examples so it is easy for others to continue. And I do not want the PR to be to big.

[puiterwijk]

Looks good to me! Thanks!