From: Thibaut Cuvelier <thibaut@tcuvelier.be>
Date: Tue, 1 Aug 2023 01:27:18 +0000 (-0400)
Subject: Highlight limitations of current multicol DocBook implementation.
X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=d1398a5ba29273c8690707722a5d9a1aa16a33d8;p=features.git

Highlight limitations of current multicol DocBook implementation.
---

diff --git a/lib/layouts/multicol.module b/lib/layouts/multicol.module
index 3d40754432..c3148ffbac 100644
--- a/lib/layouts/multicol.module
+++ b/lib/layouts/multicol.module
@@ -38,6 +38,16 @@ InsetLayout Flex:Multiple_Columns
 	DocBookTag      IGNORE
   EndArgument
   ResetsFont        true
+
+  # The current DocBook implementation is quite lacking, but it would require
+  # a lot more C++ code to have perfect output. The major problem: not all
+  # elements within a column should be wrapped in an item. It has been
+  # designed for pure text (like in Modules > Page Layout > Multiple Columns,
+  # the excerpt of "The Adventure of the Empty House"), it produces wrong
+  # output for lists (such as Document classes > Articles > Astronomy >
+  # Supported environments, the Columns flex only contains a list). Columns
+  # within columns are not supported either (as in Modules > Page Layout >
+  # Multiple Columns > Columns inside Columns).
   DocBookWrapperTag NONE
   DocBookTag        NONE
   DocBookNotInPara  true