Summary: to make sphinx happy.

Test Plan: make -C docs

Reviewers: ardumont

Reviewed By: ardumont

Differential Revision: https://forge.softwareheritage.org/D571

double back-quote (``) are not interpreted when inside a emphasis block.

This prevent from requiring a too much recent tox version to fire the
tests, especially this allows to run tests using stretch's tox version.

Promote "Resolution" to a new top-level section, because it's now rather
voluminous.

As part of this document the resolver limitations of identifiers.org, that get
in the way of PID contextual information.

Closes T1015
Closes T1223

so pytest does not think they are test classes.

to clear deprecation warnings.

related to T1261

Summary: Related to T1261

Test Plan: before and after: 138 tests passed (2 skipped)

Reviewers: #reviewers!

Differential Revision: https://forge.softwareheritage.org/D520

and ensure it is included in the source package.

Related to T1265.

to prevent confusion with setup()'s "extras_require" argument.

related to T1242

it makes life a bit easier for CI (less dependencies).

This is a temporary move.  This will eventually converge with
swh.model.cli as the directory hashing ability overlaps.  What's
missing in the cli for now is the ability to filter patterns.

This is mostly used to compute hashes on tree coming from multiple
dvcs. This imposes the need to be able to filter pattern like .svn,
.hg, etc...

Related D454

This aligns the new api with the old one.

Remove unused track_length parameter

And revert to their original behavior (returning only digest as bytes)

This allows calls like:

- MultiHash.from_file(file_object).digest()
- MultiHash.from_path(b'foo').hexdigest()
- MultiHash.from_data(b'foo').bytehexdigest()

This is the first step to improve the hashutil module according to
"the" plan [1].

In this regards, the hashutil exposes the same function as before.
Internally though, they now uses a MultiHash instance.

Related D410

[1] D410#7952