From f3049351dac17f15bab33ec2563a3424ebb906ac Mon Sep 17 00:00:00 2001
From: "Salvador E. Tropea" <salvador@inti.gob.ar>
Date: Fri, 28 Oct 2022 06:30:17 -0300
Subject: [PATCH] [Populate] Documented the changes

- Also added author and license to the files
---
 kibot/PcbDraw/README.md     | 66 +++++++------------------------------
 kibot/PcbDraw/mdrenderer.py |  2 ++
 kibot/PcbDraw/populate.py   |  4 +++
 3 files changed, 18 insertions(+), 54 deletions(-)

diff --git a/kibot/PcbDraw/README.md b/kibot/PcbDraw/README.md
index 46aadb15..75c8d537 100644
--- a/kibot/PcbDraw/README.md
+++ b/kibot/PcbDraw/README.md
@@ -251,58 +251,16 @@ index f8990722..17f90185 100644
   - Fixes issues with Browsers
   - A plotter member controls the precision
   - We adjust the ki2svg and svg2ki converters before plotting
+  - This idea was also adopted by upstream and the code adapted to the way the upstream implemented it
+
+### mdrenderer.py
+
+No current changes
+
+### populate.py
+
+- Removed the command line interface, just because it pulls click
+- Added `create_renderer`. Just creates the correct MD/HTML mistune renderer
+- Made `mdrenderer` import relative. So we get the mdrenderer from the same dir, not the system
+
 
-```diff
-diff --git a/kibot/PcbDraw/plot.py b/kibot/PcbDraw/plot.py
-index 01e7f523..9685d032 100644
---- a/kibot/PcbDraw/plot.py
-+++ b/kibot/PcbDraw/plot.py
-@@ -1066,6 +1066,7 @@ class PcbPlotter():
-         self.margin: tuple = (0, 0, 0, 0)  # Margin of the resulting document
-         self.compute_bbox: bool = False  # Adjust the bbox using the SVG drawings
-         self.kicad_bb_only_edge: bool = False  # Use the PCB edge when asking the BBox to KiCad
-+        self.svg_precision: int = 4  # KiCad 6 SVG scale (1 mm == 10 ** svg_precision)
- 
-         self.yield_warning: Callable[[str, str], None] = lambda tag, msg: None # Handle warnings
- 
-@@ -1074,6 +1075,7 @@ class PcbPlotter():
-         Plot the board based on the arguments stored in this class. Returns
-         SVG tree that you can either save or post-process as you wish.
-         """
-+        self._set_unit_conversion()
-         self._build_libs_path()
-         self._setup_document(self.render_back, self.mirror)
-         for plotter in self.plot_plan:
-@@ -1219,6 +1221,8 @@ class PcbPlotter():
-         with tempfile.TemporaryDirectory() as tmp:
-             pctl = pcbnew.PLOT_CONTROLLER(self.board)
-             popt = pctl.GetPlotOptions()
-+            if isV6(KICAD_VERSION):
-+                popt.SetSvgPrecision(self.svg_precision, False)
-             popt.SetOutputDirectory(tmp)
-             popt.SetScale(1)
-             popt.SetMirror(False)
-@@ -1280,3 +1284,22 @@ class PcbPlotter():
-         self._board_cont.attrib["id"] = "boardContainer"
-         self._comp_cont.attrib["id"] = "componentContainer"
-         self._high_cont.attrib["id"] = "highlightContainer"
-+
-+    def _set_unit_conversion(self):
-+        """ Setup the KiCad to SVG and SVG to KiCad conversions.
-+            Only needed for KiCad 6 where we can select the `SVG precision` """
-+        if not isV6(KICAD_VERSION):
-+            # KiCad 5 has a fixed precision
-+            return
-+        global ki2svg
-+        global svg2ki
-+        if self.svg_precision == 6:
-+            # This is the default for KiCad 6, lamentably this isn't supported by
-+            # Chrome and Firefox (october 2022)
-+            ki2svg = (lambda x: int(x))
-+            svg2ki = (lambda x: int(x))
-+            return
-+        # Not the default precision, must be 0 to 5
-+        divider = 10.0 ** (6 - self.svg_precision)
-+        ki2svg = (lambda x: x / divider)
-+        svg2ki = (lambda x: int(x * divider))
-```
diff --git a/kibot/PcbDraw/mdrenderer.py b/kibot/PcbDraw/mdrenderer.py
index f97ce67c..a42bd381 100644
--- a/kibot/PcbDraw/mdrenderer.py
+++ b/kibot/PcbDraw/mdrenderer.py
@@ -1,4 +1,6 @@
 # coding: utf-8
+# Author: Jaroslav Kysela and Jan Mrázek
+# License: WTFPL 2
 
 """
     Markdown renderer
diff --git a/kibot/PcbDraw/populate.py b/kibot/PcbDraw/populate.py
index 03a03437..14627d88 100644
--- a/kibot/PcbDraw/populate.py
+++ b/kibot/PcbDraw/populate.py
@@ -1,3 +1,7 @@
+#!/usr/bin/env python3
+# Author: Jan Mrázek
+# License: MIT
+
 import codecs
 import os
 import re