From e80c0f7c5e741f9cfb3ca922d47e60eba586c8a8 Mon Sep 17 00:00:00 2001 From: Marian Beermann Date: Mon, 5 Jun 2017 01:00:41 +0200 Subject: [PATCH] docs: fix way too small figures in pdf --- docs/conf.py | 1 + docs/internals.rst | 2 ++ docs/internals/data-structures.rst | 9 +++++++-- 3 files changed, 10 insertions(+), 2 deletions(-) diff --git a/docs/conf.py b/docs/conf.py index 1baf39a75..30171b3be 100644 --- a/docs/conf.py +++ b/docs/conf.py @@ -207,6 +207,7 @@ latex_elements = { 'papersize': 'a4paper', 'pointsize': '10pt', + 'figure_align': 'H', } # For "manual" documents, if this is true, then toplevel headings are parts, diff --git a/docs/internals.rst b/docs/internals.rst index 35ab0018e..973d1e6ed 100644 --- a/docs/internals.rst +++ b/docs/internals.rst @@ -27,6 +27,8 @@ chunk is checked against the :ref:`chunks cache `, which is a hash-table of all chunks that already exist. .. figure:: internals/structure.png + :figwidth: 100% + :width: 100% Layers in Borg. On the very top commands are implemented, using a data access layer provided by the Archive and Item classes. diff --git a/docs/internals/data-structures.rst b/docs/internals/data-structures.rst index e6e52fe62..c9ecf7923 100644 --- a/docs/internals/data-structures.rst +++ b/docs/internals/data-structures.rst @@ -204,8 +204,9 @@ commit is written to the new segment. Then, the old segment is deleted A simplified example (excluding conditional compaction and with simpler commit logic) showing the principal operation of compaction: -.. figure:: - compaction.png +.. figure:: compaction.png + :figwidth: 100% + :width: 100% (The actual algorithm is more complex to avoid various consistency issues, refer to the ``borg.repository`` module for more comments and documentation on these issues.) @@ -288,6 +289,8 @@ by their chunk ID, which is cryptographically derived from their contents. More on how this helps security in :ref:`security_structural_auth`. .. figure:: object-graph.png + :figwidth: 100% + :width: 100% .. _manifest: @@ -640,6 +643,8 @@ and both are stored in the chunk. Encryption and MAC use two different keys. Each chunk consists of ``TYPE(1)`` + ``MAC(32)`` + ``NONCE(8)`` + ``CIPHERTEXT``: .. figure:: encryption.png + :figwidth: 100% + :width: 100% In AES-CTR mode you can think of the IV as the start value for the counter. The counter itself is incremented by one after each 16 byte block.