aboutsummaryrefslogtreecommitdiff
path: root/docs/design.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/design.md')
-rw-r--r--docs/design.md11
1 files changed, 8 insertions, 3 deletions
diff --git a/docs/design.md b/docs/design.md
index 59c64bd..ca8d550 100644
--- a/docs/design.md
+++ b/docs/design.md
@@ -861,10 +861,15 @@ placeholder numbers, screenshots by date, cleaning up old installers).
path against `git check-ignore --no-index` (skipped if git is absent).
- **Conditions:** truth tables; a property test that random condition trees
give the same result with and without cost reordering.
-- **Extraction:** the tests generate their fixtures in temporary
+- **Extraction:** most tests generate their fixtures in temporary
directories and use fake tools for PDF and the legacy formats (doc, xls,
- ppt); the real `pdftotext` test skips when the tool is missing. Real
- office-suite files and real legacy-tool runs are not tested in 0.0.1.
+ ppt). `testdata/real` holds documents LibreOffice and pandoc made from
+ invented text (docx, odt, ods, xlsx, pptx, epub, pdf, doc, xls); each is
+ read, the tool formats only when a tool for them is installed. There is no
+ real `.ppt` or `.odp` fixture (LibreOffice could not convert pandoc's
+ pptx), and xls/ppt have only run through fake tools where `catdoc` is not
+ installed. antiword refuses a `.doc` with very little text; catdoc reads
+ it.
- **Plan, apply, undo:** in temporary directories: build a tree, plan,
apply, check; undo; check the tree is identical to the start (paths,
contents, modes, mtimes). A cross-filesystem move test runs when a tmpfs is