From 59514d6cf205d3a98a2fcfb97bc22d75e301fb90 Mon Sep 17 00:00:00 2001
From: Alexey Vazhnov <vazhnov@boot-keys.org>
Date: Sun, 21 Dec 2025 16:23:15 +0100
Subject: [PATCH 1/4] README.md: expand description, add links

---
 README.md | 12 ++++++++++--
 1 file changed, 10 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index efd4047..2cfac82 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,12 @@
 # svg2ild
 
-Converts a series of .svg files to .ild animation for laser shows
-ILDA - image data transfer format for laser shows
+Converts a series of .svg files to .ild animation for laser shows.
+
+ILDA - image data transfer format for laser shows.
+Description of the format, made by author of the `LaserBoy`: <https://laserboy.org/ilda_file_format.html>.
+
+## Links
+
+* Homepage: <https://git.hswro.org/miklo/svg2ild>.
+* Documentation: <https://git.hswro.org/miklo/svg2ild/wiki>.
+* Mirror: <https://forge.citizen4.eu/miklo/svg2ild>.
-- 
2.40.1


From 01d3fbc35a288bb3e56e08113426d94e6fbf547c Mon Sep 17 00:00:00 2001
From: Alexey Vazhnov <vazhnov@boot-keys.org>
Date: Sun, 21 Dec 2025 19:09:34 +0100
Subject: [PATCH 2/4] README.md: + How to detect an internal format of .ild
 file; + https://ilda.com/resources/StandardsDocs/ILDA_IDTF14_rev011.pdf

---
 README.md | 27 +++++++++++++++++++++++++--
 1 file changed, 25 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 2cfac82..4a01063 100644
--- a/README.md
+++ b/README.md
@@ -1,12 +1,35 @@
 # svg2ild
 
-Converts a series of .svg files to .ild animation for laser shows.
+Converts a series of `.svg` files to `.ild` animation for laser shows.
+Supports both static and animated images.
 
 ILDA - image data transfer format for laser shows.
-Description of the format, made by author of the `LaserBoy`: <https://laserboy.org/ilda_file_format.html>.
+
+Description of the format:
+
+* Official: <https://ilda.com/resources/StandardsDocs/ILDA_IDTF14_rev011.pdf> (80 KiB, revision 011, <time>2014-11-16</time>).
+* Made by author of the `LaserBoy`: <https://laserboy.org/ilda_file_format.html>.
+
+## How to
+
+### How to detect an internal format of .ild file
+
+You can use [file](https://en.wikipedia.org/wiki/File_%28Unix%29) tool from package `file` ([sources](https://www.darwinsys.com/file/)):
+
+```console
+ % file ./*.ild
+./hs.ild:         ILDA Image Data Transfer Format 3D Coordinates with Indexed Color, company MIKLO, number of records 88, palette number 0, number of frames 1
+./opos.ild:       ILDA Image Data Transfer Format 3D Coordinates with Indexed Color, company MIKLO, number of records 2137, palette number 0, number of frames 1
+./rgb.ild:        ILDA Image Data Transfer Format 3D Coordinates with Indexed Color, company MIKLO, number of records 18, palette number 0, number of frames 1
+./text-paths.ild: ILDA Image Data Transfer Format 3D Coordinates with Indexed Color, company MIKLO, number of records 102, palette number 0, number of frames 1
+```
 
 ## Links
 
 * Homepage: <https://git.hswro.org/miklo/svg2ild>.
 * Documentation: <https://git.hswro.org/miklo/svg2ild/wiki>.
 * Mirror: <https://forge.citizen4.eu/miklo/svg2ild>.
+
+## License
+
+AGPL v3.0
-- 
2.40.1


From 6b849a139909f8046dd987cb173f152449e7237f Mon Sep 17 00:00:00 2001
From: Alexey Vazhnov <vazhnov@boot-keys.org>
Date: Sun, 21 Dec 2025 19:37:52 +0100
Subject: [PATCH 3/4] README.md: add the _Table of contents_, update it with
 `md_toc --in-place --skip-lines 1 commonmarker README.md`

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 4a01063..87644a1 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,25 @@
 # svg2ild
 
+## Table of contents
+
+<!--
+ Generate with: `md_toc --in-place --skip-lines 1 commonmarker README.md` (package `python3-md-toc` required).
+ Also, in GitLab, it can be replaced with just `[[_TOC_]]`.
+-->
+<!--TOC-->
+
+- [Table of contents](#table-of-contents)
+- [About](#about)
+- [Installation](#installation)
+- [How to](#how-to)
+  - [How to detect an internal format of .ild file](#how-to-detect-an-internal-format-of-ild-file)
+- [Links](#links)
+- [License](#license)
+
+<!--TOC-->
+
+## About
+
 Converts a series of `.svg` files to `.ild` animation for laser shows.
 Supports both static and animated images.
 
@@ -10,6 +30,8 @@ Description of the format:
 * Official: <https://ilda.com/resources/StandardsDocs/ILDA_IDTF14_rev011.pdf> (80 KiB, revision 011, <time>2014-11-16</time>).
 * Made by author of the `LaserBoy`: <https://laserboy.org/ilda_file_format.html>.
 
+## Installation
+
 ## How to
 
 ### How to detect an internal format of .ild file
-- 
2.40.1


From 4f8e17e0aadf276d9e690137057ca7c73fbf026d Mon Sep 17 00:00:00 2001
From: Alexey Vazhnov <vazhnov@boot-keys.org>
Date: Sun, 21 Dec 2025 19:45:58 +0100
Subject: [PATCH 4/4] README.md: + How does it work

---
 README.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/README.md b/README.md
index 87644a1..aeedf16 100644
--- a/README.md
+++ b/README.md
@@ -11,6 +11,7 @@
 - [Table of contents](#table-of-contents)
 - [About](#about)
 - [Installation](#installation)
+- [How does it work](#how-does-it-work)
 - [How to](#how-to)
   - [How to detect an internal format of .ild file](#how-to-detect-an-internal-format-of-ild-file)
 - [Links](#links)
@@ -32,6 +33,13 @@ Description of the format:
 
 ## Installation
 
+## How does it work
+
+Optimizations:
+
+* Order of objects in the input SVG file is not important — `svg2ild` finds nearest edges after each object.
+* Palette: ?
+
 ## How to
 
 ### How to detect an internal format of .ild file
-- 
2.40.1