[latex3-commits] [git/LaTeX3-latex3-pdfresources] splitting: docu (b3ee684)

[Ulrike Fischer]

Repository : https://github.com/latex3/pdfresources
On branch  : splitting
Link       : https://github.com/latex3/pdfresources/commit/b3ee684006bc3f09da71692fc1b2b59add20acdd

>---------------------------------------------------------------

commit b3ee684006bc3f09da71692fc1b2b59add20acdd
Author: Ulrike Fischer <fischer at troubleshooting-tex.de>
Date:   Tue Jul 14 19:39:36 2020 +0200

    docu


>---------------------------------------------------------------

b3ee684006bc3f09da71692fc1b2b59add20acdd
 l3pdfcoredict.dtx |  8 +-------
 pdfresources.dtx  | 13 ++++++++++++-
 2 files changed, 13 insertions(+), 8 deletions(-)

diff --git a/l3pdfcoredict.dtx b/l3pdfcoredict.dtx
index e4a6838..d7bd7fb 100644
--- a/l3pdfcoredict.dtx
+++ b/l3pdfcoredict.dtx
@@ -53,13 +53,7 @@
 %
 % \section{\pkg{l3pdfcoredict} documentation}
 % When creating a pdf a number of objects, dictionaries and entries to
-% central dictionaries must be created. The \LaTeX{} format currently contains no
-% support for theses tasks. It either relies on the binaries to do the job,
-% or on external packages using the primitives of the binaries. These
-% approach is problematic for two reasons: packages trying to set the same resources
-% can clash, and as the primitives differ between the various binaries and backend with
-% which \LaTeX{} is used all packages have to write and maintain \enquote{driver} files
-% for the various backends.
+% central \enquote{core} dictionaries must be created.
 %
 % The commands in this module offer interfaces to this core PDF dictionaries
 % They unify a number of primitives like the pdftex
diff --git a/pdfresources.dtx b/pdfresources.dtx
index 85924e7..be21d8b 100644
--- a/pdfresources.dtx
+++ b/pdfresources.dtx
@@ -63,7 +63,18 @@
 %
 % \maketitle
 % \section{Introduction}
-
+% The \LaTeX{} format currently contains nearly no code specific to the now quite
+% central output format, PDF.
+% It delegates important tasks like supporting PDF standards,
+% creating links, adding special colors, managing the content of
+% central PDF-directories to external packages.
+% This is problematic as it can lead easily to clashes if two packages try
+% to access the same resource in an incompatible way.  Also as
+% the primitives differ between the various binaries and backend with
+% which \LaTeX{} is used all packages have to write and maintain \enquote{driver} files
+% for the various backends.
+%
+%
 % The project here tries to resolve this situation by providing interfaces to
 % the various resources and objects in a backend independent way.
 %