update from master

configure.ac

@@ -2,7 +2,7 @@
 ##### Prelude #####
 
 AC_PREREQ(2.59)
-AC_INIT([pd], [0.55.2])
+AC_INIT([pd], [0.56.0])
 AC_CONFIG_SRCDIR(src/m_pd.c)
 AC_CONFIG_AUX_DIR([m4/config])
 AC_CONFIG_MACRO_DIR([m4/generated])

doc/1.manual/resources/chapter2.htm

@@ -123,25 +123,38 @@ <H4> <A href="#s2.1.1" id="s2.1.1"> 2.1.1. The main window, canvases, and printo
     <figcaption><u>Fig. 2.1.7</u> The log level popup menu</figcaption>
 </figure>
 
-<P> Errors are mostly printed by objects and displayed in the Pd window in red color.
+<P id="sfinderror">Errors are mostly printed by objects and displayed in the Pd window in red color.
 You can find error sources for the corresponding line with <kbd>Ctrl</kbd>+<kbd>click</kbd>
-as shown in <A href="chapter2.htm#sfinderror">here</A>).
+or through the context menu on right click as shown below. Alternatively, you can use the
+"Find Last Error" entry in the <b>Find menu</b> for this.
+
+<p>Note that you can also find objects printing regular log outputs via right click or
+<kbd>Ctrl</kbd>+<kbd>click</kbd> in many cases (a cursor change will signalize this option
+when hovering the log lines).
+
+<p>In cases of objects that couldn't be created, the context menu also contains a
+"Find externals" option that will open <b>deken</b> with a prefilled search field.
+
+<figure>
+    <IMG src="2.1.8.png" ALT="find error">
+    <figcaption><u>Fig. 2.1.8</u>Find error source via right click</figcaption>
+</figure>
 
-<P> If the Pd window is focused, the font size for menus and printout can be changed
+<P>If the Pd window is focused, the font size for menus and printout can be changed
 using the "Font" dialog entry in the <b>Edit menu</b>.
 
 <figure>
-<IMG src="2.1.8.png" ALT="edit menu">
-    <figcaption><u>Fig. 2.1.8</u> The Edit menu</figcaption>
+<IMG src="2.1.9.png" ALT="edit menu">
+    <figcaption><u>Fig. 2.1.9</u> The Edit menu</figcaption>
 </figure>
 
 <P> Make your adjustments in the Font dialog window and increase the size if you are
 having trouble reading on HiDPI screens. You can ignore the "Stretch" parameter here, since
 that only works for Pd documents.
 
 <figure>
-<IMG src="2.1.9.png" ALT="font settings">
-    <figcaption><u>Fig. 2.1.9</u> The Font settings dialog</figcaption>
+<IMG src="2.1.10.png" ALT="font settings">
+    <figcaption><u>Fig. 2.1.10</u> The Font settings dialog</figcaption>
 </figure>
 
 <P>Pd documents (called "patches" or "canvases") have their own main window and any number of
@@ -159,8 +172,8 @@ <H4> <A href="#s2.1.1" id="s2.1.1"> 2.1.1. The main window, canvases, and printo
 Note that the Zoom setting is not saved in the patch though.
 
 <figure>
-<IMG src="2.1.10.png" ALT="zoomed in and out">
-    <figcaption><u>Fig. 2.1.10</u> A patch in standard and zoomed state</figcaption>
+<IMG src="2.1.11.png" ALT="zoomed in and out">
+    <figcaption><u>Fig. 2.1.11</u> A patch in standard and zoomed state</figcaption>
 </figure>
 
 <P>In the <b>Edit menu</b>, you can also clear all messages printed in the Pd window with
@@ -179,8 +192,8 @@ <H4> <A href="#s2.1.2" id="s2.1.2"> 2.1.2. Object boxes</A> </H4>
 and presented with a dashed border before creation.
 
 <figure>
-<IMG src="2.1.11.png" ALT="dashed box">
-    <figcaption><u>Fig. 2.1.11</u> An uncreated object box</figcaption>
+<IMG src="2.1.12.png" ALT="dashed box">
+    <figcaption><u>Fig. 2.1.12</u> An uncreated object box</figcaption>
 </figure>
 
 <P>You only create a particular <i>object</i> after you entered text into the
@@ -191,8 +204,8 @@ <H4> <A href="#s2.1.2" id="s2.1.2"> 2.1.2. Object boxes</A> </H4>
 "+ 13".
 
 <figure>
-<IMG src="2.1.12.png" ALT="object box">
-    <figcaption><u>Fig. 2.1.12</u> A created object box</figcaption>
+<IMG src="2.1.13.png" ALT="object box">
+    <figcaption><u>Fig. 2.1.13</u> A created object box</figcaption>
 </figure>
 
 <P>Here, the "+" specifies the <I>class</I> of the object. In this case the
@@ -220,8 +233,8 @@ <H4> <A href="#s2.1.2" id="s2.1.2"> 2.1.2. Object boxes</A> </H4>
 synthesizes a pure tone:
 
 <figure>
-<IMG src="2.1.13.png" ALT="simple MIDI synthesizer">
-    <figcaption><u>Fig. 2.1.13</u> A simple MIDI synthesizer</figcaption>
+<IMG src="2.1.14.png" ALT="simple MIDI synthesizer">
+    <figcaption><u>Fig. 2.1.14</u> A simple MIDI synthesizer</figcaption>
 </figure>
 
 <P>This patch mixes <I>control</I> objects (<b>[notein]</b>, <b>[stripnote]</b>,
@@ -281,8 +294,8 @@ <H4> <A href="#s2.1.3" id="s2.1.3"> 2.1.3. Message and GUI boxes</A> </H4>
 connected object box, which adds 13 to it.
 
 <figure>
-<IMG src="2.1.14.png" ALT="Different box shapes">
-    <figcaption><u>Fig. 2.1.14</u> Different box shapes</figcaption>
+<IMG src="2.1.15.png" ALT="Different box shapes">
+    <figcaption><u>Fig. 2.1.15</u> Different box shapes</figcaption>
 </figure>
 
 <P>The third box here is a <I>GUI</I> ("graphical user interface") box. Pd has
@@ -381,8 +394,8 @@ <H4> <A href="#s2.2.1" id="s2.2.1"> 2.2.1. Edit and run mode</A> </H4>
 they can't be resized in edit mode with the mouse cursor.
 
 <P>If you are predominantly editing a patch, but would like to quickly switch to
-run mode just to click on something like a message, you can press and hold the
-<kbd>Ctrl</kbd> to temporarily switch to edit mode until you release it.
+run mode just to click on something like a message, you can press and hold
+<kbd>Ctrl</kbd> to temporarily switch to run mode until you release it.
 
 <P>In the <b>Edit menu</b> you also find "Undo" and "Redo" operations, which revert
 and recreate changes you've done in your patch while in edit mode. Note that you can
@@ -997,39 +1010,47 @@ <H4> <A href="#s2.4.1" id="s2.4.1">2.4.1. Message types (selectors) and numerica
 and start with decimal digits.
 
 <P>Number atoms are always of type <i>float</i>, meaning that Pd does not have an
-<i>integer</i> number type. Numbers in Pd may also be written in exponential
-notation, such as "4.5e+06", which means 4.5*10<sup>6</sup>, resulting in
-<i>4'500'000</i>. Negative exponents also work, such as 1.5e-06, which
-means 1.5*10<sup>&minus;6</sup> and results in <i>0.0000015</i>.
+<i>integer</i> number type. Numbers in Pd are formatted with the '%g' pattern from
+the 'sprintf' function, with a precision of '6'. This allows formatting numbers
+with and without exponential (or scientific) notation. One example of this notation
+is "4.5e+06", which means 4.5*10<sup>6</sup>, resulting in <i>4'500'000</i>.
+Negative exponents also work, such as 1.5e-06, which means 1.5*10<sup>&minus;6</sup>
+and results in <i>0.0000015</i>.
 
 <P>Depending on their value, numbers are displayed either in decimal or exponential
-notation. You'll only see up to three zeros after the decimal point before the
-first non-zero digit. For instance, "0.0001". If you add another zero, Pd turns it
+notation. For negative exponential notation, the exponent number needs to be '-5'
+or lower. This means you'll only see up to three zeros after the decimal point before
+the first non-zero digit. For instance, "0.0001". If you add another zero, Pd turns it
 into exponential notation for display, so "0.00001" becomes "1e-05". Conversely, if
 you type "1e-04", Pd converts it to "0.0001" for display.
 
-<P>Other than this, Pd only displays 6 significant digits. This means that you can have
-"100000", but adding another zero will switch the representation to "1e+06". Similarly,
-typing "1e+05" results in "100000".
+<P>As for positive exponent numbers, the scientific notation is only used if the
+exponent value is '6' or higher. '6' is also the default numeric precision, so Pd
+only displays 6 significant digits. This means that you can have "100000", but
+adding another zero will switch the representation to "1e+06". Similarly, typing
+"1e+05" results in "100000".
 
-<P>Having 6 significant digits means that numbers are rounded. You can display
-"0.000123456", which has 6 significant digits, but adding another digit as in
-"0.0001234567" forces Pd to round it to "0.000123457". Now, adding another zero
-before the first significant digit turns this into exponential notation as
-"1.23456e-05", keeping the display of the 6 significant digits. Similarly to
-the earlier example, "1.234567e-05" becomes "1.23457e-05". The 7th significant
+<P>Having a 6 digit precision means that numbers are rounded. The 7th significant
 digit is rounded in a way that "0.9999994" or less becomes "0.999999" and
-"0.9999995" or higher becomes "1".
+"0.9999995" or higher becomes "1". You can display "0.000123456", which has 6
+significant digits, but adding another digit as in "0.0001234567" forces Pd to
+round it to "0.000123457". If instead you add another zero before the first
+significant digit, it turns it into exponential notation as "1.23456e-05",
+keeping the display of the 6 significant digits. Similarly to the earlier example,
+"1.234567e-05" becomes "1.23457e-05".
+
+<P>Trailing zeros are not displayed in Pd, and no decimal point is shown if there's
+no fractional part of the number. So if you type <b>1.</b>, it becomes <b>"1"</b>.
 
 <P>Don't mistake the display precision and rounding with the actual floating point
 precision though. If compiled for single precision, numbers in Pd are handled as
 32-bit floats, which allows you to represent any integer with 7 digits or less, even
 though Pd will only display 6.
 
-<P>Note that the display resolution remains the same when Pure Data is compiled for double
-precision, even though the resolution is much higher in Pd64. Since Pure Data has no
-integer data type, the range of representable integer numbers depends on the float
-precision. The integer range is shown below for single and double precision.
+<P>Note that the display resolution remains the same when Pure Data is compiled for
+double precision, even though the resolution is much higher in Pd64. Since Pure Data
+has no integer data type, the range of representable integer numbers depends on the
+float precision. The integer range is shown below for single and double precision.
 
 <figure>
 <table class="center">
@@ -1104,15 +1125,14 @@ <H4> <A href="#s2.4.2" id="s2.4.2">2.4.2. Depth first message passing</A> </H4>
 
 <figure>
     <IMG src="2.4.7.png" ALT="infinite loop">
-    <figcaption><A id="sfinderror"><u>Fig. 2.4.7</u> An infinite loop (stack overflow)</A></figcaption>
+    <figcaption><u>Fig. 2.4.7</u> An infinite loop (stack overflow)</figcaption>
 </figure>
 
 <P>Here, the left-hand <b>[+ 1]</b> can't finish processing until the right-hand one has
 been sent the result "2", which can't finish processing until the left-hand one
 has been sent "3", and so on. This generates a "stack overflow" error (meaning there's
-an infinite loop) in the Pd window that you can <kbd>Ctrl</kbd>+<kbd>click</kbd>
-on (as described earlier) to select the causing object. Note that you can also use the
-"Find Last Error" entry in the <b>Find menu</b> for this.
+an infinite loop) in the Pd window that you can interact with (as described
+<a href="chapter2.htm#sfinderror">earlier</a>) to select the causing object.
 
 <figure>
     <IMG src="2.4.8.png" ALT="find error source">
@@ -1287,8 +1307,8 @@ <H4> <A href="#s2.5.1" id="s2.5.1">2.5.1. Sample rate and format</A> </H4>
 you have all the dynamic range you could want. However, depending on your
 hardware, audio I/O is usually limited to 16 or 24 bits. Inputs all appear
 between the values of -1 and 1; and output values will be clipped to that range.
-Pd assumes a sample rate of 44100 unless you override this (in Pd's command line
-or in the "audio setup" dialog).
+Pd runs at a sample rate of 48000 unless you override this (in Pd's command line
+or in an "audio setup" or "preferences" dialog window).
 
 <P>Pd can read or write samples to files either in 16-bit or 24-bit fixed point
 or in 32-bit floating point, in 'wave', 'aiff', 'caf', and 'next' formats via
@@ -1298,13 +1318,13 @@ <H4> <A href="#s2.5.1" id="s2.5.1">2.5.1. Sample rate and format</A> </H4>
 <H4> <A href="#s2.5.2" id="s2.5.2">2.5.2. Tilde objects and audio connections</A> </H4>
 
 <P>Audio computations in Pd are carried out by "tilde objects" such as
-<b>[osc~]</b>, whose names conventionally end with a tilde character
-(which resembles a sinusoid, symbolizing their function in handling audio signals).
-Tilde objects can intercommunicate via audio connections. When audio computation is
-turned on or when you change the audio network while audio is on, Pd sorts all the
-tilde objects into a linear order for running; this linear list is then by default
-run down in blocks of 64 samples each at 44100 Hz. this means the audio network runs
-every 1.45 milliseconds.
+<b>[osc~]</b>, whose names conventionally end with a tilde character (which
+resembles a sinusoid, symbolizing their function in handling audio signals).
+Tilde objects can intercommunicate via audio connections. When audio computation
+is turned on or when you change the audio network while audio is on, Pd sorts
+all the tilde objects into a linear order for running; this linear list is then
+by default run down in blocks of 64 samples each at 48000 Hz.  The
+audio network then runs every 1-1/3 (about 1.33) milliseconds.
 
 <P>Inlets or outlets are configured in Pd either for messages or audio. You can't
 connect an audio outlet to a non-audio inlet. An object's leftmost inlet may accept
@@ -1466,7 +1486,7 @@ <H4> <A href="#s2.6.1" id="s2.6.1">2.6.1. Audio and messages</A> </H4>
 
 <P>Audio and message processing are interleaved in Pd. Audio processing
 is scheduled every block (64 samples by default) at Pd's sample rate, which
-is 44100 Hz by default and results in a period of approximately 1.45
+is 48000 Hz by default and results in a period of approximately 1.33
 milliseconds. You may turn DSP computation on and off in a patch by sending
 the messages "dsp 1" and "dsp 0" to "pd".
 

doc/1.manual/resources/chapter5.htm

@@ -25,6 +25,62 @@ <H2>Chapter 5: Current status</H2>
 <H3> <A href="#s5.1" id="s5.1"> 5.1. Release notes </A> </H3><section><div>
 
 
+</div></section><section class="releasenote"><h4 id="0.55-2">0.56-0</h4><div>
+
+<p>The dafault sample rate is now 48000.  (All the same sample rates as before
+are still supported).</p>
+
+<p>Reworked text editing mechanism for object/message/gatom/comment boxes and
+applied it also for text fields in scalars (aka "data structures").  It is now
+reasonably feasible to use data structures to hold messages or sequences of
+messages. Also methods "get" and "set" added to the pointer object make it much
+easier to traverse the contents of a scalar; and "nearest" and extended "next"
+messages that make it easier to search for a scalar or scan through a list of
+them.  A variant of the pointer object called "vpointer" allows to access the
+same pointer by name from more than one place, like the value object for
+numnbers. There are several other useful additions such as the ability to drag
+scalars around without having to swap the window into edit mode.</p>
+
+<p>Multichannel support for delread~, etc., tabread~, etc., sig~, snapshot~,
+and print~, all thanks to
+Christof Ressi</p>
+
+<p>a phase argument to block~ allows you to explicitly offset block segmentation
+(also Christof)</p>
+
+<p>Ticks and labels on graphs are now saved with the graph, and run-time
+messages added to show/hide the name, and make editable or not (Hannes).</p>
+
+<p>A new "colors" message to "pd" allows changing the foreground, background, and
+selection colors.  Colors are specified X-style, so "white", "black", etc., are
+OK but you can also say "#ffffff" for white, ##ff0000" for bright red, and
+so on.  This is not yet incorporated in Pd's preferences as it certainly
+should be.</p>
+
+<p>updates to the "deken" ("find externals") mechanism.</p>
+
+<p>Menus cleanup (Hannes)<p>
+
+<p>It's now possible to edit the text contents of a GOP with hidden text from
+its properties dialog.</p>
+
+<p>New "-devicename" argument to set jack's MID and audio device names
+(-jackname still works for jack audio devices but not for MIDI as before).</p>
+
+<p>New option for the "bag" object to prevent multiple entries of the same
+value, and a "bang" message to output without clearning, plus a "query" message
+to look at contents without expelling them.</p>
+
+<p>The "random" object takes a "float" message that both sets the range and
+generates an output.<p>
+
+<p>Shebang support: it's optionally allowed to put a header like "#/bin/pd" in a
+patch file so that you can click on it and have that start Pd.</p>
+
+<p>New "vis" message to Pd to start/stop the gui.</p>
+
+<p>Improvements to mouse handling in MacOS (Ben Wesch).</p>
+
 </div></section><section class="releasenote"><h4 id="0.55-2">0.55-2</h4><div>
 
 <P>Bug fixes in jack - 16+ channels crashed in linux; auto-connect improved to