Document gs problems

This commit is contained in:
John Whitington
2023-06-01 15:24:00 +01:00
parent 2038f546cb
commit 64b0767858
2 changed files with 6 additions and 5 deletions

Binary file not shown.

View File

@ -276,9 +276,9 @@ Just a few of the facilities provided by the Coherent PDF Command Line Tools. Se
\noindent List the fonts in use, and what pages they are used on. \noindent List the fonts in use, and what pages they are used on.
\begin{framed}\noindent\texttt{cpdf -gs /usr/bin/gs -embed-missing-fonts in.pdf -o out.pdf}\end{framed} \begin{framed}\noindent\texttt{cpdf -list-missing-fonts in.pdf}\end{framed}
\noindent Embed missing fonts (with the help of Ghostscript). \noindent List missing fonts.
\section*{\hyperref[chap:15]{Chapter 15: PDF and JSON}} \section*{\hyperref[chap:15]{Chapter 15: PDF and JSON}}
@ -961,7 +961,7 @@ progress is shown on \verb!stderr! (Standard Error):
\small\verb$Malformed PDF reconstruction succeeded!$ \small\verb$Malformed PDF reconstruction succeeded!$
\end{framed} \end{framed}
\noindent If \texttt{cpdf} cannot reconstruct a malformed file, it is able to use the \texttt{gs} program to try to reconstruct the PDF file, if you have it installed. For example, if \texttt{gs} is installed and in your path, we might try: \noindent In the unlikely event that \texttt{cpdf} cannot reconstruct a malformed file, it is able to use the \texttt{gs} program to try to reconstruct the PDF file, if you have it installed. For example, if \texttt{gs} is installed and in your path, we might try:
\begin{framed} \begin{framed}
\noindent\small\verb!cpdf -gs gs -gs-malformed in.pdf -o out.pdf!\end{framed} \noindent\small\verb!cpdf -gs gs -gs-malformed in.pdf -o out.pdf!\end{framed}
@ -973,8 +973,7 @@ If the malformity lies inside an individual page of the PDF, rather than in its
\begin{framed} \begin{framed}
\noindent\small\verb!cpdf in.pdf -gs gs -gs-malformed-force -o out.pdf [-gs-quiet]!\end{framed} \noindent\small\verb!cpdf in.pdf -gs gs -gs-malformed-force -o out.pdf [-gs-quiet]!\end{framed}
\noindent The command line for \texttt{-gs-malformed-force} must be of \textit{precisely} this form. Sometimes, on the other hand, we might wish \texttt{cpdf} to fail immediately on any malformed file, rather than try its own reconstruction process. The option \texttt{-error-on-malformed} achieves this. \noindent The command line for \texttt{-gs-malformed-force} must be of \textit{precisely} this form. Sometimes, on the other hand, we might wish \texttt{cpdf} to fail immediately on any malformed file, rather than try its own reconstruction process. The option \texttt{-error-on-malformed} achieves this. \textit{Note: Use of these commands with \texttt{-gs} is a last resort; they may strip some metadata from PDF files.}
Sometimes (old, pre-ISO standardisation) files can be technically well-formed but use inefficient PDF Sometimes (old, pre-ISO standardisation) files can be technically well-formed but use inefficient PDF
constructs. If you are sure the input files you are using are constructs. If you are sure the input files you are using are
@ -3598,6 +3597,8 @@ recommended when file size is the sole consideration.
\small\noindent\verb!cpdf -embed-missing-fonts -gs gs in.pdf -o out.pdf! \small\noindent\verb!cpdf -embed-missing-fonts -gs gs in.pdf -o out.pdf!
\end{framed} \end{framed}
\noindent\textit{Note: putting a PDF file through \texttt{gs} in this manner may not be lossless: some metadata may not be preserved.}
\label{listmisingfonts}\clearpage\pagestyle{empty} \label{listmisingfonts}\clearpage\pagestyle{empty}
\begin{cpdflib} \begin{cpdflib}