<document title="PS2Paper">
<define name="version" value="">
<define name="date" value="" length=30 align="right">




<literal mode="Strong" file="!Root">
PS2Paper
#SpriteFile Sprites
#Sprite 8,0 Logo
#Align Right
{f*/:Manage PostScript 2 Paper Sizes}
Version $$version$$ ($$date$$)
#Below
#Line
#Align Centre
{f/:PS2Paper} is {f*:Open Source}: please read the <Licence>

#Indent 2
#Table Columns 4
 <Introduction>
 <Installing PS2Paper=>Install>
 <Using PS2Paper=>Use>
 <Version History=>History>
#Endtable
#Indent
#Line
#Align Left
If you have any comments about {f/:PS2Paper}, or would like to report any bugs that you find, you can email me at the address below.

Updates to {f/:PS2Paper} and more applications for RISC OS computers can be found on my website at <http://www.stevefryatt.org.uk/software/=>#url>.

#Align Centre
 Stephen Fryatt, 2013-2020 (<steve@stevefryatt.org.uk=>#url mailto:steve@stevefryatt.org.uk>)

A plain text version of this manual is available <here=>*Filer_Run <PS2Paper$HelpText\>>.
#Align Left
</literal>




<literal mode="HTML">
<html>
<head>
<title>PS2Paper</title>
<style type="text/css">
 DIV.container {
   background-color: silver;
   margin: 0;
 }

 DIV.chapter {
   color: black;
   background-color: white;
   margin: 2em;
   padding: 1em;
 }
</style>
</head>

<body>
<div class="container">
<div class="chapter">
<h1>PS2Paper</h1>
</div>
</literal>




<literal mode="Text">
=============================================================================
PS2Paper - Manage PostScript 2 Paper Sizes                       Version $$version$$

(c) Stephen Fryatt, 2013-2020                  $$date$$
=============================================================================
</literal>



<chapter title="Licence" file="Licence">

<cite>PS2Paper</cite> is licensed under the EUPL, Version&nbsp;1.1 only (the &ldquo;Licence&rdquo;); you may not use this work except in compliance with the Licence.

You may obtain a copy of the Licence at <link ref="#url http://joinup.ec.europa.eu/software/page/eupl">http://joinup.ec.europa.eu/software/page/eupl</link>

Unless required by applicable law or agreed to in writing, software distributed under the Licence is distributed on an &ldquo;<strong>as is</strong>&rdquo; basis, <strong>without warranties or conditions of any kind</strong>, either express or implied.

See the Licence for the specific language governing permissions and limitations under the Licence.

The source for <cite>PS2Paper</cite> can be found alongside this binary download, at <link ref="#url http://www.stevefryatt.org.uk/software">http://www.stevefryatt.org.uk/software</link>

The necessary libraries and build tools can be found at <link ref="#url http://www.stevefryatt.org.uk/software/build">http://www.stevefryatt.org.uk/software/build</link>

</chapter>




<chapter title="Introduction" file="Introduction">

<cite>PS2Paper</cite> is a utility to help manage the different paper sizes configured for the Acorn Level&nbsp;2 PostScript printer driver supplied with RISC&nbsp;OS. Note that <cite>PS2Paper</cite> is <strong>not</strong> required when using the Level&nbsp;3 PostScript driver from John Tytgat and Martin Wuerthner.

Perhaps surprisingly for a printer driver, the Level&nbsp;2 PostScript driver does not directly use the paper dimensions defined in <cite>Printers</cite>. Instead, it uses the <em>name</em> of the paper to help identify a snippet of PostScript data held in a small file inside <file>!Printers</file> (or the user&rsquo;s choices inside <file>!Boot</file>), and includes this in a suitable place in the PostScript data being output. If this snippet contains the page dimensions, these then get passed on to whatever subsequently reads the PostScript output.

The purpose of <cite>PS2Paper</cite> is to help keep track of the different papers defined on your system and the corresponding PostScript snippets &ndash; and to help ensure that the sizes given in those snippets actually match the sizes given for the associated paper definitions.

In addition to this manual, interactive help is fully supported by the application.

</chapter>




<chapter title="Installing PS2Paper" file="Install">

To install <cite>PS2Paper</cite>, drag the <file>!PS2Paper</file> application directory from the archive to a suitable location on your hard disc. Once copied, <cite>PS2Paper</cite> can be started by double-clicking in the usual way.

<cite>PS2Paper</cite> is 26/32-bit neutral, and should therefore run on all hardware systems as long as the 32-bit Shared C Library is installed. If required, this can be found in the System Resources on RISC&nbsp;OS Open Ltd&rsquo;s website at <link ref="https://www.riscosopen.org/content/downloads/common">https://www.riscosopen.org/content/downloads/common</link>.

</chapter>



<chapter title="Using PS2Paper" file="Use">

Once installed on disc, <cite>PS2Paper</cite> can be started in the usual way by double-clicking on its application directory to place a copy on the iconbar. Once on the iconbar, a <mouse>select</mouse> click on its icon will scan the paper sizes on the system and then open the paper window.

The window shows a list of the paper sizes available to the PostScript Level&nbsp;2 printer driver, grouped into the three sections that they are held in within Printers. Although these all appear in the dialogue which opens when selecting <menu>Edit paper sizes...</menu> from the <cite>Printers</cite> iconbar menu, the fact that there are three distinct places which hold paper definitions explains why it&rsquo;s possible to have more than one paper size with the same name.

Each row shows the width and height of the paper, in either millimetres, inches or points (as selected from the toolbar, or from the <menu>Dimension units</menu> submenu). Note that this is the overall paper dimension, before any margins are applied. To the right of these <icon>Width</icon> and <icon>Height</icon> columns is the <icon>Size</icon> column, which shows either &lsquo;OK&rsquo; or &lsquo;Ambiguous&rsquo; &ndash; we will come on to this soon.

The <icon>File Name</icon> column shows the name of the PostScript snippet file associated with the paper. The name of the file is derived from the name of the paper associated with it, converted to lower case and truncated at the first space. As a result, a paper definition named &lsquo;A4&rsquo; would have a snippet file called <file>a4</file> &ndash; but then, so would a paper size with the name &lsquo;A4&nbsp;Paper&rsquo; or even &lsquo;A4&nbsp;(Generic&nbsp;PS)&rsquo;.

There&rsquo;s clearly a risk that with this ambiguity in file names, two or more paper definitions could both resolve to the same name for the snippet file. If all of the affected paper sizes are the same, the <icon>Size</icon> column shows &lsquo;OK&lsquo;, but if any of them are different they <em>all</em> show &lsquo;Ambiguous&rsquo;.

Finally, the <icon>Status</icon> column shows what <cite>PS2Paper</cite> can make of the snippet file and its contents. If there is no file of the given name on the system, the file icon is greyed out and the status shows as &lsquo;Missing&rsquo;; if there is a file, but it wasn&rsquo;t created by <cite>PS2Paper</cite>, the column shows &lsquo;Unknown&rsquo;. Otherwise, the column shows &lsquo;Correct&rsquo; if the snippet contains the same dimensions as shown in the <icon>Width</icon> and <icon>Height</icon> columns, or &lsquo;Incorrect&rsquo; if there&rsquo;s a discrepancy.

Double-clicking on a file icon in the <icon>File Name</icon> column will run it in the usual way: hold down <key>shift</key> to load a snippet into a text editor for inspection. The selected files can also be run by selecting <menu>Selection &msep; Run snippet</menu> from the menu.

The different paper definitions can be selected by clicking <mouse>select</mouse> or <mouse>adjust</mouse> on the items in the <icon>Paper Name</icon> column. To update the contents of the PostScript snippet files for the selected papers so that they contain the correct paper dimensions (or create new ones if the files don&rsquo;t exist), choose <menu>Selection &msep; Write files</menu> from the menu.

</chapter>



<chapter title="Version History" file="History">

Here is a list of the versions of <cite>PS2Paper</cite>, along with all the changes made.

<subhead title="0.10 (29 October 2016)">

First beta release, for feedback and comment.

<subhead title="0.11 (28 July 2020)">

Update to first beta release, for feedback and comment.

<list>
<li>Remove all unbounded string operations from source code.
<li>Correctly ensure that a C99-friendly version of the Shared C Library is present (ticket&nbsp;#637).
<li>Use ResConf-style system variables to identify resources.
</list>

</chapter>





<literal mode="Strong" file="!Configure">
# Configure file for StrongHelp
# Lines starting with "# " are comments (Note the space)
# Lines starting with "#Commands" and "#End" are *not* comments.

#Commands

# f0  = Sassoon.Primary           14   Bold  1  Italic  2  Both  3
# f1  = Sassoon.Primary.Bold      14   Bold  1  Italic  2  Both  3
# f2  = Homerton.Medium.Oblique   14   Bold  1  Italic  2  Both  3
# f3  = Homerton.Bold.Oblique     14   Bold  1  Italic  2  Both  3

# The Body font

f0  = Trinity.Medium          14   Bold  1  Italic  2  Both  3
f1  = Trinity.Bold            14   Bold  1  Italic  2  Both  3
f2  = Trinity.Medium.Italic   14   Bold  1  Italic  2  Both  3
f3  = Trinity.Bold.Italic     14   Bold  1  Italic  2  Both  3
f4  = Trinity.Medium          10

# The Headline fonts

f10 = Homerton.Bold           16
f11 = Homerton.Bold.Oblique   14
f12 = Trinity.Bold            14
f13 = Trinity.Bold.Italic     12
f14 = Trinity.Medium          10
f15 = Trinity.Medium.Italic   8

# The fonts used for fCode

f20 = Corpus.Medium           14   Bold 21  Italic 22  Both 23
f21 = Corpus.Bold             14   Bold 21  Italic 22  Both 23
f22 = Corpus.Medium.Oblique   14   Bold 21  Italic 22  Both 23
f23 = Corpus.Bold.Oblique     14   Bold 21  Italic 22  Both 23

# Fonts 24 to 31 are reserved for the manuals themselves.

f31 = Selwyn                  14

# The styles..

fStd       = f0
fLink      = f_
fStrong    = f*
fEmphasis  = f/
fUnderline = f_
fCode      = f20
fCite      = f/

fH1        = f10
fH2        = f11
fH3        = f12
fH4        = f13
fH5        = f14
fH6        = f15

# Set default background and font

#Background rgb 255,255,255
Background wimp 1
fStd

#End
</literal>




<literal mode="HTML">
</div>
</body>
</html>
</literal>




<literal mode="Text">


Updates and Contacting Me
-------------------------

  If you have any comments about PS2Paper, or would like to report any bugs
  that you find, you can email me at the address below.

  Updates to PS2Paper and more software for RISC OS computers can be found
  on my website at http://www.stevefryatt.org.uk/software/

  Stephen Fryatt
  email: steve@stevefryatt.org.uk
</literal>
