From 2bd5a1b831fb279c20027ccb68fca785af2835e4 Mon Sep 17 00:00:00 2001 From: Dan Allen Date: Fri, 9 Feb 2024 02:43:09 -0700 Subject: [PATCH] clarify docs for page columns setting --- docs/modules/theme/pages/page.adoc | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/docs/modules/theme/pages/page.adoc b/docs/modules/theme/pages/page.adoc index b94871a6e..a23395ab9 100644 --- a/docs/modules/theme/pages/page.adoc +++ b/docs/modules/theme/pages/page.adoc @@ -150,10 +150,13 @@ It essentially informs the converter that the front cover will be inserted by a [#columns] === Columns -The columns are only applied to the body of a document with the article or manpage doctype. -The body of the document begins after the document title and TOC, if present. +Page columns are applied to the body of a document that has either the article or manpage doctype. +The body of the document begins after the document title and, if present, the TOC. -If the columns are set on the index section using the `index-columns` key, they will be ignored when `page-columns` is set. +If the toc macro is used in a document configured to have columns, the behavior is undefined. + +If the columns are set on the index section using the `index-columns` key, that setting will be overridden by the value of `page-columns`. +The index will be arranged within the page columns. [#numbering] == page-numbering