summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDan Allen <dan.j.allen@gmail.com>2022-07-06 23:42:10 -0600
committerDan Allen <dan.j.allen@gmail.com>2022-07-07 01:43:20 -0600
commita8ad369e77f92a459940f9f0030c1d9bd2b64899 (patch)
tree25479471c4931397356e36bc89ea92a7bb9e5a60
parentdd7b6d47ad7dc8c15319674dda4b45cc10282132 (diff)
add disclaimer about copying text in a PDF to the limitations section
-rw-r--r--docs/modules/ROOT/pages/features.adoc3
1 files changed, 3 insertions, 0 deletions
diff --git a/docs/modules/ROOT/pages/features.adoc b/docs/modules/ROOT/pages/features.adoc
index c9e96ecc..8b088a76 100644
--- a/docs/modules/ROOT/pages/features.adoc
+++ b/docs/modules/ROOT/pages/features.adoc
@@ -34,6 +34,9 @@
[#limitations]
== Known limitations
+* Copying text from a PDF in a way that preserves the original line wrapping is not reliable, particularly in code blocks.
+To achieve proper rendering, non-visible characters may either be interpretted, inserted, or dropped.
+This is primarily a limitation of the PDF format, in which text is broken into fragments and positioned at absolute coordinates on the canvas.
* Footnotes are always displayed as endnotes (at the bottom of the last page of a chapter for books; at the bottom of the last page of the document for all other doctypes).
*Footnotes cannot be displayed at the current bottom of the page because the PDF generator does not support content reflows* (see {url-project-issues}/85#issuecomment-577412975[#85^] for reasoning).
* Table cells that exceed the height of a single page are truncated with a warning (see https://github.com/prawnpdf/prawn-table/issues/41[prawn-table#41^]).