summaryrefslogtreecommitdiff
path: root/Build/tests/largefile/README
diff options
context:
space:
mode:
Diffstat (limited to 'Build/tests/largefile/README')
-rw-r--r--Build/tests/largefile/README40
1 files changed, 40 insertions, 0 deletions
diff --git a/Build/tests/largefile/README b/Build/tests/largefile/README
new file mode 100644
index 00000000000..9c98b6b443a
--- /dev/null
+++ b/Build/tests/largefile/README
@@ -0,0 +1,40 @@
+$Id$
+Copyright (C) 2012 Peter Breitenlohner <tex-live@tug.org>
+You may freely use, modify and/or distribute this file.
+
+Shell scripts and data to test large file support (LFS) for dvips and
+TeX-like engines, in particular pdfTeX. These tests consume a generous
+amount of disk space in the current directory, typically 4GB and more.
+Since they require a fair amount of time a progress report is displayed on
+the terminal, followed by a line starting with either 'PASS' or 'FAIL'.
+
+============
+
+Run
+ PATH_TO_largeps.test PATH_TO_dvips
+to verify that dvips can create PS files with 2GB or more.
+
+Run
+ PATH_TO_largedvi.test PATH_TO_TEX_ENGINE
+to verify that the TeX engine (TeX, pdfTeX, Aleph, etc.) detects when a DVI
+file would be 2GB or more.
+
+Run
+ PATH_TO_largepdf.test PATH_TO_PDFTEX_OR_LUATEX_ENGINE
+to verify that pdfTeX and LuaTeX can create PDF files with 2.8GB (based on
+lfs.tgz from Martin Schr\"oder <martin@oneiros.de>, compare testlfs-martin/*).
+
+Run
+ PATH_TO_hugepdf.test PATH_TO_PDFTEX_OR_LUATEX_ENGINE
+to verify that pdfTeX and LuaTeX can create PDF files with 4.6GB (based on
+lfs.tgz from Martin Schr\"oder <martin@oneiros.de>, compare testlfs-martin/*).
+
+Run
+ PATH_TO_pdfimage.test PATH_TO_PDFTEX_ENGINE IMG
+to verify that pdfTeX can create PDF files with 2GB or more, using various
+jpeg, png, jbig2, and pdf images (based on test-lfs.zip from Thanh Han The
+<thanh@river-valley.org>, compare testlfs-thanh/*). The parameter IMG
+indicates the test(s) to perform:
+ jpeg-1, jpeg-2, png-1, png-2, jbig2-1, jbig2-2: just one test
+ jpeg, png, jbig2, pdf: two tests
+ all: all seven tests.