Docs: add explicit warning on spoolfile formats
authorJeremy Harris <jgh146exb@wizmail.org>
Sun, 5 Aug 2018 12:58:40 +0000 (13:58 +0100)
committerJeremy Harris <jgh146exb@wizmail.org>
Sun, 5 Aug 2018 16:24:27 +0000 (17:24 +0100)
doc/doc-docbook/spec.xfpt
doc/doc-txt/experimental-spec.txt

index fb5944d..81261c8 100644 (file)
@@ -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.
 
 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:
 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:
index 1bc5d02..7805c25 100644 (file)
@@ -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.
 
 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
 
 The motivation/inspiration for the transport is to allow external
 processes to access email queued by exim and have access to all the