summaryrefslogtreecommitdiff
path: root/public/README
diff options
context:
space:
mode:
authorTom Sepez <tsepez@chromium.org>2015-05-12 15:46:48 -0700
committerTom Sepez <tsepez@chromium.org>2015-05-12 15:46:48 -0700
commit12df7f730cea21885c177254bb2b4e1b9e1bea59 (patch)
treeb5580bba14aaac7303b31e50f2608de627b161a5 /public/README
parent9b43a43568877282b6a70d3a8da6ef78e6acc4e2 (diff)
downloadpdfium-12df7f730cea21885c177254bb2b4e1b9e1bea59.tar.xz
Merge to XFA: Describe required properties of public/ files with a README.
Original Review URL: https://codereview.chromium.org/1140833002 TBR=thestig@chromium.org Review URL: https://codereview.chromium.org/1128863005
Diffstat (limited to 'public/README')
-rw-r--r--public/README13
1 files changed, 13 insertions, 0 deletions
diff --git a/public/README b/public/README
new file mode 100644
index 0000000000..b07d0f3068
--- /dev/null
+++ b/public/README
@@ -0,0 +1,13 @@
+public/ README
+
+The header files in this directory are the only ones that should ever be
+included by an embedder of PDFium. If there arises a need for functionality
+beyond what is present here, then a new API must be added here to provide it.
+
+These header files must be entirely contained in this directory; they must
+never include other header files from outside of it.
+
+These files must compile cleanly without warnings on both C and C++ compilers.
+
+Changes to these files must be carefully considered to avoid breaking
+compatibility.