summaryrefslogtreecommitdiff
path: root/docs/utilities.rst
diff options
context:
space:
mode:
authorjaseg <git@jaseg.de>2022-02-03 19:57:16 +0100
committerjaseg <git@jaseg.de>2022-02-03 19:57:16 +0100
commiteaf4f21ce65081da0490a41ee1829b4ec8319109 (patch)
tree07e97aa74f950e0484c4f74ae4d8e02b93377fce /docs/utilities.rst
parentac66fd9d6b3561c1a0fb52ac2e196157bcf5f4fd (diff)
downloadgerbonara-eaf4f21ce65081da0490a41ee1829b4ec8319109.tar.gz
gerbonara-eaf4f21ce65081da0490a41ee1829b4ec8319109.tar.bz2
gerbonara-eaf4f21ce65081da0490a41ee1829b4ec8319109.zip
More doc
Diffstat (limited to 'docs/utilities.rst')
-rw-r--r--docs/utilities.rst15
1 files changed, 15 insertions, 0 deletions
diff --git a/docs/utilities.rst b/docs/utilities.rst
index 80ce5ec..5e75df5 100644
--- a/docs/utilities.rst
+++ b/docs/utilities.rst
@@ -1,8 +1,23 @@
Utilities
=========
+Physical units
+~~~~~~~~~~~~~~
+
+Gerbonara tracks length units using the :py:class:`.LengthUnit` class. :py:class:`.LengthUnit` contains a number of
+conventient conversion functions. Everywhere where Gerbonara accepts units as a method argument, it automatically
+converts a string ``'mm'`` or ``'inch'`` to the corresponding :py:class:`.LengthUnit`.
+
.. autoclass:: gerbonara.utils.LengthUnit
:members:
+Format settings
+~~~~~~~~~~~~~~~
+
+When reading or writing Gerber or Excellon, Gerbonara stores information about file format options such as zero
+suppression or number of decimal places in a :py:class:`.FileSettings` instance. When you are writing a Gerber file,
+Gerbonara picks reasonable defaults, but allows you to specify your own :py:class:`.FileSettings` to override these
+defaults.
+
.. autoclass:: gerbonara.cam.FileSettings
:members: