From 625f4fbd45b048223c64f18769755aa19730ef85 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 18:23:58 +0200 Subject: [PATCH 01/14] XML docs: layout fixes for value lists and help buttons Signed-off-by: Jan Kowalleck --- docgen/xml/README.md | 3 +++ docgen/xml/xs3p.xsl | 22 +++++++++++++++------- 2 files changed, 18 insertions(+), 7 deletions(-) create mode 100644 docgen/xml/README.md diff --git a/docgen/xml/README.md b/docgen/xml/README.md new file mode 100644 index 000000000..f7295d701 --- /dev/null +++ b/docgen/xml/README.md @@ -0,0 +1,3 @@ + +- Unclear which version of `xs3p.xls` was used asa base. + To be researched!!1 diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 7b246c0b4..ad8a63b16 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -699,7 +699,7 @@ --> -
+

@@ -909,6 +909,18 @@ pre { line-height: 1; font-size: 12px; } +.bi.hide-content { + display: inline-block; + width: 1em; + height: 1em; + overflow: hidden; + text-indent: 100%; + white-space: nowrap; +} +.bi.hide-content:before { + display: block; + text-indent: 0; +} .unpre { font-family: "Helvetica Neue",Helvetica,Arial,sans-serif; @@ -4104,7 +4116,7 @@ pre { - + @@ -7245,7 +7257,7 @@ pre { @@ -8210,10 +8222,6 @@ was not specified in the links file, . | - - - - ' ' From ff912aa5e184ade31afe8ff6e09800ea8afa6359 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 19:33:08 +0200 Subject: [PATCH 02/14] enum-breaks Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 25 ++++++++++++++++++++++++- 1 file changed, 24 insertions(+), 1 deletion(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index ad8a63b16..9c97d4e7d 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -165,6 +165,12 @@ 0.0 + + 5 + @@ -3971,11 +3977,13 @@ pre { --> this + 0 + @@ -4353,6 +4361,7 @@ pre { + @@ -5326,6 +5335,7 @@ pre { this + 0 @@ -5334,6 +5344,7 @@ pre { + @@ -5405,6 +5416,7 @@ pre { this + 0 @@ -5474,6 +5486,7 @@ pre { ( + ) @@ -8213,6 +8226,7 @@ was not specified in the links file, . --> + 0 value @@ -8220,7 +8234,16 @@ was not specified in the links file, . - | + | + + + + + + + ' From 83ef98afa78b48131dc01c2d0492b06d52afbff7 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 19:41:02 +0200 Subject: [PATCH 03/14] tity Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 9c97d4e7d..8549ee554 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -8236,9 +8236,9 @@ was not specified in the links file, . | - + From 0c6b35bb9b79e800d2154d7f0b3f23bb805d8cb7 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 19:46:45 +0200 Subject: [PATCH 04/14] docs Signed-off-by: Jan Kowalleck --- docgen/xml/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docgen/xml/README.md b/docgen/xml/README.md index f7295d701..e4b044ba5 100644 --- a/docgen/xml/README.md +++ b/docgen/xml/README.md @@ -1,3 +1,3 @@ -- Unclear which version of `xs3p.xls` was used asa base. +- Unclear which version of `xs3p.xsl` was used asa base. To be researched!!1 From 7077e29a3dd1a101aef43b6a1b3eaa50f4b9dd8c Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 19:47:52 +0200 Subject: [PATCH 05/14] tidy Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 8549ee554..ce8ab347f 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -5344,7 +5344,7 @@ pre { - + From 9a429d1cdac1186da93c44f970947296692432e5 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:00:44 +0200 Subject: [PATCH 06/14] refactor Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 20 ++++---------------- 1 file changed, 4 insertions(+), 16 deletions(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index ce8ab347f..442bde5fb 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -705,7 +705,7 @@ --> - +

@@ -915,18 +915,6 @@ pre { line-height: 1; font-size: 12px; } -.bi.hide-content { - display: inline-block; - width: 1em; - height: 1em; - overflow: hidden; - text-indent: 100%; - white-space: nowrap; -} -.bi.hide-content:before { - display: block; - text-indent: 0; -} .unpre { font-family: "Helvetica Neue",Helvetica,Arial,sans-serif; @@ -4124,7 +4112,7 @@ pre {
- + @@ -7269,8 +7257,8 @@ pre { - From 1917abd2ed68e8b896317b7b9ee0cef985822be3 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:10:20 +0200 Subject: [PATCH 07/14] docs Signed-off-by: Jan Kowalleck --- docgen/xml/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docgen/xml/README.md b/docgen/xml/README.md index e4b044ba5..3eee46993 100644 --- a/docgen/xml/README.md +++ b/docgen/xml/README.md @@ -1,3 +1,3 @@ -- Unclear which version of `xs3p.xsl` was used asa base. +- Unclear which version of `xs3p.xsl` was used as a base. To be researched!!1 From 6fcc0e40bc01e66116e0aa096dae95906f2f061e Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:16:26 +0200 Subject: [PATCH 08/14] fix Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 3 +++ 1 file changed, 3 insertions(+) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 442bde5fb..5c0772575 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -5350,6 +5350,7 @@ pre { + ]
@@ -5380,6 +5381,7 @@ pre { + ] @@ -5427,6 +5429,7 @@ pre { + From cd95f14807fabfbd0ec13d4e556c3c19fda54724 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:21:29 +0200 Subject: [PATCH 09/14] refactor Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 5c0772575..5728b1f23 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -8225,7 +8225,7 @@ was not specified in the links file, . - | + | 0.0 - 5 @@ -8224,9 +8223,6 @@ was not specified in the links file, . comes from list: { - - | - @@ -8236,6 +8232,9 @@ was not specified in the links file, . + + | + ' ' From b83f1a0e96cf5cbcc63ba3cfcc64d6c44983a0b0 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:29:25 +0200 Subject: [PATCH 11/14] fix Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 1 + 1 file changed, 1 insertion(+) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index f42e726eb..5bd12fac6 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -3161,6 +3161,7 @@ pre { + From db64b9da8b6a66fdf3bd79cbb85bc5b1fc41a6b1 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:37:09 +0200 Subject: [PATCH 12/14] docs Signed-off-by: Jan Kowalleck --- docgen/xml/README.md | 3 +++ docgen/xml/xs3p.xsl | 3 ++- 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/docgen/xml/README.md b/docgen/xml/README.md index 3eee46993..fcce9e4f3 100644 --- a/docgen/xml/README.md +++ b/docgen/xml/README.md @@ -1,3 +1,6 @@ +# XML docs rendering + +## Heritage - Unclear which version of `xs3p.xsl` was used as a base. To be researched!!1 diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 5bd12fac6..624005759 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -165,7 +165,8 @@ 0.0 - 5 From ece144e29273ff44396d1d1f2fa7c252d51fd548 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 20:46:41 +0200 Subject: [PATCH 13/14] fix Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 19 +++++++++---------- 1 file changed, 9 insertions(+), 10 deletions(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 624005759..993bfead2 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -8225,17 +8225,16 @@ was not specified in the links file, . comes from list: { - - - - - - - - | + + + + + + + + | ' From 3fed8941511b93b9091efac9133814a6e6adea42 Mon Sep 17 00:00:00 2001 From: Jan Kowalleck Date: Wed, 16 Sep 2026 21:21:16 +0200 Subject: [PATCH 14/14] fix-docs Signed-off-by: Jan Kowalleck --- docgen/xml/xs3p.xsl | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/docgen/xml/xs3p.xsl b/docgen/xml/xs3p.xsl index 993bfead2..78323acc0 100644 --- a/docgen/xml/xs3p.xsl +++ b/docgen/xml/xs3p.xsl @@ -438,6 +438,7 @@ obj.querySelectorAll('code,pre').forEach(function(block) { block.innerHTML = block.textContent; }); + rawEl.className += ' docs-hidden'; }); // Sidebar scroll handling @@ -939,6 +940,8 @@ pre { .codehilite a {color: inherit !important; text-decoration: underline !important;} .codehilite a:hover {opacity: 0.7 !important;} +.docs-hidden {display:none;} + @media (min-width: 992px) { .xs3p-sidebar { position: fixed; @@ -2667,7 +2670,7 @@ pre {

-