Gitweb:
https://git.exim.org/exim.git/commitdiff/20751c768578c81f5136f58b4bd98109716894b0
Commit: 20751c768578c81f5136f58b4bd98109716894b0
Parent: 6a012214711def1133383366a0ddf7337eb0efa0
Author: Jeremy Harris <jgh146exb@???>
AuthorDate: Sun Aug 5 13:58:40 2018 +0100
Committer: Jeremy Harris <jgh146exb@???>
CommitDate: Sun Aug 5 17:24:27 2018 +0100
Docs: add explicit warning on spoolfile formats
---
doc/doc-docbook/spec.xfpt | 6 ++++++
doc/doc-txt/experimental-spec.txt | 2 ++
2 files changed, 8 insertions(+)
diff --git a/doc/doc-docbook/spec.xfpt b/doc/doc-docbook/spec.xfpt
index fb5944d..81261c8 100644
--- a/doc/doc-docbook/spec.xfpt
+++ b/doc/doc-docbook/spec.xfpt
@@ -38652,6 +38652,12 @@ two files contains the final component of its own name as its first line. This
is insurance against disk crashes where the directory is lost but the files
themselves are recoverable.
+.new
+The file formats may be changed, or new formats added, at any release.
+Spool files are not intended as an interface to other programs
+and should not be used as such.
+.wen
+
Some people are tempted into editing -D files in order to modify messages. You
need to be extremely careful if you do this; it is not recommended and you are
on your own if you do it. Here are some of the pitfalls:
diff --git a/doc/doc-txt/experimental-spec.txt b/doc/doc-txt/experimental-spec.txt
index 1bc5d02..7805c25 100644
--- a/doc/doc-txt/experimental-spec.txt
+++ b/doc/doc-txt/experimental-spec.txt
@@ -709,6 +709,8 @@ an external directory retaining the exim spool format.
The spool files can then be processed by external processes and then
requeued into exim spool directories for final delivery.
+However, note carefully the warnings in the main documentation on
+qpool file formats.
The motivation/inspiration for the transport is to allow external
processes to access email queued by exim and have access to all the
