<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">

    <!-- This Source Code Form is subject to the terms of the Mozilla Public
       - License, v. 2.0. If a copy of the MPL was not distributed with this
       - file, You can obtain one at https://mozilla.org/MPL/2.0/. -->
    <!-- Copyright © 1989-1998 Colton Software Limited,
       - Copyright © 1998-2015 R W Colton -->

    <title>Colton Software PipeDream 4 - Release Notes</title>
</head>
<body>
    <h1>Colton Software PipeDream 4 - Release Notes</h1>

    <ul style="list-style: none">
        <li><a href="#GettingStarted">Getting Started</a></li>
        <li><a href="#OnlineResources">Online Resources</a></li>
        <li><a href="#Support">Support</a></li>
        <li><a href="#Copyright">Copyright and Licence</a></li>
        <li><a href="#ReleaseHistory">Release History</a></li>
        <li><a href="#KnownProblems">Known Problems</a></li>
    </ul>


    <h2 id="GettingStarted">Getting Started</h2>

    <h4>From the PipeDream 4 package obtained via PlingStore</h4>
    <p>
        The <a href="file:///PipeDreamManuals:StartGuide/index.html"><em>Getting Started Guide</em></a>
        may be accessed in the Manuals.StartGuide directory.<br>
        The accompanying tutorial files may be found in the Examples directory.<br>
        A copy of the <a href="file:///PipeDreamManuals:RefGuide/index.html"><em>Reference Guide</em></a>
        may be found in the Manuals.RefGuide directory.
    </p>

    <h4>From the PipeDream 4 package obtained via PackMan</h4>
    <p>
        The <a href="file:///PipeDreamManuals:StartGuide/index.html"><em>Getting Started Guide</em></a>
        may be accessed from the <em>PipeDream-Manuals</em> package that you can install using PackMan,
        or <a href="https://croftnuisk.co.uk/coltsoft/pipedream/getting_started/">online</a>.
        The accompanying tutorial files may be found by installing the <em>PipeDream-Examples</em> package.
        The <em>PipeDream-Manuals</em> package also provides a copy of the
        <a href="file:///PipeDreamManuals:RefGuide/index.html"><em>Reference Guide</em></a>.
    </p>


    <h2 id="OnlineResources">Online Resources</h2>

    <p>Many resources for PipeDream 4 are available <a href="https://croftnuisk.co.uk/coltsoft/pipedream/">online</a>:</p>

    <ul>
        <li><a href="https://croftnuisk.co.uk/coltsoft/pipedream/getting_started/">Getting Started Guide</a>;</li>
        <li><a href="https://croftnuisk.co.uk/coltsoft/pipedream/reference_guide/">Reference Guide</a>;</li>
        <li>
            <a href="https://croftnuisk.co.uk/coltsoft/pipedream/addenda_and_errata/">Addenda and Errata</a>
            - updates since the documentation was printed, and errata therein;
        </li>
        <li><a href="https://croftnuisk.co.uk/coltsoft/pipedream/hints_and_tips">Hints and Tips</a>;</li>
        <li>
            <a href="https://croftnuisk.co.uk/coltsoft/pipedream/downloads/">Downloads</a>
            - updated PipeDream 4 packages, including tutorial files used in the PipeDream 4 <em>Getting Started Guide</em>.
        </li>
    </ul>


    <h2 id="Support">Support</h2>

    <p>
        As PipeDream 4 is now completely free to use, support is a self-help affair.<br>
        There is a Google Group <strong>colton-software-pipedream</strong> where you may seek help from other users:<br>
        web site: <a href="https://groups.google.com/group/colton-software-pipedream">https://groups.google.com/group/colton-software-pipedream</a><br>
        e-mail: <a href="mailto:colton-software-pipedream@googlegroups.com">colton-software-pipedream@googlegroups.com</a><br>
        Please include files which demonstrate any problems (using a Spark or ZIP archive).
    </p>


    <h2 id="Copyright">Copyright and <a href="file:///PipeDream:RISC_OS/Help/HTML/licenc.htm">Licence</a></h2>

    <p>
        Copyright © 1987–2023 Colton Software<br>
        <a href="file:///PipeDream:RISC_OS/Help/HTML/licenc.htm#CopyrightExtra">Additional copyright information</a>
    </p>

    <p>Thanks to Richard Colton, PipeDream 4 is now open source and completely free to use!</p>


    <h2 id="ReleaseHistory">Release History</h2>

    <p>
        The full release history may be found <a href="https://croftnuisk.co.uk/coltsoft/pipedream/release_history/">online</a>;
        just the last few revisions of PipeDream 4 are documented here.
    </p>

    <p>Please refer to the <a href="https://croftnuisk.co.uk/coltsoft/pipedream/addenda_and_errata/">Addenda and Errata</a> for details of changes to functionality.</p>


<h4>4.62.02 (05 Mar 2023)</h4>

<p>Fix redraw of title bar when it is updated (very old bug!).</p>

<p>Multiple instances of PipeDream 4 can now be launched.</p>

<p>Document file buffering size now determined at run-time. This is:
4KB for systems with less than 4MB of memory,
16KB for systems up to 16MB memory;
32KB for 'modern' systems.
</p>

<p>WimpSlot required at startup reduced further (for 4KB page size systems).</p>

<p>ROOL DDE 31b build environment used.</p>


<h4>4.62.01 (30 Dec 2022)</h4>

<p>Fix missing Interactive Help messages.</p>


<h4>4.62 (28 Dec 2022)</h4>

<p>Fix for loading chart UI sprites on non-RISC OS 5 systems.</p>

<p>Fix for rapidly flashing action buttons in dialogue boxes on RISC OS 3.1.</p>

<p>WimpSlot required at startup reduced - in total it is about 44 KiB less compared to 4.61.</p>

<p>Chart UI templates are only loaded when needed (saves about 20 KiB).</p>

<p>Interactive Help messages are only loaded when needed (saves about 8 KiB).</p>

<p>List of HTML colour names used by @C@ is now loaded as needed.
The file ColMapHTML may be found in Resources.RISC_OS.Neutral.
You could modify this file to add custom colours but beware that any
changes to the one supplied in the application directory may not survive updates!
Instead, it would be better to create a directory called RISC_OS
in Boot:Choices.PipeDream and put the modified file in there.</p>

<p>Lotus 1-2-3 converter detection is performed on each attempted load of Lotus files rather than just once.
Allows user to not have to restart PipeDream 4 if converter had not been 'seen', or has been moved due to reinstallation.</p>

<p>Window title bars no longer contain 'PipeDream: ' prefix - more consistent with current usage.</p>

<p>ROOL DDE 31a build environment used. This allows PipeDream 4 to directly call SWIs in many cases. Yay.</p>


<h4>4.61 (12 Dec 2022)</h4>

<p>Engineering format for the TEXT() spreadsheet function updated to match
Resolution 3 of the 27th CGPM (2022) - 'On the extension of the range of SI prefixes'.
This adds the following to the list of SI prefixes to be used for multiples and submultiples of units:
</p>
<ul>
<li>Q : 10^30</li>
<li>R : 10^27</li>
<li>r : 10^-27</li>
<li>q : 10^-30</li>
</ul>
<p>Prior to this release, PipeDream 4 used prefixes that had been proposed by Jeff K. Aronson in the 1990s for these multiples and submultiples,
with the prefixes W, X, x, w corresponding to the new prefixes Q, R, r, q.</p>

<p>Several redundant RISC_OSLib functions removed; some others replaced with inline ASM blocks.</p>

<p>Interactive Help messages more consistent with RISC OS User and Style Guides.</p>

<p>'PipeDream 4' used more throughout to discriminate vs PipeDream 3.</p>


<h4>4.60.03 (23 Oct 2022)</h4>

<p>Cosmetic fixes for menu and toolbar icons running on RISC OS 3.1.</p>

<p>HTML documentation now encoded as UTF-8.</p>


<h4>4.60.02 (18 Aug 2022)</h4>

<p>PipeDream no longer attempts to parse expressions as ISO 8601 format
date / times as this was messing up several users' existing spreadsheets.
The DATEVALUE() spreadsheet function does still recognise such dates.</p>

<p>CSV file loading no longer parses number fields as expressions. Dates
such as 2022-08-18 are inserted as text rather than as a formula. This means
that if you have a CSV file with a column of dates in ISO 8601 format, they
can be loaded unchanged and then converted to usable dates using the
DATEVALUE() spreadsheet function.</p>

<p>Fix for dragging an icon from the Save dialogue box when the file type
icon is not present in the Wimp Sprite Pool (e.g. TSV) - as elsewhere, the
generic file_xxx icon is now used for solid drag in these cases.</p>


<h4>4.60.01 (04 Aug 2022)</h4>

<p>Loader and Splash had incorrect file types in 4.60 due to a packaging error.</p>


<h4>4.60 (22 Jul 2022)</h4>

<p>PipeDream can import tab-separated-value files of type TSV (&amp;F0D).</p>

<p>The international currency symbol (&curren;: &amp;A4) can be used in the
leading (or trailing - but not in both) characters definition string, where
it is substituted during rendering with the appropriate currency string read
from the Territory Manager (e.g. &pound; in the UK).</p>

<p>The default leading characters string is now &curren; rather than &pound;.</p>

<p>An empty default locale is set during startup so that the system default
locale is used wherever possible by the SharedCLibrary functions, using the
Territory Manager. This may be overridden by editing
 <code>!PipeDream.!Run</code> and adding
 <code>-l &lt;locale-specifier&gt;</code> to the PipeDream command line.</p>

<p>Pressing Ctrl whilst clicking the Up icon in dialogue boxes may be used
to set the value in the adjacent field to its maximum allowed value (or to
the start of the list of values). Similarly, Ctrl-Down may be used to set
the minimum allowed value (or to the end of the list of values).</p>

<p>Numbers typed in the formula line (or imported from CSV files) with only
trailing zeros immediately behind the decimal point (e.g. 1.0) are no longer
immediately converted to integers for subsequent calculation, display or
saving but now remain as floating point values (with zero fractional
part).</p>

<p>Interactive Help messages more consistent between row and column
borders.</p>

<p><code>SWI Portable_Idle</code> is called during pausing when printing to
screen.</p>

<p>More consistent use of https:// vs. http:// in URLs.</p>

<p>ROOL DDE 30d build environment used.</p>


    <h2 id="KnownProblems">Known Problems In This Release</h2>

    <p>
        It is still possible (and has been since PipeDream 3) to create circular
        dependencies in @cell_ref@ chains which fail to complete calculation.
    </p>

    <p>
        Pressing ESCAPE whilst dragging a file somewhere to be saved may
        sometimes cause a Data Abort.
    </p>

    <p>
        There is a problem whereby a document does not reload a newly created
        chart properly. If an chart is created and a copy of the chart is saved out
        as a Draw file (with a different name) then the chart will not reload after
        being closed down. It will reload successfully if PipeDream is
        restarted.
    </p>

    <p>
        Exporting charts directly to other applications (e.g. EasyWriter) as Draw
        files via the Message_RAMFetch / Message_RAMTransfer mechanism only works if
        the application being exported to asks for the whole file in one go as the
        protocol is stopped by PipeDream after the first Message_RAMFetch is
        responded to.
    </p>


    <h2>32-bit !System</h2>

    <p>
        Please note that the latest distribution of !System for use with
        pre-RISC OS 5 computers may be found on the RISC OS Open web site at:
        <a href="https://www.riscosopen.org/content/downloads/common/">https://www.riscosopen.org/content/downloads/common/</a>
        under the heading: <strong>System resources</strong>.
        Please consult the ReadMe file in the downloaded archive.
    </p>


    <p>End of Colton Software PipeDream 4 - Release Notes</p>
</body>
</html>
