summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJamie Lemon <jamie.lemon@artifex.com>2023-03-10 12:43:41 +0000
committerJamie Lemon <jamie.lemon@dijipiji.com>2023-03-10 13:06:44 +0000
commit0812fa75edd52162abc1bceae69b0e588b93895b (patch)
treec72ad3bd9439b48f0d79d39703450392de9edf28 /doc
parent99fb753dc0f2a67d0b9a95aaa0c29962aafcdb9e (diff)
downloadghostpdl-0812fa75edd52162abc1bceae69b0e588b93895b.tar.gz
Documentation updates for 10.01.0
- Adds new version number to conf.py - Removes -dOLDSAFER & old language-bindings folder. - Updates PDF version
Diffstat (limited to 'doc')
-rw-r--r--doc/Ghostscript.pdfbin4526055 -> 4519285 bytes
-rw-r--r--doc/language-bindings/images/favicon.svg39
-rw-r--r--doc/language-bindings/md/images/export-jar.pngbin203606 -> 0 bytes
-rw-r--r--doc/language-bindings/md/images/ghostnet-wpf-example.pngbin353078 -> 0 bytes
-rw-r--r--doc/language-bindings/md/images/gsviewer.pngbin63958 -> 0 bytes
-rw-r--r--doc/language-bindings/md/images/linking-jar.pngbin112169 -> 0 bytes
-rw-r--r--doc/src/Use.rst21
-rw-r--r--doc/src/conf.py2
8 files changed, 2 insertions, 60 deletions
diff --git a/doc/Ghostscript.pdf b/doc/Ghostscript.pdf
index ea8f9f4fa..136b87226 100644
--- a/doc/Ghostscript.pdf
+++ b/doc/Ghostscript.pdf
Binary files differ
diff --git a/doc/language-bindings/images/favicon.svg b/doc/language-bindings/images/favicon.svg
deleted file mode 100644
index 86b60ff95..000000000
--- a/doc/language-bindings/images/favicon.svg
+++ /dev/null
@@ -1,39 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px"
- viewBox="0 0 174.5 203" enable-background="new 0 0 174.5 203" xml:space="preserve">
-
- <style>path{fill:#333}@media (prefers-color-scheme:dark){path{fill:#eee}}</style>
-
- <path d="M88.914,62.379c2.305-1.166-1.965-4.208-1.717-9.555c0.275-6.038,2.834-9.767-0.775-9.663
- c-2.843,0.078-7.028,5.283-6.347,10.597C80.771,59.059,85.951,63.869,88.914,62.379z"/>
- <path d="M82.704,70.756c-2.901,1.852,4.552,3.786,6.338,9.383c2.024,6.331-0.215,10.913,5.012,9.777
- c4.119-0.888,8.132-7.467,5.004-12.756C95.923,71.864,86.422,68.364,82.704,70.756z"/>
- <path d="M77.635,65.538c2.012-1.627-2.801-3.695-3.686-8.962c-1.002-5.985,0.72-10.149-2.799-9.292
- c-2.752,0.663-5.759,6.648-3.971,11.687C68.97,64.008,75.064,67.635,77.635,65.538z"/>
- <g>
- <path d="M8.34,182.553c8.033,8.36,27.344,18.325,73.727,18.325c77.712,0,86.343-34.936,86.672-36.423l0.074-0.335
- l-2.615-0.673l-0.103,0.317c-0.084,0.262-9.182,26.392-76.57,26.392c-2.336,0-4.77-0.032-7.237-0.095
- c-16.732-0.429-30.657-3.138-40.269-7.831c-8.394-4.1-13.017-9.442-13.017-15.044c0-11.862,13.986-12.627,14.581-12.655
- l0.316-0.015l0.177-2.639l-0.312-0.057c-0.233-0.042-5.807-1.036-12.745-1.036c-18.07,0-28.293,6.655-28.786,18.739
- C2.206,170.181,2.159,176.119,8.34,182.553z"/>
- <path d="M152.435,59.232c1.118-13.45-11.403-23.37-15.267-26.09l-0.155-0.109l0.021-0.188
- c0.952-8.478-0.737-15.52-5.021-20.929c-6.977-8.81-18.449-10.085-18.934-10.135l-0.328-0.033l-0.437,2.648l0.32,0.077
- c0.518,0.124,12.73,3.157,14.018,14.733c1.131,10.18-6.367,14.962-13.618,19.586c-5.594,3.572-10.871,6.942-10.871,12.57
- c0,6.214,5.439,10.593,10.7,14.827c5.32,4.281,10.341,8.321,9.969,13.87c-0.687,10.304-20.492,15.748-20.692,15.802l-0.331,0.088
- l0.568,2.639l0.333-0.054C143.685,91.88,151.452,71.054,152.435,59.232z"/>
- <path d="M80.146,181.454c4.818,0.771,10.645,1.179,16.85,1.179c16.754,0,39.861-3.118,54.467-11.867
- c14.401-8.616,16.364-22.548,10.86-31.856v-0.001c-4.971-8.418-20.259-22.757-66.8-24.202
- c-32.475-0.997-48.941-3.565-48.941-7.633c0-3.392,5.788-4.433,11.916-5.535c7.688-1.384,16.401-2.954,16.174-10.354
- c-0.145-4.691-4.298-7.432-9.107-10.607c-7.262-4.8-16.297-10.773-14.116-26.241c1.864-13.148,21.14-18.701,29.341-20.478
- c11.723-2.537,31.451-8.128,31.858-17.067c0.368-8.21-8.415-10.998-8.503-11.025l-0.304-0.095l-0.915,2.059l-0.194,0.336
- l0.304,0.179c0.152,0.092,3.643,2.253,2.214,6.375c-1.521,4.398-7.704,4.754-25.358,5.137
- c-17.544,0.386-39.579,2.793-54.373,18.103c-8.041,8.324-11.314,19.207-8.754,29.112c2.713,10.485,11.718,19.235,25.356,24.64
- l0.913,0.362l-0.951,0.245c-3.259,0.838-8.195,2.305-13.196,4.529c-12.741,5.665-19.313,13.407-19.004,22.39
- c0.797,22.879,35.182,26.661,68.713,27.343c35.983,0.731,51.335,4.303,51.335,11.942c0,6.147-11.885,11.023-28.26,11.596
- c-1.88,0.065-3.719,0.097-5.466,0.097c-10.907,0-17.937-1.091-21.914-2.007c-4.734-1.088-7.577-2.501-7.606-3.777
- c-0.015-0.593,0.165-1.072,0.55-1.467c1.375-1.41,4.781-1.706,7.397-1.706c3.296,0,6.365,0.481,6.704,0.535l0.315,0.052
- l0.748-2.53l-0.29-0.125c-0.064-0.027-6.083-2.606-14.252-2.606c-0.505,0-1.018,0.01-1.539,0.031
- c-6.817,0.301-11.677,3.807-11.819,8.526C54.379,168.728,56.635,177.698,80.146,181.454z"/>
- </g>
-
-</svg>
diff --git a/doc/language-bindings/md/images/export-jar.png b/doc/language-bindings/md/images/export-jar.png
deleted file mode 100644
index 55550496c..000000000
--- a/doc/language-bindings/md/images/export-jar.png
+++ /dev/null
Binary files differ
diff --git a/doc/language-bindings/md/images/ghostnet-wpf-example.png b/doc/language-bindings/md/images/ghostnet-wpf-example.png
deleted file mode 100644
index b5b1eaa11..000000000
--- a/doc/language-bindings/md/images/ghostnet-wpf-example.png
+++ /dev/null
Binary files differ
diff --git a/doc/language-bindings/md/images/gsviewer.png b/doc/language-bindings/md/images/gsviewer.png
deleted file mode 100644
index 75c9d5aff..000000000
--- a/doc/language-bindings/md/images/gsviewer.png
+++ /dev/null
Binary files differ
diff --git a/doc/language-bindings/md/images/linking-jar.png b/doc/language-bindings/md/images/linking-jar.png
deleted file mode 100644
index ce64e5876..000000000
--- a/doc/language-bindings/md/images/linking-jar.png
+++ /dev/null
Binary files differ
diff --git a/doc/src/Use.rst b/doc/src/Use.rst
index db53cfe1f..6a570fe1c 100644
--- a/doc/src/Use.rst
+++ b/doc/src/Use.rst
@@ -2281,7 +2281,7 @@ Other parameters
Enables access controls on files. Access controls fall into three categories, files from which Ghostscript is permitted to read, ones to which it is permitted to write, and ones over which it has "control" (i.e. delete/rename). These access controls apply to all files accessed via Ghostscript's internal interface to the C library file handling. Whilst we have taken considerable pains to ensure that all the code we maintain (as well as the so called "contrib" devices, that are devices included in our release packages, but not strictly maintained by the Ghostscript development team) uses this interface, we have no control over thirdparty code.
- This is an entirely new implementation of ``SAFER`` for Ghostscript versions 9.50 and later. Earlier versions (see :ref:`-dOLDSAFER<dOLDSAFER>`) relied on storing the file permission lists in Postscript VM (Virtual Memory), and only applied file access permissions to the Postscript file related operators. It relied on restricting the function of setpagedevice to avoid the device code from being manipulated into opening arbitrary files. The application of the file permissions was done within the internal context of the Postscript interpreter, and some other aspects of the Postscript restrictions were applied in the Postscript environment. With so many of the feature's capabilities relying on the Postscript context and environment, by using other (Ghostscript specific) features maliciously, the restrictions could be overridden.
+ This is an entirely new implementation of ``SAFER`` for Ghostscript versions 9.50 and later. Earlier versions relied on storing the file permission lists in Postscript VM (Virtual Memory), and only applied file access permissions to the Postscript file related operators. It relied on restricting the function of setpagedevice to avoid the device code from being manipulated into opening arbitrary files. The application of the file permissions was done within the internal context of the Postscript interpreter, and some other aspects of the Postscript restrictions were applied in the Postscript environment. With so many of the feature's capabilities relying on the Postscript context and environment, by using other (Ghostscript specific) features maliciously, the restrictions could be overridden.
Whilst the path storage and application of the permissions is implemented entirely in C, it is still possible for Postscript to add and remove paths from the permissions lists (see .addcontrolpath) until such time as the access controls are enabled (see :ref:`.activatepathcontrol<Language_ActivateControlPath>`), any call to :ref:`.addcontrolpath<Language_AddControlPath>` after :ref:`.activatepathcontrol<Language_ActivateControlPath>` will result in a ``Fatal`` error causing the interpreter to immediately exit.
@@ -2357,25 +2357,6 @@ Other parameters
Finally, paths supplied on the command line (such as those in ``-I``, ``-sFONTPATH`` parameters) are added to the permitted reading list. Similarly, paths read during initialisation from ``Fontmap``, ``cidfmap``, and the platform specific font file enumeration (e.g. ``fontconfig`` on Unix systems) are automatically added to the permit read lists.
-
-
-.. _dOLDSAFER:
-
-**-dOLDSAFER**
-^^^^^^^^^^^^^^^^^^
-
- .. important :: This enables deprecated code which will shortly be removed.
-
- Used in combination with ``-dSAFER`` (or ``.setsafe``) enables the pre-9.50 ``SAFER`` implementation. It is included (for now) in case any users find a case where the 9.50 and later ``SAFER`` does not work for them. It means such users can keep working until we have assessed the issue, and distributed a solution.
-
- Disables the ``deletefile`` and ``renamefile`` operators, and the ability to open piped commands (``%pipe%cmd``) at all. Only ``%stdout`` and ``%stderr`` can be opened for writing. Disables reading of files other than ``%stdin``, those given as a command line argument, or those contained on one of the paths given by ``LIBPATH`` and ``FONTPATH`` and specified by the system params ``/FontResourceDir`` and ``/GenericResourceDir``.
-
- This mode also sets the :ref:`.LockSafetyParams<Language_LockSafetyParams>` parameter of the default device, or the device specified with the ``-sDEVICE=`` switch to protect against programs that attempt to write to files using the ``OutputFile`` device parameter. Note that since the device parameters specified on the command line (including ``OutputFile``) are set prior to ``SAFER`` mode, the ``-sOutputFile=...`` on the command line is unrestricted.
-
- ``SAFER`` mode also prevents changing the ``/GenericResourceDir``, ``/FontResourceDir`` and either the ``/SystemParamsPassword`` or the ``/StartJobPassword``.
-
- When running ``-dNOSAFER`` it is possible to perform a save, followed by ``.setsafe``, execute a file or procedure in ``SAFER`` mode, then use restore to return to ``NOSAFER`` mode. It is possible that a crafted foreign file could restore back to a point when ``NOSAFER`` was in operation.
-
**-dPreBandThreshold=** *true/false*
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
If the target device is a halftone device, then images that are normally stored in the command list during banded output will be halftoned during the command list writing phase, if the resulting image will result in a smaller command list. The decision to halftone depends upon the output and source resolution as well as the output and source color space.
diff --git a/doc/src/conf.py b/doc/src/conf.py
index 1fdcd1b1f..743a5e0b6 100644
--- a/doc/src/conf.py
+++ b/doc/src/conf.py
@@ -49,7 +49,7 @@ copyright = "1988-2022, Artifex"
# built documents.
#
# The full version, including alpha/beta/rc tags.
-release = "10.0.0"
+release = "10.01.0"
# The short X.Y version
version = release