diff options
| author | Sybren A. Stüvel <sybren@stuvel.eu> | 2022-07-20 11:00:13 +0200 |
|---|---|---|
| committer | Sybren A. Stüvel <sybren@stuvel.eu> | 2022-07-20 11:28:13 +0200 |
| commit | ce5a32f3fdbcb5128800719e2c3d68e6248d3e47 (patch) | |
| tree | 535084815d7ed9ae22fd1910e0d87d3afbeaf620 /doc | |
| parent | 0e3e54859f85d352e6a71f4069f5481b03d9e4e8 (diff) | |
| download | rsa-git-ce5a32f3fdbcb5128800719e2c3d68e6248d3e47.tar.gz | |
Fix #199: Sphinx warnings reference target not found
Fix the documentation by adding referenced-but-not-included functions and
some other small fixes.
The only warnings left are:
```
python-rsa/rsa/key.py:docstring of rsa.key.AbstractKey.load_pkcs1:: WARNING: py:class reference target not found: rsa.key.T
python-rsa/rsa/key.py:docstring of rsa.key.AbstractKey.load_pkcs1:: WARNING: py:class reference target not found: rsa.key.T
```
These are due to Sphynx not really understanding `typing` type references.
Not sure how to fix those.
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/reference.rst | 10 | ||||
| -rw-r--r-- | doc/usage.rst | 2 |
2 files changed, 10 insertions, 2 deletions
diff --git a/doc/reference.rst b/doc/reference.rst index 9da7c6b..a0d9b6b 100644 --- a/doc/reference.rst +++ b/doc/reference.rst @@ -17,7 +17,13 @@ Functions .. autofunction:: rsa.find_signature_hash -.. autofunction:: rsa.newkeys(keysize) +.. autofunction:: rsa.newkeys + +.. autofunction:: rsa.sign_hash + +.. autofunction:: rsa.compute_hash + +.. autodata:: rsa.pkcs1.HASH_METHODS Classes @@ -31,6 +37,8 @@ Classes constructed data. Never unpickle data received from an untrusted or unauthenticated source. +.. autoclass:: rsa.key.AbstractKey + .. autoclass:: rsa.PublicKey :members: :inherited-members: diff --git a/doc/usage.rst b/doc/usage.rst index a55a2bc..5c60e2d 100644 --- a/doc/usage.rst +++ b/doc/usage.rst @@ -214,7 +214,7 @@ Modify the message, and the signature is no longer valid and a makes cracking the keys easier. Instead of a message you can also call :py:func:`rsa.sign` and -:py:func:`rsa.verify` with a :py:class:`file`-like object. If the +:py:func:`rsa.verify` with a `file`-like object. If the message object has a ``read(int)`` method it is assumed to be a file. In that case the file is hashed in 1024-byte blocks at the time. |