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/README35
1 files changed, 29 insertions, 6 deletions
diff --git a/Build/tests/largefile/README b/Build/tests/largefile/README
index 515691568d8..56974fe274e 100644
--- a/Build/tests/largefile/README
+++ b/Build/tests/largefile/README
@@ -1,9 +1,32 @@
-(This file public domain.)
+$Id$
+Copyright (C) 2012 Peter Breitenlohner <tex-live@tug.org>
+You may freely use, modify and/or distribute this file.
-The idea here is to see if a 3gb PDF file can be created, that is, if
-largefile support is present and working. Just run make.
+Shell scripts and data to test largs file support (LFS) for 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'.
-You'll need ppmpat from the netpbm tools to make the test image,
-although any image >1gb will do.
+============
--ms/peb/karl, 5mar08.
+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_ENGINE
+to verify that pdfTeX can create PDF files with 2GB or more (based on
+lfs.tgz from Martin Schröder <martin@oneiros.de>, compare lfs/*).
+
+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 test-lfs/*). 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.
+ \ No newline at end of file