1 /* manual_tutorials.cpp
2  *
3  * Copyright (C) 1992-2021 Paul Boersma
4  *
5  * This code is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or (at
8  * your option) any later version.
9  *
10  * This code is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
13  * See the GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this work. If not, see <http://www.gnu.org/licenses/>.
17  */
18 
19 #include "ManPagesM.h"
20 #include "praat_version.h"
21 
22 void manual_tutorials_init (ManPages me);
manual_tutorials_init(ManPages me)23 void manual_tutorials_init (ManPages me) {
24 
25 MAN_BEGIN (U"What's new?", U"ppgb", 20211203)
26 INTRO (U"Latest changes in Praat.")
27 NORMAL (U"##6.2.03# (3 December 2021)")
28 LIST_ITEM (U"• Mac: made Enter key work as expected (i.e. character selection) on Japanese keyboards in multi-line text fields in dialogs and TextGrid window.")
29 NORMAL (U"##6.2.02# (2 December 2021)")
30 LIST_ITEM (U"• Fixed a hang if there were negative pitch values in Sound: Change Gender.")
31 LIST_ITEM (U"• Fixed a crash if the size of a PCA did not match the size of a TableOfReal.")
32 NORMAL (U"##6.2.01# (17 November 2021)")
33 LIST_ITEM (U"• Sound window: corrected a bug that caused a thick waveform during or after playing.")
34 ENTRY (U"What used to be new?")
35 LIST_ITEM (U"• @@What was new in 6.2?")
36 LIST_ITEM (U"• @@What was new in 6.1?")
37 LIST_ITEM (U"• @@What was new in 6.0?")
38 LIST_ITEM (U"• @@What was new in 5.4?")
39 LIST_ITEM (U"• @@What was new in 5.3?")
40 LIST_ITEM (U"• @@What was new in 5.2?")
41 LIST_ITEM (U"• @@What was new in 5.1?")
42 LIST_ITEM (U"• @@What was new in 5.0?")
43 LIST_ITEM (U"• @@What was new in 4.6?")
44 LIST_ITEM (U"• @@What was new in 4.5?")
45 LIST_ITEM (U"• @@What was new in 4.4?")
46 LIST_ITEM (U"• @@What was new in 4.3?")
47 LIST_ITEM (U"• @@What was new in 4.2?")
48 LIST_ITEM (U"• @@What was new in 4.1?")
49 LIST_ITEM (U"• @@What was new in 4.0?")
50 LIST_ITEM (U"• @@What was new in 3.9?")
51 LIST_ITEM (U"• @@What was new in 3.8?")
52 LIST_ITEM (U"• @@What was new in 3.7?")
53 LIST_ITEM (U"• @@What was new in 3.6?")
54 LIST_ITEM (U"• @@What was new in 3.5?")
55 LIST_ITEM (U"• @@What was new in 3.3?")
56 LIST_ITEM (U"• @@What was new in 3.2?")
57 LIST_ITEM (U"• @@What was new in 3.1?")
58 MAN_END
59 
60 MAN_BEGIN (U"What was new in 6.2?", U"ppgb", 20211115)
61 NORMAL (U"##6.2# (15 November 2021)")
62 LIST_ITEM (U"• TextGrid window: closing box and opening triangle for IPA chart.")
63 LIST_ITEM (U"• Linux: compatibility with Wayland (rather than just X11).")
64 LIST_ITEM (U"• Chromebook: surrogate window title replaces the one that Chromebooks won’t show.")
65 LIST_ITEM (U"• Much longer list of functions in manual.")
66 NORMAL (U"##6.1.56# (3 November 2021)")
67 LIST_ITEM (U"• Scripting: ##Record Sound (fixed time)...# should return an object ID.")
68 LIST_ITEM (U"• More phonetic symbols in EPS files.")
69 NORMAL (U"##6.1.55# (25 October 2021)")
70 LIST_ITEM (U"• TextGrid window: guard against a rare crash on Windows.")
71 LIST_ITEM (U"• TextGrid: Extract part: guard against producing an empty interval tier.")
72 LIST_ITEM (U"• Plug-ins: settings windows should not show the file name of the script.")
73 LIST_ITEM (U"• Scripting: clicking Cancel when browsing an Infile field should not crash.")
74 LIST_ITEM (U"• Phonetic symbols: a new backslash trigraph for a mid-centralized diacritic (as in [e\\x^]), namely \\bsx\\^ .")
75 NORMAL (U"##6.1.54# (9 October 2021)")
76 LIST_ITEM (U"• PowerCepstrogram: can tabulate cepstral peak prominence values.")
77 LIST_ITEM (U"• Mac: repaired global Escape key menu shortcut (stops sounds that play from the Objects window).")
78 NORMAL (U"##6.1.53# (8 September 2021)")
79 LIST_ITEM (U"• Linux: corrected a bug that caused PDF files to be misaligned "
80 	"if the origin was not in the top left corner.")
81 NORMAL (U"##6.1.52# (25 August 2021)")
82 LIST_ITEM (U"• FormantPath window: more formant listings and stress listings.")
83 LIST_ITEM (U"• Sound window: on Cut or Paste, all windows that contain that Sound now get ungrouped.")
84 LIST_ITEM (U"• Corrected a crash when reading Vorbis files on some 32-bit platforms.")
85 NORMAL (U"##6.1.51# (22 July 2021)")
86 LIST_ITEM (U"• ##Spectrum: Tabulate (verbose)# with:  power spectral density, bin width within domain, bin energy, and much more.")
87 LIST_ITEM (U"• Sound window: ##Get amplitude(s)#.")
88 LIST_ITEM (U"• Scripting: ##date_utc\\$  ( )#, ##date\\#  ( )#, ##date_utc\\#  ( )#.")
89 NORMAL (U"##6.1.50# (20 June 2021)")
90 LIST_ITEM (U"• RealTier: editing, Formula, conversion from and to Matrix and Table and other tiers such as PitchTier, "
91 	"DurationTier, IntensityTier and AmplitudeTier.")
92 LIST_ITEM (U"• Scripting: can now assign multiple objects to a vector.")
93 LIST_ITEM (U"• Fix crashes in ##Create letter R example# and ##Create KlattTable example# introduced in 6.1.49.")
94 NORMAL (U"##6.1.49# (12 June 2021)")
95 LIST_ITEM (U"• @PitchTier, @IntensityTier, @DurationTier and @AmplitudeTier windows: save preferences.")
96 LIST_ITEM (U"• @Manipulation window: removed unused semitone options.")
97 LIST_ITEM (U"• @RealTier object: editing; conversions from and to other tiers and from Table and Matrix.")
98 NORMAL (U"##6.1.48# (2 June 2021)")
99 LIST_ITEM (U"• TextGrid window: Shift-drag drags multiple boundaries again even if the Shift key is not released.")
100 LIST_ITEM (U"• Scripting: publishing (\"Extract\") an object from an editor window returns its ID again.")
101 LIST_ITEM (U"• Scripting: \"Select...\" in an editor window is now prevented from selecting outside the time domain.")
102 NORMAL (U"##6.1.47# (21 May 2021)")
103 LIST_ITEM (U"• The Escape key now means Cancel also in a non-pausing pause window.")
104 NORMAL (U"##6.1.46# (20 May 2021)")
105 LIST_ITEM (U"• Fixed a bug with line types in the Picture window.")
106 LIST_ITEM (U"• TextGrid window: shift-click on a boundary again extends the selection.")
107 NORMAL (U"##6.1.45# (20 May 2021)")
108 LIST_ITEM (U"• Praat picture files can be drawn with ##Read from file# again.")
109 NORMAL (U"##6.1.44# (17 May 2021)")
110 LIST_ITEM (U"• Scripting: queries in editor windows are scriptable again.")
111 NORMAL (U"##6.1.43# (13 May 2021)")
112 LIST_ITEM (U"• TextGrid window: characters in the IPA chart grow with the window.")
113 LIST_ITEM (U"• TextGrid window: seeing the maroon shadow now always means that the boundary will be moved when the mouse is released (problem since 6.1.20 or so).")
114 LIST_ITEM (U"• Scripting: pause window on the Mac: the Enter key works as designed (bug in 6.1.42).")
115 NORMAL (U"##6.1.42# (15 April 2021)")
116 LIST_ITEM (U"• Settings windows: taller text fields for formulas and vectors.")
117 LIST_ITEM (U"• Mac TextGrid window: cursor moves to end of text after selecting an interval (as on Windows and Linux).")
118 NORMAL (U"##6.1.41# (25 March 2021)")
119 LIST_ITEM (U"• TextGrid window: unselected boundaries can again be drawn to the cursor.")
120 LIST_ITEM (U"• Windows: faster running cursor.")
121 LIST_ITEM (U"• Multi-line formula fields.")
122 LIST_ITEM (U"• Scripting: guard against too deep recursive calls to runScript (depth 20).")
123 LIST_ITEM (U"• EEG: repaired a bug that could cause Praat to crash when computing an ERPTier.")
124 NORMAL (U"##6.1.40# (27 February 2021)")
125 LIST_ITEM (U"• Inspect window: corrected a bug that could cause Praat to crash when opening a string vector.")
126 LIST_ITEM (U"• Sound window: made channel scrolling work again when there are more than 8 channels.")
127 LIST_ITEM (U"• Sound window: made channel muting by clicking on the loudspeaker symbols work again.")
128 NORMAL (U"##6.1.39# (8 February 2021)")
129 LIST_ITEM (U"• Scripting: made string vectors visible in writeFile (), pauseScript () and exitScript ().")
130 LIST_ITEM (U"• Mac: corrected a bug that could cause About Praat to crash on macOS 10.10.")
131 NORMAL (U"##6.1.38# (2 January 2021)")
132 LIST_ITEM (U"• Scripting: string vectors, empty\\$ \\#  (), readLinesFromFile\\$ \\#  (), fileNames\\$ \\#  (), folderNames\\$ \\#  (), splitByWhitespace\\$ \\#  ().")
133 LIST_ITEM (U"• Sound files: open Ogg Vorbis files and Opus files.")
134 NORMAL (U"##6.1.37# (16 December 2020)")
135 LIST_ITEM (U"• TextGrid window: removed a bug that caused Praat to crash when option-clicking or command-clicking a boundary when another boundary was selected on a point tier.")
136 LIST_ITEM (U"• Record Sound (fixed time): removed a bug that caused Praat to crash with certain combinations of duration and sampling frequency on Windows.")
137 LIST_ITEM (U"• PowerCepstrogram: more precise integration, so that the cepstral peak prominence is now a continuous function of time.")
138 LIST_ITEM (U"• TextGrid: Get points (preceded): removed a bug that caused Praat to crash under some edge conditions.")
139 LIST_ITEM (U"• Scripting: tryToWriteFile () and tryToAppendFile () should not be available in manuals.")
140 NORMAL (U"##6.1.36# (6 December 2020)")
141 LIST_ITEM (U"• Scripting: tryToWriteFile (), tryToAppendFile (); formulas can have a size of 1 million.")
142 LIST_ITEM (U"• Obscured scripts: error messages always disclosed.")
143 LIST_ITEM (U"• IPA chart: sacrifice laminality symbol for breathiness symbol.")
144 NORMAL (U"##6.1.35# (29 November 2020)")
145 LIST_ITEM (U"• Scripting: sort\\#  (), shuffle\\#  (), to\\#  (), from_to\\#  (), from_to_by\\#  (), from_to_count\\#  (), between_by\\#  (), between_count\\#  ().")
146 LIST_ITEM (U"• Mac: repaired a bug existing since 6.1.04 that caused incorrect line counts in text files with high Unicode characters.")
147 NORMAL (U"##6.1.34# (25 November 2020)")
148 LIST_ITEM (U"• Mac: got bold and italic to work on Praat versions compiled with the BigSur API.")
149 LIST_ITEM (U"• SoundRecorder always a white background, instead of a different background on each platform.")
150 NORMAL (U"##6.1.33# (19 November 2020)")
151 LIST_ITEM (U"• Mac: got audio to work on Praat versions compiled with the BigSur API (6.1.32 did not have audio on BigSur).")
152 NORMAL (U"##6.1.32# (16 November 2020)")
153 LIST_ITEM (U"• First version for Macs with Apple Silicon chip.")
154 LIST_ITEM (U"• Mac: corrected a bug that could cause Praat to crash when a Sound window was closed from a script.")
155 LIST_ITEM (U"• Windows and Linux: made ##Text width...# work correctly from batch.")
156 LIST_ITEM (U"• Linux: reinstalled Tab shortcut in Sound window.")
157 NORMAL (U"##6.1.31# (10 November 2020)")
158 LIST_ITEM (U"• Linux: first GTK-3 version.")
159 NORMAL (U"##6.1.30# (3 November 2020)")
160 LIST_ITEM (U"• Windows: prevented a crash that could occur in the Sound window when clicking with the touchpad while dragging with the mouse (or the reverse).")
161 NORMAL (U"##6.1.29# (27 October 2020)")
162 LIST_ITEM (U"• Mac: corrected a bug revealed by Xcode 12 since 6.1.22 that could cause Praat to crash when using empty vectors, "
163 	"such as when querying a Harmonicity for its mean in regions without frames.")
164 NORMAL (U"##6.1.28# (20 October 2020)")
165 LIST_ITEM (U"• Pause forms: text fields can be multi-line.")
166 LIST_ITEM (U"• Removed a bug that caused Praat to crash when editing a PitchTier.")
167 LIST_ITEM (U"• Script window: got rid of too many history entries after dragging in the Picture window.")
168 NORMAL (U"##6.1.27# (13 October 2020)")
169 LIST_ITEM (U"• Demo window: make sure that the contents of the window become visible "
170 	"more often without calling demoShow() or demoWaitForInput().")
171 NORMAL (U"##6.1.26# (5 October 2020)")
172 LIST_ITEM (U"• Windows: removed a bug that caused Praat to crash if you clicked in the Sound window, "
173 	"then dragged the mouse out of that window, then released the mouse button, and then clicked in the Sound window again.")
174 LIST_ITEM (U"• Linux: removed a bug that caused Praat to crash when clicking Change in the Inspect window.")
175 NORMAL (U"##6.1.25# (4 October 2020)")
176 LIST_ITEM (U"• @FormantPath and @FormantPathEditor.")
177 LIST_ITEM (U"• Windows: implemented vertical scrolling with the mouse wheel in the manual and in the Picture window.")
178 LIST_ITEM (U"• Linux: removed a bug that caused Praat to crash when double-clicking in the Sound window.")
179 LIST_ITEM (U"• Linux: removed a bug that caused Praat to crash when raising the About window twice.")
180 LIST_ITEM (U"• Removed a bug that caused Praat to crash when zooming in "
181 	"to a region in the Sound window without samples, when a pitch curve was visible.")
182 LIST_ITEM (U"• Removed a bug that caused Praat to crash when pasting in "
183 	"a region in the Sound window without samples.")
184 NORMAL (U"##6.1.24# (29 September 2020)")
185 LIST_ITEM (U"• Linux: got rid of flashing during a running cursor or "
186 	"when making a selection in the Sound window or the Picture window.")
187 NORMAL (U"##6.1.23# (28 September 2020)")
188 LIST_ITEM (U"• Windows: got rid of flashing during a running cursor or "
189 	"when making a selection in the Sound window or the Picture window.")
190 LIST_ITEM (U"• Linux: corrected a bug that caused the buttons at the top of a manual window "
191 	"to be overwritten with text when scrolling.")
192 NORMAL (U"##6.1.22# (24 September 2020)")
193 LIST_ITEM (U"• Windows: made the running cursor visible again.")
194 LIST_ITEM (U"• Corrected a bug introduced in 6.1.17alpha that could cause incorrect line spacing in the Picture window, "
195 	"such as in ##TableOfReal: Draw as numbers#.")
196 NORMAL (U"##6.1.21# (20 September 2020)")
197 LIST_ITEM (U"• First fully functional version for BigSur.")
198 LIST_ITEM (U"• Removed a decades-old bug by which an extremum allegedly computed by cubic interpolation "
199 	"would actually have been computed by sinc700.")
200 NORMAL (U"##6.1.20beta# (10 September 2020)")
201 LIST_ITEM (U"• Second beta version for macOS Big Sur.")
202 NORMAL (U"##6.1.19beta# (7 September 2020)")
203 LIST_ITEM (U"• First beta version for macOS Big Sur.")
204 NORMAL (U"##6.1.18alpha# (1 September 2020)")
205 LIST_ITEM (U"• Second alpha version for macOS Big Sur.")
206 NORMAL (U"##6.1.17alpha# (16 August 2020)")
207 LIST_ITEM (U"• Alpha version for macOS Big Sur.")
208 NORMAL (U"##6.1.16# (6 June 2020)")
209 LIST_ITEM (U"• ##Record fixed time...#: more reliable choice of input device.")
210 LIST_ITEM (U"• Mac: notice plugging and unplugging of headphones.")
211 NORMAL (U"##6.1.15# (20 May 2020)")
212 LIST_ITEM (U"• Repaired a bug introduced in 6.0.44 that could cause an incorrect (namely, totally constant) ClassificationTable.")
213 NORMAL (U"##6.1.14# (2 May 2020)")
214 LIST_ITEM (U"• Repaired a bug in drawing ranges introduced in 6.1.06.")
215 NORMAL (U"##6.1.13# (19 April 2020)")
216 LIST_ITEM (U"• Repaired discriminant analysis on i386 processors.")
217 LIST_ITEM (U"• Scripting: enabled predictability by setting random seeds.")
218 LIST_ITEM (U"• Automated batch testing on x86_64, i386 and ARMv7 processors.")
219 NORMAL (U"##6.1.12# (13 April 2020)")
220 LIST_ITEM (U"• All non-GUI tests can be automated from batch.")
221 LIST_ITEM (U"• Repaired a bug introduced in 6.0 whereby a KlattGrid-generated Sound would always be peak-scaled.")
222 NORMAL (U"##6.1.11# (6 April 2020)")
223 LIST_ITEM (U"• Better messages.")
224 LIST_ITEM (U"• Overhauled VowelEditor.")
225 LIST_ITEM (U"• Repaired crashes after creating a Formant from a Spectrum or an Excitation.")
226 NORMAL (U"##6.1.10# (23 March 2020)")
227 LIST_ITEM (U"• Faster formant computation.")
228 LIST_ITEM (U"• More LPC queries.")
229 NORMAL (U"##6.1.09# (26 January 2020)")
230 LIST_ITEM (U"• Accept some more kinds of broken WAV files.")
231 LIST_ITEM (U"• Improved box plot drawing.")
232 LIST_ITEM (U"• More Network commands.")
233 NORMAL (U"##6.1.08# (5 December 2019)")
234 LIST_ITEM (U"• Repaired a bug with automatic alignment for TextGrids (introduced in 6.1.07).")
235 NORMAL (U"##6.1.07# (26 November 2019)")
236 LIST_ITEM (U"• Raspberry Pi edition.")
237 NORMAL (U"##6.1.06# (8 November 2019)")
238 LIST_ITEM (U"• Chromebook edition.")
239 LIST_ITEM (U"• Scripting: colour fields now take name, grey value or RGB vector.")
240 NORMAL (U"##6.1.05# (16 October 2019)")
241 LIST_ITEM (U"• Repaired a bug introduced in 6.0.44 that could cause rubbish LPC smoothing.")
242 LIST_ITEM (U"• Repaired a rare crash when dragging a selection on the Mac.")
243 NORMAL (U"##6.1.04# (28 September 2019)")
244 LIST_ITEM (U"• @Electroglottography.")
245 LIST_ITEM (U"• Sound and other windows: ##Widen or shrink selection...#.")
246 LIST_ITEM (U"• ##KlattGrid: Create from vowel...#.")
247 LIST_ITEM (U"• Fix rectangle playing bug when selection viewer is on.")
248 LIST_ITEM (U"• Selection viewer separately visible for Sound window and TextGrid window.")
249 LIST_ITEM (U"• Scripting: allow comments after parameter list.")
250 LIST_ITEM (U"• Scripting: fix CR/LF pasting from Microsoft Word.")
251 NORMAL (U"##6.1.03# (1 September 2019)")
252 LIST_ITEM (U"• Sound window: ##Widen or shrink selection...#.")
253 NORMAL (U"##6.1.02# (25 August 2019)")
254 LIST_ITEM (U"• Repaired ##Sound: Concatenate with overlap...#.")
255 LIST_ITEM (U"• Mac: Info and script windows: prevent line breaks caused by tab stops.")
256 NORMAL (U"##6.1.01# (14 August 2019)")
257 LIST_ITEM (U"• Repaired ##TextGrid: Replace interval texts...#.")
258 MAN_END
259 
260 MAN_BEGIN (U"What was new in 6.1?", U"ppgb", 20190713)
261 NORMAL (U"##6.1# (13 July 2019)")
262 NORMAL (U"##6.0.57# (1 July 2019)")
263 LIST_ITEM (U"• Repaired a crash when an editor window zoomed in to a zero time range.")
264 LIST_ITEM (U"• Repaired a crash when playing a matrix movie with one row or a constant value.")
265 LIST_ITEM (U"• Repaired a crash when reconstructing a TableOfReal from a PCA.")
266 LIST_ITEM (U"• Scripting: allow comments after `else`, `endif`, `endfor`...")
267 NORMAL (U"##6.0.56# (20 June 2019)")
268 LIST_ITEM (U"• Windows: file dropping on the Praat icon works for higher-Unicode file names.")
269 LIST_ITEM (U"• SpellingChecker: Unicode support.")
270 NORMAL (U"##6.0.55# (13 June 2019)")
271 LIST_ITEM (U"• Unicode normalization in file names.")
272 NORMAL (U"##6.0.54# (6 June 2019)")
273 LIST_ITEM (U"• Removed a bug introduced in 6.0.51 that could cause incorrect axes in Demo window.")
274 NORMAL (U"##6.0.53# (26 May 2019)")
275 LIST_ITEM (U"• Much faster playing of short parts of long sounds that need resampling.")
276 LIST_ITEM (U"• Better handling of broken CSV files.")
277 LIST_ITEM (U"• 64-bit floating-point WAV files.")
278 NORMAL (U"##6.0.52# (2 May 2019)")
279 LIST_ITEM (U"• Removed a bug introduced in 6.0.51 that could cause turning a Discriminant into a Configuration to crash.")
280 LIST_ITEM (U"• Removed a bug introduced in contour grey drawing in August 2017.")
281 NORMAL (U"##6.0.51# (29 April 2019)")
282 LIST_ITEM (U"• Script window: Use Selection for Find.")
283 LIST_ITEM (U"• Removed a bug introduced in 6.0.41 that could cause Praat to crash after removing an element from a Strings or a row from a TableOfReal.")
284 NORMAL (U"##6.0.50# (31 March 2019)")
285 LIST_ITEM (U"• Manual updates, speed, more tests.")
286 LIST_ITEM (U"• Scripting: rowSums\\# , columnSums\\# ; randomGauss\\# \\#  finally with four arguments.")
287 NORMAL (U"##6.0.49# (2 March 2019)")
288 LIST_ITEM (U"• Removed a bug introduced in 6.0.41 whereby a script could misreport an undefined table value.")
289 LIST_ITEM (U"• Removed a bug introduced in 6.0.44 whereby an MFCC's maximum frequency could be ignored.")
290 LIST_ITEM (U"• Pitch: Tabulate candidates.")
291 LIST_ITEM (U"• SoundSet.")
292 NORMAL (U"##6.0.48# (17 February 2019)")
293 LIST_ITEM (U"• Removed a bug introduced in 6.0.44 whereby Praat could crash when drawing a function without any points.")
294 LIST_ITEM (U"• Removed a bug whereby Praat would not start up on macOS 10.10 (because of required GPU libraries).")
295 NORMAL (U"##6.0.47# (8 February 2019)")
296 LIST_ITEM (U"• Removed a bug introduced in 6.0.44 whereby a cepstral peak prominence would be computed incorrectly.")
297 NORMAL (U"##6.0.46# (3 January 2019)")
298 LIST_ITEM (U"• Removed a crashing bug in the LongSound window introduced in 6.0.44.")
299 LIST_ITEM (U"• Removed a bug causing incorrect conversion from Formant to LPC introduced in 6.0.44.")
300 LIST_ITEM (U"• More space for actions in buttons window.")
301 NORMAL (U"##6.0.45# (1 January 2019)")
302 LIST_ITEM (U"• Removed a crashing bug in EditDistanceTable introduced in 6.0.44.")
303 LIST_ITEM (U"• Removed a crashing bug in KlattGrid drawing introduced in 6.0.44.")
304 LIST_ITEM (U"• Removed a bug introduced in 6.0.44 whereby old HMM files were read incorrectly.")
305 NORMAL (U"##6.0.44# (31 December 2018)")
306 LIST_ITEM (U"• Bug fixes and speed.")
307 NORMAL (U"##6.0.43# (8 September 2018)")
308 LIST_ITEM (U"• Removed a very old bug that could create invalid TextGrids during forced alignment.")
309 LIST_ITEM (U"• Windows: repaired a bug introduced in 6.0.41 "
310 	"that caused a crash in several places (such as when changing the sample rate in the SoundRecorder) "
311 	"when Praat had been started with a double click.")
312 LIST_ITEM (U"• Windows: repaired a bug introduced in 6.0.41 that caused Praat to crash when exiting.")
313 NORMAL (U"##6.0.42# (15 August 2018)")
314 LIST_ITEM (U"• Repaired a bug introduced in 6.0.41 that caused a crash in pause windows.")
315 NORMAL (U"##6.0.41# (6 August 2018)")
316 LIST_ITEM (U"• Interoperability: the Windows edition can now communicate with other software in UTF-8.")
317 NORMAL (U"##6.0.40# (11 May 2018)")
318 LIST_ITEM (U"• Scripting: @@Scripting 4.3. Querying objects|selected\\#  ()@.")
319 LIST_ITEM (U"• Table window: cell selection.")
320 LIST_ITEM (U"• Unicode-savvy regular expressions.")
321 NORMAL (U"##6.0.39# (3 April 2018)")
322 LIST_ITEM (U"• More string matching (case-insensitive, word-level).")
323 NORMAL (U"##6.0.38# (29 March 2018)")
324 LIST_ITEM (U"• Concordance: ##TextGrid: Tabulate occurrences...#.")
325 LIST_ITEM (U"• Some @@Independent Component Analysis on EEG@.")
326 LIST_ITEM (U"• Removed many small bugs.")
327 NORMAL (U"##6.0.37# (3 February 2018)")
328 LIST_ITEM (U"• Graphics: fixed crashing bug with \\bsun trigraph.")
329 NORMAL (U"##6.0.36# (11 November 2017)")
330 LIST_ITEM (U"• Many more languages for SpeechSynthesizer and automatic alignment (new eSpeak).")
331 NORMAL (U"##6.0.35# (16 October 2017)")
332 LIST_ITEM (U"• Fixed a bug introduced in 6.0.23 by which ##Remove right boundary# would sometimes incorrectly refuse.")
333 NORMAL (U"##6.0.34# (10 October 2017)")
334 LIST_ITEM (U"• Scripting: arrays in menu commands in scripts.")
335 LIST_ITEM (U"• #Inspect: made a button visible that had disappeared in 6.0.33.")
336 NORMAL (U"##6.0.33# (26 September 2017)")
337 LIST_ITEM (U"• #Pitch: Subtract linear fit...#: correct a bug that prevented computation in the ERB domain.")
338 LIST_ITEM (U"• Scripting: made object[xx].xmin work again.")
339 LIST_ITEM (U"• Removed a bug in ##Polynomial: Evaluate...# introduced in 6.0.32.")
340 NORMAL (U"##6.0.32# (16 September 2017)")
341 LIST_ITEM (U"• Table: allow spaces in column names.")
342 LIST_ITEM (U"• Settings windows no longer replace your visible expressions with their resulting values.")
343 LIST_ITEM (U"• Scripting: formulas using the tilde.")
344 LIST_ITEM (U"• Optimality Theory learning: corrected a bug introduced in 6.0.30 that could cause the editor to crash on the Mac.")
345 LIST_ITEM (U"• EEG: corrected a bug that could cause an infinite loop when doing principal component analysis.")
346 LIST_ITEM (U"• Scripting: faster interpreter.")
347 NORMAL (U"##6.0.31# (21 August 2017)")
348 LIST_ITEM (U"• Scripting: more vectors and matrices.")
349 LIST_ITEM (U"• Numerics: faster and more precise sums, means, standard deviations.")
350 NORMAL (U"##6.0.30# (22 July 2017)")
351 LIST_ITEM (U"• Removed a bug that caused an incorrect title for a PitchTier or PointProcess window.")
352 LIST_ITEM (U"• Removed a bug that caused Praat to crash when doing a linear regression on a Table with no rows.")
353 LIST_ITEM (U"• Scripting: $$object[]$, @@Scripting 5.7. Vectors and matrices|vectors@.")
354 LIST_ITEM (U"• Graphics: better text drawing details.")
355 LIST_ITEM (U"• Linux: possibility to compile Praat without a GUI but with graphics file output.")
356 NORMAL (U"##6.0.29# (24 May 2017)")
357 LIST_ITEM (U"• Sound window: channel muting.")
358 LIST_ITEM (U"• Linux: support for Chinese, Japanese, Korean, Indic, Arabic and Hebrew characters in TextGrids and elsewhere.")
359 NORMAL (U"##6.0.28# (23 March 2017)")
360 LIST_ITEM (U"• Scripting: $$demoPeekInput()$ for animations in combination with $$sleep()$.")
361 NORMAL (U"##6.0.27# (18 March 2017)")
362 LIST_ITEM (U"• TextGrid: fewer error messages in concatenation of multiple TextGrids.")
363 LIST_ITEM (U"• Scripting: $$sleep()$ to pause Praat temporarily: useful for animations in combination with $$demoShow()$.")
364 NORMAL (U"##6.0.26# (2 March 2017)")
365 LIST_ITEM (U"• Mac: more corrections in $$demoShow()$ and $$blankWhilePlaying$.")
366 LIST_ITEM (U"• PraatBarren: better error message when an attempt is made to run PraatBarren interactively.")
367 NORMAL (U"##6.0.25# (11 February 2017)")
368 LIST_ITEM (U"• Mac: made $$demoShow()$ and $$blankWhilePlaying$ compatible with MacOS 10.12 Sierra.")
369 LIST_ITEM (U"• Mac SoundRecorder: more sampling frequencies, on behalf of external USB microphones.")
370 NORMAL (U"##6.0.24# (23 January 2017)")
371 LIST_ITEM (U"• Fixed a bug introduced in 6.0.23 by which ##Remove right boundary# would choose the wrong tier.")
372 LIST_ITEM (U"• TextGrid window: click to insert a phonetic symbol from an IPA chart.")
373 NORMAL (U"##6.0.23# (12 December 2016)")
374 LIST_ITEM (U"• Linux: fixed a bug that caused Praat to crash when playing a sound of more than 7 channels.")
375 LIST_ITEM (U"• Change Gender: fixed a bug introduced in 6.0.22 by which the pitch range factor could not be 0.")
376 LIST_ITEM (U"• Improvements in the manual and in texts.")
377 NORMAL (U"##6.0.22# (15 November 2016)")
378 LIST_ITEM (U"• Scripting: correct error messages for expressions like: 5 + \"hello\"")
379 LIST_ITEM (U"• Command line: the --open option works correctly in the GUI if you open multiple files.")
380 //LIST_ITEM (U"• Sound window: option for showing time in minutes instead of just seconds.")   // too confusing in UI
381 NORMAL (U"##6.0.21# (25 September 2016)")
382 LIST_ITEM (U"• ExperimentMFC: you can now specify font sizes and response keys for goodness judgments.")
383 LIST_ITEM (U"• Table: when drawing ellipses, a font size of 0 can now be used to prevent drawing the labels.")
384 LIST_ITEM (U"• Mac: dragging selections repaired for System 10.11.6 (but we advise to upgrade to 10.12).")
385 LIST_ITEM (U"• Mac: re-enabled Return key for confirming some dialog boxes.")
386 NORMAL (U"##6.0.20# (3 September 2016)")
387 LIST_ITEM (U"• Can open UTF-8 text files with Byte Order Mark.")
388 LIST_ITEM (U"• Scripting improvement: function names can now be used as names of indexed variables.")
389 NORMAL (U"##6.0.19# (13 June 2016)")
390 LIST_ITEM (U"• Mac: dragging selections repaired for System 10.11.5.")
391 NORMAL (U"##6.0.18# (23 May 2016)")
392 LIST_ITEM (U"• Windows: better dotted lines.")
393 LIST_ITEM (U"• TextGrid window: again better automatic alignment.")
394 NORMAL (U"##6.0.17# (21 April 2016)")
395 LIST_ITEM (U"• TextGrid window: better automatic alignment.")
396 NORMAL (U"##6.0.16# (5 April 2016)")
397 LIST_ITEM (U"• Scripting: \"hashes\": variables can now be indexed with strings rather than only with numbers.")
398 LIST_ITEM (U"• TextGrid window: fewer out-of-order messages in automatic alignment.")
399 NORMAL (U"##6.0.15# (21 March 2016)")
400 LIST_ITEM (U"• TextGrid window: removed a bug whereby Praat could do automatic alignment only on sounds sampled at 44.1 kHz.")
401 LIST_ITEM (U"• TextGrid window: improved the location of the final boundary in automatic alignment.")
402 LIST_ITEM (U"• Table window: added a preference for the interpretation of graphical style symbols (\\% \\# \\^ \\_ \\@ ).")
403 NORMAL (U"##6.0.14# (11 February 2016)")
404 LIST_ITEM (U"• Linux: corrected a bug by which the Tab short-cut for playing a sound would not work if the NumLock key was on.")
405 LIST_ITEM (U"• Mac 64-bit: corrected a bug that could cause Praat to crash if the Tab key was pressed in a dialog window.")
406 NORMAL (U"##6.0.13# (31 January 2016)")
407 LIST_ITEM (U"• Windows: corrected a bug that could cause Praat to crash when closing a script window.")
408 LIST_ITEM (U"• Mac 64-bit: progress bars with movies.")
409 NORMAL (U"##6.0.12# (24 January 2016)")
410 LIST_ITEM (U"• Windows 32-bit: corrected a bug that could cause Praat to crash when closing the Sound window after popping up dialog boxes.")
411 LIST_ITEM (U"• Mac 64-bit: better $$demoShow()$.")
412 LIST_ITEM (U"• Mac 64-bit: working Matrix movies and articulatory synthesizer movies.")
413 NORMAL (U"##6.0.11# (18 January 2016)")
414 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when drawing a Spectrum with undefined values.")
415 LIST_ITEM (U"• Mac 64-bit: corrected a bug by which some text in the Sound window would sometimes not be drawn.")
416 LIST_ITEM (U"• Mac 64-bit demo window: improved the working of $$demoShow()$.")
417 NORMAL (U"##6.0.10# (8 January 2016)")
418 LIST_ITEM (U"• Corrected a bug that would cause Praat to crash when starting an ExperimentMFC window.")
419 LIST_ITEM (U"• Mac 64-bit: corrected a bug that would cause black selections in the Sound window.")
420 NORMAL (U"##6.0.09# (1 January 2016)")
421 LIST_ITEM (U"• Windows 64-bit: corrected a bug that could cause Praat to crash when closing the Sound window after popping up dialog boxes.")
422 NORMAL (U"##6.0.08# (5 December 2015)")
423 LIST_ITEM (U"• Windows command line: the $$--a$ option can be used when redirecting the output to pipes and files.")
424 LIST_ITEM (U"• Linux command line: the $$--run$ option is not needed in the Terminal when redirecting output "
425 	"(unless you redirect standard output, standard input %and standard error).")
426 NORMAL (U"##6.0.07# (30 November 2015)")
427 LIST_ITEM (U"• Mac 64-bit: repaired dragging selections (which got broken in the El Capitan fix in 6.0.06).")
428 NORMAL (U"##6.0.06# (29 November 2015)")
429 LIST_ITEM (U"• Mac 64-bit: correct early Info window updates and $$demoShow()$ in El Capitan.")
430 LIST_ITEM (U"• Manual updates.")
431 LIST_ITEM (U"• Corrected some small memory leaks.")
432 NORMAL (U"##6.0.05# (8 November 2015)")
433 LIST_ITEM (U"• A manual page that describes @@TextGrid file formats@.")
434 LIST_ITEM (U"• Corrected a bug that prevented some KlattGrid tiers from being edited.")
435 LIST_ITEM (U"• 32-bit Linux: correct use of PulseAudio (note: 6.0.04 on Debian already had this correct).")
436 NORMAL (U"##6.0.04# (1 November 2015)")
437 LIST_ITEM (U"• Corrected a bug that caused an incorrect number in FFNet files; "
438 	"unreadable FFNet files can be sent to the Praat authors for repair.")
439 NORMAL (U"##6.0.03# (31 October 2015)")
440 LIST_ITEM (U"• Corrected a bug that caused Praat to crash when the Soundrecorder window was closed.")
441 LIST_ITEM (U"• Scripting: when calling Praat from the command line, added the $$--run$ option to force script execution.")
442 NORMAL (U"##6.0.02# (30 October 2015)")
443 LIST_ITEM (U"• Corrected the redrawing of analyses in the Sound window after a change in the sound.")
444 NORMAL (U"##6.0.01# (29 October 2015)")
445 LIST_ITEM (U"• Windows: fixed a bug that caused Praat to crash at start-up in some Windows versions.")
446 MAN_END
447 
448 MAN_BEGIN (U"What was new in 6.0?", U"ppgb", 20151028)
449 NORMAL (U"##6.0# (28 October 2015)")
450 LIST_ITEM (U"• Linux: use PulseAudio as the server for playing sound.")
451 LIST_ITEM (U"• Windows: removed Praatcon.exe, because Praat.exe can now be used from the command line.")
452 LIST_ITEM (U"• Praat can now open files from the command line on all platforms.")
453 LIST_ITEM (U"• The API change that requires raising the major Praat version to 6: "
454 	"no longer any need for Praatcon.exe, because Praat itself can now run a script from the command line on all platforms.")
455 LIST_ITEM (U"• See @@Scripting 6.9. Calling from the command line@ for all command line options.")
456 LIST_ITEM (U"• SpeechSynthesizer: corrected a potentially crashing bug.")
457 LIST_ITEM (U"• Mac Retina graphics: made function drawing (e.g. in the TextGrid window) twice as fast.")
458 LIST_ITEM (U"• LongSound: corrected playing of more than 2 channels.")
459 NORMAL (U"##5.4.22# (8 October 2015)")
460 LIST_ITEM (U"• Sound files: added support for MP3 files with ID3 version 2 headers.")
461 LIST_ITEM (U"• Table: Line graph where: removed a bug that caused nothing to be drawn if the number of columns was larger than the number of rows and "
462 	"the column index was larger than the number of rows.")
463 LIST_ITEM (U"• Mac: corrected horizontal spacing in graphical text on El Capitán.")
464 LIST_ITEM (U"• Mac: corrected a bug that would cause Praat to crash if a PNG file could not be saved (from a script).")
465 LIST_ITEM (U"• Windows: enabled PNG saving from Praatcon.")
466 NORMAL (U"##5.4.21# (29 September 2015)")
467 LIST_ITEM (U"• Corrected a bug introduced in 5.4.20 that could cause the Sound window to crash.")
468 LIST_ITEM (U"• Repaired a very old hang with pulses in the Sound window.")
469 NORMAL (U"##5.4.20# (26 September 2015)")
470 LIST_ITEM (U"• Corrected the graphical representation of numbers with exponents (wrong since 5.4.10).")
471 LIST_ITEM (U"• Windows: prevented flashing console window in $$runScript()$.")
472 NORMAL (U"##5.4.19# (16 September 2015)")
473 LIST_ITEM (U"• LongSound: corrected saving of 8-bit files as 16-bit.")
474 NORMAL (U"##5.4.18# (7 September 2015)")
475 LIST_ITEM (U"• Regular expressions: if the pattern is illegal, you'll now get an error message instead of an empty string.")
476 LIST_ITEM (U"• LongSound: removed a bug introduced in 1999 that could play long stereo sounds much too fast if they had unusual sampling frequencies. "
477 	"This bug has become more noticeable on the Mac since January 2015.")
478 LIST_ITEM (U"• Guard better against sound files that contain 0 samples.")
479 LIST_ITEM (U"• Scripting: faster look-up of variables.")
480 NORMAL (U"##5.4.17# (20 August 2015)")
481 LIST_ITEM (U"• Scripting: removed a bug that could cause Praat to crash when calling $$writeFile()$ with an empty text.")
482 NORMAL (U"##5.4.16# (16 August 2015)")
483 LIST_ITEM (U"• Mac 64-bit: removed a bug by which graphical text passed over the right edge in TextGrid intervals.")
484 LIST_ITEM (U"• Mac 64-bit: removed a bug that allowed the general \"Zoom\" and \"Close\" commands to be accessible from a script.")
485 NORMAL (U"##5.4.15# (1 August 2015)")
486 LIST_ITEM (U"• Introduced several command line options that make it easier to call Praat from a web server.")
487 LIST_ITEM (U"• 64-bit Mac: removed a bug introduced in 5.4.11 that caused incorrect spacing of vertical text in picture files.")
488 NORMAL (U"##5.4.14# (24 July 2015)")
489 LIST_ITEM (U"• Windows and 32-bit Mac: removed a bug introduced in 5.4.12 that could cause weird behavior (even crashing) when "
490 	"pressing the Tab key in the script window or in the manual.")
491 NORMAL (U"##5.4.13# (22 July 2015)")
492 LIST_ITEM (U"• The Demo window can now save itself to a PNG or PDF file.")
493 LIST_ITEM (U"• Windows: removed a bug introduced in 5.4.10 whereby Praatcon would write garbled text to the console.")
494 NORMAL (U"##5.4.12# (10 July 2015)")
495 LIST_ITEM (U"• Windows: removed a bug introduced in 5.4.10 whereby SpeechSynthesizer would only pronounce the first letter of the text.")
496 NORMAL (U"##5.4.11# (8 July 2015)")
497 LIST_ITEM (U"• Windows: removed a bug introduced in 5.4.10 whereby the file selection window could try to open a file with a garbled name.")
498 LIST_ITEM (U"• Removed a bug whereby the PointProcess window would crash when showing a perfectly silent sound.")
499 NORMAL (U"##5.4.10# (27 June 2015)")
500 LIST_ITEM (U"• Removed a bug introduced in version 4.5.09 (January 2007) that caused incorrect "
501 	"upsampling of stereo sounds when the upsampling factor was exactly 2. This bug has caused "
502 	"incorrect playing of stereo sounds with a sampling frequency of 22050 Hz on the Mac since January 2015.")
503 LIST_ITEM (U"• Removed a bug introduced in 2011 that could cause Praat to crash when you scrolled the LongSound window.")
504 LIST_ITEM (U"• TextGrid: ##Count intervals where...# and ##Count points where...#.")
505 NORMAL (U"##5.4.09# (1 June 2015)")
506 LIST_ITEM (U"• Linux: the tab key can be used to play sounds on more computers.")
507 LIST_ITEM (U"• Windows: TextGrid files with non-BMP characters are now read correctly.")
508 LIST_ITEM (U"• Windows: files with names that contain non-BMP characters are now saved correctly.")
509 LIST_ITEM (U"• Updated manual.")
510 NORMAL (U"##5.4.08# (24 March 2015)")
511 LIST_ITEM (U"• Sound window: removed a bug that caused a crash in \"Editor info\".")
512 NORMAL (U"##5.4.07# (22 March 2015)")
513 LIST_ITEM (U"• TextGrid window: ##Add interval# now does the same thing as ##Add boundary# if a time stretch is selected.")
514 LIST_ITEM (U"• Linux: better redrawing in TextGrid window.")
515 NORMAL (U"##5.4.06# (21 February 2015)")
516 LIST_ITEM (U"• Windows: repaired a bug that could cause Praat to crash if a metafile resolution was 200 dpi.")
517 NORMAL (U"##5.4.05# (13 February 2015)")
518 LIST_ITEM (U"• Better support for big integer numbers on Windows XP.")
519 LIST_ITEM (U"• Sound window: guarded against empty view ranges for the intensity curve.")
520 NORMAL (U"##5.4.04# (28 December 2014)")
521 LIST_ITEM (U"• Windows audio playback: if the sound has more channels than the audio hardware, distribute them evenly.")
522 NORMAL (U"##5.4.03# (18 December 2014)")
523 LIST_ITEM (U"• TextGrid reading: Praat now corrects some incomplete TextGrid files created by others.")
524 LIST_ITEM (U"• Better support for text files larger than 2 GB.")
525 NORMAL (U"##5.4.02# (26 November 2014)")
526 LIST_ITEM (U"• Mac: repaired a bug by which quote characters typed into the script window could become curly instead of straight.")
527 NORMAL (U"##5.4.01# (9 November 2014)")
528 LIST_ITEM (U"• @MelSpectrogram, @BarkSpectrogram.")
529 LIST_ITEM (U"• Linux: removed a bug that could cause too many flashes when scrolling a Sound window.")
530 LIST_ITEM (U"• Mac: repaired a bug that could cause a crash in the VowelEditor window.")
531 MAN_END
532 
533 MAN_BEGIN (U"What was new in 5.4?", U"ppgb", 20141004)
534 NORMAL (U"##5.4# (4 October 2014)")
535 NORMAL (U"##5.3.87# (3 October 2014)")
536 LIST_ITEM (U"• Windows scripting: prevented incorrect handling of relative paths after the use of chooseReadFile\\$ .")
537 LIST_ITEM (U"• Windows: repaired a bug that could cause Praat to crash if a metafile resolution was 180 or 1200 dpi.")
538 NORMAL (U"##5.3.86# (28 September 2014)")
539 LIST_ITEM (U"• Linux audio: reverted to old version of PortAudio because of race problems in the Alsa–PulseAudio cooperation.")
540 NORMAL (U"##5.3.85# (19 September 2014)")
541 LIST_ITEM (U"• Mac audio: circumvented a bug in PortAudio by which playback of sounds with sampling frequencies "
542 	"below 44100 Hz could be distorted on some USB headsets.")
543 NORMAL (U"##5.3.84# (26 August 2014)")
544 LIST_ITEM (U"• Manipulation: repaired a bug that could cause Praat to crash when playing a manipulation of a Sound created by the SpeechSynthesizer.")
545 NORMAL (U"##5.3.83# (16 August 2014)")
546 LIST_ITEM (U"• TextGrid window: repaired a bug with automatic alignment that could cause an analysis tier to go out of order.")
547 LIST_ITEM (U"• Linux audio: created a second workaround that reduces even more the chances of a freeze that is due to a potential deadlock "
548 	"in the collaboration between Alsa and PulseAudio that can occur when the playback of a sound is cancelled.")
549 LIST_ITEM (U"• Smoother communication with Phon.")
550 LIST_ITEM (U"• Windows: repaired a memory leak when saving PNG files.")
551 NORMAL (U"##5.3.82# (26 July 2014)")
552 LIST_ITEM (U"• Linux and Mac audio playback: if the sound has more channels than the audio hardware, distribute them evenly.")
553 LIST_ITEM (U"• Pause forms: more consistent appearance of the Revert button.")
554 LIST_ITEM (U"• Scripting: pauseScript ( ) function.")
555 NORMAL (U"##5.3.81# (2 July 2014)")
556 LIST_ITEM (U"• EEG: can work with status %numbers instead of only with status %bits.")
557 LIST_ITEM (U"• Windows: repaired a bug that could cause Praat to crash if there was a 96-dpi printer.")
558 NORMAL (U"##5.3.80# (29 June 2014)")
559 LIST_ITEM (U"• Praat preferences: choice between Chinese and Japanese style for Han characters.")
560 NORMAL (U"##5.3.79# (21 June 2014)")
561 LIST_ITEM (U"• Can now play sounds over more than two channels.")
562 LIST_ITEM (U"• Asynchronous play in scripts (see @@Demo window@).")
563 LIST_ITEM (U"• EEG: blue-to-red colour scale for scalp distributions.")
564 NORMAL (U"##5.3.78# (12 June 2014)")
565 LIST_ITEM (U"• Multithreading can now speed up pitch analysis by a factor of 4 or so, "
566 	"depending on the number of cores in your processor.")
567 LIST_ITEM (U"• Linux: can now open and save Photo objects (from PNG files) "
568 	"and use @@Insert picture from file...@.")
569 LIST_ITEM (U"• Open WAV files that are in the \"extensible\" format (previously \"unsupported format -2\").")
570 LIST_ITEM (U"• Windows: support for dropping more than one file on the Praat icon.")
571 LIST_ITEM (U"• Scripting: can now use the #editor command with an object's ID instead of only with its name.")
572 LIST_ITEM (U"• Windows: removed a bug that sometimes disallowed saving more than one JPEG file.")
573 LIST_ITEM (U"• Linux audio: created a workaround that reduces the chances of a freeze that is due to a potential deadlock "
574 	"in the collaboration between Alsa and PulseAudio that can occur when the playback of a sound is cancelled.")
575 NORMAL (U"##5.3.77# (18 May 2014)")
576 LIST_ITEM (U"• EEG: more facilities for EDF+ files.")
577 NORMAL (U"##5.3.76# (8 May 2014)")
578 LIST_ITEM (U"• One can determine the size of \"speckles\" (filled circles) with ##Speckle size...# in the #Pen menu. "
579 	"Speckles are used in drawing Formant, PitchTier, and several other kinds of objects.")
580 NORMAL (U"##5.3.75# (30 April 2014)")
581 LIST_ITEM (U"• Linux Matrix graphics bug fix: corrected working of ##Draw cells...#.")
582 LIST_ITEM (U"• Scripting bug fix: ability to use x and y as indexed variables.")
583 LIST_ITEM (U"• PowerCepstrogram bug fix: made old version of Paint command available again for scripts.")
584 NORMAL (U"##5.3.74# (24 April 2014)")
585 LIST_ITEM (U"• EEG: more interpretation of triggers in EDF+ files.")
586 NORMAL (U"##5.3.73# (21 April 2014)")
587 LIST_ITEM (U"• EEG: understand more EGI/NetStation files.")
588 NORMAL (U"##5.3.72# (17 April 2014)")
589 LIST_ITEM (U"• Windows: repaired a bug that caused two black edges in PNG files.")
590 LIST_ITEM (U"• Windows: repaired a bug that could cause Praat to crash if a metafile resolution was 360 dpi.")
591 LIST_ITEM (U"• Linux: repaired a bug that caused Praat to crash when cutting or pasting a sound in the Sound window.")
592 NORMAL (U"##5.3.71# (9 April 2014)")
593 LIST_ITEM (U"• Windows: brought more unity in the style of Chinese characters.")
594 NORMAL (U"##5.3.70# (2 April 2014)")
595 LIST_ITEM (U"• Added some query commands for DurationTier objects.")
596 LIST_ITEM (U"• Repaired a bug that caused Praat not to run as a console app.")
597 NORMAL (U"##5.3.69# (28 March 2014)")
598 LIST_ITEM (U"• Picture window: can save to 300-dpi and 600-dpi PNG files.")
599 LIST_ITEM (U"• Graphics: sub-pixel precision line drawing on Mac and Linux.")
600 LIST_ITEM (U"• Repaired a bug that could show spurious buttons in the Objects window if a plug-in created objects.")
601 NORMAL (U"##5.3.68# (20 March 2014)")
602 LIST_ITEM (U"• Mac: corrected a bug introduced in 5.3.67 that could cause crashes when drawing a spectrogram.")
603 LIST_ITEM (U"• Mac and Linux: @@Create Strings as file list...@ handles broken symbolic links more leniently.")
604 NORMAL (U"##5.3.67# (19 March 2014)")
605 LIST_ITEM (U"• Corrected a bug that would create strange PNG files if the selection did not touch the upper left corner of the Picture window.")
606 LIST_ITEM (U"• Mac: can save the Picture window to PNG file.")
607 LIST_ITEM (U"• EEG: understand trigger letters in BDF/EDF files.")
608 NORMAL (U"##5.3.66# (9 March 2014)")
609 LIST_ITEM (U"• Windows and Linux: can save the Picture window to PNG file.")
610 LIST_ITEM (U"• Windows: opening, modifying and saving PNG, TIFF or JPEG files (the Photo object, as on the Mac).")
611 NORMAL (U"##5.3.65# (27 February 2014)")
612 LIST_ITEM (U"• Scripting language: removed some bugs from runScript.")
613 LIST_ITEM (U"• Linux: can save the Picture window to PDF file.")
614 NORMAL (U"##5.3.64# (12 February 2014)")
615 LIST_ITEM (U"• Scripting language: writeInfo, procedure, exitScript, runScript: all with colons.")
616 LIST_ITEM (U"• 64-bit Mac graphics: better highlighting and unhighlighting of selection.")
617 LIST_ITEM (U"• 64-bit Mac graphics: full screen.")
618 NORMAL (U"##5.3.63# (24 January 2014)")
619 LIST_ITEM (U"• Scripting language: easier menu command invocation using the colon \":\".")
620 LIST_ITEM (U"• 64-bit Mac graphics: better handling of any absence of Doulos SIL or Charis SIL.")
621 LIST_ITEM (U"• Windows scripting: can now use \"~\" in file names to refer to home directory, as on Mac and Linux.")
622 NORMAL (U"##5.3.62# (2 January 2014)")
623 LIST_ITEM (U"• 64-bit Mac: removed a bug introduced in 5.3.61 that could cause text containing \"ff\" to become invisible.")
624 NORMAL (U"##5.3.61# (1 January 2014)")
625 LIST_ITEM (U"• EEG: understand status registers that contain text.")
626 LIST_ITEM (U"• KlattGrid: removed a bug introduced in May 2009 that could make Praat crash after editing an oral formant grid.")
627 NORMAL (U"##5.3.60# (8 December 2013)")
628 LIST_ITEM (U"• Mac 64-bit: implemented swiping (to scroll with the trackpad) and pinching (to zoom with the trackpad).")
629 LIST_ITEM (U"• Scripting: backslashTrigraphsToUnicode () and unicodeToBackslashTrigraphs ().")
630 NORMAL (U"##5.3.59# (20 November 2013)")
631 LIST_ITEM (U"• EEG: faster reading of BDF and EDF files.")
632 LIST_ITEM (U"• Batch scripting: made ##appendInfo()# write to the console in the same way as #print.")
633 LIST_ITEM (U"• Removed a bug introduced in 5.3.57 whereby some Praat text files could not be read.")
634 NORMAL (U"##5.3.58# (17 November 2013)")
635 LIST_ITEM (U"• EEG: support for 16-bit (next to 24-bit) BDF files and for 16-bit (next to 8-bit) statuses.")
636 LIST_ITEM (U"• Mac: 64-bit beta version.")
637 NORMAL (U"##5.3.57# (27 October 2013)")
638 LIST_ITEM (U"• Mac: opening, modifying and saving image files (the Photo object).")
639 LIST_ITEM (U"• Mac 64-bit: some small improvements in the user interface.")
640 NORMAL (U"##5.3.56# (15 September 2013)")
641 LIST_ITEM (U"• Mac: 64-bit alpha version.")
642 LIST_ITEM (U"• Linux: improved selecting in the Picture window.")
643 NORMAL (U"##5.3.55# (2 September 2013)")
644 LIST_ITEM (U"• Corrected a bug introduced in 5.3.54 by which you couldn't select a file for saving.")
645 NORMAL (U"##5.3.54# (1 September 2013)")
646 LIST_ITEM (U"• Sound window: removed a bug introduced in 5.3.42 by which you couldn't ask for an odd number of poles in Formant Settings "
647 	"(by e.g. specifying \"5.5\" for the number of formants).")
648 LIST_ITEM (U" Linux: improved dragging of selections in the Picture window and the Sound window.")
649 NORMAL (U"##5.3.53# (9 July 2013)")
650 LIST_ITEM (U"• Table: more drawing commands.")
651 NORMAL (U"##5.3.52# (12 June 2013)")
652 LIST_ITEM (U"• Scripting: editor windows understand #do and ##do\\$ #.")
653 NORMAL (U"##5.3.51# (30 May 2013)")
654 LIST_ITEM (U"• Sound window: ##Extract selected sound for overlap...#.")
655 NORMAL (U"##5.3.49# (13 May 2013)")
656 LIST_ITEM (U"• TextGrid window: alignment of the sound and the annotation in an interval, via Espeak.")
657 LIST_ITEM (U"• Scripting: repaired a bug introduced in 5.3.32 that could cause very slow running of scripts.")
658 NORMAL (U"##5.3.48# (1 May 2013)")
659 LIST_ITEM (U"• Scripting: variable-substitution-free object selection and file writing.")
660 LIST_ITEM (U"• Scripting: #selectObject and #removeObject can select or remove multiple objects at a time.")
661 NORMAL (U"##5.3.47# (23 April 2013)")
662 LIST_ITEM (U"• OTGrammar: included Giorgio Magri's (2012) update rule (weighted all up, high down).")
663 NORMAL (U"##5.3.46# (21 April 2013)")
664 LIST_ITEM (U"• Scripting: variable-substitution-free procedure calls.")
665 LIST_ITEM (U"• Linux: made the Save menu compatible with Ubuntu 12.04.")
666 NORMAL (U"##5.3.45# (15 April 2013)")
667 LIST_ITEM (U"• More parts of the manual reflect variable-substitution-free scripting.")
668 NORMAL (U"##5.3.44# (7 April 2013)")
669 LIST_ITEM (U"• ##Create Sound as pure tone...#.")
670 LIST_ITEM (U"• First steps towards variable-substitution-free scripting: the #do, ##do\\$ #, #writeInfo and #appendInfo functions.")
671 NORMAL (U"##5.3.43# (27 March 2013)")
672 LIST_ITEM (U"• Read and write stereo Kay sound files.")
673 LIST_ITEM (U"• Phonetic symbols \\ts, \\tS and \\ap.")
674 LIST_ITEM (U"• Network: ##Normalize weights...#, ##List weights...#, ##Weights down to Table...#.")
675 NORMAL (U"##5.3.42# (2 March 2013)")
676 LIST_ITEM (U"• Repaired some minor bugs regarding synchronization between multiple windows.")
677 NORMAL (U"##5.3.41# (9 February 2013)")
678 LIST_ITEM (U"• Linux: repaired a bug that could cause Praat to crash when closing the Info window or a script window.")
679 NORMAL (U"##5.3.40# (2 February 2013)")
680 LIST_ITEM (U"• Windows: better handling (in the LongSound window) of sounds that are too long to play.")
681 LIST_ITEM (U"• Mac: corrected a bug that caused Praat to crash when closing the Strings window.")
682 LIST_ITEM (U"• Linux: made audio output work again on 32-bit Linux.")
683 NORMAL (U"##5.3.39# (6 January 2013)")
684 LIST_ITEM (U"• Formant & Spectrogram: To IntensityTier...")
685 NORMAL (U"##5.3.38# (4 January 2013)")
686 LIST_ITEM (U"• ExperimentMFC: repaired a bug introduced in 5.3.36 that caused sound to fail to play completely if the screen did not blank.")
687 NORMAL (U"##5.3.37# (2 January 2013)")
688 LIST_ITEM (U"• ExperimentMFC: after screen blanking, reaction times count from when the response buttons appear.")
689 NORMAL (U"##5.3.36# (1 January 2013)")
690 LIST_ITEM (U"• ExperimentMFC: made it possible to blank the screen while the sound is playing.")
691 NORMAL (U"##5.3.35# (8 December 2012)")
692 LIST_ITEM (U"• SpeechSynthesizer: made it possible to have more than one at a time.")
693 LIST_ITEM (U"• Linux: corrected a bug that caused incorrect alignment of the buttons in the Objects window.")
694 NORMAL (U"##5.3.34# (21 November 2012)")
695 LIST_ITEM (U"• Windows: corrected a bug that caused incorrect alignment of the buttons in the Objects window.")
696 LIST_ITEM (U"• The new ##Sound: Combine to stereo# can now work with Sounds of different durations, as the old could.")
697 LIST_ITEM (U"• Corrected a bug that caused Praat to crash when creating a SpeechSynthesizer.")
698 NORMAL (U"##5.3.33# (20 November 2012)")
699 LIST_ITEM (U"• ##Sound: Combine to stereo# can now combine any number of Sounds into a new Sound whose number of channels "
700 	"is the sum of the numbers of channels of the original Sounds.")
701 LIST_ITEM (U"• ERP: Down to Sound.")
702 NORMAL (U"##5.3.32# (17 October 2012)")
703 LIST_ITEM (U"• Sound window: corrected the working of the \"by window\" scaling option.")
704 NORMAL (U"##5.3.31# (10 October 2012)")
705 LIST_ITEM (U"• ERP: Down to Table...")
706 LIST_ITEM (U"• Linux: corrected a bug that could cause Praat to crash after closing a file selector window for saving.")
707 NORMAL (U"##5.3.30# (6 October 2012)")
708 LIST_ITEM (U"• Circumvented a rare Windows bug that could cause Praat to start to write 1.5 as 1,5 in some countries "
709 	"after opening a strange directory.")
710 LIST_ITEM (U"• Windows: corrected a bug introduced in 5.3.24 that could cause Praat to crash when quitting.")
711 LIST_ITEM (U"• Windows: corrected a bug introduced in 5.3.24 that could cause the Objects window to look weird after resizing.")
712 NORMAL (U"##5.3.29# (30 September 2012)")
713 LIST_ITEM (U"• @EEG: Draw scalp..., including gray legend.")
714 LIST_ITEM (U"• Made the new Sound scaling options available for LongSounds.")
715 NORMAL (U"##5.3.28# (28 September 2012)")
716 LIST_ITEM (U"• Corrected a bug introduced in 5.3.24 that made Praat crash on OSX 10.5.")
717 NORMAL (U"##5.3.27# (27 September 2012)")
718 LIST_ITEM (U"• Corrected a couple of small bugs.")
719 NORMAL (U"##5.3.26# (26 September 2012)")
720 LIST_ITEM (U"• Corrected a bug introduced in 5.3.24 that prevented Praat from running in batch mode.")
721 NORMAL (U"##5.3.25# (26 September 2012)")
722 LIST_ITEM (U"• EEG: view of scalp distribution takes scaling options into account.")
723 LIST_ITEM (U"• Linux: swipable Sound window and manual.")
724 LIST_ITEM (U"• Linux: corrected a bug introduced in 5.3.24 whereby TextGrids could not be edited.")
725 NORMAL (U"##5.3.24# (24 September 2012)")
726 LIST_ITEM (U"• More kinds of vertical scaling in e.g. Sound and EEG windows.")
727 LIST_ITEM (U"• Rewritten user interface (may contain some bugs).")
728 NORMAL (U"##5.3.23# (7 August 2012)")
729 LIST_ITEM (U"• Mac: removed a bug introduced in September 2011 that could cause incorrect behaviour of regular expressions since July 2012.")
730 NORMAL (U"##5.3.22# (21 July 2012)")
731 LIST_ITEM (U"• Linux: removed a bug introduced in 5.3.21 that could cause Praat to crash when opening files.")
732 LIST_ITEM (U"• Neural networks: correct writing and reading of learning settings.")
733 NORMAL (U"##5.3.21# (10 July 2012)")
734 LIST_ITEM (U"• Linux: better folder choice in file selector window for opening files.")
735 LIST_ITEM (U"• Repaired a bug that caused Praat to crash when opening a ManPages file on some platforms.")
736 NORMAL (U"##5.3.20# (5 July 2012)")
737 LIST_ITEM (U"• @EEG: ##Replace TextGrid#.")
738 NORMAL (U"##5.3.19# (24 June 2012)")
739 NORMAL (U"##5.3.18# (15 June 2012)")
740 LIST_ITEM (U"• Corrected a bug in @@Sound: Change gender...@ that caused a part of the sound not to be changed.")
741 NORMAL (U"##5.3.17# (12 June 2012)")
742 LIST_ITEM (U"• @EEG window: extent autoscaling by window.")
743 LIST_ITEM (U"• ERPTier: Remove events between...")
744 NORMAL (U"##5.3.16# (23 May 2012)")
745 NORMAL (U"##5.3.15# (10 May 2012)")
746 LIST_ITEM (U"• Improvements in clipboards, PDF and EPS files.")
747 NORMAL (U"##5.3.14# (28 April 2012)")
748 LIST_ITEM (U"• Linux: Tab shortcut for playing the selection.")
749 LIST_ITEM (U"• EPS files: higher minimum image resolution for spectrograms (300 instead of 106 dpi).")
750 NORMAL (U"##5.3.13# (11 April 2012)")
751 LIST_ITEM (U"• @EEG: Extract part...")
752 NORMAL (U"##5.3.12# (5 April 2012)")
753 LIST_ITEM (U"• Praat picture file: allow larger function drawings (up to 10^9 instead of 10^6 points).")
754 LIST_ITEM (U"• Linux: better audio compatibility with Ubuntu 11.10 (support for unusual sampling frequencies when playing LongSounds).")
755 NORMAL (U"##5.3.11# (27 March 2012)")
756 LIST_ITEM (U"• @EEG: a selected ERPTier can extract events on the basis of a column of a selected Table.")
757 NORMAL (U"##5.3.10# (12 March 2012)")
758 LIST_ITEM (U"• @EEG: Concatenate.")
759 NORMAL (U"##5.3.09# (10 March 2012)")
760 LIST_ITEM (U"• Better text-to-speech.")
761 NORMAL (U"##5.3.08# (5 March 2012)")
762 LIST_ITEM (U"• Removed a bug introduced in 5.3.07 that could cause Praat to crash when viewing a LongSound.")
763 NORMAL (U"##5.3.07# (4 March 2012)")
764 LIST_ITEM (U"• Praat can now save Sounds as 24-bit and 32-bit WAV files.")
765 NORMAL (U"##5.3.06# (28 February 2012)")
766 NORMAL (U"##5.3.05# (19 February 2012)")
767 LIST_ITEM (U"• SpeechSynthesizer (#New menu \\-> #Sound): text-to-speech.")
768 LIST_ITEM (U"• @EEG: better scalp distribution drawing for both 32-channel and 64-channel recordings.")
769 NORMAL (U"##5.3.04# (12 January 2012)")
770 LIST_ITEM (U"• EEG: draw scalp distribution.")
771 LIST_ITEM (U"• Linux: better audio compatibility with Ubuntu 11.10 (support for unusual sampling frequencies when playing Sounds).")
772 NORMAL (U"##5.3.03# (21 November 2011)")
773 LIST_ITEM (U"• EEG: filtering, editing, more viewing.")
774 NORMAL (U"##5.3.02# (7 November 2011)")
775 LIST_ITEM (U"• Corrected a bug introduced in 5.3.01 that could cause the PitchTier or PointProcess window to crash.")
776 LIST_ITEM (U"• Corrected a bug that could cause the Info window to freeze after an error message in a script window.")
777 NORMAL (U"##5.3.01# (1 November 2011)")
778 LIST_ITEM (U"• Macintosh and Windows: better window positioning if the Dock or Task Bar is on the left or right.")
779 LIST_ITEM (U"• IPA symbol: you can now use \\bs.f for the half-length sign (\\.f).")
780 LIST_ITEM (U"• EEG window.")
781 MAN_END
782 
783 MAN_BEGIN (U"What was new in 5.3?", U"ppgb", 20111015)
784 NORMAL (U"##5.3# (15 October 2011)")
785 NORMAL (U"##5.2.46# (7 October 2011)")
786 LIST_ITEM (U"• Corrected the same very old bug as in 5.2.44, but now also for opening and saving files.")
787 LIST_ITEM (U"• Many better messages.")
788 NORMAL (U"##5.2.45# (29 September 2011)")
789 LIST_ITEM (U"• Spectrum window: ##Move cursor to nearest peak#.")
790 LIST_ITEM (U"• Table: ##Save as comma-separated file...#.")
791 LIST_ITEM (U"• Windows: you can now change the font size of the script window.")
792 LIST_ITEM (U"• Windows scripting: the Info window now updates while you are writing to it.")
793 LIST_ITEM (U"• Windows: error messages now stay at the front so that you never have to click away "
794 	"an invisible message window anymore.")
795 NORMAL (U"##5.2.44# (23 September 2011)")
796 LIST_ITEM (U"• Corrected a very old bug in the history mechanism (the button title wouldn't always show up).")
797 NORMAL (U"##5.2.43# (21 September 2011)")
798 LIST_ITEM (U"• Linux: you can now change the font size of the script window.")
799 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when opening an already open file in the script window.")
800 NORMAL (U"##5.2.42# (18 September 2011)")
801 LIST_ITEM (U"• Corrected a bug introduced in 5.2.36 that prevented formulas from working on FormantGrid objects.")
802 NORMAL (U"##5.2.41# (17 September 2011)")
803 LIST_ITEM (U"• Improved dashed-dotted lines in EPS files.")
804 LIST_ITEM (U"• Corrected a bug introduced in 5.2.36 that caused Praat to crash when running an ExperimentMFC.")
805 NORMAL (U"##5.2.40# (11 September 2011)")
806 LIST_ITEM (U"• Corrected a bug in the 64-bit Windows edition that led to an incorrect location for the preferences files.")
807 NORMAL (U"##5.2.39# (10 September 2011)")
808 LIST_ITEM (U"• 64-bit edition for Windows.")
809 LIST_ITEM (U"• Corrected a bug that caused Praat to crash instead of saying \"undefined\" when reporting the shimmer of a sound with fewer than 3 pulses.")
810 NORMAL (U"##5.2.38# (6 September 2011)")
811 LIST_ITEM (U"• Corrected several bugs that were introduced in 5.2.36 in the Inspect window.")
812 NORMAL (U"##5.2.37# (2 September 2011)")
813 LIST_ITEM (U"• Graphics: added the Chinese phonetic symbols \\id and \\ir. See @@Phonetic symbols: vowels@.")
814 LIST_ITEM (U"• Corrected a bug introduced in 5.2.36 that caused Praat to crash when querying formant quantiles.")
815 NORMAL (U"##5.2.36# (30 August 2011)")
816 LIST_ITEM (U"• Graphics: added superscript diacritics as single symbols: \\^h (\\bs\\^ h), \\^j (\\bs\\^ j), "
817 	"and many more; also \\_u (\\bs\\_ u). See @@Phonetic symbols: diacritics@.")
818 LIST_ITEM (U"• Praat fully converted to C++ (this may initially cause some bugs, but will be more reliable in the end).")
819 NORMAL (U"##5.2.35# (5 August 2011)")
820 LIST_ITEM (U"• Corrected the menus of the Sound and TextGrid windows.")
821 NORMAL (U"##5.2.34# (3 August 2011)")
822 LIST_ITEM (U"• @@Insert picture from file...@ now works on Windows (as well as on the Mac).")
823 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when playing a LongSound.")
824 NORMAL (U"##5.2.33# (29 July 2011)")
825 LIST_ITEM (U"• Improved the reliability of sound playing and several other things.")
826 LIST_ITEM (U"• Improved several error messages.")
827 NORMAL (U"##5.2.32# (22 July 2011)")
828 LIST_ITEM (U"• Corrected several problems with error messages.")
829 LIST_ITEM (U"• Corrected a bug that could cause slow execution of scripts with forms.")
830 NORMAL (U"##5.2.31# (21 July 2011)")
831 LIST_ITEM (U"• Corrected a bug that caused an incorrect window size in the VowelEditor.")
832 LIST_ITEM (U"• Corrected a bug that caused incorrect error messages when opening a FLAC file as a LongSound.")
833 LIST_ITEM (U"• Sound window: corrected a bug that could cause Praat to crash when zooming in on the left or right edge.")
834 NORMAL (U"##5.2.30# (18 July 2011)")
835 LIST_ITEM (U"• Corrected a bug introduced in 5.2.29 whereby the list of object actions could stay empty after an error message in a script.")
836 LIST_ITEM (U"• Corrected a bug in Klatt synthesis whereby the generation of a sound could be refused.")
837 NORMAL (U"##5.2.29# (12 July 2011)")
838 LIST_ITEM (U"• More accurate error checking, due to Praat's conversion to C++ (last C-only version was 5.2.17).")
839 NORMAL (U"##5.2.28# (28 June 2011)")
840 LIST_ITEM (U"• Corrected some Polygon bugs.")
841 NORMAL (U"##5.2.27# (19 June 2011)")
842 LIST_ITEM (U"• @Polygon: ##Draw (closed)...#.")
843 LIST_ITEM (U"• @@PointProcess: To Sound (phonation)...@: "
844 	"corrected a bug that could cause Praat to crash if pulses lay outside the time domain.")
845 NORMAL (U"##5.2.26# (24 May 2011)")
846 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash on some platforms when reading a Praat binary file.")
847 LIST_ITEM (U"• @ExperimentMFC: corrected a bug that caused Praat to crash if an experiment contained zero trials.")
848 LIST_ITEM (U"• Corrected a bug that caused Praat to crash when merging multiple IntervalTiers.")
849 NORMAL (U"##5.2.25# (11 May 2011)")
850 LIST_ITEM (U"• OT learning: corrected a crashing bug from ##Get candidate...#.")
851 NORMAL (U"##5.2.24# (10 May 2011)")
852 LIST_ITEM (U"• Ability to open WAV files that contain incorrect information about the number of samples.")
853 LIST_ITEM (U"• Removed an old bug that could cause Praat to fail to read a chronological TextGrid text file.")
854 NORMAL (U"##5.2.23# (1 May 2011)")
855 LIST_ITEM (U"• Removed a bug introduced recently that could cause Praat to crash when working with derivatives of TableOfReal (such as Distributions).")
856 NORMAL (U"##5.2.22# (14 April 2011)")
857 LIST_ITEM (U"• @ExperimentMFC: reaction times for key presses.")
858 LIST_ITEM (U"• Linux: more reliable start-up on German systems.")
859 NORMAL (U"##5.2.21# (29 March 2011)")
860 LIST_ITEM (U"• Scripting: removed a crashing bug introduced for colour names in 5.2.20.")
861 NORMAL (U"##5.2.20# (25 March 2011)")
862 LIST_ITEM (U"• Scripting: removed a large memory leak for indexed variables.")
863 LIST_ITEM (U"• Scripting: removed a small memory leak for colour names.")
864 LIST_ITEM (U"• Support for very long file paths on the Mac.")
865 NORMAL (U"##5.2.19# (16 March 2011)")
866 LIST_ITEM (U"• @ExperimentMFC: corrected a bug introduced in 5.2.18 that could cause Praat to crash when extracting results from an incomplete experiment.")
867 NORMAL (U"##5.2.18# (9 March 2011)")
868 LIST_ITEM (U"• @ExperimentMFC: incomplete experiments can nevertheless output their incomplete results.")
869 NORMAL (U"##5.2.17# (2 March 2011)")
870 LIST_ITEM (U"• Better names for Table opening and saving commands.")
871 LIST_ITEM (U"• @ExperimentMFC: reaction times for mouse clicks.")
872 LIST_ITEM (U"• Linux/GTK: corrected triple clicks in ExperimentMFC.")
873 NORMAL (U"##5.2.16# (20 February 2011)")
874 LIST_ITEM (U"• Better support for WAV files with special \"chunks\" in them.")
875 LIST_ITEM (U"• Manual: documentation of explicit formulas for @@Voice 2. Jitter|jitter measurements@.")
876 NORMAL (U"##5.2.15# (11 February 2011)")
877 LIST_ITEM (U"• @@Sounds: Concatenate with overlap...@.")
878 NORMAL (U"##5.2.14# (8 February 2011)")
879 LIST_ITEM (U"• Repaired crashing bug in Manipulation window introduced in 5.2.13.")
880 NORMAL (U"##5.2.13# (7 February 2011)")
881 LIST_ITEM (U"• Renamed #Write commands to #Save commands.")
882 LIST_ITEM (U"• Scripting: allow pause forms without #Stop button (see @@Scripting 6.6. Controlling the user@).")
883 LIST_ITEM (U"• GTK: correct behaviour of default buttons.")
884 NORMAL (U"##5.2.12# (28 January 2011)")
885 LIST_ITEM (U"• Renamed #Edit buttons to ##View & Edit#.")
886 LIST_ITEM (U"• Better visibility of dragged things on Linux.")
887 NORMAL (U"##5.2.11# (18 January 2011)")
888 LIST_ITEM (U"• Better visibility of dragged things (sound selection, tier points, TextGrid boundaries) on Windows and Linux.")
889 NORMAL (U"##5.2.10# (11 January 2011)")
890 LIST_ITEM (U"• Renamed #Read and #Write menus to #Open and #Save.")
891 LIST_ITEM (U"• Sound: use of ##Formula (part)...# can speed up formulas appreciably.")
892 NORMAL (U"##5.2.09# (9 January 2011)")
893 LIST_ITEM (U"• Much improved scripting tutorial.")
894 LIST_ITEM (U"• Listening experiments can now show pictures instead of just texts (on the Mac).")
895 LIST_ITEM (U"• EPS files can now be many miles wide instead of just 55 inches.")
896 NORMAL (U"##5.2.08# (1 January 2011)")
897 LIST_ITEM (U"• Improved manual.")
898 LIST_ITEM (U"• Improved memory allocation on 32-bit platforms: "
899 	"less probability of crashes when you approach the 2 GB memory limit gradually, and a new \"low on memory; save your work now\" warning.")
900 LIST_ITEM (U"• Removed IntervalTier and TextTier datatypes from Praat (old scripts that use them will continue to work).")
901 NORMAL (U"##5.2.07# (24 December 2010)")
902 LIST_ITEM (U"• Support for reading and writing multi-channel sound files (i.e. above two-channel stereo).")
903 NORMAL (U"##5.2.06# (18 December 2010)")
904 LIST_ITEM (U"• Picture window: a new (the fourth) line type, namely dashed-dotted.")
905 LIST_ITEM (U"• Support for analysing and drawing multi-channel sounds (i.e. above two-channel stereo).")
906 LIST_ITEM (U"• Can read some EEG files (BioSemi 24-bit BDF) as a Sound and a TextGrid object.")
907 LIST_ITEM (U"• Linux: compatibility with computers without English language support.")
908 LIST_ITEM (U"• Macintosh: support for high-plane (i.e. very uncommon) Unicode characters in file names (as already existed on Unix and Windows).")
909 NORMAL (U"##5.2.05# (4 December 2010)")
910 LIST_ITEM (U"• Regular expressions: better Unicode support.")
911 LIST_ITEM (U"• Scripting window: command ##Convert to C string#.")
912 NORMAL (U"##5.2.04# (27 November 2010)")
913 LIST_ITEM (U"• Scripting: allow directory (folder) selector windows; see @@Scripting 6.6. Controlling the user@.")
914 NORMAL (U"##5.2.03# (19 November 2010)")
915 LIST_ITEM (U"• Scripting: support for string arrays.")
916 NORMAL (U"##5.2.02# (17 November 2010)")
917 LIST_ITEM (U"• TextGrid window: corrected a bug that caused Praat to crash (instead of doing nothing) when you tried to add boundaries "
918 	"if the selection ran from the penultimate interval to the end of the TextGrid.")
919 LIST_ITEM (U"• Scripting: support for arrays with multiple indexes.")
920 LIST_ITEM (U"• Linux: made spectrogram drawing compatible with Ubuntu 10.10.")
921 LIST_ITEM (U"• Linux: made sound more easily available on Ubuntu 10.10.")
922 NORMAL (U"##5.2.01# (4 November 2010)")
923 LIST_ITEM (U"• Scripting: support for numeric @@Scripting 5.6. Arrays and dictionaries|arrays@.")
924 MAN_END
925 
926 MAN_BEGIN (U"What was new in 5.2?", U"ppgb", 20101029)
927 NORMAL (U"##5.2# (29 October 2010)")
928 NORMAL (U"##5.1.45# (26 October 2010)")
929 LIST_ITEM (U"• Linux/GTK: allow Praat to run without an X display.")
930 LIST_ITEM (U"• Sounds are played synchronously in scripts run from ManPages with \\bsSC.")
931 NORMAL (U"##5.1.44# (4 October 2010)")
932 LIST_ITEM (U"• Linux/GTK: visibility of ExperimentMFC window.")
933 LIST_ITEM (U"• Linux/GTK: keyboard shortcuts.")
934 NORMAL (U"##5.1.43# (4 August 2010)")
935 LIST_ITEM (U"• Scripting: support for stand-alone programs; see @@Scripting 9.1. Turning a script into a stand-alone program@.")
936 LIST_ITEM (U"• Table: allow drawing of ellipses even if irrelevant columns contain undefined data.")
937 LIST_ITEM (U"• Linux/GTK: correct resizing of Table window.")
938 LIST_ITEM (U"• Linux/GTK: prevented multiple storing of Picture window selection in scripting history.")
939 NORMAL (U"##5.1.42# (26 July 2010)")
940 LIST_ITEM (U"• Scripting: allow file selector windows; see @@Scripting 6.6. Controlling the user@.")
941 LIST_ITEM (U"• Linux: multiple file selection.")
942 NORMAL (U"##5.1.41# (15 July 2010)")
943 LIST_ITEM (U"• OTGrammar: ##Compare candidates...#")
944 LIST_ITEM (U"• GTK: support for the Doulos SIL and Charis SIL fonts.")
945 LIST_ITEM (U"• GTK: working vowel editor.")
946 LIST_ITEM (U"• Vowel editor: repaired memory leak.")
947 //LIST_ITEM (U"• GTK: Picture window: front when drawing.")
948 //LIST_ITEM (U"• GTK: correct scrolling in manuals.")
949 NORMAL (U"##5.1.40# (13 July 2010)")
950 LIST_ITEM (U"• GTK: working Demo window (drawing, clicks, keys).")
951 LIST_ITEM (U"• GTK: pause forms.")
952 LIST_ITEM (U"• GTK: manual pages: receive a white background, for compatibility with dark-background themes.")
953 LIST_ITEM (U"• GTK: in settings windows, better alignment of labels to radio groups.")
954 LIST_ITEM (U"• GTK: rotated text.")
955 NORMAL (U"##5.1.39# (10 July 2010)")
956 LIST_ITEM (U"• GTK beta version.")
957 LIST_ITEM (U"• Linux: made ##Sound: Record fixed time...# work correctly (the sampling frequency was wrong).")
958 LIST_ITEM (U"• GTK: list of objects: multiple selection, working Rename button.")
959 LIST_ITEM (U"• GTK: running a script no longer deselects all objects at the start.")
960 LIST_ITEM (U"• GTK: working Buttons editor.")
961 LIST_ITEM (U"• GTK: correctly laid out settings windows.")
962 NORMAL (U"##5.1.38# (2 July 2010)")
963 LIST_ITEM (U"• Linux: made ##Sound: Record fixed time...# work correctly (the sampling frequency was wrong).")
964 LIST_ITEM (U"• Mac: repaired a bug introduced in 5.1.35 that could cause Praat to crash if neither Doulos SIL nor Charis SIL were installed.")
965 LIST_ITEM (U"• Mac: correct live scrolling in Picture window and DataEditor.")
966 NORMAL (U"##5.1.37# (23 June 2010)")
967 LIST_ITEM (U"• PitchTier window and similar windows: can drag multiple points simultaneously.")
968 LIST_ITEM (U"• Table: %t-tests report the number of degrees of freedom.")
969 LIST_ITEM (U"• GTK: correct progress bar again.")
970 LIST_ITEM (U"• GTK: correct behaviour of Synth menu in manipulation window.")
971 NORMAL (U"##5.1.36# (18 June 2010)")
972 LIST_ITEM (U"• Mac: live scrolling.")
973 LIST_ITEM (U"• Demo window: the Demo window can now run from the command line.")
974 LIST_ITEM (U"• Motif: corrected a bug introduced in 5.1.33 whereby things in the Picture window could be placed incorrectly.")
975 LIST_ITEM (U"• GTK: script window accepts Unicode again.")
976 NORMAL (U"##5.1.35# (10 June 2010)")
977 LIST_ITEM (U"• TextGrid window: removed a very old bug that could lead to reversed intervals and to crashes when you inserted a boundary after using Shift-arrow and Command-arrow.")
978 LIST_ITEM (U"• Graphics: Praat now uses Doulos SIL instead of Charis SIL if your font setting is \"Times\" and the font is nonbold and nonitalic, "
979 	"because Doulos SIL matches Times New Roman better.")
980 LIST_ITEM (U"• kNN: made Ola Söder's k-nearest-neighbours classification compatible with Windows.")
981 NORMAL (U"##5.1.34# (31 May 2010)")
982 LIST_ITEM (U"• Sound window: corrected a bug that caused Praat to crash if the analysis window was shorter than 2 samples.")
983 LIST_ITEM (U"• GTK: scrolling in the Info window and script window.")
984 LIST_ITEM (U"• GTK: script editor: implemented searching, replacing, and change dialogs.")
985 NORMAL (U"##5.1.33# (24 May 2010)")
986 LIST_ITEM (U"• GTK alpha version.")
987 LIST_ITEM (U"• Abolished resolution independence: the Sound window now looks the same on all platforms, "
988 	"and the Demo window has the same relative font size on your screen and on the video projector.")
989 LIST_ITEM (U"• GTK: support for asynchronous audio output.")
990 LIST_ITEM (U"• GTK: sound plays once rather than three times in Sound and other windows.")
991 LIST_ITEM (U"• GTK: can click more than once in the manual.")
992 LIST_ITEM (U"• GTK: correct pink selections in Sound and other windows.")
993 LIST_ITEM (U"• GTK: correct dragging in TextGrid, Manipulation, and tier windows.")
994 LIST_ITEM (U"• GTK: a working TextGrid window.")
995 LIST_ITEM (U"• GTK: no automatic triple click in the manual (and many other windows).")
996 LIST_ITEM (U"• GTK: moving cursor while sound is playing in Sound and other windows.")
997 LIST_ITEM (U"• GTK: correct colours of the rectangles in Sound and other windows.")
998 LIST_ITEM (U"• GTK: a working Group button.")
999 LIST_ITEM (U"• GTK: correct font menus, font size menus, colour menus, line type menus.")
1000 LIST_ITEM (U"• GTK: scrolling in the manual (and many other windows).")
1001 LIST_ITEM (U"• GTK: erase old texts in manual windows.")
1002 LIST_ITEM (U"• GTK: made Picture window come back when drawing.")
1003 LIST_ITEM (U"• GTK: Info window is fronted automatically.")
1004 LIST_ITEM (U"• GTK: support sendpraat.")
1005 NORMAL (U"##5.1.32# (30 April 2010)")
1006 LIST_ITEM (U"• Scripting: command ##Expand include files#.")
1007 LIST_ITEM (U"• Scripting: accept lines that start with non-breaking spaces (as may occur in scripts copied from the web manual).")
1008 LIST_ITEM (U"• Sound files: accept MP3 files with extension written in capitals.")
1009 LIST_ITEM (U"• Linux audio recording: corrected input choice (microphone, line).")
1010 NORMAL (U"##5.1.31# (4 April 2010)")
1011 LIST_ITEM (U"• @@Sounds: Convolve...@, @@Sounds: Cross-correlate...@, @@Sound: Autocorrelate...@, with full documentation.")
1012 LIST_ITEM (U"• More query commands for IntensityTier.")
1013 NORMAL (U"##5.1.30# (25 March 2010)")
1014 LIST_ITEM (U"• Scripting: $$createFolder ()$ can now work with absolute paths.")
1015 LIST_ITEM (U"• PointProcess: made it impossible to add a point where there is already a point.")
1016 NORMAL (U"##5.1.29# (11 March 2010)")
1017 LIST_ITEM (U"• Full support for unicode values above 0xFFFF on Macintosh.")
1018 NORMAL (U"##5.1.28# (10 March 2010)")
1019 LIST_ITEM (U"• TextGrid window: removed a recently introduced bug that could cause Praat to crash when inserting a boundary.")
1020 NORMAL (U"##5.1.27# (7 March 2010)")
1021 LIST_ITEM (U"• Table: Wilcoxon rank sum test.")
1022 LIST_ITEM (U"• Logistic regression: corrected a bug by which a boundary would sometimes not be drawn.")
1023 NORMAL (U"##5.1.26# (25 February 2010)")
1024 LIST_ITEM (U"• Experimental GTK version with the help of Franz Brauße.")
1025 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash if sound playing failed twice.")
1026 NORMAL (U"##5.1.25# (20 January 2010)")
1027 LIST_ITEM (U"• Script window: the new command ##Reopen from disk# allows you to edit the script with an external editor.")
1028 LIST_ITEM (U"• Script window: removed a bug that could cause Praat to crash of you did ##Find again# before having done any #Find.")
1029 NORMAL (U"##5.1.24# (15 January 2010)")
1030 LIST_ITEM (U"• Formulas run 10 to 20 percent faster.")
1031 LIST_ITEM (U"• Macintosh: support for forward delete key and Command-`.")
1032 NORMAL (U"##5.1.23# (1 January 2010)")
1033 LIST_ITEM (U"• Allowed multiple files to be selected with e.g. @@Read from file...@.")
1034 LIST_ITEM (U"• Demo window: guarded against handling the Demo window from two scripts at a time.")
1035 NORMAL (U"##5.1.22# (15 December 2009)")
1036 LIST_ITEM (U"• Picture window: millions of @@colour|colours@ instead of just twelve.")
1037 LIST_ITEM (U"• Sound window: ##Move frequency cursor to...#")
1038 NORMAL (U"##5.1.21# (30 November 2009)")
1039 LIST_ITEM (U"• @@Sound: Draw where...@")
1040 LIST_ITEM (U"• ##Matrix: Draw contours...# and ##LogisticRegression: Draw boundary...# support reversed axes.")
1041 LIST_ITEM (U"• Sound window: ##Move frequency cursor to...#.")
1042 NORMAL (U"##5.1.20# (26 October 2009)")
1043 LIST_ITEM (U"• Editor windows: repaired the Synchronized Zoom And Scroll preference.")
1044 NORMAL (U"##5.1.19# (21 October 2009)")
1045 LIST_ITEM (U"• Table: Randomize rows")
1046 LIST_ITEM (U"• Tables: Append (vertically)")
1047 LIST_ITEM (U"• Scripting: corrected a bug that could cause Praat to crash if the name of a field in a form contained a colon.")
1048 LIST_ITEM (U"• Windows: corrected arc drawing.")
1049 NORMAL (U"##5.1.18# (9 October 2009)")
1050 LIST_ITEM (U"• The @@Demo window@ is less often automatically moved to the front "
1051 	"(in order to allow it to pop up other editor windows).")
1052 LIST_ITEM (U"• @@DTW & TextGrid: To TextGrid (warp times)@: corrected a bug that could "
1053 	"lead to an incorrect end time of the last interval in new IntervalTiers.")
1054 NORMAL (U"##5.1.17# (22 September 2009)")
1055 LIST_ITEM (U"• Made more stereo movies readable.")
1056 LIST_ITEM (U"• Editor windows now have a ##Zoom Back# button.")
1057 NORMAL (U"##5.1.16# (17 September 2009)")
1058 LIST_ITEM (U"• Macintosh: corrected a bug that caused incorrect phonetic symbols if Charis SIL was available but SIL Doulos IPA93 was not.")
1059 NORMAL (U"##5.1.15# (30 August 2009)")
1060 LIST_ITEM (U"• Corrected a bug in @@Sound: Change gender...@ introduced in 5.1.14.")
1061 NORMAL (U"##5.1.14# (27 August 2009)")
1062 LIST_ITEM (U"• Windows: corrected a bug introduced in 5.1.13 that caused Praat to crash during tab navigation.")
1063 LIST_ITEM (U"• Made @@Sound: Change gender...@ compatible with elephant calls (i.e. very low F0).")
1064 NORMAL (U"##5.1.13# (21 August 2009)")
1065 LIST_ITEM (U"• Script window: #Find and #Replace.")
1066 LIST_ITEM (U"• Picture window (and therefore Demo window!): @@Insert picture from file...@ (MacOS 10.4 and up).")
1067 LIST_ITEM (U"• @@Demo window@: full screen (on the Mac).")
1068 LIST_ITEM (U"• Scripting: faster object selection (scripts no longer slow down when there are many objects in the list).")
1069 LIST_ITEM (U"• Scripting: $$variableExists$.")
1070 LIST_ITEM (U"• Macintosh: PDF clipboard (MacOS 10.4 and up).")
1071 NORMAL (U"##5.1.12# (4 August 2009)")
1072 LIST_ITEM (U"• Macintosh: the Picture window can save to PDF file (you need MacOS 10.4 or up).")
1073 LIST_ITEM (U"• Macintosh: corrected a bug that caused Praat to crash at start-up on MacOS 10.3.")
1074 NORMAL (U"##5.1.11# (19 July 2009)")
1075 NORMAL (U"##5.1.10# (8 July 2009)")
1076 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash if the Demo window was closed after an \"execute\".")
1077 LIST_ITEM (U"• OTGrammar & PairDistribution: added ##Get minimum number correct...#.")
1078 NORMAL (U"##5.1.09# (28 June 2009)")
1079 LIST_ITEM (U"• Made East-European Roman characters available in EPS files.")
1080 NORMAL (U"##5.1.08# (21 June 2009)")
1081 LIST_ITEM (U"• Removed a bug introduced in 5.1.07 that could cause strange pictures in manual.")
1082 LIST_ITEM (U"• Macintosh: execute @sendpraat messages immediately instead of waiting for the user to click the jumping Praat icon.")
1083 NORMAL (U"##5.1.07# (12 May 2009)")
1084 LIST_ITEM (U"• Demo window: navigation by arrow keys also on Windows.")
1085 LIST_ITEM (U"• Demo window: no longer crashes on Linux.")
1086 NORMAL (U"##5.1.06# (11 May 2009)")
1087 LIST_ITEM (U"• Demo window.")
1088 NORMAL (U"##5.1.05# (7 May 2009)")
1089 LIST_ITEM (U"• KlattGrid update.")
1090 NORMAL (U"##5.1.04# (4 April 2009)")
1091 LIST_ITEM (U"• Corrected a bug that could cause a missing text character in EPS files produced by a version of Praat running in batch.")
1092 LIST_ITEM (U"• Corrected a bug that could cause high values in a Matrix computed from a Pitch.")
1093 NORMAL (U"##5.1.03# (21 March 2009)")
1094 //LIST_ITEM (U"• OT learning: the \"Random up, highest down\" update rule.")
1095 LIST_ITEM (U"• ExperimentMFC: corrected a bug introduced in 5.0.36 that caused Praat to crash if a sound file did not exist.")
1096 LIST_ITEM (U"• Articulatory synthesis: corrected a bug that could cause Praat to crash when copying Artwords.")
1097 LIST_ITEM (U"• Macintosh: corrected a bug that could cause poor text alignment in picture.")
1098 NORMAL (U"##5.1.02# (9 March 2009)")
1099 LIST_ITEM (U"• Allow pause forms without fields.")
1100 LIST_ITEM (U"• The value \"undefined\" is disallowed from all fields in command windows "
1101 	"except ##Table: Set numeric value...# and ##TableOfReal: Set value...#.")
1102 LIST_ITEM (U"• TextGrid: ##List...# and ##Down to Table...#.")
1103 LIST_ITEM (U"• OT learning: Giorgio Magri's \"Weighted all up, highest down\" update rule.")
1104 NORMAL (U"##5.1.01# (26 February 2009)")
1105 LIST_ITEM (U"• Corrected several bugs in Klatt synthesis.")
1106 MAN_END
1107 
1108 MAN_BEGIN (U"What was new in 5.1?", U"ppgb", 20090131)
1109 NORMAL (U"##5.1# (31 January 2009)")
1110 LIST_ITEM (U"• Editors for Klatt synthesis.")
1111 LIST_ITEM (U"• Corrected many bugs.")
1112 NORMAL (U"##5.0.47# (21 January 2009)")
1113 LIST_ITEM (U"• Extensive pause windows: @@Scripting 6.6. Controlling the user@.")
1114 NORMAL (U"##5.0.46# (7 January 2009)")
1115 LIST_ITEM (U"• More Klatt synthesizer.")
1116 LIST_ITEM (U"• First pause form support.")
1117 LIST_ITEM (U"• Renewed CategoriesEditor.")
1118 LIST_ITEM (U"• Repaired several memory leaks.")
1119 NORMAL (U"##5.0.45# (29 December 2008)")
1120 LIST_ITEM (U"• Bug fixes in Klatt synthesizer.")
1121 NORMAL (U"##5.0.44# (24 December 2008)")
1122 LIST_ITEM (U"• David's Klatt synthesizer: @KlattGrid.")
1123 NORMAL (U"##5.0.43# (9 December 2008)")
1124 LIST_ITEM (U"• Scripting tutorial: local variables in procedures.")
1125 NORMAL (U"##5.0.42# (26 November 2008)")
1126 LIST_ITEM (U"• Removed a bug that could cause Praat to crash when drawing pictures in the manual window.")
1127 LIST_ITEM (U"• Removed a bug that could cause Praat to crash when drawing multi-line text.")
1128 NORMAL (U"##5.0.41# (23 November 2008)")
1129 LIST_ITEM (U"• ExperimentMFC: allow multiple lines in all texts.")
1130 LIST_ITEM (U"• Regular expressions: removed a bug that could cause Praat to hang when using \".*\".")
1131 LIST_ITEM (U"• Table: Draw ellipses: removed a bug that could cause Praat to crash if some cells were undefined.")
1132 NORMAL (U"##5.0.40# (10 November 2008)")
1133 LIST_ITEM (U"• Improved reading and writing of text files (faster, bigger).")
1134 NORMAL (U"##5.0.39# (1 November 2008)")
1135 LIST_ITEM (U"• praatcon -a (for sending ANSI encoding when redirected)")
1136 NORMAL (U"##5.0.38# (28 October 2008)")
1137 LIST_ITEM (U"• @FormantGrid: To Formant...")
1138 NORMAL (U"##5.0.36# (20 October 2008)")
1139 LIST_ITEM (U"• @ExperimentMFC: accepts nonstandard sound files.")
1140 NORMAL (U"##5.0.35# (5 October 2008)")
1141 LIST_ITEM (U"• ##Scale times by...# and ##Scale times to...# (Modify menu).")
1142 NORMAL (U"##5.0.34# (22 September 2008)")
1143 LIST_ITEM (U"• ##Shift times by...# and ##Shift times to...# (Modify menu).")
1144 LIST_ITEM (U"• Sound: @@Combine to stereo@ works even if the two mono sounds have different durations or time domains.")
1145 NORMAL (U"##5.0.33# (9 September 2008)")
1146 LIST_ITEM (U"• Windows: prevented warning messages about \"Widget type\".")
1147 NORMAL (U"##5.0.32# (12 August 2008)")
1148 LIST_ITEM (U"• Contributed by Ola Söder: kNN classifiers and k-means clustering.")
1149 LIST_ITEM (U"• Made UTF-16-encoded chronological TextGrid files readable.")
1150 NORMAL (U"##5.0.31# (6 August 2008)")
1151 LIST_ITEM (U"• Macintosh: corrected a bug introduced in 5.0.30 that caused Praat to crash when you pressed the Tab key "
1152 	"in a window without text fields.")
1153 NORMAL (U"##5.0.30# (22 July 2008)")
1154 LIST_ITEM (U"• Macintosh and Windows: tab navigation.")
1155 NORMAL (U"##5.0.29# (8 July 2008)")
1156 LIST_ITEM (U"• OTMulti: can record history.")
1157 LIST_ITEM (U"• Picture window: corrected text in Praat picture files.")
1158 NORMAL (U"##5.0.28# (3 July 2008)")
1159 LIST_ITEM (U"• Windows: audio output uses DirectX (next to Multi-Media Extensions).")
1160 NORMAL (U"##5.0.27# (28 June 2008)")
1161 LIST_ITEM (U"• @@Phonetic symbols@: breve (a\\N^).")
1162 LIST_ITEM (U"• Annotation: improved some SpellingChecker commands.")
1163 LIST_ITEM (U"• Table: can now set string values that contain spaces.")
1164 NORMAL (U"##5.0.26# (15 June 2008)")
1165 LIST_ITEM (U"• Windows: sound recording no longer makes your laptop's fan spin.")
1166 LIST_ITEM (U"• Windows: no longer any 64 MB limit on recorded sounds.")
1167 LIST_ITEM (U"• Linux: audio input and output uses Alsa (next to OSS).")
1168 NORMAL (U"##5.0.25# (31 May 2008)")
1169 LIST_ITEM (U"• OT learning: added decision strategy ExponentialMaximumEntropy.")
1170 NORMAL (U"##5.0.24# (14 May 2008)")
1171 LIST_ITEM (U"• Linux: corrected a bug at start-up.")
1172 NORMAL (U"##5.0.23# (9 May 2008)")
1173 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when you edited an Artword that you had read from a file.")
1174 NORMAL (U"##5.0.22# (26 April 2008)")
1175 LIST_ITEM (U"• Editing formant contours: @FormantGrid.")
1176 NORMAL (U"##5.0.21# (22 April 2008)")
1177 LIST_ITEM (U"• Annotating with Cyrillic, Arabic, Chinese, Korean characters, and many more (on Macintosh and Windows).")
1178 NORMAL (U"##5.0.20# (8 April 2008)")
1179 LIST_ITEM (U"• @ExperimentMFC: prevented the OK key from working if no response (and goodness choice) had been made.")
1180 LIST_ITEM (U"• OT learning: sped up learning from partial outputs by a factor of five or more.")
1181 NORMAL (U"##5.0.19# (4 April 2008)")
1182 LIST_ITEM (U"• TextGrid window: corrected a bug introduced in 5.0.17 that could cause Praat to crash when handling point tiers.")
1183 NORMAL (U"##5.0.18# (31 March 2008)")
1184 LIST_ITEM (U"• Manipulation window: corrected a bug introduced in 5.0.17 that caused Praat to crash when adding the first duration point.")
1185 LIST_ITEM (U"• Sound: added ##Extract all channels#.")
1186 LIST_ITEM (U"• OT learning: added @@OTGrammar & PairDistribution: Find positive weights...@.")
1187 LIST_ITEM (U"• ExperimentMFC: corrected a bug that caused Praat to crash when the second of multiple experiments "
1188 	"referred to non-existing sound files.")
1189 NORMAL (U"##5.0.17# (29 March 2008)")
1190 LIST_ITEM (U"• Sped up vowel editor by a large factor.")
1191 LIST_ITEM (U"• OT learning: corrected Exponential HG update rule from OT-GLA to HG-GLA.")
1192 LIST_ITEM (U"• OT learning: shift Exponential HG average constraint weight to zero after every learning step.")
1193 NORMAL (U"##5.0.16# (25 March 2008)")
1194 LIST_ITEM (U"• Macintosh: returned to old compiler because of incompatibility with MacOS X 10.4.")
1195 NORMAL (U"##5.0.15# (21 March 2008)")
1196 LIST_ITEM (U"• Windows: more reliable dropping of files on the Praat icon when Praat is already running.")
1197 NORMAL (U"##5.0.14# (20 March 2008)")
1198 LIST_ITEM (U"• David's vowel editor (New \\-> Sound).")
1199 LIST_ITEM (U"• Formulas: corrected scaling of sinc function.")
1200 NORMAL (U"##5.0.13# (18 March 2008)")
1201 LIST_ITEM (U"• Corrected drawing of histograms.")
1202 LIST_ITEM (U"• TextGrid window: selected part of the TextGrid can be extracted and saved.")
1203 LIST_ITEM (U"• TextGrid: more complete conversion between backslash trigraphs and Unicode.")
1204 LIST_ITEM (U"• Windows: more reliable dropping of files on the Praat icon when Praat is not running yet.")
1205 LIST_ITEM (U"• Formulas: sinc function.")
1206 NORMAL (U"##5.0.12# (12 March 2008)")
1207 LIST_ITEM (U"• Bigger ligature symbol (k\\lip).")
1208 NORMAL (U"##5.0.11# (7 March 2008)")
1209 LIST_ITEM (U"• Corrected saving of new binary Manipulation files (you can send any unreadable Manipulation files to Paul Boersma for correction).")
1210 NORMAL (U"##5.0.10# (27 February 2008)")
1211 LIST_ITEM (U"• Added the characters \\d- and \\D-.")
1212 LIST_ITEM (U"• Windows: made ##praatcon.exe# compatible with Unicode command lines.")
1213 NORMAL (U"##5.0.09# (16 February 2008)")
1214 LIST_ITEM (U"• Windows: corrected a bug by which Praat would not open files that were dragged on the Praat icon "
1215 	"if the names of these files or their directory paths contained non-ASCII characters.")
1216 LIST_ITEM (U"• Linux: ignore the Mod2 key, because of its unpredictable assignment.")
1217 NORMAL (U"##5.0.08# (10 February 2008)")
1218 LIST_ITEM (U"• Corrected the minus sign (\\bs-m = \"\\-m\").")
1219 NORMAL (U"##5.0.07# (8 February 2008)")
1220 LIST_ITEM (U"• Object IDs are visible in editor windows.")
1221 NORMAL (U"##5.0.06# (31 January 2008)")
1222 LIST_ITEM (U"• Corrected a bug that caused ##Find again# in the TextGrid window not to work.")
1223 LIST_ITEM (U"• Macintosh: made Praat work correctly on 10.3 computers with missing fonts.")
1224 NORMAL (U"##5.0.05# (19 January 2008)")
1225 LIST_ITEM (U"• All Matrix, Sound, Spectrogram, Pitch, Ltas, and Spectrum objects (and more) are now in 52-bit relative precision (instead of the earlier 23 bits).")
1226 LIST_ITEM (U"• Corrected a bug that could lead to \"Unknown opcode (0)\" messages when drawing large sounds (more than 16 million samples) in the Picture window.")
1227 LIST_ITEM (U"• Macintosh: solved around a bug in the C library that could cause incorrect representation of non-ASCII characters (in the OTGrammar window).")
1228 NORMAL (U"##5.0.04# (12 January 2008)")
1229 LIST_ITEM (U"• Windows: corrected a bug introduced in 5.0.03 that caused Praat to crash if you pressed a key in the Sound window.")
1230 LIST_ITEM (U"• Macintosh: some cosmetic corrections.")
1231 NORMAL (U"##5.0.03# (9 January 2008)")
1232 LIST_ITEM (U"• Scripting: guard against opening the same file more than once.")
1233 LIST_ITEM (U"• Table: possibility of regarding a column as a distribution (#Generate menu).")
1234 LIST_ITEM (U"• Macintosh: corrected line colours.")
1235 NORMAL (U"##5.0.02# (27 December 2007)")
1236 LIST_ITEM (U"• TextGrid window: corrected the drawing of numbers to the right of the tiers.")
1237 LIST_ITEM (U"• Corrected a bug that caused Praat to crash when doing ##SpectrumTier: List#.")
1238 NORMAL (U"##5.0.01# (18 December 2007)")
1239 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when redrawing the sound or TextGrid window.")
1240 MAN_END
1241 
1242 MAN_BEGIN (U"What was new in 5.0?", U"ppgb", 20071210)
1243 NORMAL (U"##5.0# (10 December 2007)")
1244 LIST_ITEM (U"• Corrected many bugs.")
1245 LIST_ITEM (U"• Display font sizes in points rather than pixels.")
1246 NORMAL (U"##4.6.41# (9 December 2007)")
1247 LIST_ITEM (U"• Windows: corrected a bug that could cause listening experiments not to run when the directory path included non-ASCII characters; "
1248 	"the same bug could (under comparable circumstances) cause scripted menu commands not to work.")
1249 LIST_ITEM (U"• Corrected a bug that could cause null bytes in data files when the text output encoding preference was ##try ISO Latin-1, then UTF-16#.")
1250 NORMAL (U"##4.6.40# (3 December 2007)")
1251 LIST_ITEM (U"• Corrected some minor bugs.")
1252 NORMAL (U"##4.6.39# (1 December 2007)")
1253 LIST_ITEM (U"• Manual: corrected a bug that could cause Praat to crash when viewing certain manual pages with pictures.")
1254 LIST_ITEM (U"• Scripting: corrected a bug that could cause Praat to crash when a long string was used as an argument to a procedure.")
1255 NORMAL (U"##4.6.38# (19 November 2007)")
1256 LIST_ITEM (U"• More extensive @@logistic regression@.")
1257 NORMAL (U"##4.6.37# (15 November 2007)")
1258 LIST_ITEM (U"• Object list shows numbers.")
1259 LIST_ITEM (U"• Macintosh: corrected saving of non-ASCII text settings.")
1260 NORMAL (U"##4.6.36# (2 November 2007)")
1261 LIST_ITEM (U"• Sound and TextGrid windows: direct drawing of intensity, formants, pulses, and TextGrid.")
1262 LIST_ITEM (U"• Regular expressions: corrected handling of newlines on Windows.")
1263 LIST_ITEM (U"• Scripting: improved positioning of settings windows for script commands in editors on Windows.")
1264 NORMAL (U"##4.6.35# (22 October 2007)")
1265 LIST_ITEM (U"• Windows and Linux: better positioning of form windows of editor scripts.")
1266 LIST_ITEM (U"• Macintosh: OTMulti learning window more compatible with non-ASCII characters.")
1267 NORMAL (U"##4.6.34# (18 October 2007)")
1268 LIST_ITEM (U"• Corrected a bug introduced in September that could cause Praat to crash when starting up "
1269 	"if the user had explicitly made action commands visible or invisible in an earlier session.")
1270 NORMAL (U"##4.6.33# (16 October 2007)")
1271 LIST_ITEM (U"• Corrected a bug introduced in September that caused Praat to crash when a PointProcess window was opened without a Sound.")
1272 LIST_ITEM (U"• Macintosh: objects with non-ASCII names show up correctly in the list.")
1273 NORMAL (U"##4.6.32# (14 October 2007)")
1274 LIST_ITEM (U"• Unicode support for names of objects.")
1275 LIST_ITEM (U"• Linux: first Unicode support (in window titles).")
1276 LIST_ITEM (U"• Windows scripting: corrected a bug that caused weird characters in Paste History.")
1277 NORMAL (U"##4.6.31# (8 October 2007)")
1278 LIST_ITEM (U"• TextGrid window: made Save command available again for TextGrid windows without a sound.")
1279 LIST_ITEM (U"• Corrected a bug that caused binary Collection files with objects with names with non-ASCII characters to be unreadable.")
1280 NORMAL (U"##4.6.30# (3 October 2007)")
1281 LIST_ITEM (U"• OTMulti: added an evaluate command in the Objects window, so that paced learning becomes scriptable.")
1282 LIST_ITEM (U"• Macintosh: worked around a feature of a system library that could cause Praat to crash when reading a Collection text file "
1283 	"that contained objects with non-ASCII names.")
1284 NORMAL (U"##4.6.29# (1 October 2007)")
1285 LIST_ITEM (U"• OT learning: leak and constraint in OTMulti.")
1286 LIST_ITEM (U"• Support for saving Table, TableOfReal, Strings, OTGrammar and OTMulti in Unicode.")
1287 NORMAL (U"##4.6.28# (1 October 2007)")
1288 LIST_ITEM (U"• OT learning: positive constraint satisfactions in OTMulti tableaus.")
1289 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when reading a non-UTF-8 text file "
1290 	"when the \"Text reading preference\" had been set to UTF-8.")
1291 NORMAL (U"##4.6.27# (29 September 2007)")
1292 LIST_ITEM (U"• Corrected redrawing of text with non-ASCII characters.")
1293 NORMAL (U"##4.6.26# (29 September 2007)")
1294 LIST_ITEM (U"• Corrected reading of high UTF-8 codes.")
1295 NORMAL (U"##4.6.25# (26 September 2007)")
1296 LIST_ITEM (U"• @ExperimentMFC: can set font size for response buttons.")
1297 NORMAL (U"##4.6.24# (24 September 2007)")
1298 LIST_ITEM (U"• Czech, Polish, Croatian, and Hungarian characters such as \\c< \\uo \\t< \\e; \\s' \\l/ \\c\' \\o: (see @@Special symbols@).")
1299 LIST_ITEM (U"• Some support for Hebrew characters such as \\?+ \\B+ \\sU (see @@Special symbols@).")
1300 NORMAL (U"##4.6.23# (22 September 2007)")
1301 LIST_ITEM (U"• Corrected a bug introduced in 4.6.13 that caused crashes in text handling (mainly on Linux).")
1302 LIST_ITEM (U"• Info commands in editors.")
1303 NORMAL (U"##4.6.22# (17 September 2007)")
1304 LIST_ITEM (U"• Phonetic symbols: added the nonsyllabicity diacritic (a\\nv).")
1305 LIST_ITEM (U"• Macintosh: worked around a feature of a system library that could cause strange behaviour of forms in scripts with non-ASCII characters.")
1306 NORMAL (U"##4.6.21# (5 September 2007)")
1307 LIST_ITEM (U"• Sound and TextGrid windows: direct drawing of selected sound to the picture window.")
1308 NORMAL (U"##4.6.20# (2 September 2007)")
1309 LIST_ITEM (U"• Introduced direct drawing of spectrogram and pitch to the Praat picture window from Sound windows and TextGrid windows.")
1310 LIST_ITEM (U"• Corrected a bug introduced in 4.6.13 by which Inspect did not show all data in a TextGrid.")
1311 NORMAL (U"##4.6.19# (31 August 2007)")
1312 LIST_ITEM (U"• Macintosh: worked around a bug in a system library that caused Praat to crash (since version 4.6.13) "
1313 	"when removing a boundary from a TextGrid interval in MacOS X 10.3 or earlier.")
1314 NORMAL (U"##4.6.18# (28 August 2007)")
1315 LIST_ITEM (U"• Sound: Filter (formula): now works in the same way as the other filter commands "
1316 	"(without adding an empty space at the end), and on stereo sounds.")
1317 NORMAL (U"##4.6.17# (25 August 2007)")
1318 LIST_ITEM (U"• Windows: improved rotated text, also for copy-paste and printing.")
1319 LIST_ITEM (U"• Windows: phonetic characters on the screen now require the Charis SIL or Doulos SIL font.")
1320 LIST_ITEM (U"• Picture settings report (mainly for script writers).")
1321 LIST_ITEM (U"• Corrected a bug that could cause Praat to crash when closing a manual page that had been read from a file.")
1322 NORMAL (U"##4.6.16# (22 August 2007)")
1323 LIST_ITEM (U"• Macintosh: corrected a bug introduced in 4.6.13 that could cause Praat to crash when drawing a spectrogram in MacOS X 10.3 or earlier.")
1324 NORMAL (U"##4.6.15# (21 August 2007)")
1325 LIST_ITEM (U"• Corrected a bug introduced in 4.6.14 that prevented the use of Helvetica in the Picture window.")
1326 LIST_ITEM (U"• Corrected a bug in \"Read Table from table file...\", introduced in 4.6.13.")
1327 NORMAL (U"##4.6.14# (20 August 2007)")
1328 LIST_ITEM (U"• Corrected a bug introduced in 4.6.13 that prevented any other font than Palatino in the Picture window.")
1329 LIST_ITEM (U"• Macintosh: corrected height of subscripts and superscripts (broken in 4.6.13).")
1330 NORMAL (U"##4.6.13# (16 August 2007)")
1331 LIST_ITEM (U"• TextGrid: corrected reading of chronological files.")
1332 LIST_ITEM (U"• Macintosh: text looks better (and rotated text is now readable on Intel Macs).")
1333 LIST_ITEM (U"• Macintosh: phonetic characters on the screen now require the Charis SIL or Doulos SIL font.")
1334 NORMAL (U"##4.6.12# (27 July 2007)")
1335 LIST_ITEM (U"• OTGrammar bug fix: leak and constraint plasticity correctly written into OTGrammar text files.")
1336 NORMAL (U"##4.6.11# (25 July 2007)")
1337 LIST_ITEM (U"• OTGrammar: introduced %%constraint plasticity% for slowing down or halting the speed with which constraints are reranked.")
1338 LIST_ITEM (U"• OTGrammar: introduced %%leak% for implementing forgetful learning of correlations.")
1339 LIST_ITEM (U"• OTGrammar: positive constraint satisfactions are drawn as `+' in tableaus.")
1340 NORMAL (U"##4.6.10# (22 July 2007)")
1341 LIST_ITEM (U"• Improved reading of UTF-16 data files.")
1342 LIST_ITEM (U"• Improved error messages when reading text files (line numbers are mentioned).")
1343 LIST_ITEM (U"• Table: Get group mean (Student t)...")
1344 NORMAL (U"##4.6.09# (24 June 2007)")
1345 LIST_ITEM (U"• Corrected a bug introduced in 4.6.07 that caused a crash when reading Collections.")
1346 LIST_ITEM (U"• Corrected a bug introduced in 4.6.07 that caused incorrect Open buttons in Inspect.")
1347 LIST_ITEM (U"• How come 4.6.07 introduced those bugs? Because of large changes in the Praat source code as a result of the transition to Unicode.")
1348 NORMAL (U"##4.6.08# (22 June 2007)")
1349 LIST_ITEM (U"• Windows: worked around a `feature' of the C library that caused 3-byte line-breaks in the buttons file.")
1350 LIST_ITEM (U"• Windows: returned to smaller font in script window.")
1351 LIST_ITEM (U"• OT learning: corrected a bug in PositiveHG.")
1352 NORMAL (U"##4.6.07# (20 June 2007)")
1353 LIST_ITEM (U"• Sound files: MP3 as LongSound (implemented by Erez Volk).")
1354 LIST_ITEM (U"• Scripting: Unicode support for strings and script window (Mac and Windows only).")
1355 NORMAL (U"##4.6.06# (4 June 2007)")
1356 LIST_ITEM (U"• Script window: corrected a bug introduced in 4.6.05 that could cause incorrect symbols in saved files.")
1357 NORMAL (U"##4.6.05# (2 June 2007)")
1358 LIST_ITEM (U"• Sound files: reading MP3 audio files (implemented by Erez Volk).")
1359 NORMAL (U"##4.6.04# (29 May 2007)")
1360 LIST_ITEM (U"• OT learning: added decision strategy PositiveHG.")
1361 NORMAL (U"##4.6.03# (24 May 2007)")
1362 LIST_ITEM (U"• Spectral slices have better names.")
1363 NORMAL (U"##4.6.02# (17 May 2007)")
1364 LIST_ITEM (U"• Sound files: saving FLAC audio files (implemented by Erez Volk).")
1365 NORMAL (U"##4.6.01# (16 May 2007)")
1366 LIST_ITEM (U"• Removed a bug that caused downsampling (and therefore formant measurements) "
1367 	"to be incorrect for stereo sounds.")
1368 MAN_END
1369 
1370 MAN_BEGIN (U"What was new in 4.6?", U"ppgb", 20070512)
1371 NORMAL (U"##4.6# (12 May 2007)")
1372 NORMAL (U"##4.5.26# (8 May 2007)")
1373 LIST_ITEM (U"• Sound files: reading FLAC audio files (implemented by Erez Volk).")
1374 NORMAL (U"##4.5.25# (7 May 2007)")
1375 LIST_ITEM (U"• Table: Rows to columns...")
1376 LIST_ITEM (U"• Table: Collapse rows... (renamed from Pool).")
1377 LIST_ITEM (U"• Table: Formula (column range)...")
1378 LIST_ITEM (U"• OT learning: OTGrammar window shows harmonies.")
1379 NORMAL (U"##4.5.24# (27 April 2007)")
1380 LIST_ITEM (U"• OT learning: added decision strategy MaximumEntropy; "
1381 	"this has the same harmony determination method as Harmonic Grammar (include the additive constraint noise), "
1382 	"but there is some more variability, in that every candidate gets a relative probability of exp(harmony).")
1383 NORMAL (U"##4.5.23# (26 April 2007)")
1384 LIST_ITEM (U"• Macintosh: much smaller sizes (in kilobytes) of spectrograms for printing and clipboard; "
1385 	"this improves the compatibility with other programs such as Microsoft Word for large spectrograms.")
1386 NORMAL (U"##4.5.22# (25 April 2007)")
1387 LIST_ITEM (U"• Macintosh: improved drawing of spectrograms for printing and clipboard "
1388 	"(this was crippled in 4.5.18, but now it is better than before 4.5.18).")
1389 NORMAL (U"##4.5.21# (24 April 2007)")
1390 LIST_ITEM (U"• OT learning: corrected HarmonicGrammar (and LinearOT) learning procedure "
1391 	"to the stochastic gradient ascent method applied by @@Jäger (2003)@ to MaxEnt grammars.")
1392 LIST_ITEM (U"• Scripting: removed a bug that could make selection checking (in command windows) unreliable after a script was run.")
1393 NORMAL (U"##4.5.20# (19 April 2007)")
1394 LIST_ITEM (U"• Scripting: allow assignments like $$pitch = To Pitch... 0 75 600$.")
1395 LIST_ITEM (U"• PitchTier Formula: guard against undefined values.")
1396 NORMAL (U"##4.5.19# (2 April 2007)")
1397 LIST_ITEM (U"• Scripting: allow comments with \"\\# \" and \";\" in forms.")
1398 LIST_ITEM (U"• Windows audio playing: attempt at more compatibility with Vista.")
1399 NORMAL (U"##4.5.18# (30 March 2007)")
1400 LIST_ITEM (U"• Macintosh: better image drawing (more grey values).")
1401 LIST_ITEM (U"• More tabulation commands.")
1402 LIST_ITEM (U"• More SpectrumTier commands.")
1403 LIST_ITEM (U"• Picture window: keyboard shortcut for ##Erase all#.")
1404 NORMAL (U"##4.5.17# (19 March 2007)")
1405 LIST_ITEM (U"• Picture window: can change arrow size.")
1406 LIST_ITEM (U"• Several #List commands.")
1407 LIST_ITEM (U"• Spectrum: To SpectrumTier (peaks).")
1408 NORMAL (U"##4.5.16# (22 February 2007)")
1409 LIST_ITEM (U"• Sound-to-Intensity: made resistant against undefined settings.")
1410 LIST_ITEM (U"• Windows: made Ctrl-. available as a shortcut.")
1411 LIST_ITEM (U"• Linux: made it more likely to find the correct fonts.")
1412 NORMAL (U"##4.5.15# (12 February 2007)")
1413 LIST_ITEM (U"• Windows XP: worked around a bug in Windows XP that could cause Praat to crash "
1414 	"when the user moved the mouse pointer over a file in the Desktop in the file selector. "
1415 	"The workaround is to temporarily disable file info tips when the file selector window is on the screen.")
1416 NORMAL (U"##4.5.14# (5 February 2007)")
1417 LIST_ITEM (U"• Scripting: some new predefined string variables like preferencesDirectory\\$ .")
1418 NORMAL (U"##4.5.13# (3 February 2007)")
1419 LIST_ITEM (U"• For stereo sounds, pitch analysis is based on correlations pooled over channels "
1420 	"(rather than on correlations of the channel average).")
1421 LIST_ITEM (U"• For stereo sounds, spectrogram analysis is based on power density averaged across channels "
1422 	"(rather than on the power density of the channel average).")
1423 LIST_ITEM (U"• Scripting: removed a bug introduced in 4.5.06 that caused some variables not to be substituted.")
1424 NORMAL (U"##4.5.12# (30 January 2007)")
1425 LIST_ITEM (U"• Made cross-correlation pitch analysis as fast as it used to be before 4.5.11.")
1426 NORMAL (U"##4.5.11# (29 January 2007)")
1427 LIST_ITEM (U"• Sound objects can be stereo, for better playback quality "
1428 	"(most analyses will work on the averaged mono signal).")
1429 LIST_ITEM (U"• Macintosh: recording a sound now uses CoreAudio instead of SoundManager, "
1430 	"for more compatibility with modern recording devices, "
1431 	"and the possibility to record with a sampling frequency of 96 kHz.")
1432 LIST_ITEM (U"• @ManPages allow picture scripts with separate object lists.")
1433 LIST_ITEM (U"• Linux: better scroll bars in object list for Lesstif (Debian).")
1434 LIST_ITEM (U"• Linux: made @@Create Strings as file list...@ work on Reiser.")
1435 LIST_ITEM (U"• @sendpraat scripts correctly wait until sounds have played.")
1436 NORMAL (U"##4.5.08# (20 December 2006)")
1437 LIST_ITEM (U"• ExperimentMFC: can use stereo sounds.")
1438 NORMAL (U"##4.5.07# (16 December 2006)")
1439 LIST_ITEM (U"• Macintosh: playing a sound now uses CoreAudio instead of SoundManager.")
1440 LIST_ITEM (U"• Phonetic symbols: \\\'1primary stress and \\\'1secon\\\'2dary stress.")
1441 NORMAL (U"##4.5.06# (13 December 2006)")
1442 LIST_ITEM (U"• Support for 32-bit floating-point WAV files.")
1443 LIST_ITEM (U"• Scripting: removed several kinds of restrictions on string length.")
1444 LIST_ITEM (U"• SSCP: Draw confidence ellipse: corrected a bug that would sometimes not draw the ellipse when %N was very large.")
1445 NORMAL (U"##4.5.05# (5 December 2006)")
1446 LIST_ITEM (U"• Macintosh scripting: European symbols such as ö and é and ç are now allowed in file names in scripts "
1447 	"and in MacRoman-encoded file names sent by other programs through the sendpraat subroutine.")
1448 NORMAL (U"##4.5.04# (1 December 2006)")
1449 LIST_ITEM (U"• @@Sound: Change gender...@: corrected a bug that often caused a female-to-male conversion to sound monotonous.")
1450 NORMAL (U"##4.5.03# (29 November 2006)")
1451 LIST_ITEM (U"• Table: added independent-samples t-test.")
1452 LIST_ITEM (U"• Linux: corrected a bug introduced in 4.5.02 that prevented sounds from playing and other weird things.")
1453 NORMAL (U"##4.5.02# (16 November 2006)")
1454 LIST_ITEM (U"• Corrected yet another bug in the new @@Sound: To TextGrid (silences)...@.")
1455 NORMAL (U"##4.5.01# (28 October 2006)")
1456 LIST_ITEM (U"• Sound window: the pitch drawing method is #Curves, #Speckles, or #Automatic.")
1457 LIST_ITEM (U"• Corrected another bug in the new @@Sound: To TextGrid (silences)...@.")
1458 MAN_END
1459 
1460 MAN_BEGIN (U"What was new in 4.5?", U"ppgb", 20061026)
1461 NORMAL (U"##4.5# (26 October 2006)")
1462 NORMAL (U"##4.4.35# (20 October 2006)")
1463 LIST_ITEM (U"• In @ManPages you can now draw pictures.")
1464 NORMAL (U"##4.4.34# (19 October 2006)")
1465 LIST_ITEM (U"• Corrected a bug in the new @@Sound: To TextGrid (silences)...@.")
1466 NORMAL (U"##4.4.33# (4 October 2006)")
1467 LIST_ITEM (U"• Windows: corrected a bug introduced in 4.4.31 that caused Praat to skip the first line of the Buttons file.")
1468 NORMAL (U"##4.4.32# (30 September 2006)")
1469 LIST_ITEM (U"• Scripting: more techniques for @@Scripting 4. Object selection|object selection@.")
1470 LIST_ITEM (U"• Scripting: more support for putting the results of the #Info command into a string variable.")
1471 NORMAL (U"##4.4.31# (23 September 2006)")
1472 LIST_ITEM (U"• Support for @@plug-ins@.")
1473 LIST_ITEM (U"• Split between @@Create Strings as file list...@ and @@Create Strings as folder list...@.")
1474 NORMAL (U"##4.4.30# (28 August 2006)")
1475 LIST_ITEM (U"• Table: Draw ellipse (standard deviation)...")
1476 NORMAL (U"##4.4.29# (21 August 2006)")
1477 LIST_ITEM (U"• Allowed \"European\" symbols in file names and object names.")
1478 NORMAL (U"##4.4.28# (10 August 2006)")
1479 LIST_ITEM (U"• Windows XP: Praat files can finally again be opened by double-clicking and by dragging them onto the Praat icon.")
1480 LIST_ITEM (U"• Scripting (Windows): removed a bug that caused Praat to crash if the script window was closed when a file selector window was open.")
1481 NORMAL (U"##4.4.27# (4 August 2006)")
1482 LIST_ITEM (U"• Table window: corrected vertical scroll bar (on Windows).")
1483 LIST_ITEM (U"• Formulas: invSigmoid.")
1484 LIST_ITEM (U"• Logging: added 'power' (and documented the 'freq' command).")
1485 LIST_ITEM (U"• Removed a bug that caused ##Read two Sounds from stereo file...# not to work in scripts.")
1486 NORMAL (U"##4.4.26# (24 July 2006)")
1487 LIST_ITEM (U"• ##Sound & FormantTier: Filter#: much more accurate.")
1488 NORMAL (U"##4.4.25# (16 July 2006)")
1489 LIST_ITEM (U"• TextGrid reading: don't set first boundary to zero for .wrd label files.")
1490 NORMAL (U"##4.4.24# (19 June 2006)")
1491 LIST_ITEM (U"• Scripting: regular expressions allow replacement with empty string.")
1492 NORMAL (U"##4.4.23# (1 June 2006)")
1493 LIST_ITEM (U"• Table: ignore more white space.")
1494 NORMAL (U"##4.4.22# (30 May 2006)")
1495 LIST_ITEM (U"• Scripting: replacing with regular expression. See @@Formulas 6. String functions@.")
1496 NORMAL (U"##4.4.21# (29 May 2006)")
1497 LIST_ITEM (U"• Made Manipulation objects readable again.")
1498 NORMAL (U"##4.4.20# (3 May 2006)")
1499 LIST_ITEM (U"• Removed limit on number of menus (Praat could crash if the number of open windows was high).")
1500 NORMAL (U"##4.4.19# (28 April 2006)")
1501 LIST_ITEM (U"• Table: ##Get mean#, ##Get standard deviation#, ##Get quantile#.")
1502 NORMAL (U"##4.4.18# (24 April 2006)")
1503 LIST_ITEM (U"• Table: ##View & Edit#: view the contents of a table.")
1504 LIST_ITEM (U"• Table: ##Scatter plot#.")
1505 LIST_ITEM (U"• Scripting: more warnings against missing or extra spaces.")
1506 NORMAL (U"##4.4.17# (19 April 2006)")
1507 LIST_ITEM (U"• Table: #Pool: computing averages and medians of dependent variables "
1508 	"for a selected combination of independent variables.")
1509 LIST_ITEM (U"• Table: #Formula accepts string expressions as well as numeric expressions.")
1510 LIST_ITEM (U"• Table: #Sort can sort by any number of columns.")
1511 LIST_ITEM (U"• Table: ##Create with column names#.")
1512 LIST_ITEM (U"• Table: ##Report mean#.")
1513 LIST_ITEM (U"• Formulas: @@Formulas 8. Attributes of objects|row\\$  and col\\$  attributes@.")
1514 LIST_ITEM (U"• Warning when trying to read data files whose format is newer than the Praat version.")
1515 NORMAL (U"##4.4.16# (1 April 2006)")
1516 LIST_ITEM (U"• Spectrum window: dynamic range setting.")
1517 LIST_ITEM (U"• SoundRecorder: corrected a bug in the Intel Mac edition.")
1518 NORMAL (U"##4.4.15# (30 March 2006)")
1519 LIST_ITEM (U"• Source code even more compatible with 64-bit compilers.")
1520 NORMAL (U"##4.4.14# (29 March 2006)")
1521 LIST_ITEM (U"• Source code more compatible with 64-bit compilers.")
1522 NORMAL (U"##4.4.13# (8 March 2006)")
1523 LIST_ITEM (U"• Table To TableOfReal: better handling of --undefined-- values (are now numeric).")
1524 LIST_ITEM (U"• MacOS X: TextGrid files can be double-clicked to open.")
1525 LIST_ITEM (U"• @@Create Strings as file list...@: now handles up to 1,000,000 files per directory.")
1526 NORMAL (U"##4.4.12# (24 February 2006)")
1527 LIST_ITEM (U"• TextGrid: removed a bug introduced in 4.4.10 that caused Praat to crash when converting an IntervalTier into a TextGrid.")
1528 NORMAL (U"##4.4.11# (23 February 2006)")
1529 LIST_ITEM (U"• Listening experiments: removed a bug that could cause Praat to crash when an ExperimentMFC object was removed.")
1530 NORMAL (U"##4.4.10# (20 February 2006)")
1531 LIST_ITEM (U"• Intel computers: corrected reading and writing of 24-bit sound files (error introduced in 4.4.09).")
1532 LIST_ITEM (U"• Create TextGrid: guard against zero tiers.")
1533 LIST_ITEM (U"• MacOS X: correct visibility of Praat icon.")
1534 LIST_ITEM (U"• MacOS X: correct dropping of Praat files on Praat icon.")
1535 NORMAL (U"##4.4.09# (19 February 2006)")
1536 LIST_ITEM (U"• Macintosh: first Intel Macintosh version.")
1537 LIST_ITEM (U"• Windows: Create Strings from folder list...")
1538 NORMAL (U"##4.4.08# (6 February 2006)")
1539 LIST_ITEM (U"• Much improved cepstral smoothing.")
1540 NORMAL (U"##4.4.07# (2 February 2006)")
1541 LIST_ITEM (U"• More scripting facilities (local variables in procedures, e.g. .x and .text\\$ ).")
1542 LIST_ITEM (U"• Faster formulas.")
1543 NORMAL (U"##4.4.06# (30 January 2006)")
1544 LIST_ITEM (U"• More scripting facilities (Object_xxx [ ], Self.nx, Table_xxx\\$  [ ], better messages).")
1545 LIST_ITEM (U"• Better reading and writing of Xwaves label files.")
1546 NORMAL (U"##4.4.05# (26 January 2006)")
1547 LIST_ITEM (U"• @ExperimentMFC: removed a bug that caused Praat to crash when the Oops button was pressed after the experiment finished.")
1548 LIST_ITEM (U"• TextGrid: an IntervalTier can be written to an Xwaves label file.")
1549 NORMAL (U"##4.4.04# (6 January 2006)")
1550 LIST_ITEM (U"• Windows: Quicktime support (see at 4.4.03).")
1551 NORMAL (U"##4.4.03# (6 January 2006)")
1552 LIST_ITEM (U"• Macintosh: Quicktime support, i.e., \"Read from file\" can now read the audio from several kinds of movie files (.mov, .avi).")
1553 NORMAL (U"##4.4.02# (5 January 2006)")
1554 LIST_ITEM (U"• OT learning: allow the decision strategies of Harmonic Grammar and Linear OT.")
1555 NORMAL (U"##4.4.01# (2 January 2006)")
1556 LIST_ITEM (U"• Picture window: \"Logarithmic marks\" allows reversed axes.")
1557 LIST_ITEM (U"• Manipulation window: removed a bug from \"Shift frequencies\" that caused much too small shifts in semitones.")
1558 LIST_ITEM (U"• TextGrid: \"Remove point...\".")
1559 MAN_END
1560 
1561 MAN_BEGIN (U"What was new in 4.4?", U"ppgb", 20051219)
1562 NORMAL (U"##4.4# (19 December 2005)")
1563 NORMAL (U"##4.3.37# (15 December 2005)")
1564 LIST_ITEM (U"• @@Principal component analysis@: now accepts tables with more variables (columns) than cases (rows).")
1565 LIST_ITEM (U"• TIMIT label files: removed a bug that caused Praat to crash for files whose first part was not labelled.")
1566 NORMAL (U"##4.3.36# (11 December 2005)")
1567 LIST_ITEM (U"• Ltas: Average.")
1568 LIST_ITEM (U"• Optimality Theory: compute crucial rankings (select OTGrammar + PairDistribution).")
1569 NORMAL (U"##4.3.35# (8 December 2005)")
1570 LIST_ITEM (U"• @ExperimentMFC: switched off warnings for stereo files.")
1571 NORMAL (U"##4.3.34# (8 December 2005)")
1572 LIST_ITEM (U"• Sound window: the arrow scroll step is settable.")
1573 LIST_ITEM (U"• You can now run multiple listening experiments (@ExperimentMFC) in one \"Run\".")
1574 LIST_ITEM (U"• Formant: Get quantile of bandwidth...")
1575 NORMAL (U"##4.3.33# (6 December 2005)")
1576 LIST_ITEM (U"• Removed three bugs introduced in 4.3.32 in @ExperimentMFC.")
1577 NORMAL (U"##4.3.32# (5 December 2005)")
1578 LIST_ITEM (U"• Many more possibilities in @ExperimentMFC.")
1579 NORMAL (U"##4.3.31# (27 November 2005)")
1580 LIST_ITEM (U"• @@Sound: To Ltas (pitch-corrected)...@")
1581 NORMAL (U"##4.3.30# (18 November 2005)")
1582 LIST_ITEM (U"• TableOfReal: Scatter plot: allows reversed axes.")
1583 NORMAL (U"##4.3.29# (11 November 2005)")
1584 LIST_ITEM (U"• Windows: many more font sizes.")
1585 NORMAL (U"##4.3.28# (7 November 2005)")
1586 LIST_ITEM (U"• Fontless EPS files: corrected character width for Symbol font (depended on SILIPA setting).")
1587 LIST_ITEM (U"• Windows: more reliable detection of home directory.")
1588 NORMAL (U"##4.3.27# (7 October 2005)")
1589 LIST_ITEM (U"• TextGrid & Pitch: draw with text alignment.")
1590 NORMAL (U"##4.3.26# (29 September 2005)")
1591 LIST_ITEM (U"• Macintosh: corrected error introduced in 4.3.25.")
1592 NORMAL (U"##4.3.25# (28 September 2005)")
1593 LIST_ITEM (U"• Macintosh: allowed recording with sampling frequencies of 12 and 64 kHz.")
1594 NORMAL (U"##4.3.24# (26 September 2005)")
1595 LIST_ITEM (U"• Table: Down to TableOfReal...: one column of the Table can be used as the row labels for the TableOfReal, "
1596 	"and the strings in the remaining columns of the Table are replaced with whole numbers assigned in alphabetical order.")
1597 NORMAL (U"##4.3.23# (24 September 2005)")
1598 LIST_ITEM (U"• Read Table from comma-separated file...")
1599 LIST_ITEM (U"• Read Table from tab-separated file...")
1600 LIST_ITEM (U"• Write picture as fontless EPS file: choice between XIPA and SILIPA93.")
1601 LIST_ITEM (U"• Bold IPA symbols in EPS files (fontless SILIPA93 only).")
1602 NORMAL (U"##4.3.22# (8 September 2005)")
1603 LIST_ITEM (U"• Macintosh: variable scroll bar size (finally, 7 years since System 8.5).")
1604 NORMAL (U"##4.3.21# (1 September 2005)")
1605 LIST_ITEM (U"• Macintosh: error message if any of the fonts Times, Helvetica, Courier and Symbol are unavailable at start-up.")
1606 LIST_ITEM (U"• Renamed \"Control\" menu to \"Praat\" on all platforms (as on the Mac), "
1607 	"to reflect the fact that no other programs than Praat have used the Praat shell for five years.")
1608 LIST_ITEM (U"• Script editor: Undo and Redo buttons (only on the Mac for now).")
1609 LIST_ITEM (U"• Manual: corrected a bug that sometimes caused Praat to crash when trying to print.")
1610 NORMAL (U"##4.3.20# (18 August 2005)")
1611 LIST_ITEM (U"• Log files: include name of editor window.")
1612 NORMAL (U"##4.3.19# (20 July 2005)")
1613 LIST_ITEM (U"• Improved buttons in manual.")
1614 LIST_ITEM (U"• TableOfReal: Read from headerless spreadsheet file: allow row and column labels to be 30,000 rather than 100 characters.")
1615 NORMAL (U"##4.3.18# (12 July 2005)")
1616 LIST_ITEM (U"• Glottal source for sound synthesis, corrected and documented.")
1617 NORMAL (U"##4.3.17# (7 July 2005)")
1618 LIST_ITEM (U"• Glottal source for sound synthesis.")
1619 LIST_ITEM (U"• Multi-level Optimality Theory: parallel evaluation and bidirectional learning.")
1620 NORMAL (U"##4.3.16# (22 June 2005)")
1621 LIST_ITEM (U"• Pitch drawing: corrected logarithmic scales.")
1622 NORMAL (U"##4.3.15# (22 June 2005)")
1623 LIST_ITEM (U"• Graphics: better dotted lines in pitch contours; clipped pitch curves in editor windows.")
1624 LIST_ITEM (U"• Pitch analysis: more different units (semitones %re 1 Hz).")
1625 NORMAL (U"##4.3.14# (14 June 2005)")
1626 LIST_ITEM (U"• Scripting: regular expressions.")
1627 LIST_ITEM (U"• Removed a bug that caused Praat to crash if a proposed object name was longer than 200 characters.")
1628 NORMAL (U"##4.3.13# (19 May 2005)")
1629 LIST_ITEM (U"• Macintosh: an option to switch off screen previews in EPS files.")
1630 LIST_ITEM (U"• Sources: compatibility of makefiles with MinGW (Minimalist GNU for Windows).")
1631 NORMAL (U"##4.3.12# (10 May 2005)")
1632 LIST_ITEM (U"• Some more manual tricks.")
1633 NORMAL (U"##4.3.11# (6 May 2005)")
1634 LIST_ITEM (U"• TextGrid editor: show number of intervals.")
1635 NORMAL (U"##4.3.10# (25 April 2005)")
1636 LIST_ITEM (U"• Table: Get logistic regression.")
1637 NORMAL (U"##4.3.08# (19 April 2005)")
1638 LIST_ITEM (U"• OT learning: store history with \"OTGrammar & Strings: Learn from partial outputs...\".")
1639 NORMAL (U"##4.3.07# (31 March 2005)")
1640 LIST_ITEM (U"• Linux: removed a bug that could cause a sound to stop playing.")
1641 NORMAL (U"##4.3.04# (9 March 2005)")
1642 LIST_ITEM (U"• Use SIL Doulos IPA 1993/1996 instead of 1989.")
1643 NORMAL (U"##4.3.03# (2 March 2005)")
1644 LIST_ITEM (U"• TextGrid window: green colouring of matching text.")
1645 LIST_ITEM (U"• Regular expressions can be used in many places.")
1646 LIST_ITEM (U"• Pitch analysis: switched off formant-pulling.")
1647 NORMAL (U"##4.3.02# (16 February 2005)")
1648 LIST_ITEM (U"• TextGrid: Remove boundary at time...")
1649 LIST_ITEM (U"• Scripting: corrected %nowarn.")
1650 LIST_ITEM (U"• Linux: guard against blocking audio device.")
1651 LIST_ITEM (U"• Macintosh: guard against out-of-range audio level meter.")
1652 NORMAL (U"##4.3.01# (9 February 2005)")
1653 LIST_ITEM (U"• Replaced PostScript font SILDoulosIPA with XIPA (adapted for Praat by Rafael Laboissière).")
1654 LIST_ITEM (U"• Sound: Set part to zero...")
1655 LIST_ITEM (U"• Pitch: To Sound (sine)...")
1656 LIST_ITEM (U"• Sound & TextGrid: Clone time domain.")
1657 MAN_END
1658 
1659 MAN_BEGIN (U"What was new in 4.3?", U"ppgb", 20050126)
1660 ENTRY (U"Praat 4.3, 26 January 2005")
1661 	NORMAL (U"General:")
1662 	LIST_ITEM (U"• `Apply' button in settings windows for menu commands and in script forms.")
1663 	LIST_ITEM (U"• Info window can be saved.")
1664 	LIST_ITEM (U"• Removed 30,000-character limit in Info window.")
1665 	NORMAL (U"Phonetics:")
1666 	LIST_ITEM (U"• Speeded up intensity analysis by a factor of 10 "
1667 		"(by making its time resolution 0.01 ms rather than 0.0001 ms at a sampling frequency of 44 kHz).")
1668 	LIST_ITEM (U"• Speeded up pitch analysis and spectrogram analysis by a factor of two.")
1669 	LIST_ITEM (U"• Sound: To Spectrum... now has a reasonably fast non-FFT version.")
1670 	LIST_ITEM (U"• Calibrated long-term average spectrum (Sound: To Ltas...).")
1671 	LIST_ITEM (U"• Pitch-corrected LTAS analysis.")
1672 	LIST_ITEM (U"• Sound: Scale intensity.")
1673 	LIST_ITEM (U"• PitchTier: To Sound (sine).")
1674 	LIST_ITEM (U"• Better warnings against use of the LPC object.")
1675 	NORMAL (U"Voice:")
1676 	LIST_ITEM (U"• July 9, 2004 (4.2.08): Shimmer measurements: more accurate and less sensitive to additive noise.")
1677 	LIST_ITEM (U"• More extensive voice report: pitch statistics; harmonicity.")
1678 	NORMAL (U"Audio:")
1679 	LIST_ITEM (U"• Reading and opening 24-bit and 32-bit sound files (saving still goes in 16 bits).")
1680 	LIST_ITEM (U"• LongSound: save separate channels.")
1681 	LIST_ITEM (U"• Macintosh: much faster reading of WAV files.")
1682 	NORMAL (U"Listening experiments:")
1683 	LIST_ITEM (U"• Subjects can now respond with keyboard presses.")
1684 	NORMAL (U"Graphics:")
1685 	LIST_ITEM (U"• One can now drag the inner viewport in the Picture window, excluding the margins. "
1686 		"This is nice e.g. for creating square viewports or for drawing a waveform and a spectrogram in close contact.")
1687 	LIST_ITEM (U"• Unix: picture highlighting as on Mac and Windows.")
1688 	LIST_ITEM (U"• More drawing methods for Sound and Ltas (curve, bars, poles, speckles).")
1689 	NORMAL (U"OT learning:")
1690 	LIST_ITEM (U"• Monitor rankings when learning.")
1691 	LIST_ITEM (U"• OTGrammar: Remove harmonically bounded candidates...")
1692 	LIST_ITEM (U"• OTGrammar: Save as headerless spreadsheet file...")
1693 	LIST_ITEM (U"• Metrics grammar: added *Clash, *Lapse, WeightByPosition and *MoraicConsonant.")
1694 	NORMAL (U"Scripting:")
1695 	LIST_ITEM (U"• nowarn, noprogress, nocheck.")
1696 	LIST_ITEM (U"• Line numbers.")
1697 MAN_END
1698 
1699 MAN_BEGIN (U"What was new in 4.2?", U"ppgb", 20040304)
1700 ENTRY (U"Praat 4.2, 4 March 2004")
1701 	NORMAL (U"General:")
1702 	LIST_ITEM (U"• July 10, 2003: Open source code (General Public Licence).")
1703 	NORMAL (U"Phonetics:")
1704 	LIST_ITEM (U"• Faster computation of spectrum, spectrogram, and pitch.")
1705 	LIST_ITEM (U"• More precision in numeric libraries.")
1706 	LIST_ITEM (U"• PitchTier: Interpolate quadratically.")
1707 	LIST_ITEM (U"• TextGrids can be saved chronologically (and Praat can read that file again).")
1708 	LIST_ITEM (U"• Sound editor window @@Time step settings...@: \"Automatic\", \"Fixed\", and \"View-dependent\".")
1709 	LIST_ITEM (U"• Sound window: distinguish basic from advanced spectrogram and pitch settings.")
1710 	LIST_ITEM (U"• Read TableOfReal from headerless spreadsheet file...: cells with strings are considered zero.")
1711 	LIST_ITEM (U"• Sound window: introduced time step as advanced setting.")
1712 	LIST_ITEM (U"• Sound window: reintroduced view range as advanced setting.")
1713 	LIST_ITEM (U"• Ltas: Compute trend line, Subtract trend line.")
1714 	NORMAL (U"Audio:")
1715 	LIST_ITEM (U"• Sun workstations: support audio servers.")
1716 	NORMAL (U"Graphics:")
1717 	LIST_ITEM (U"• Better selections in Picture window and editor windows.")
1718 	LIST_ITEM (U"• Picture window: better handling of rectangles and ellipses for reversed axes.")
1719 	LIST_ITEM (U"• Windows: corrected positioning of pictures on clipboard and in metafiles.")
1720 	LIST_ITEM (U"• Windows: EPS files check availability of Times and TimesNewRomanPSMT.")
1721 	LIST_ITEM (U"• Polygon: can now also paint in colour instead of only in grey values.")
1722 	LIST_ITEM (U"• Unlimited number of points for polygons in PostScript (may not work on very old printers).")
1723 	LIST_ITEM (U"• Picture window: line widths on all printers and clipboards are now equal to line widths used on PostScript printers: "
1724 		"a line with a line width of \"1\" will be drawn with a width 3/8 points. This improves the looks of pictures printed "
1725 		"on non-PostScript printers, improves the looks of pictures copied to your wordprocessor when printed, "
1726 		"and changes the looks of pictures copied to your presentation program.")
1727 	NORMAL (U"OT learning:")
1728 	LIST_ITEM (U"• Metrics grammar supports `impoverished overt forms', "
1729 		"i.e. without secondary stress even if surface structures do have secondary stress.")
1730 	LIST_ITEM (U"• Support for crucially tied constraints and tied candidates.")
1731 	LIST_ITEM (U"• Support for backtracking in EDCD.")
1732 	LIST_ITEM (U"• Queries for testing grammaticality.")
1733 	NORMAL (U"Scripting:")
1734 	LIST_ITEM (U"• ManPages: script links can receive arguments.")
1735 	LIST_ITEM (U"• ManPages: variable duration of recording.")
1736 	LIST_ITEM (U"• Support for unlimited size of script files in editor window on Windows XP and MacOS X (the Unix editions already had this).")
1737 	LIST_ITEM (U"• Improved the reception of %sendpraat commands on Windows XP.")
1738 MAN_END
1739 
1740 MAN_BEGIN (U"What was new in 4.1?", U"ppgb", 20030605)
1741 ENTRY (U"Praat 4.1, 5 June 2003")
1742 	NORMAL (U"General:")
1743 	LIST_ITEM (U"• MacOS X edition.")
1744 	LIST_ITEM (U"• Removed licensing.")
1745 	LIST_ITEM (U"• More than 99 percent of the source code distributed under the General Public Licence.")
1746 	LIST_ITEM (U"• Windows 2000 and XP: put preferences files in home directory.")
1747 	NORMAL (U"Phonetics:")
1748 	LIST_ITEM (U"• Spectrum: the sign of the Fourier transform has changed, to comply with common use "
1749 		"in technology and physics. Old Spectrum files are converted when read.")
1750 	LIST_ITEM (U"• Spectral moments.")
1751 	LIST_ITEM (U"• Many jitter and shimmer measures, also in the Sound editor window.")
1752 	LIST_ITEM (U"• PitchTier: shift or multiply frequencies (also in ManipulationEditor).")
1753 	LIST_ITEM (U"• TextGrid: shift times, scale times.")
1754 	LIST_ITEM (U"• Overlap-add synthesis: reduced buzz in voiceless parts.")
1755 	LIST_ITEM (U"• @@Sound: Change gender...")
1756 	LIST_ITEM (U"• Editors: @@Intro 3.6. Viewing a spectral slice@.")
1757 	LIST_ITEM (U"• Editors: Get spectral power at cursor cross.")
1758 	LIST_ITEM (U"• @@Sound: To PointProcess (periodic, peaks)...@")
1759 	LIST_ITEM (U"• Ltas: merge.")
1760 	NORMAL (U"Listening experiments:")
1761 	LIST_ITEM (U"• Goodness judgments.")
1762 	LIST_ITEM (U"• Multiple ResultsMFC: ##To Table#, so that the whole experiment can go into a single statistics file.")
1763 	LIST_ITEM (U"• Stimulus file path can be relative to directory of experiment file.")
1764 	LIST_ITEM (U"• @ExperimentMFC: multiple substimuli for discrimination tests.")
1765 	NORMAL (U"Statistics:")
1766 	LIST_ITEM (U"• New @Table object for column @statistics: Pearson's %r, Kendall's %\\ta-%b, %t-test.")
1767 	LIST_ITEM (U"• Table: scatter plot.")
1768 	LIST_ITEM (U"• Table: column names as variables.")
1769 	LIST_ITEM (U"• @@T-test@.")
1770 	LIST_ITEM (U"• TableOfReal: Extract rows where column...")
1771 	LIST_ITEM (U"• TableOfReal: Get correlation....")
1772 	LIST_ITEM (U"• @@Correlation: Confidence intervals...")
1773 	LIST_ITEM (U"• @@SSCP: Get diagonality (bartlett)...")
1774 	NORMAL (U"OT learning:")
1775 	LIST_ITEM (U"• Tutorial for bidirectional learning.")
1776 	LIST_ITEM (U"• Random choice between equally violating candidates.")
1777 	LIST_ITEM (U"• More constraints in metrics grammar.")
1778 	LIST_ITEM (U"• Learning in editor.")
1779 	NORMAL (U"Graphics:")
1780 	LIST_ITEM (U"• Printing: hard-coded image interpolation for EPS files and PostScript printers.")
1781 	NORMAL (U"Scripting:")
1782 	LIST_ITEM (U"• New @Formulas tutorial.")
1783 	LIST_ITEM (U"• @Formulas: can use variables without quotes.")
1784 	LIST_ITEM (U"• Formulas for PitchTier, IntensityTier, AmplitudeTier, DurationTier.")
1785 	LIST_ITEM (U"• Refer to any matrices and tables in formulas, e.g. Sound_hello (x) or Table_everything [row, col] "
1786 		"or Table_tokens [i, \"F1\"].")
1787 	LIST_ITEM (U"• Assignment by modification, as with += -= *= /=.")
1788 	LIST_ITEM (U"• New functions: date\\$ (), extractNumber, extractWord\\$ , extractLine\\$ . See @@Formulas 6. String functions@.")
1789 	LIST_ITEM (U"• @@Scripting 5.8. Including other scripts@.")
1790 	LIST_ITEM (U"• String formulas in the calculator.")
1791 	LIST_ITEM (U"• Stopped support of things that had been undocumented for the last four years: "
1792 		"#let, #getnumber, #getstring, #ARGS, #copy, #proc, variables with capitals, and strings in numeric variables; "
1793 		"there are messages about how to modify your old scripts.")
1794 	LIST_ITEM (U"• Disallowed ambiguous expressions like -3\\^ 2.")
1795 MAN_END
1796 
1797 MAN_BEGIN (U"What was new in 4.0?", U"ppgb", 20011015)
1798 ENTRY (U"Praat 4.0, 15 October 2001")
1799 	NORMAL (U"Editors:")
1800 	LIST_ITEM (U"• Simplified selection and cursor in editor windows.")
1801 	LIST_ITEM (U"• Spectrogram, pitch contour, formant contour, and intensity available in the "
1802 		"Sound, LongSound, and TextGrid editors.")
1803 	LIST_ITEM (U"• TextGrid editor: additions and improvements.")
1804 	LIST_ITEM (U"• @@Log files@.")
1805 	NORMAL (U"Phonetics library:")
1806 	LIST_ITEM (U"• @ExperimentMFC: multiple-forced-choice listening experiments.")
1807 	LIST_ITEM (U"• @@Sound: To Pitch (ac)...@: pitch contour less dependent on time resolution. "
1808 		"This improves the constancy of the contours in the editors when zooming.")
1809 	LIST_ITEM (U"• TextGrid: additions and improvements.")
1810 	LIST_ITEM (U"• Sounds: Concatenate recoverably. Creates a TextGrid whose interval labels are the original "
1811 		"names of the sounds.")
1812 	LIST_ITEM (U"• Sound & TextGrid: Extract all intervals. The reverse of the previous command.")
1813 	LIST_ITEM (U"• Filterbank analyses, @MelFilter, @BarkFilter and "
1814 		"@FormantFilter, by @@band filtering in the frequency domain@." )
1815 	LIST_ITEM (U"• Cepstrum by David Weenink: @MFCC, @LFCC. "
1816 		"@Cepstrum object is a representation of the %%complex cepstrum%.")
1817 	LIST_ITEM (U"• Intensity: To IntensityTier (peaks, valleys).")
1818 	LIST_ITEM (U"• Replaced Analysis and AnalysisEditor with @Manipulation and @ManipulationEditor.")
1819 	NORMAL (U"Phonology library:")
1820 	LIST_ITEM (U"• PairDistribution: Get percentage correct (maximum likelihood, probability matching).")
1821 	LIST_ITEM (U"• OTGrammar & PairDistribution: Get percentage correct...")
1822 	NORMAL (U"Graphics:")
1823 	LIST_ITEM (U"• Improved spectrogram drawing.")
1824 	LIST_ITEM (U"• @@Special symbols@: háček.")
1825 	LIST_ITEM (U"• Macintosh: improved screen rendition of rotated text.")
1826 	NORMAL (U"Audio:")
1827 	LIST_ITEM (U"• Macintosh: support for multiple audio input devices (sound cards).")
1828 	NORMAL (U"Statistics and numerics library:")
1829 	LIST_ITEM (U"• More statistics by David Weenink.")
1830 	LIST_ITEM (U"• Improved random numbers and other numerical stuff.")
1831 	LIST_ITEM (U"• @@Regular expressions@.")
1832 	NORMAL (U"Scripting:")
1833 	LIST_ITEM (U"• Formatting in variable substitution, e.g. 'pitch:2' gives two digits after the decimal point.")
1834 	LIST_ITEM (U"• Added ##fixed\\$ # to scripting language for formatting of numbers.")
1835 	NORMAL (U"Documentation:")
1836 	LIST_ITEM (U"• @@Multidimensional scaling@ tutorial.")
1837 	LIST_ITEM (U"• Enabled debugging-at-a-distance.")
1838 MAN_END
1839 
1840 MAN_BEGIN (U"What was new in 3.9?", U"ppgb", 20001018)
1841 ENTRY (U"Praat 3.9, 18 October 2000")
1842 	NORMAL (U"Editors:")
1843 	LIST_ITEM (U"• Shift-click and shift-drag extend or shrink selection in editor windows.")
1844 	LIST_ITEM (U"• Grouped editors can have separate zooming and scrolling (FunctionEditor preferences).")
1845 	LIST_ITEM (U"• Cursor follows playing sound in editors; interruption by Escape key moves the cursor.")
1846 	LIST_ITEM (U"• TextGridEditor: optimized for transcribing large corpora: text field, directly movable boundaries, "
1847 		"more visible text in tiers, @SpellingChecker, "
1848 		"type while the sound is playing, complete keyboard navigation, control font size, control text alignment, "
1849 		"shift-click near boundary adds interval to selection.")
1850 	LIST_ITEM (U"• Stereo display in LongSound and TextGrid editors.")
1851 	LIST_ITEM (U"• LongSoundEditor and TextGridEditor: write selection to audio file.")
1852 	LIST_ITEM (U"• SoundEditor: added command \"Extract selection (preserve times)\".")
1853 	LIST_ITEM (U"• IntervalTierEditor, DurationTierEditor.")
1854 	LIST_ITEM (U"• Added many query commands in editors.")
1855 	NORMAL (U"Phonetics library:")
1856 	LIST_ITEM (U"• Sound: To Formant...: sample-rate-independent formant analysis.")
1857 	LIST_ITEM (U"• Sound: To Harmonicity (glottal-to-noise excitation ratio).")
1858 	LIST_ITEM (U"• Pitch: support for ERB units, draw all combinations of line/speckle and linear/logarithmic/semitones/mels/erbs, "
1859 		"optionally with TextGrid, Subtract linear fit.")
1860 	LIST_ITEM (U"• Spectrum: Draw along logarithmic frequency axis.")
1861 	LIST_ITEM (U"• TextGrid:  modification commands, Extract part, Shift to zero, Scale times (with Sound or LongSound).")
1862 	LIST_ITEM (U"• @@Matrix: To TableOfReal@, Draw contour...")
1863 	LIST_ITEM (U"• Concatenate Sound and LongSound objects.")
1864 	LIST_ITEM (U"• File formats: save PitchTier in spreadsheet format, read CGN syntax files (XML version), "
1865 		"text files now completely file-server-safe (independent from Windows/Macintosh/Unix line separators).")
1866 	NORMAL (U"Statistics and numerics library:")
1867 	LIST_ITEM (U"• @@Principal component analysis@.")
1868 	LIST_ITEM (U"• @@Discriminant analysis@.")
1869 	LIST_ITEM (U"• @Polynomial: drawing, @@Roots|root@ finding etc.")
1870 	LIST_ITEM (U"• @@TableOfReal: Draw box plots...@.")
1871 	LIST_ITEM (U"• @@Covariance: To TableOfReal (random sampling)...@.")
1872 	LIST_ITEM (U"• @@SSCP: Get sigma ellipse area...@.")
1873 	LIST_ITEM (U"• Query @DTW for 'weighted distance' of time warp.")
1874 	LIST_ITEM (U"• Distributions: To Strings (exact)...")
1875 	LIST_ITEM (U"• Strings: Randomize.")
1876 	NORMAL (U"Phonology library:")
1877 	LIST_ITEM (U"• OTGrammar: To PairDistribution.")
1878 	NORMAL (U"Graphics:")
1879 	LIST_ITEM (U"• Full support for colour inkjet printers on Windows and Macintosh.")
1880 	LIST_ITEM (U"• Full support for high-resolution colour clipboards and metafiles for "
1881 		"Windows and Macintosh programs that support them (this include MS Word "
1882 		"for Windows, but unfortunately not MS Word for Macintosh).")
1883 	LIST_ITEM (U"• Colour in EPS files.")
1884 	LIST_ITEM (U"• Interpolating grey images, i.e. better zoomed spectrograms.")
1885 	LIST_ITEM (U"• Linux: support for 24-bits screens.")
1886 	NORMAL (U"Audio:")
1887 	LIST_ITEM (U"• Asynchronous sound play.")
1888 	LIST_ITEM (U"• Linux: solved problems with /dev/mixer (\"Cannot read MIC gain.\") on many computers.")
1889 	LIST_ITEM (U"• Added possibility of zero padding for sound playing, "
1890 		"in order to reduce clicks on some Linux and Sun computers.")
1891 	LIST_ITEM (U"• LongSound supports mono and stereo, 8-bit and 16-bit, %\\mu-law and A-law, "
1892 		"big-endian and little-endian, AIFC, WAV, NeXT/Sun, and NIST files.")
1893 	LIST_ITEM (U"• \"Read two Sounds from stereo file...\" supports 8-bit and 16-bit, %\\mu-law and A-law, "
1894 		"big-endian and little-endian, AIFC, WAV, NeXT/Sun, and NIST files.")
1895 	LIST_ITEM (U"• SoundRecorder writes to 16-bit AIFC, WAV, NeXT/Sun, and NIST mono and stereo files.")
1896 	LIST_ITEM (U"• Sound & LongSound: write part or whole to mono or stereo audio file.")
1897 	LIST_ITEM (U"• Read Sound from raw Alaw file.")
1898 	LIST_ITEM (U"• Artword & Speaker (& Sound) movie: real time on all platforms.")
1899 	NORMAL (U"Scripting:")
1900 	LIST_ITEM (U"• @@Formulas 5. Mathematical functions@: added statistical functions: %\\ci^2, Student T, Fisher F, binomial, "
1901 		"and their inverse functions.")
1902 	LIST_ITEM (U"• Windows: program #praatcon for use as a Unix-style console application.")
1903 	LIST_ITEM (U"• Windows and Unix: Praat can be run with a command-line interface without quitting on errors.")
1904 	LIST_ITEM (U"• Unix & Windows: can use <stdout> as a file name (supports pipes for binary data).")
1905 	LIST_ITEM (U"• @sendpraat now also for Macintosh.")
1906 	LIST_ITEM (U"• @@Scripting 6.7. Sending a message to another program|sendsocket@.")
1907 	LIST_ITEM (U"• @@Read from file...@ recognizes script files if they begin with \"\\# !\".")
1908 	LIST_ITEM (U"• Script links in @ManPages.")
1909 	NORMAL (U"Documentation")
1910 	LIST_ITEM (U"• Tutorials on all subjects available through @Intro.")
1911 MAN_END
1912 
1913 MAN_BEGIN (U"What was new in 3.8?", U"ppgb", 19990112)
1914 ENTRY (U"Praat 3.8, 12 January 1999")
1915 	NORMAL (U"Phonetics library")
1916 	LIST_ITEM (U"• New objects: @LongSound (view and label long sound files), with editor; PairDistribution.")
1917 	LIST_ITEM (U"• @@Overlap-add@ manipulation of voiceless intervals, version 2: quality much better now; "
1918 		"target duration is exactly as expected from Duration tier or specified lengthening in @@Sound: Lengthen (overlap-add)...@.")
1919 	LIST_ITEM (U"• Audio: Escape key stops audio playing (on Mac also Command-period).")
1920 	LIST_ITEM (U"• @SoundRecorder: allows multiple recordings without close; Play button; Write buttons; buffer size can be set.")
1921 	LIST_ITEM (U"• Reverse a Sound or a selection of a Sound.")
1922 	LIST_ITEM (U"• @@Sound: Get nearest zero crossing...@.")
1923 	LIST_ITEM (U"• Formant: \"Scatter plot (reversed axes)...\".")
1924 	LIST_ITEM (U"• TextGrid & Pitch: \"Speckle separately...\".")
1925 	LIST_ITEM (U"• \"Extract Sound selection (preserve times)\" in TextGridEditor.")
1926 	LIST_ITEM (U"• More query commands for Matrix, TableOfReal, Spectrum, PointProcess.")
1927 	NORMAL (U"Phonology library")
1928 	LIST_ITEM (U"• 25-page OT learning tutorial.")
1929 	LIST_ITEM (U"• Made the OT learner 14 times as fast.")
1930 	NORMAL (U"Platforms")
1931 	LIST_ITEM (U"• May 23: Windows beta version.")
1932 	LIST_ITEM (U"• April 24: Windows alpha version.")
1933 	NORMAL (U"Files")
1934 	LIST_ITEM (U"• Read more Kay, Sun (.au), and WAV sound files.")
1935 	LIST_ITEM (U"• \"Read Strings from raw text file...\"")
1936 	LIST_ITEM (U"• @@Create Strings as file list...@.")
1937 	LIST_ITEM (U"• \"Read IntervalTier from Xwaves...\"")
1938 	LIST_ITEM (U"• hidden \"Read from old Windows Praat picture file...\"")
1939 	NORMAL (U"Graphics")
1940 	LIST_ITEM (U"• Use colours (instead of only greys) in \"Paint ellipse...\" etc.")
1941 	LIST_ITEM (U"• More true colours (maroon, lime, navy, teal, purple, olive).")
1942 	LIST_ITEM (U"• Direct printing from Macintosh to PostScript printers.")
1943 	LIST_ITEM (U"• Hyperpage printing to PostScript printers and PostScript files.")
1944 	LIST_ITEM (U"• Phonetic symbols: raising sign, lowering sign, script g, corner, ligature, pointing finger.")
1945 	NORMAL (U"Shell")
1946 	LIST_ITEM (U"• November 4: all dialogs are modeless (which is new for Unix and Mac).")
1947 	LIST_ITEM (U"• September 27: @sendpraat for Windows.")
1948 	NORMAL (U"Scripting")
1949 	LIST_ITEM (U"• January 7: scriptable editors.")
1950 	LIST_ITEM (U"• October 7: file I/O in scripts.")
1951 	LIST_ITEM (U"• August 23: script language includes all the important functions for string handling.")
1952 	LIST_ITEM (U"• June 24: string variables in scripts.")
1953 	LIST_ITEM (U"• June 22: faster look-up of script variables.")
1954 	LIST_ITEM (U"• June 22: unlimited number of script variables.")
1955 	LIST_ITEM (U"• April 5: suspended chopping of trailing spaces.")
1956 	LIST_ITEM (U"• March 29: enabled formulas as arguments to dialogs (also interactive).")
1957 MAN_END
1958 
1959 MAN_BEGIN (U"What was new in 3.7?", U"ppgb", 19980324)
1960 ENTRY (U"Praat 3.7, 24 March 1998")
1961 	NORMAL (U"Editors:")
1962 	LIST_ITEM (U"• In all FunctionEditors: drag to get a selection.")
1963 	NORMAL (U"Phonetics library:")
1964 	LIST_ITEM (U"• Many new query (#Get) commands for @Sound, @Intensity, @Harmonicity, @Pitch, "
1965 		"@Formant, @Ltas, @PitchTier, @IntensityTier, @DurationTier, #FormantTier.")
1966 	LIST_ITEM (U"• Many new modification commands.")
1967 	LIST_ITEM (U"• Many new interpolations.")
1968 	LIST_ITEM (U"• Sound enhancements: @@Sound: Lengthen (overlap-add)...@, @@Sound: Deepen band modulation...@")
1969 	LIST_ITEM (U"• @@Source-filter synthesis@ tutorial, @@Sound & IntensityTier: Multiply@, "
1970 		"##Sound & FormantTier: Filter#, @@Formant: Formula (frequencies)...@, @@Sound: Pre-emphasize (in-place)...@.")
1971 	NORMAL (U"Labelling")
1972 	LIST_ITEM (U"• TextGrid queries (#Get times and labels in a script).")
1973 	LIST_ITEM (U"• @@TextGrid: Count labels...@.")
1974 	LIST_ITEM (U"• @@PointProcess: To TextGrid (vuv)...@: get voiced/unvoiced information from a point process.")
1975 	LIST_ITEM (U"• IntervalTier to TableOfReal: labels become row labels.")
1976 	LIST_ITEM (U"• TextTier to TableOfReal.")
1977 	NORMAL (U"Numerics and statistics library")
1978 	LIST_ITEM (U"• Multidimensional scaling (Kruskal, INDSCAL, etc).")
1979 	LIST_ITEM (U"• @TableOfReal: Set value, Formula, Remove column, Insert column, Draw as squares, To Matrix.")
1980 	NORMAL (U"Phonology library")
1981 	LIST_ITEM (U"• OT learning: new strategies: weighted symmetric plasticity (uncancelled or all).")
1982 	NORMAL (U"Praat shell")
1983 	LIST_ITEM (U"• First Linux version.")
1984 	LIST_ITEM (U"• Eight new functions like e.g. %hertzToBark in @@Formulas 5. Mathematical functions@.")
1985 	LIST_ITEM (U"• @@Praat script@: procedure arguments; object names.")
1986 	NORMAL (U"Documentation:")
1987 	LIST_ITEM (U"• 230 more man pages (now 630).")
1988 	LIST_ITEM (U"• Hypertext: increased readability of formulas, navigation with keyboard.")
1989 MAN_END
1990 
1991 MAN_BEGIN (U"What was new in 3.6?", U"ppgb", 19971027)
1992 ENTRY (U"Praat 3.6, 27 October 1997")
1993 	NORMAL (U"Editors:")
1994 	LIST_ITEM (U"• Intuitive position of B and E buttons on left-handed mice.")
1995 	LIST_ITEM (U"• @SoundEditor: copy %windowed selection to list of objects.")
1996 	LIST_ITEM (U"• @SoundEditor: undo Cut, Paste, Zero.")
1997 	LIST_ITEM (U"• @SpectrumEditor: copy band-filtered spectrum or sound to list of objects.")
1998 	LIST_ITEM (U"• @ManipulationEditor: LPC-based pitch manipulation.")
1999 	NORMAL (U"Objects:")
2000 	LIST_ITEM (U"• Use '-', and '+' in object names.")
2001 	NORMAL (U"Phonetics library")
2002 	LIST_ITEM (U"• LPC-based resynthesis in @ManipulationEditor.")
2003 	LIST_ITEM (U"• @Sound: direct modification without formulas (addition, multiplication, windowing)")
2004 	LIST_ITEM (U"• @Sound: filtering in spectral domain by formula.")
2005 	LIST_ITEM (U"• Create a simple @Pitch object from a @PitchTier (for %F__0_) and a @Pitch (for V/U).")
2006 	LIST_ITEM (U"• Semitones in @PitchTier tables.")
2007 	LIST_ITEM (U"• @PointProcess: transplant time domain from @Sound.")
2008 	LIST_ITEM (U"• Much more...")
2009 	NORMAL (U"Phonology library")
2010 	LIST_ITEM (U"• Computational Optimality Theory. See @@OT learning@.")
2011 	NORMAL (U"Hypertext")
2012 	LIST_ITEM (U"• You can use @ManPages files for creating your own tutorials. "
2013 		"These contains buttons for playing and recording sounds, so you can use this for creating "
2014 		"an interactive IPA sound training course.")
2015 	NORMAL (U"Scripting:")
2016 	LIST_ITEM (U"• Programmable @@Praat script@ language: variables, expressions, control structures, "
2017 		"procedures, complete dialog box, exchange of information with Info window, continuation lines.")
2018 	LIST_ITEM (U"• Use platform-independent relative file paths in @@Praat script@.")
2019 	LIST_ITEM (U"• @ScriptEditor: Run selection.")
2020 	NORMAL (U"Graphics:")
2021 	LIST_ITEM (U"• Rotation and scaling while printing the @@Picture window@.")
2022 	LIST_ITEM (U"• Apart from bold and italic, now also bold-italic (see @@Text styles@).")
2023 	LIST_ITEM (U"• Rounded rectangles.")
2024 	LIST_ITEM (U"• Conversion of millimetres and world coordinates.")
2025 	LIST_ITEM (U"• Measurement of text widths (screen and PostScript).")
2026 	NORMAL (U"Unix:")
2027 	LIST_ITEM (U"• Use the @sendpraat program for sending messages to running Praat programs.")
2028 	NORMAL (U"Mac:")
2029 	LIST_ITEM (U"• Praat looks best with the new and beautiful System 8.")
2030 MAN_END
2031 
2032 MAN_BEGIN (U"What was new in 3.5?", U"ppgb", 19970527)
2033 ENTRY (U"Praat 3.5, 27 May 1997")
2034 	NORMAL (U"New editors:")
2035 	LIST_ITEM (U"• #TextGridEditor replaces and extends LabelEditor: edit points as well as intervals.")
2036 	LIST_ITEM (U"• #AnalysisEditor replaces and extends PsolaEditor: view pitch, spectrum, formant, and intensity "
2037 		"analyses in a single window, and allow pitch and duration resynthesis by overlap-add and more (would be undone in 3.9.19).")
2038 	LIST_ITEM (U"• #SpectrumEditor allows you to view and edit spectra.")
2039 	NORMAL (U"Praat shell:")
2040 	LIST_ITEM (U"• ##History mechanism# remembers all the commands that you have chosen, "
2041 		"and allows you to put them into a script.")
2042 	LIST_ITEM (U"• #ScriptEditor allows you to edit and run any Praat script, and to put it under a button.")
2043 	LIST_ITEM (U"• All added and removed buttons are remembered across sessions.")
2044 	LIST_ITEM (U"• #ButtonEditor allows you to make buttons visible or invisible.")
2045 	NORMAL (U"Evaluations:")
2046 	LIST_ITEM (U"• In his 1996 doctoral thesis, Henning Reetz "
2047 		"compared five pitch analysis routines; @@Sound: To Pitch (ac)...@ appeared to make the fewest errors. "
2048 		"H. Reetz (1996): %%Pitch Perception in Speech: a Time Domain Approach%, Studies in Language and Language Use #26, "
2049 		"IFOTT, Amsterdam (ICG Printing, Dordrecht).")
2050 	NORMAL (U"Documentation:")
2051 	LIST_ITEM (U"• 140 more man pages (now 330).")
2052 	LIST_ITEM (U"• Tables and pictures in manual.")
2053 	LIST_ITEM (U"• Printing the entire manual.")
2054 	LIST_ITEM (U"• Logo.")
2055 	NORMAL (U"New types:")
2056 	LIST_ITEM (U"• Labelling & segmentation: #TextGrid, #IntervalTier, #TextTier.")
2057 	LIST_ITEM (U"• Analysis & manipulation: #Analysis.")
2058 	LIST_ITEM (U"• Statistics: #TableOfReal, #Distributions, #Transition")
2059 	NORMAL (U"File formats:")
2060 	LIST_ITEM (U"• Read and write rational numbers in text files.")
2061 	LIST_ITEM (U"• Read 8-bit .au sound files.")
2062 	LIST_ITEM (U"• Read and write raw 8-bit two\'s-complement and offset-binary sound files.")
2063 	NORMAL (U"Audio:")
2064 	LIST_ITEM (U"• 16-bit interactive Sound I/O on Mac.")
2065 	LIST_ITEM (U"• Record sounds at 9.8 kHz on SGI.")
2066 	NORMAL (U"New commands:")
2067 	LIST_ITEM (U"• Two more pitch-analysis routines.")
2068 	LIST_ITEM (U"• Sound to PointProcess: collect all maxima, minima, zero crossings.")
2069 	LIST_ITEM (U"• PointProcess: set calculus.")
2070 	LIST_ITEM (U"• TextGrid: extract time-point information.")
2071 	LIST_ITEM (U"• Compute pitch or formants at given time points.")
2072 	LIST_ITEM (U"• Put pitch, formants etc. in tables en get statistics.")
2073 	LIST_ITEM (U"• Many more...")
2074 	NORMAL (U"Macintosh:")
2075 	LIST_ITEM (U"• 16-bit interactive sound I/O.")
2076 	LIST_ITEM (U"• Fast and interpolating spectrogram drawing.")
2077 	LIST_ITEM (U"• Phonetic Mac screen font included in source code (as a fallback to using SIL Doulos IPA).")
2078 	LIST_ITEM (U"• Keyboard shortcuts, text editor, help under question mark, etc.")
2079 MAN_END
2080 
2081 MAN_BEGIN (U"What was new in 3.3?", U"ppgb", 19961006)
2082 ENTRY (U"Praat 3.3, 6 October 1996")
2083 	LIST_ITEM (U"• Documentation: hypertext help browser, including the first 190 man pages.")
2084 	LIST_ITEM (U"• New editors: type #TextTier for labelling times instead of intervals.")
2085 	LIST_ITEM (U"• New actions: #Formant: Viterbi tracker, Statistics menu, Scatter plot.")
2086 	LIST_ITEM (U"• Evaluation: For HNR analysis of speech, the cross-correlation method, "
2087 		"which has a sensitivity of 60 dB and a typical time resolution of 12 milliseconds, "
2088 		"must be considered better than the autocorrelation method, "
2089 		"which has a better sensitivity (80 dB), but a much worse time resolution (30 ms). "
2090 		"For pitch analysis, the autocorrelation method still beats the cross-correlation method "
2091 		"because of its better resistance against noise and echos, "
2092 		"and despite its marginally poorer resolution (15 vs. 12 ms).")
2093 	LIST_ITEM (U"• User preferences are saved across sessions.")
2094 	LIST_ITEM (U"• The phonetic X screen font included in the source code.")
2095 	LIST_ITEM (U"• Xwindows resources included in the source code")
2096 	LIST_ITEM (U"• Graphics: eight colours, small caps, text rotation.")
2097 	LIST_ITEM (U"• File formats: Sun/NexT mu-law files, raw matrix text files, Xwaves mark files.")
2098 	LIST_ITEM (U"• Accelerations: keyboard shortcuts, faster dynamic menu, Shift-OK keeps file selector on screen.")
2099 	LIST_ITEM (U"• Object type changes: #StylPitch and #MarkTier are now called #PitchTier and #TextTier, respectively. "
2100 		"Old files can still be read.")
2101 	LIST_ITEM (U"• Script warning: all times in dialogs are in seconds now: milliseconds have gone.")
2102 MAN_END
2103 
2104 MAN_BEGIN (U"What was new in 3.2?", U"ppgb", 19960429)
2105 ENTRY (U"Praat 3.2, 29 April 1996")
2106 	LIST_ITEM (U"• Sound I/O for HPUX, Sun Sparc 5, and Sun Sparc LX.")
2107 	LIST_ITEM (U"• Cross-correlation pitch and HNR analysis.")
2108 	LIST_ITEM (U"• Facilities for generating tables from scripts.")
2109 	LIST_ITEM (U"• Editing and playing stylized pitch contours and point processes.")
2110 	LIST_ITEM (U"• Overlap-add pitch manipulation.")
2111 	LIST_ITEM (U"• Spectral smoothing techniques: cepstrum and LPC.")
2112 	LIST_ITEM (U"• Time-domain pitch analysis with jitter measurement.")
2113 	LIST_ITEM (U"• Read and write Bell-Labs sound files and Kay CSL audio files.")
2114 	LIST_ITEM (U"• Replaced IpaTimes font by free SILDoulos-IPA font, and embedded phonetic font in PostScript picture.")
2115 	LIST_ITEM (U"• Completed main phonetic characters.")
2116 MAN_END
2117 
2118 MAN_BEGIN (U"What was new in 3.1?", U"ppgb", 19951205)
2119 ENTRY (U"Praat 3.1, 5 December 1995")
2120 	LIST_ITEM (U"• Add and remove buttons dynamically.")
2121 	LIST_ITEM (U"• DataEditor (Inspect button).")
2122 	LIST_ITEM (U"• Initialization scripts.")
2123 	LIST_ITEM (U"• Logarithmic axes.")
2124 	LIST_ITEM (U"• Call remote ADDA server directly.")
2125 MAN_END
2126 /*
2127    BUGBASE
2128 
2129 >* The Artword editor would be easier to read if the vertical axis of the
2130 >graphs were squeezed a little.  As it is, the line for a target of 1
2131 >throughout the utterance merges into the top bounding box and is
2132 >invisible.
2133 >
2134 
2135 >* In drawing a picture of an Artword for a Speaker, the Pen|Line-width
2136 >option only works for dotted and dashed lines.  It's ignored for plain
2137 >lines (and is WAY too wide).
2138 
2139 ENTRY (U"To do")
2140 	LIST_ITEM (U"• TextGrid & Sound: Extract intervals with margins.")
2141 	LIST_ITEM (U"• Spectrum: draw power, re, im, phase.")
2142 	LIST_ITEM (U"• Formant: To Spectrum (slice)... (combines Formant-to-LPC and LPC-to-Spectrum-slice)")
2143 	LIST_ITEM (U"• Read and/or write Matlab files, MBROLA files, Xwaves files, CHAT files.") // Aix
2144 	LIST_ITEM (U"• Matrix: draw numbers.")
2145 	LIST_ITEM (U"• Fractions with \\bsf{a|b}.")
2146 	LIST_ITEM (U"• Move objects up and down list.")
2147 	LIST_ITEM (U"• Spectrogram cross-correlation.")
2148 	LIST_ITEM (U"• Labels in AIFC file.") // Theo Veenker 19980323
2149 	LIST_ITEM (U"• Improve scrolling and add selection in hyperpages.")
2150 	LIST_ITEM (U"• Segment spectrograph?") // Ton Wempe, Jul 16 1996
2151 	LIST_ITEM (U"• Phoneme-to-articulation conversion??") // Mirjam Ernestus, Jul 1 1996
2152 ENTRY (U"Known bugs in the Windows version")
2153 	LIST_ITEM (U"• Cannot stand infinitesimal zooming in SpectrogramEditor.")
2154 */
2155 
2156 MAN_BEGIN (U"FLAC BSD 3-clause license", U"ppgb", 20210823)
2157 NORMAL (U"The Praat source code contains a copy of the FLAC software (see @Acknowledgments). "
2158 	"Here is the FLAC license text:")
2159 CODE (U"libFLAC - Free Lossless Audio Codec library")
2160 CODE (U"Copyright (C) 2000-2009  Josh Coalson")
2161 CODE (U"Copyright (C) 2011-2018  Xiph.Org Foundation")
2162 CODE (U"")
2163 CODE (U"Redistribution and use in source and binary forms, with or without "
2164 	"modification, are permitted provided that the following conditions "
2165 	"are met:")
2166 CODE (U"")
2167 CODE (U"- Redistributions of source code must retain the above copyright "
2168 	"notice, this list of conditions and the following disclaimer.")
2169 CODE (U"")
2170 CODE (U"- Redistributions in binary form must reproduce the above copyright "
2171 	"notice, this list of conditions and the following disclaimer in the "
2172 	"documentation and/or other materials provided with the distribution.")
2173 CODE (U"")
2174 CODE (U"- Neither the name of the Xiph.org Foundation nor the names of its "
2175 	"contributors may be used to endorse or promote products derived from "
2176 	"this software without specific prior written permission.")
2177 CODE (U"")
2178 CODE (U"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "
2179 	"``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT "
2180 	"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR "
2181 	"A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR "
2182 	"CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, "
2183 	"EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, "
2184 	"PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR "
2185 	"PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF "
2186 	"LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING "
2187 	"NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS "
2188 	"SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.")
2189 MAN_END
2190 
2191 MAN_BEGIN (U"Ogg Vorbis BSD 3-clause license", U"ppgb", 20201227)
2192 NORMAL (U"The Praat source code contains a copy of the Ogg Vorbis software (see @Acknowledgments). "
2193 	"Here is the Ogg Vorbis license text:")
2194 CODE (U"Copyright (c) 2002-2020 Xiph.org Foundation")
2195 CODE (U"")
2196 CODE (U"Redistribution and use in source and binary forms, with or without "
2197 	"modification, are permitted provided that the following conditions "
2198 	"are met:")
2199 CODE (U"")
2200 CODE (U"- Redistributions of source code must retain the above copyright "
2201 	"notice, this list of conditions and the following disclaimer.")
2202 CODE (U"")
2203 CODE (U"- Redistributions in binary form must reproduce the above copyright "
2204 	"notice, this list of conditions and the following disclaimer in the "
2205 	"documentation and/or other materials provided with the distribution.")
2206 CODE (U"")
2207 CODE (U"- Neither the name of the Xiph.org Foundation nor the names of its "
2208 	"contributors may be used to endorse or promote products derived from "
2209 	"this software without specific prior written permission.")
2210 CODE (U"")
2211 CODE (U"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "
2212 	"``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT "
2213 	"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR "
2214 	"A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR "
2215 	"CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, "
2216 	"EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, "
2217 	"PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR "
2218 	"PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF "
2219 	"LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING "
2220 	"NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS "
2221 	"SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.")
2222 MAN_END
2223 
2224 MAN_BEGIN (U"Opus BSD 3-clause license", U"ppgb", 20210105)
2225 NORMAL (U"The Praat source code contains a copy of the Opus software (see @Acknowledgments). "
2226 	"Here is the Opus license text:")
2227 CODE (U"Copyright (c) 2001-2011 Xiph.Org, Skype Limited, Octasic,")
2228 CODE (U"                        Jean-Marc Valin, Timothy B. Terriberry,")
2229 CODE (U"                        CSIRO, Gregory Maxwell, Mark Borgerding,")
2230 CODE (U"                        Erik de Castro Lopo")
2231 CODE (U"")
2232 CODE (U"Redistribution and use in source and binary forms, with or without "
2233 	"modification, are permitted provided that the following conditions "
2234 	"are met:")
2235 CODE (U"")
2236 CODE (U"- Redistributions of source code must retain the above copyright "
2237 	"notice, this list of conditions and the following disclaimer.")
2238 CODE (U"")
2239 CODE (U"- Redistributions in binary form must reproduce the above copyright "
2240 	"notice, this list of conditions and the following disclaimer in the "
2241 	"documentation and/or other materials provided with the distribution.")
2242 CODE (U"")
2243 CODE (U"- Neither the name of Internet Society, IETF or IETF Trust, nor the "
2244 	"names of specific contributors may be used to endorse or promote "
2245 	"products derived from this software without specific prior written "
2246 	"permission.")
2247 CODE (U"")
2248 CODE (U"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "
2249 	"``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT "
2250 	"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR "
2251 	"A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE FOUNDATION OR "
2252 	"CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, "
2253 	"EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, "
2254 	"PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR "
2255 	"PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF "
2256 	"LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING "
2257 	"NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS "
2258 	"SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.")
2259 CODE (U"")
2260 CODE (U"Opus is subject to the royalty-free patent licenses which are "
2261 	"specified at:")
2262 CODE (U"")
2263 CODE (U"Xiph.Org Foundation:")
2264 CODE (U"https://datatracker.ietf.org/ipr/1524/")
2265 CODE (U"")
2266 CODE (U"Microsoft Corporation:")
2267 CODE (U"https://datatracker.ietf.org/ipr/1914/")
2268 CODE (U"")
2269 CODE (U"Broadcom Corporation:")
2270 CODE (U"https://datatracker.ietf.org/ipr/1526/")
2271 MAN_END
2272 
2273 MAN_BEGIN (U"Skype Limited BSD 3-clause license", U"ppgb", 20220102)
2274 NORMAL (U"The Praat source code contains a copy of the SILK software (see @Acknowledgments). "
2275 	"Here is the Skype Limited license text:")
2276 CODE (U"Copyright (c) 2006-2011 Skype Limited. All rights reserved.")
2277 CODE (U"")
2278 CODE (U"Redistribution and use in source and binary forms, with or without "
2279 	"modification, are permitted provided that the following conditions "
2280 	"are met:")
2281 CODE (U"")
2282 CODE (U"- Redistributions of source code must retain the above copyright "
2283 	"notice, this list of conditions and the following disclaimer.")
2284 CODE (U"")
2285 CODE (U"- Redistributions in binary form must reproduce the above copyright "
2286 	"notice, this list of conditions and the following disclaimer in the "
2287 	"documentation and/or other materials provided with the distribution.")
2288 CODE (U"")
2289 CODE (U"- Neither the name of Internet Society, IETF or IETF Trust, nor the names of specific "
2290 	"contributors, may be used to endorse or promote products derived from "
2291 	"this software without specific prior written permission.")
2292 CODE (U"")
2293 CODE (U"THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "
2294 	"``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT "
2295 	"LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR "
2296 	"A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE COPYRIGHT OWNER OR "
2297 	"CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, "
2298 	"EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, "
2299 	"PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR "
2300 	"PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF "
2301 	"LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING "
2302 	"NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS "
2303 	"SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.")
2304 MAN_END
2305 
2306 MAN_BEGIN (U"Acknowledgments", U"ppgb", 20211016)
2307 NORMAL (U"The following people contributed source code to Praat:")
2308 LIST_ITEM (U"Paul Boersma: user interface, graphics, @printing, @@Intro|sound@, "
2309 	"@@Intro 3. Spectral analysis|spectral analysis@, @@Intro 4. Pitch analysis|pitch analysis@, "
2310 	"@@Intro 5. Formant analysis|formant analysis@, @@Intro 6. Intensity analysis|intensity analysis@, "
2311 	"@@Intro 7. Annotation|annotation@, @@Intro 8. Manipulation|speech manipulation@, @@voice|voice report@, "
2312 	"@@ExperimentMFC|listening experiments@, "
2313 	"@@articulatory synthesis@, @@OT learning|optimality-theoretic learning@, "
2314 	"tables, @formulas, @scripting, and adaptation of PortAudio, GLPK, regular expressions, and Opus.")
2315 LIST_ITEM (U"David Weenink: "
2316 	"@@feedforward neural networks@, @@principal component analysis@, @@multidimensional scaling@, @@discriminant analysis@, @LPC, "
2317 	"@VowelEditor, "
2318 	"and adaptation of GSL, LAPACK, fftpack, regular expressions, Espeak, Ogg Vorbis, and Opus.")
2319 LIST_ITEM (U"Stefan de Konink and Franz Brauße: major help in port to GTK.")
2320 LIST_ITEM (U"Tom Naughton: major help in port to Cocoa.")
2321 LIST_ITEM (U"Erez Volk: adaptation of FLAC and MAD.")
2322 LIST_ITEM (U"Ola Söder: kNN classifiers, k-means clustering.")
2323 LIST_ITEM (U"Rafael Laboissière: adaptation of XIPA, audio bug fixes for Linux.")
2324 LIST_ITEM (U"Darryl Purnell created the first version of audio for Praat for Linux.")
2325 NORMAL (U"We included the following freely available software libraries in Praat (sometimes with adaptations):")
2326 LIST_ITEM (U"XIPA: IPA font for Unix by Fukui Rei (GPL).")
2327 LIST_ITEM (U"GSL: GNU Scientific Library by Gerard Jungman and Brian Gough (GPL 3 or later).")
2328 LIST_ITEM (U"GLPK: GNU Linear Programming Kit by Andrew Makhorin (GPL 3 or later); "
2329 	"contains AMD software by the same author (LGPL 2.1 or later).")
2330 LIST_ITEM (U"PortAudio: Portable Audio Library by Ross Bencina, Phil Burk, Bjorn Roche, Dominic Mazzoni, Darren Gibbs "
2331 	"(CC-BY-like license).")
2332 LIST_ITEM (U"Espeak: text-to-speech synthesizer by Jonathan Duddington and Reece Dunn (GPL 3 or later).")
2333 LIST_ITEM (U"MAD: MPEG Audio Decoder by Underbit Technologies (GPL 2 or later).")
2334 LIST_ITEM (U"FLAC: Free Lossless Audio Codec by Josh Coalson and Xiph.Org, version 1.3.3 (@@FLAC BSD 3-clause license@).")
2335 LIST_ITEM (U"Ogg Vorbis: audio compression by Christopher Montgomery (@@Ogg Vorbis BSD 3-clause license@).")
2336 LIST_ITEM (U"Opus: audio compression by Jean-Marc Valin, Gregory Maxwell, Christopher Montgomery, Timothy Terriberry, "
2337 	"Koen Vos, Andrew Allen and others (@@Opus BSD 3-clause license@).")
2338 LIST_ITEM (U"SILK: audio compression by Skype Limited (@@Skype Limited BSD 3-clause license@).")
2339 LIST_ITEM (U"fftpack: public domain Fourier transforms by Paul Swarztrauber, translated to C by Christopher Montgomery.")
2340 LIST_ITEM (U"@LAPACK: public domain numeric algorithms by Univ. of Tennessee, Univ. of California Berkeley, NAG Ltd., "
2341 	"Courant Institute, Argonne National Lab, and Rice University.")
2342 LIST_ITEM (U"Regular expressions by Henry Spencer, Mark Edel, Christopher Conrad, Eddy De Greef (GPL 2 or later).")
2343 NORMAL (U"Most of the source code of Praat is distributed under the General Public License, version 2 or later. "
2344 	"However, as Praat includes the above software written by others, "
2345 	"the whole of Praat is distributed under the General Public License, version 3 or later.")
2346 NORMAL (U"For their financial support during the development of Praat:")
2347 LIST_ITEM (U"Netherlands Organization for Scientific Research (NWO) (1996–1999).")
2348 LIST_ITEM (U"Nederlandse Taalunie (2006–2008).")
2349 LIST_ITEM (U"Talkbank project, Carnegie Mellon / Linguistic Data Consortium (2002–2003).")
2350 LIST_ITEM (U"Stichting Spraaktechnologie (2014–2016).")
2351 LIST_ITEM (U"Spoken Dutch Corpus (CGN) (1999–2001).")
2352 LIST_ITEM (U"Laboratorium Experimentele OtoRhinoLaryngologie, KU Leuven.")
2353 LIST_ITEM (U"DFG-Projekt Dialektintonation, Universität Freiburg.")
2354 LIST_ITEM (U"Department of Linguistics and Phonetics, Lund University.")
2355 LIST_ITEM (U"Centre for Cognitive Neuroscience, University of Turku.")
2356 LIST_ITEM (U"Linguistics Department, University of Joensuu.")
2357 LIST_ITEM (U"Laboratoire de Sciences Cognitives et Psycholinguistique, Paris.")
2358 LIST_ITEM (U"Department of Linguistics, Northwestern University.")
2359 LIST_ITEM (U"Department of Finnish and General Linguistics, University of Tampere.")
2360 LIST_ITEM (U"Institute for Language and Speech Processing, Paradissos Amaroussiou.")
2361 LIST_ITEM (U"Jörg Jescheniak, Universität Leipzig.")
2362 LIST_ITEM (U"The Linguistics Teaching Laboratory, Ohio State University.")
2363 LIST_ITEM (U"Linguistics & Cognitive Science, Dartmouth College, Hanover NH.")
2364 LIST_ITEM (U"Cornell Phonetics Lab, Ithaca NY.")
2365 NORMAL (U"Finally we thank:")
2366 LIST_ITEM (U"Ton Wempe and Dirk Jan Vet, for technical support and advice.")
2367 LIST_ITEM (U"Daniel Hirst and Daniel McCloy, for managing the Praat Users List.")
2368 LIST_ITEM (U"Rafael Laboissière and Andreas Tille, for maintaining the Debian package.")
2369 LIST_ITEM (U"Jason Bacon and Adriaan de Groot, for maintaining the FreeBSD port.")
2370 LIST_ITEM (U"José Joaquín Atria and Ingmar Steiner, for setting up the source-code repository on GitHub.")
2371 LIST_ITEM (U"Hundreds of Praat users, for sending suggestions and notifying us of problems and thus helping us to improve Praat.")
2372 MAN_END
2373 
2374 MAN_BEGIN (U"License", U"ppgb", 20211016)
2375 NORMAL (U"Praat is free software distributed under the @@General Public License, version 3@ or higher. "
2376 	"See @Acknowledgments for details on the licenses of software libraries by others "
2377 	"that are included in Praat.")
2378 MAN_END
2379 
2380 MAN_BEGIN (U"General Public License, version 3", U"ppgb", 20211026)
2381 NORMAL (U"This is the license under which Praat as a whole is distributed.")
2382 CODE (U"                    GNU GENERAL PUBLIC LICENSE")
2383 CODE (U"                       Version 3, 29 June 2007")
2384 CODE (U"")
2385 CODE (U" Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>")
2386 CODE (U" Everyone is permitted to copy and distribute verbatim copies")
2387 CODE (U" of this license document, but changing it is not allowed.")
2388 CODE (U"")
2389 CODE (U"                            Preamble")
2390 CODE (U"")
2391 CODE (U"The GNU General Public License is a free, copyleft license for "
2392 	"software and other kinds of works.")
2393 CODE (U"")
2394 CODE (U"The licenses for most software and other practical works are designed "
2395 	"to take away your freedom to share and change the works.  By contrast, "
2396 	"the GNU General Public License is intended to guarantee your freedom to "
2397 	"share and change all versions of a program--to make sure it remains free "
2398 	"software for all its users.  We, the Free Software Foundation, use the "
2399 	"GNU General Public License for most of our software; it applies also to "
2400 	"any other work released this way by its authors.  You can apply it to "
2401 	"your programs, too.")
2402 CODE (U"")
2403 CODE (U"When we speak of free software, we are referring to freedom, not "
2404 	"price.  Our General Public Licenses are designed to make sure that you "
2405 	"have the freedom to distribute copies of free software (and charge for "
2406 	"them if you wish), that you receive source code or can get it if you "
2407 	"want it, that you can change the software or use pieces of it in new "
2408 	"free programs, and that you know you can do these things.")
2409 CODE (U"")
2410 CODE (U"To protect your rights, we need to prevent others from denying you "
2411 	"these rights or asking you to surrender the rights.  Therefore, you have "
2412 	"certain responsibilities if you distribute copies of the software, or if "
2413 	"you modify it: responsibilities to respect the freedom of others.")
2414 CODE (U"")
2415 CODE (U"For example, if you distribute copies of such a program, whether "
2416 	"gratis or for a fee, you must pass on to the recipients the same "
2417 	"freedoms that you received.  You must make sure that they, too, receive "
2418 	"or can get the source code.  And you must show them these terms so they "
2419 	"know their rights.")
2420 CODE (U"")
2421 CODE (U"Developers that use the GNU GPL protect your rights with two steps: "
2422 	"(1) assert copyright on the software, and (2) offer you this License "
2423 	"giving you legal permission to copy, distribute and/or modify it.")
2424 CODE (U"")
2425 CODE (U"For the developers' and authors' protection, the GPL clearly explains "
2426 	"that there is no warranty for this free software.  For both users' and "
2427 	"authors' sake, the GPL requires that modified versions be marked as "
2428 	"changed, so that their problems will not be attributed erroneously to "
2429 	"authors of previous versions.")
2430 CODE (U"")
2431 CODE (U"Some devices are designed to deny users access to install or run "
2432 	"modified versions of the software inside them, although the manufacturer "
2433 	"can do so.  This is fundamentally incompatible with the aim of "
2434 	"protecting users' freedom to change the software.  The systematic "
2435 	"pattern of such abuse occurs in the area of products for individuals to "
2436 	"use, which is precisely where it is most unacceptable.  Therefore, we "
2437 	"have designed this version of the GPL to prohibit the practice for those "
2438 	"products.  If such problems arise substantially in other domains, we "
2439 	"stand ready to extend this provision to those domains in future versions "
2440 	"of the GPL, as needed to protect the freedom of users.")
2441 CODE (U"")
2442 CODE (U"Finally, every program is threatened constantly by software patents. "
2443 	"States should not allow patents to restrict development and use of "
2444 	"software on general-purpose computers, but in those that do, we wish to "
2445 	"avoid the special danger that patents applied to a free program could "
2446 	"make it effectively proprietary.  To prevent this, the GPL assures that "
2447 	"patents cannot be used to render the program non-free.")
2448 CODE (U"")
2449 CODE (U"The precise terms and conditions for copying, distribution and "
2450 	"modification follow.")
2451 CODE (U"")
2452 CODE (U"                       TERMS AND CONDITIONS")
2453 CODE (U"")
2454 CODE (U"0. Definitions.")
2455 CODE (U"")
2456 CODE (U"\"This License\" refers to version 3 of the GNU General Public License.")
2457 CODE (U"")
2458 CODE (U"\"Copyright\" also means copyright-like laws that apply to other kinds of "
2459 	"works, such as semiconductor masks.")
2460 CODE (U"")
2461 CODE (U"\"The Program\" refers to any copyrightable work licensed under this "
2462 	"License.  Each licensee is addressed as \"you\".  \"Licensees\" and "
2463 	"\"recipients\" may be individuals or organizations.")
2464 CODE (U"")
2465 CODE (U"To \"modify\" a work means to copy from or adapt all or part of the work "
2466 	"in a fashion requiring copyright permission, other than the making of an "
2467 	"exact copy.  The resulting work is called a \"modified version\" of the "
2468 	"earlier work or a work \"based on\" the earlier work.")
2469 CODE (U"")
2470 CODE (U"A \"covered work\" means either the unmodified Program or a work based "
2471 	"on the Program.")
2472 CODE (U"")
2473 CODE (U"To \"propagate\" a work means to do anything with it that, without "
2474 	"permission, would make you directly or secondarily liable for "
2475 	"infringement under applicable copyright law, except executing it on a "
2476 	"computer or modifying a private copy.  Propagation includes copying, "
2477 	"distribution (with or without modification), making available to the "
2478 	"public, and in some countries other activities as well.")
2479 CODE (U"")
2480 CODE (U"To \"convey\" a work means any kind of propagation that enables other "
2481 	"parties to make or receive copies.  Mere interaction with a user through "
2482 	"a computer network, with no transfer of a copy, is not conveying.")
2483 CODE (U"")
2484 CODE (U"An interactive user interface displays \"Appropriate Legal Notices\" "
2485 	"to the extent that it includes a convenient and prominently visible "
2486 	"feature that (1) displays an appropriate copyright notice, and (2) "
2487 	"tells the user that there is no warranty for the work (except to the "
2488 	"extent that warranties are provided), that licensees may convey the "
2489 	"work under this License, and how to view a copy of this License.  If "
2490 	"the interface presents a list of user commands or options, such as a "
2491 	"menu, a prominent item in the list meets this criterion.")
2492 CODE (U"")
2493 CODE (U"1. Source Code.")
2494 CODE (U"")
2495 CODE (U"The \"source code\" for a work means the preferred form of the work "
2496 	"for making modifications to it.  \"Object code\" means any non-source "
2497 	"form of a work.")
2498 CODE (U"")
2499 CODE (U"A \"Standard Interface\" means an interface that either is an official "
2500 	"standard defined by a recognized standards body, or, in the case of "
2501 	"interfaces specified for a particular programming language, one that "
2502 	"is widely used among developers working in that language.")
2503 CODE (U"")
2504 CODE (U"The \"System Libraries\" of an executable work include anything, other "
2505 	"than the work as a whole, that (a) is included in the normal form of "
2506 	"packaging a Major Component, but which is not part of that Major "
2507 	"Component, and (b) serves only to enable use of the work with that "
2508 	"Major Component, or to implement a Standard Interface for which an "
2509 	"implementation is available to the public in source code form.  A "
2510 	"\"Major Component\", in this context, means a major essential component "
2511 	"(kernel, window system, and so on) of the specific operating system "
2512 	"(if any) on which the executable work runs, or a compiler used to "
2513 	"produce the work, or an object code interpreter used to run it.")
2514 CODE (U"")
2515 CODE (U"The \"Corresponding Source\" for a work in object code form means all "
2516 	"the source code needed to generate, install, and (for an executable "
2517 	"work) run the object code and to modify the work, including scripts to "
2518 	"control those activities.  However, it does not include the work's "
2519 	"System Libraries, or general-purpose tools or generally available free "
2520 	"programs which are used unmodified in performing those activities but "
2521 	"which are not part of the work.  For example, Corresponding Source "
2522 	"includes interface definition files associated with source files for "
2523 	"the work, and the source code for shared libraries and dynamically "
2524 	"linked subprograms that the work is specifically designed to require, "
2525 	"such as by intimate data communication or control flow between those "
2526 	"subprograms and other parts of the work.")
2527 CODE (U"")
2528 CODE (U"The Corresponding Source need not include anything that users "
2529 	"can regenerate automatically from other parts of the Corresponding "
2530 	"Source.")
2531 CODE (U"")
2532 CODE (U"The Corresponding Source for a work in source code form is that "
2533 	"same work.")
2534 CODE (U"")
2535 CODE (U"2. Basic Permissions.")
2536 CODE (U"")
2537 CODE (U"All rights granted under this License are granted for the term of "
2538 	"copyright on the Program, and are irrevocable provided the stated "
2539 	"conditions are met.  This License explicitly affirms your unlimited "
2540 	"permission to run the unmodified Program.  The output from running a "
2541 	"covered work is covered by this License only if the output, given its "
2542 	"content, constitutes a covered work.  This License acknowledges your "
2543 	"rights of fair use or other equivalent, as provided by copyright law.")
2544 CODE (U"")
2545 CODE (U"You may make, run and propagate covered works that you do not "
2546 	"convey, without conditions so long as your license otherwise remains "
2547 	"in force.  You may convey covered works to others for the sole purpose "
2548 	"of having them make modifications exclusively for you, or provide you "
2549 	"with facilities for running those works, provided that you comply with "
2550 	"the terms of this License in conveying all material for which you do "
2551 	"not control copyright.  Those thus making or running the covered works "
2552 	"for you must do so exclusively on your behalf, under your direction "
2553 	"and control, on terms that prohibit them from making any copies of "
2554 	"your copyrighted material outside their relationship with you.")
2555 CODE (U"")
2556 CODE (U"Conveying under any other circumstances is permitted solely under "
2557 	"the conditions stated below.  Sublicensing is not allowed; section 10 "
2558 	"makes it unnecessary.")
2559 CODE (U"")
2560 CODE (U"3. Protecting Users' Legal Rights From Anti-Circumvention Law.")
2561 CODE (U"")
2562 CODE (U"No covered work shall be deemed part of an effective technological "
2563 	"measure under any applicable law fulfilling obligations under article "
2564 	"11 of the WIPO copyright treaty adopted on 20 December 1996, or "
2565 	"similar laws prohibiting or restricting circumvention of such "
2566 	"measures.")
2567 CODE (U"")
2568 CODE (U"When you convey a covered work, you waive any legal power to forbid "
2569 	"circumvention of technological measures to the extent such circumvention "
2570 	"is effected by exercising rights under this License with respect to "
2571 	"the covered work, and you disclaim any intention to limit operation or "
2572 	"modification of the work as a means of enforcing, against the work's "
2573 	"users, your or third parties' legal rights to forbid circumvention of "
2574 	"technological measures.")
2575 CODE (U"")
2576 CODE (U"4. Conveying Verbatim Copies.")
2577 CODE (U"")
2578 CODE (U"You may convey verbatim copies of the Program's source code as you "
2579 	"receive it, in any medium, provided that you conspicuously and "
2580 	"appropriately publish on each copy an appropriate copyright notice; "
2581 	"keep intact all notices stating that this License and any "
2582 	"non-permissive terms added in accord with section 7 apply to the code; "
2583 	"keep intact all notices of the absence of any warranty; and give all "
2584 	"recipients a copy of this License along with the Program.")
2585 CODE (U"")
2586 CODE (U"You may charge any price or no price for each copy that you convey, "
2587 	"and you may offer support or warranty protection for a fee.")
2588 CODE (U"")
2589 CODE (U"5. Conveying Modified Source Versions.")
2590 CODE (U"")
2591 CODE (U"You may convey a work based on the Program, or the modifications to "
2592 	"produce it from the Program, in the form of source code under the "
2593 	"terms of section 4, provided that you also meet all of these conditions:")
2594 CODE (U"")
2595 CODE1 (U"a) The work must carry prominent notices stating that you modified "
2596 	"it, and giving a relevant date.")
2597 CODE (U"")
2598 CODE1 (U"b) The work must carry prominent notices stating that it is "
2599 	"released under this License and any conditions added under section "
2600 	"7.  This requirement modifies the requirement in section 4 to "
2601 	"\"keep intact all notices\".")
2602 CODE (U"")
2603 CODE1 (U"c) You must license the entire work, as a whole, under this "
2604 	"License to anyone who comes into possession of a copy.  This "
2605 	"License will therefore apply, along with any applicable section 7 "
2606 	"additional terms, to the whole of the work, and all its parts, "
2607 	"regardless of how they are packaged.  This License gives no "
2608 	"permission to license the work in any other way, but it does not "
2609 	"invalidate such permission if you have separately received it.")
2610 CODE (U"")
2611 CODE1 (U"d) If the work has interactive user interfaces, each must display "
2612 	"Appropriate Legal Notices; however, if the Program has interactive "
2613 	"interfaces that do not display Appropriate Legal Notices, your "
2614 	"work need not make them do so.")
2615 CODE (U"")
2616 CODE (U"A compilation of a covered work with other separate and independent "
2617 	"works, which are not by their nature extensions of the covered work, "
2618 	"and which are not combined with it such as to form a larger program, "
2619 	"in or on a volume of a storage or distribution medium, is called an "
2620 	"\"aggregate\" if the compilation and its resulting copyright are not "
2621 	"used to limit the access or legal rights of the compilation's users "
2622 	"beyond what the individual works permit.  Inclusion of a covered work "
2623 	"in an aggregate does not cause this License to apply to the other "
2624 	"parts of the aggregate.")
2625 CODE (U"")
2626 CODE (U"6. Conveying Non-Source Forms.")
2627 CODE (U"")
2628 CODE (U"You may convey a covered work in object code form under the terms "
2629 	"of sections 4 and 5, provided that you also convey the "
2630 	"machine-readable Corresponding Source under the terms of this License, "
2631 	"in one of these ways:")
2632 CODE (U"")
2633 CODE1 (U"a) Convey the object code in, or embodied in, a physical product "
2634 	"(including a physical distribution medium), accompanied by the "
2635 	"Corresponding Source fixed on a durable physical medium "
2636 	"customarily used for software interchange.")
2637 CODE (U"")
2638 CODE1 (U"b) Convey the object code in, or embodied in, a physical product "
2639 	"(including a physical distribution medium), accompanied by a "
2640 	"written offer, valid for at least three years and valid for as "
2641 	"long as you offer spare parts or customer support for that product "
2642 	"model, to give anyone who possesses the object code either (1) a "
2643 	"copy of the Corresponding Source for all the software in the "
2644 	"product that is covered by this License, on a durable physical "
2645 	"medium customarily used for software interchange, for a price no "
2646 	"more than your reasonable cost of physically performing this "
2647 	"conveying of source, or (2) access to copy the "
2648 	"Corresponding Source from a network server at no charge.")
2649 CODE (U"")
2650 CODE1 (U"c) Convey individual copies of the object code with a copy of the "
2651 	"written offer to provide the Corresponding Source.  This "
2652 	"alternative is allowed only occasionally and noncommercially, and "
2653 	"only if you received the object code with such an offer, in accord "
2654 	"with subsection 6b.")
2655 CODE (U"")
2656 CODE1 (U"d) Convey the object code by offering access from a designated "
2657 	"place (gratis or for a charge), and offer equivalent access to the "
2658 	"Corresponding Source in the same way through the same place at no "
2659 	"further charge.  You need not require recipients to copy the "
2660 	"Corresponding Source along with the object code.  If the place to "
2661 	"copy the object code is a network server, the Corresponding Source "
2662 	"may be on a different server (operated by you or a third party) "
2663 	"that supports equivalent copying facilities, provided you maintain "
2664 	"clear directions next to the object code saying where to find the "
2665 	"Corresponding Source.  Regardless of what server hosts the "
2666 	"Corresponding Source, you remain obligated to ensure that it is "
2667 	"available for as long as needed to satisfy these requirements.")
2668 CODE (U"")
2669 CODE1 (U"e) Convey the object code using peer-to-peer transmission, provided "
2670 	"you inform other peers where the object code and Corresponding "
2671 	"Source of the work are being offered to the general public at no "
2672 	"charge under subsection 6d.")
2673 CODE (U"")
2674 CODE (U"A separable portion of the object code, whose source code is excluded "
2675 	"from the Corresponding Source as a System Library, need not be "
2676 	"included in conveying the object code work.")
2677 CODE (U"")
2678 CODE (U"A \"User Product\" is either (1) a \"consumer product\", which means any "
2679 	"tangible personal property which is normally used for personal, family, "
2680 	"or household purposes, or (2) anything designed or sold for incorporation "
2681 	"into a dwelling.  In determining whether a product is a consumer product, "
2682 	"doubtful cases shall be resolved in favor of coverage.  For a particular "
2683 	"product received by a particular user, \"normally used\" refers to a "
2684 	"typical or common use of that class of product, regardless of the status "
2685 	"of the particular user or of the way in which the particular user "
2686 	"actually uses, or expects or is expected to use, the product.  A product "
2687 	"is a consumer product regardless of whether the product has substantial "
2688 	"commercial, industrial or non-consumer uses, unless such uses represent "
2689 	"the only significant mode of use of the product.")
2690 CODE (U"")
2691 CODE (U"\"Installation Information\" for a User Product means any methods, "
2692 	"procedures, authorization keys, or other information required to install "
2693 	"and execute modified versions of a covered work in that User Product from "
2694 	"a modified version of its Corresponding Source.  The information must "
2695 	"suffice to ensure that the continued functioning of the modified object "
2696 	"code is in no case prevented or interfered with solely because "
2697 	"modification has been made.")
2698 CODE (U"")
2699 CODE (U"If you convey an object code work under this section in, or with, or "
2700 	"specifically for use in, a User Product, and the conveying occurs as "
2701 	"part of a transaction in which the right of possession and use of the "
2702 	"User Product is transferred to the recipient in perpetuity or for a "
2703 	"fixed term (regardless of how the transaction is characterized), the "
2704 	"Corresponding Source conveyed under this section must be accompanied "
2705 	"by the Installation Information.  But this requirement does not apply "
2706 	"if neither you nor any third party retains the ability to install "
2707 	"modified object code on the User Product (for example, the work has "
2708 	"been installed in ROM).")
2709 CODE (U"")
2710 CODE (U"The requirement to provide Installation Information does not include a "
2711 	"requirement to continue to provide support service, warranty, or updates "
2712 	"for a work that has been modified or installed by the recipient, or for "
2713 	"the User Product in which it has been modified or installed.  Access to a "
2714 	"network may be denied when the modification itself materially and "
2715 	"adversely affects the operation of the network or violates the rules and "
2716 	"protocols for communication across the network.")
2717 CODE (U"")
2718 CODE (U"Corresponding Source conveyed, and Installation Information provided, "
2719 	"in accord with this section must be in a format that is publicly "
2720 	"documented (and with an implementation available to the public in "
2721 	"source code form), and must require no special password or key for "
2722 	"unpacking, reading or copying.")
2723 CODE (U"")
2724 CODE (U"7. Additional Terms.")
2725 CODE (U"")
2726 CODE (U"\"Additional permissions\" are terms that supplement the terms of this "
2727 	"License by making exceptions from one or more of its conditions. "
2728 	"Additional permissions that are applicable to the entire Program shall "
2729 	"be treated as though they were included in this License, to the extent "
2730 	"that they are valid under applicable law.  If additional permissions "
2731 	"apply only to part of the Program, that part may be used separately "
2732 	"under those permissions, but the entire Program remains governed by "
2733 	"this License without regard to the additional permissions.")
2734 CODE (U"")
2735 CODE (U"When you convey a copy of a covered work, you may at your option "
2736 	"remove any additional permissions from that copy, or from any part of "
2737 	"it.  (Additional permissions may be written to require their own "
2738 	"removal in certain cases when you modify the work.)  You may place "
2739 	"additional permissions on material, added by you to a covered work, "
2740 	"for which you have or can give appropriate copyright permission.")
2741 CODE (U"")
2742 CODE (U"Notwithstanding any other provision of this License, for material you "
2743 	"add to a covered work, you may (if authorized by the copyright holders of "
2744 	"that material) supplement the terms of this License with terms:")
2745 CODE (U"")
2746 CODE1 (U"a) Disclaiming warranty or limiting liability differently from the "
2747 	"terms of sections 15 and 16 of this License; or")
2748 CODE (U"")
2749 CODE1 (U"b) Requiring preservation of specified reasonable legal notices or "
2750 	"author attributions in that material or in the Appropriate Legal "
2751 	"Notices displayed by works containing it; or")
2752 CODE (U"")
2753 CODE1 (U"c) Prohibiting misrepresentation of the origin of that material, or "
2754 	"requiring that modified versions of such material be marked in "
2755 	"reasonable ways as different from the original version; or")
2756 CODE (U"")
2757 CODE1 (U"d) Limiting the use for publicity purposes of names of licensors or "
2758 	"authors of the material; or")
2759 CODE (U"")
2760 CODE1 (U"e) Declining to grant rights under trademark law for use of some "
2761 	"trade names, trademarks, or service marks; or")
2762 CODE (U"")
2763 CODE1 (U"f) Requiring indemnification of licensors and authors of that "
2764 	"material by anyone who conveys the material (or modified versions of "
2765 	"it) with contractual assumptions of liability to the recipient, for "
2766 	"any liability that these contractual assumptions directly impose on "
2767 	"those licensors and authors.")
2768 CODE (U"")
2769 CODE (U"All other non-permissive additional terms are considered \"further "
2770 	"restrictions\" within the meaning of section 10.  If the Program as you "
2771 	"received it, or any part of it, contains a notice stating that it is "
2772 	"governed by this License along with a term that is a further "
2773 	"restriction, you may remove that term.  If a license document contains "
2774 	"a further restriction but permits relicensing or conveying under this "
2775 	"License, you may add to a covered work material governed by the terms "
2776 	"of that license document, provided that the further restriction does "
2777 	"not survive such relicensing or conveying.")
2778 CODE (U"")
2779 CODE (U"If you add terms to a covered work in accord with this section, you "
2780 	"must place, in the relevant source files, a statement of the "
2781 	"additional terms that apply to those files, or a notice indicating "
2782 	"where to find the applicable terms.")
2783 CODE (U"")
2784 CODE (U"Additional terms, permissive or non-permissive, may be stated in the "
2785 	"form of a separately written license, or stated as exceptions; "
2786 	"the above requirements apply either way.")
2787 CODE (U"")
2788 CODE (U"8. Termination.")
2789 CODE (U"")
2790 CODE (U"You may not propagate or modify a covered work except as expressly "
2791 	"provided under this License.  Any attempt otherwise to propagate or "
2792 	"modify it is void, and will automatically terminate your rights under "
2793 	"this License (including any patent licenses granted under the third "
2794 	"paragraph of section 11).")
2795 CODE (U"")
2796 CODE (U"However, if you cease all violation of this License, then your "
2797 	"license from a particular copyright holder is reinstated (a) "
2798 	"provisionally, unless and until the copyright holder explicitly and "
2799 	"finally terminates your license, and (b) permanently, if the copyright "
2800 	"holder fails to notify you of the violation by some reasonable means "
2801 	"prior to 60 days after the cessation.")
2802 CODE (U"")
2803 CODE (U"Moreover, your license from a particular copyright holder is "
2804 	"reinstated permanently if the copyright holder notifies you of the "
2805 	"violation by some reasonable means, this is the first time you have "
2806 	"received notice of violation of this License (for any work) from that "
2807 	"copyright holder, and you cure the violation prior to 30 days after "
2808 	"your receipt of the notice.")
2809 CODE (U"")
2810 CODE (U"Termination of your rights under this section does not terminate the "
2811 	"licenses of parties who have received copies or rights from you under "
2812 	"this License.  If your rights have been terminated and not permanently "
2813 	"reinstated, you do not qualify to receive new licenses for the same "
2814 	"material under section 10.")
2815 CODE (U"")
2816 CODE (U"9. Acceptance Not Required for Having Copies.")
2817 CODE (U"")
2818 CODE (U"You are not required to accept this License in order to receive or "
2819 	"run a copy of the Program.  Ancillary propagation of a covered work "
2820 	"occurring solely as a consequence of using peer-to-peer transmission "
2821 	"to receive a copy likewise does not require acceptance.  However, "
2822 	"nothing other than this License grants you permission to propagate or "
2823 	"modify any covered work.  These actions infringe copyright if you do "
2824 	"not accept this License.  Therefore, by modifying or propagating a "
2825 	"covered work, you indicate your acceptance of this License to do so.")
2826 CODE (U"")
2827 CODE (U"10. Automatic Licensing of Downstream Recipients.")
2828 CODE (U"")
2829 CODE (U"Each time you convey a covered work, the recipient automatically "
2830 	"receives a license from the original licensors, to run, modify and "
2831 	"propagate that work, subject to this License.  You are not responsible "
2832 	"for enforcing compliance by third parties with this License.")
2833 CODE (U"")
2834 CODE (U"An \"entity transaction\" is a transaction transferring control of an "
2835 	"organization, or substantially all assets of one, or subdividing an "
2836 	"organization, or merging organizations.  If propagation of a covered "
2837 	"work results from an entity transaction, each party to that "
2838 	"transaction who receives a copy of the work also receives whatever "
2839 	"licenses to the work the party's predecessor in interest had or could "
2840 	"give under the previous paragraph, plus a right to possession of the "
2841 	"Corresponding Source of the work from the predecessor in interest, if "
2842 	"the predecessor has it or can get it with reasonable efforts.")
2843 CODE (U"")
2844 CODE (U"You may not impose any further restrictions on the exercise of the "
2845 	"rights granted or affirmed under this License.  For example, you may "
2846 	"not impose a license fee, royalty, or other charge for exercise of "
2847 	"rights granted under this License, and you may not initiate litigation "
2848 	"(including a cross-claim or counterclaim in a lawsuit) alleging that "
2849 	"any patent claim is infringed by making, using, selling, offering for "
2850 	"sale, or importing the Program or any portion of it.")
2851 CODE (U"")
2852 CODE (U"11. Patents.")
2853 CODE (U"")
2854 CODE (U"A \"contributor\" is a copyright holder who authorizes use under this "
2855 	"License of the Program or a work on which the Program is based.  The "
2856 	"work thus licensed is called the contributor's \"contributor version\".")
2857 CODE (U"")
2858 CODE (U"A contributor's \"essential patent claims\" are all patent claims "
2859 	"owned or controlled by the contributor, whether already acquired or "
2860 	"hereafter acquired, that would be infringed by some manner, permitted "
2861 	"by this License, of making, using, or selling its contributor version, "
2862 	"but do not include claims that would be infringed only as a "
2863 	"consequence of further modification of the contributor version.  For "
2864 	"purposes of this definition, \"control\" includes the right to grant "
2865 	"patent sublicenses in a manner consistent with the requirements of "
2866 	"this License.")
2867 CODE (U"")
2868 CODE (U"Each contributor grants you a non-exclusive, worldwide, royalty-free "
2869 	"patent license under the contributor's essential patent claims, to "
2870 	"make, use, sell, offer for sale, import and otherwise run, modify and "
2871 	"propagate the contents of its contributor version.")
2872 CODE (U"")
2873 CODE (U"In the following three paragraphs, a \"patent license\" is any express "
2874 	"agreement or commitment, however denominated, not to enforce a patent "
2875 	"(such as an express permission to practice a patent or covenant not to "
2876 	"sue for patent infringement).  To \"grant\" such a patent license to a "
2877 	"party means to make such an agreement or commitment not to enforce a "
2878 	"patent against the party.")
2879 CODE (U"")
2880 CODE (U"If you convey a covered work, knowingly relying on a patent license, "
2881 	"and the Corresponding Source of the work is not available for anyone "
2882 	"to copy, free of charge and under the terms of this License, through a "
2883 	"publicly available network server or other readily accessible means, "
2884 	"then you must either (1) cause the Corresponding Source to be so "
2885 	"available, or (2) arrange to deprive yourself of the benefit of the "
2886 	"patent license for this particular work, or (3) arrange, in a manner "
2887 	"consistent with the requirements of this License, to extend the patent "
2888 	"license to downstream recipients.  \"Knowingly relying\" means you have "
2889 	"actual knowledge that, but for the patent license, your conveying the "
2890 	"covered work in a country, or your recipient's use of the covered work "
2891 	"in a country, would infringe one or more identifiable patents in that "
2892 	"country that you have reason to believe are valid.")
2893 CODE (U"")
2894 CODE (U"If, pursuant to or in connection with a single transaction or "
2895 	"arrangement, you convey, or propagate by procuring conveyance of, a "
2896 	"covered work, and grant a patent license to some of the parties "
2897 	"receiving the covered work authorizing them to use, propagate, modify "
2898 	"or convey a specific copy of the covered work, then the patent license "
2899 	"you grant is automatically extended to all recipients of the covered "
2900 	"work and works based on it.")
2901 CODE (U"")
2902 CODE (U"A patent license is \"discriminatory\" if it does not include within "
2903 	"the scope of its coverage, prohibits the exercise of, or is "
2904 	"conditioned on the non-exercise of one or more of the rights that are "
2905 	"specifically granted under this License.  You may not convey a covered "
2906 	"work if you are a party to an arrangement with a third party that is "
2907 	"in the business of distributing software, under which you make payment "
2908 	"to the third party based on the extent of your activity of conveying "
2909 	"the work, and under which the third party grants, to any of the "
2910 	"parties who would receive the covered work from you, a discriminatory "
2911 	"patent license (a) in connection with copies of the covered work "
2912 	"conveyed by you (or copies made from those copies), or (b) primarily "
2913 	"for and in connection with specific products or compilations that "
2914 	"contain the covered work, unless you entered into that arrangement, "
2915 	"or that patent license was granted, prior to 28 March 2007.")
2916 CODE (U"")
2917 CODE (U"Nothing in this License shall be construed as excluding or limiting "
2918 	"any implied license or other defenses to infringement that may "
2919 	"otherwise be available to you under applicable patent law.")
2920 CODE (U"")
2921 CODE (U"12. No Surrender of Others' Freedom.")
2922 CODE (U"")
2923 CODE (U"If conditions are imposed on you (whether by court order, agreement or "
2924 	"otherwise) that contradict the conditions of this License, they do not "
2925 	"excuse you from the conditions of this License.  If you cannot convey a "
2926 	"covered work so as to satisfy simultaneously your obligations under this "
2927 	"License and any other pertinent obligations, then as a consequence you may "
2928 	"not convey it at all.  For example, if you agree to terms that obligate you "
2929 	"to collect a royalty for further conveying from those to whom you convey "
2930 	"the Program, the only way you could satisfy both those terms and this "
2931 	"License would be to refrain entirely from conveying the Program.")
2932 CODE (U"")
2933 CODE (U"13. Use with the GNU Affero General Public License.")
2934 CODE (U"")
2935 CODE (U"Notwithstanding any other provision of this License, you have "
2936 	"permission to link or combine any covered work with a work licensed "
2937 	"under version 3 of the GNU Affero General Public License into a single "
2938 	"combined work, and to convey the resulting work.  The terms of this "
2939 	"License will continue to apply to the part which is the covered work, "
2940 	"but the special requirements of the GNU Affero General Public License, "
2941 	"section 13, concerning interaction through a network will apply to the "
2942 	"combination as such.")
2943 CODE (U"")
2944 CODE (U"14. Revised Versions of this License.")
2945 CODE (U"")
2946 CODE (U"The Free Software Foundation may publish revised and/or new versions of "
2947 	"the GNU General Public License from time to time.  Such new versions will "
2948 	"be similar in spirit to the present version, but may differ in detail to "
2949 	"address new problems or concerns.")
2950 CODE (U"")
2951 CODE (U"Each version is given a distinguishing version number.  If the "
2952 	"Program specifies that a certain numbered version of the GNU General "
2953 	"Public License \"or any later version\" applies to it, you have the "
2954 	"option of following the terms and conditions either of that numbered "
2955 	"version or of any later version published by the Free Software "
2956 	"Foundation.  If the Program does not specify a version number of the "
2957 	"GNU General Public License, you may choose any version ever published "
2958 	"by the Free Software Foundation.")
2959 CODE (U"")
2960 CODE (U"If the Program specifies that a proxy can decide which future "
2961 	"versions of the GNU General Public License can be used, that proxy's "
2962 	"public statement of acceptance of a version permanently authorizes you "
2963 	"to choose that version for the Program.")
2964 CODE (U"")
2965 CODE (U"Later license versions may give you additional or different "
2966 	"permissions.  However, no additional obligations are imposed on any "
2967 	"author or copyright holder as a result of your choosing to follow a "
2968 	"later version.")
2969 CODE (U"")
2970 CODE (U"15. Disclaimer of Warranty.")
2971 CODE (U"")
2972 CODE (U"THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY "
2973 	"APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT "
2974 	"HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM \"AS IS\" WITHOUT WARRANTY "
2975 	"OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, "
2976 	"THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR "
2977 	"PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM "
2978 	"IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF "
2979 	"ALL NECESSARY SERVICING, REPAIR OR CORRECTION.")
2980 CODE (U"")
2981 CODE (U"16. Limitation of Liability.")
2982 CODE (U"")
2983 CODE (U"IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING "
2984 	"WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS "
2985 	"THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY "
2986 	"GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE "
2987 	"USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF "
2988 	"DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD "
2989 	"PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), "
2990 	"EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF "
2991 	"SUCH DAMAGES.")
2992 CODE (U"")
2993 CODE (U"17. Interpretation of Sections 15 and 16.")
2994 CODE (U"")
2995 CODE (U"If the disclaimer of warranty and limitation of liability provided "
2996 	"above cannot be given local legal effect according to their terms, "
2997 	"reviewing courts shall apply local law that most closely approximates "
2998 	"an absolute waiver of all civil liability in connection with the "
2999 	"Program, unless a warranty or assumption of liability accompanies a "
3000 	"copy of the Program in return for a fee.")
3001 CODE (U"")
3002 CODE (U"                     END OF TERMS AND CONDITIONS")
3003 CODE (U"")
3004 CODE (U"            How to Apply These Terms to Your New Programs")
3005 CODE (U"")
3006 CODE (U"If you develop a new program, and you want it to be of the greatest "
3007 	"possible use to the public, the best way to achieve this is to make it "
3008 	"free software which everyone can redistribute and change under these terms.")
3009 CODE (U"")
3010 CODE (U"To do so, attach the following notices to the program.  It is safest "
3011 	"to attach them to the start of each source file to most effectively "
3012 	"state the exclusion of warranty; and each file should have at least "
3013 	"the \"copyright\" line and a pointer to where the full notice is found.")
3014 CODE (U"")
3015 CODE1 (U"##<one line to give the program's name and a brief idea of what it does.>")
3016 CODE1 (U"##Copyright (C) <year>  <name of author>")
3017 CODE (U"")
3018 CODE1 (U"##This program is free software: you can redistribute it and/or modify "
3019 	"it under the terms of the GNU General Public License as published by "
3020 	"the Free Software Foundation, either version 3 of the License, or "
3021 	"(at your option) any later version.")
3022 CODE (U"")
3023 CODE1 (U"##This program is distributed in the hope that it will be useful, "
3024 	"but WITHOUT ANY WARRANTY; without even the implied warranty of "
3025 	"MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the "
3026 	"GNU General Public License for more details.")
3027 CODE (U"")
3028 CODE1 (U"##You should have received a copy of the GNU General Public License "
3029 	"along with this program.  If not, see <https://www.gnu.org/licenses/>.")
3030 CODE (U"")
3031 CODE1 (U"Also add information on how to contact you by electronic and paper mail.")
3032 CODE (U"")
3033 CODE (U"If the program does terminal interaction, make it output a short "
3034 	"notice like this when it starts in an interactive mode:")
3035 CODE (U"")
3036 CODE1 (U"##<program>  Copyright (C) <year>  <name of author>")
3037 CODE1 (U"##This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'.")
3038 CODE1 (U"##This is free software, and you are welcome to redistribute it")
3039 CODE1 (U"##under certain conditions; type `show c' for details.")
3040 CODE (U"")
3041 CODE1 (U"The hypothetical commands `show w' and `show c' should show the appropriate "
3042 	"parts of the General Public License.  Of course, your program's commands "
3043 	"might be different; for a GUI interface, you would use an \"about box\".")
3044 CODE (U"")
3045 CODE (U"You should also get your employer (if you work as a programmer) or school, "
3046 	"if any, to sign a \"copyright disclaimer\" for the program, if necessary. "
3047 	"For more information on this, and how to apply and follow the GNU GPL, see "
3048 	"<https://www.gnu.org/licenses/>.")
3049 CODE (U"")
3050 CODE (U"The GNU General Public License does not permit incorporating your program "
3051 	"into proprietary programs.  If your program is a subroutine library, you "
3052 	"may consider it more useful to permit linking proprietary applications with "
3053 	"the library.  If this is what you want to do, use the GNU Lesser General "
3054 	"Public License instead of this License.  But first, please read "
3055 	"<https://www.gnu.org/licenses/why-not-lgpl.html>.")
3056 MAN_END
3057 
3058 MAN_BEGIN (U"Praat menu", U"ppgb", 20161227)
3059 INTRO (U"The first menu in the @@Object window@. "
3060 	"In macOS, this menu is in the main menu bar along the top of the screen.")
3061 MAN_END
3062 
3063 MAN_BEGIN (U"Copy...", U"ppgb", 20111018)
3064 INTRO (U"One of the fixed buttons in the @@Object window@.")
3065 ENTRY (U"Availability")
3066 NORMAL (U"You can choose this command after selecting one object of any type.")
3067 ENTRY (U"Behaviour")
3068 NORMAL (U"The Object window copies the selected object, and all the data it contains, "
3069 	"to a new object, which will appear at the bottom of the List of Objects.")
3070 ENTRY (U"Example")
3071 NORMAL (U"If you select \"Sound hallo\" and click `Copy...', "
3072 	"a command window will appear, which prompts you for a name; "
3073 	"after you click OK, a new object will appear in the list, bearing that name.")
3074 MAN_END
3075 
3076 MAN_BEGIN (U"Draw menu", U"ppgb", 20010417)
3077 INTRO (U"A menu that occurs in the @@Dynamic menu@ for many objects.")
3078 NORMAL (U"This menu contains commands for drawing the object to the @@Picture window@, "
3079 	"which will allow you to print the drawing or to copy it to your word processor.")
3080 MAN_END
3081 
3082 MAN_BEGIN (U"Dynamic menu", U"ppgb", 20110131)
3083 INTRO (U"A column of buttons in the right-hand part of the @@Object window@, "
3084 	"plus the #Save menu in the Object window.")
3085 NORMAL (U"If you select one or more @objects in the list, "
3086 	"the possible actions that you can perform with the selected objects "
3087 	"will appear in the dynamic menu. "
3088 	"These actions can include viewing & editing, saving, drawing, "
3089 	"conversions to other types (including analysis and synthesis), and more.")
3090 ENTRY (U"Example of analysis:")
3091 NORMAL (U"Record a Sound, select it, and click on ##To Pitch...#. "
3092 	"This will create a new Pitch object and put it in the list of objects. "
3093 	"You can then edit, write, and draw this Pitch object.")
3094 ENTRY (U"Example of synthesis:")
3095 NORMAL (U"Create a #Speaker, create and edit an #Artword, and click on ##To Sound...#.")
3096 MAN_END
3097 
3098 MAN_BEGIN (U"View & Edit", U"ppgb", 20110128)
3099 INTRO (U"A command in the @@Dynamic menu@ of several types of @objects.")
3100 NORMAL (U"This command puts an @@Editors|editor@ window on the screen, which shows the contents of the selected object. "
3101 	"This window will allow your to view and modify the contents of this object.")
3102 MAN_END
3103 
3104 MAN_BEGIN (U"Extract visible formant contour", U"ppgb", 20030316)
3105 INTRO (U"One of the commands in the Formant menu of the @SoundEditor and the @TextGridEditor.")
3106 NORMAL (U"See @@Intro 5. Formant analysis@")
3107 MAN_END
3108 
3109 MAN_BEGIN (U"Extract visible intensity contour", U"ppgb", 20030316)
3110 INTRO (U"One of the commands in the Intensity menu of the @SoundEditor and the @TextGridEditor.")
3111 NORMAL (U"See @@Intro 6. Intensity analysis@")
3112 MAN_END
3113 
3114 MAN_BEGIN (U"Extract visible pitch contour", U"ppgb", 20030316)
3115 INTRO (U"One of the commands in the Pitch menu of the @SoundEditor and the @TextGridEditor.")
3116 NORMAL (U"See @@Intro 4. Pitch analysis@")
3117 MAN_END
3118 
3119 MAN_BEGIN (U"Extract visible spectrogram", U"ppgb", 20030316)
3120 INTRO (U"One of the commands in the Spectrogram menu of the @SoundEditor and the @TextGridEditor.")
3121 NORMAL (U"See @@Intro 3. Spectral analysis@")
3122 MAN_END
3123 
3124 MAN_BEGIN (U"FAQ (Frequently Asked Questions)", U"ppgb", 20071210)
3125 LIST_ITEM (U"@@FAQ: How to cite Praat")
3126 LIST_ITEM (U"@Unicode")
3127 LIST_ITEM (U"@@FAQ: Formant analysis")
3128 LIST_ITEM (U"@@FAQ: Pitch analysis")
3129 LIST_ITEM (U"@@FAQ: Spectrograms")
3130 LIST_ITEM (U"@@FAQ: Scripts")
3131 /* Hardware */
3132 /* Pitch: octave errors */
3133 MAN_END
3134 
3135 MAN_BEGIN (U"FAQ: Formant analysis", U"ppgb", 20030916)
3136 NORMAL (U"#Problem: I get different formant values if I choose to analyse 3 formants "
3137 	"than if I choose to analyse 4 formants.")
3138 NORMAL (U"Solution: the \"number of formants\" in formant analysis determines the "
3139 	"number of peaks with which the %entire spectrum is modelled. For an average "
3140 	"female voice, you should choose to analyse 5 formants in the region up to 5500 Hz, "
3141 	"even if you are interested only in the first three formants.")
3142 NORMAL (U"")
3143 NORMAL (U"#Problem: I often get only 1 formant in a region where I see clearly 2 formants "
3144 	"in the spectrogram.")
3145 NORMAL (U"This occurs mainly in back vowels (F1 and F2 close together) for male voices, "
3146 	"if the \"maximum formant\" is set to the standard of 5500 Hz, which is appropriate "
3147 	"for female voices. Set the \"maximum formant\" down to 5000 Hz. "
3148 	"No, Praat comes without a guarantee: the formant analysis is based on LPC, "
3149 	"and this comes with several assumptions as to what a speech spectrum is like.")
3150 NORMAL (U"")
3151 NORMAL (U"#Question: what algorithm is used for formant analysis?")
3152 NORMAL (U"Answer: see @@Sound: To Formant (burg)...@.")
3153 MAN_END
3154 
3155 MAN_BEGIN (U"FAQ: How to cite Praat", U"ppgb", 20140826)
3156 NORMAL (U"#Question: how do I cite Praat in my articles?")
3157 NORMAL (U"Answer: nowadays most journals allow you to cite computer programs and web sites. "
3158 	"The style approved by the American Psychological Association, "
3159 	"and therefore by many journals, is like the following "
3160 	"(change the dates and version number as needed):")
3161 #define xstr(s) str(s)
3162 #define str(s) #s
3163 NORMAL (U"Boersma, Paul & Weenink, David (" xstr(PRAAT_YEAR) "). "
3164 	"Praat: doing phonetics by computer [Computer program]. "
3165 	"Version " xstr(PRAAT_VERSION_STR) ", retrieved " xstr(PRAAT_DAY) " " xstr(PRAAT_MONTH) " " xstr(PRAAT_YEAR) " from http://www.praat.org/")
3166 NORMAL (U"If the journal does not allow you to cite a web site, then try:")
3167 NORMAL (U"Boersma, Paul (2001). Praat, a system for doing phonetics by computer. "
3168 	"%%Glot International% ##5:9/10#, 341-345.")
3169 NORMAL (U"This paper can be downloaded from Boersma's website.")
3170 MAN_END
3171 
3172 MAN_BEGIN (U"FAQ: Pitch analysis", U"ppgb", 20060913)
3173 NORMAL (U"#Question: what algorithm is used for pitch analysis?")
3174 NORMAL (U"Answer: see @@Sound: To Pitch (ac)...@. The 1993 article is downloadable from "
3175 	"http://www.fon.hum.uva.nl/paul/")
3176 NORMAL (U"#Question: why does Praat consider my sound voiceless while I hear it as voiced?")
3177 NORMAL (U"There are at least five possibilities. Most of them can be checked by zooming in on the @waveform.")
3178 NORMAL (U"The first possibility is that the pitch has fallen below the @@pitch floor@. For instance, "
3179 	"your pitch floor could be 75 Hz but the English speaker produces creak at the end of the utterance. "
3180 	"Or your pitch floor could be 75 Hz but the Chinese speaker is in the middle of a third tone. "
3181 	"If this happens, it may help to lower the pitch floor to e.g. 40 Hz (@@Pitch settings...@), "
3182 	"although that may also smooth the pitch curve too much in other places.")
3183 NORMAL (U"The second possibility is that the pitch has moved too fast. This could happen at the end of a Chinese fourth tone, "
3184 	"which drops very fast. If this happens, it may help to use the \"optimize for voice analysis\" setting, "
3185 	"(@@Pitch settings...@), although Praat may then hallucinate pitches in other places that you would prefer to consider voiceless.")
3186 NORMAL (U"The third possibility is that the periods are very irregular, as in some pathological voices. "
3187 	"If you want to see a pitch in those cases, it may help to use the \"optimize for voice analysis\" setting "
3188 	"(@@Pitch settings...@). Or it may help to lower the \"voicing threshold\" setting (@@Advanced pitch settings...@) "
3189 	"to 0.25 (instead of the standard 0.45) or so.")
3190 NORMAL (U"The fourth possibility is that there is a lot of background noise, as in a recording on a busy street. "
3191 	"In such a case, it may help to lower the \"voicing threshold\" setting (@@Advanced pitch settings...@) "
3192 	"to 0.25 (instead of the standard 0.45) or so. The disadvantage of lowering this setting is that for non-noisy "
3193 	"recordings, Praat will become too eager to find voicing in some places that you would prefer to consider voiceless; "
3194 	"so make sure to set it back to 0.45 once you have finished analysing the noisy recordings.")
3195 NORMAL (U"The fifth possibility is that the part analysed as voiceless is much less loud than the rest of the sound, "
3196 	"or that the sound contains a loud noise elsewhere. This can be checked by zooming in on the part analysed as voiceless: "
3197 	"if Praat suddenly considers it as voiced, this is a sign that this part is much quieter than the rest. "
3198 	"To make Praat analyse this part as voiced, you can lower the \"silence threshold\" setting to 0.01 "
3199 	"(instead of the standard 0.03) or so. The disadvantage of lowering this setting is that Praat may start to consider "
3200 	"some distant background sounds (and quiet echos, for instance) as voiced.")
3201 NORMAL (U"#Question: why do I get different results for the maximum pitch if...?")
3202 NORMAL (U"If you select a Sound and choose @@Sound: To Pitch...@, the time step will usually "
3203 	"be 0.01 seconds. The resulting @Pitch object will have values for times that are "
3204 	"0.01 seconds apart. If you then click Info or choose ##Get maximum pitch# from the #Query menu, "
3205 	"the result is based on those time points. By contrast, if you choose ##Get maximum pitch# "
3206 	"from the #Pitch menu in the SoundEditor window, the result will be based on the visible points, "
3207 	"of which there tend to be a hundred in the visible window. These different time spacings will "
3208 	"lead to slightly different pitch contours.")
3209 NORMAL (U"If you choose ##Move cursor to maximum pitch#, then choose ##Get pitch# from the "
3210 	"#%Pitch menu, the result will be different again. This is because ##Get maximum pitch# "
3211 	"can do a parabolic interpolation around the maximum, whereas ##Get pitch#, not realizing "
3212 	"that the cursor is at a maximum, does a stupid linear interpolation, which tends to lead to "
3213 	"lower values.")
3214 MAN_END
3215 
3216 MAN_BEGIN (U"FAQ: Scripts", U"ppgb", 20140120)
3217 NORMAL (U"#Question: how do I do something to all the files in a directory?")
3218 NORMAL (U"Answer: look at @@Create Strings as file list...@.")
3219 NORMAL (U"")
3220 NORMAL (U"#Question: why doesn't the editor window react to my commands?")
3221 NORMAL (U"Your commands are probably something like:")
3222 CODE (U"Read from file: \"hello.wav\"")
3223 CODE (U"View & Edit")
3224 CODE (U"Zoom: 0.3, 0.5")
3225 NORMAL (U"Answer: Praat doesn't know it has to send the #Zoom command to the editor "
3226 	"window called ##14. Sound hello#. There could be several Sound editor windows on your "
3227 	"screen. According to @@Scripting 7.1. Scripting an editor from a shell script@, "
3228 	"you will have to say this explicitly:")
3229 CODE (U"Read from file: \"hello.wav\"")
3230 CODE (U"View & Edit")
3231 CODE (U"editor: \"Sound hello\"")
3232 CODE (U"Zoom: 0.3, 0.5")
3233 NORMAL (U"")
3234 NORMAL (U"#Problem: a line like \"Number = 1\" does not work.")
3235 NORMAL (U"Solution: names of variables should start with a lower-case letter.")
3236 NORMAL (U"")
3237 NORMAL (U"#Question: why do names of variables have to start with a lower-case letter? "
3238 	"I would like to do things like \"F0 = Get mean pitch\".")
3239 NORMAL (U"Answer (using the shorthand script syntax): Praat scripts combine button commands with things that only occur "
3240 	"in scripts. Button commands always start with a capital letter, e.g. \"Play\". "
3241 	"Script commands always start with lower case, e.g. \"echo Hello\". "
3242 	"A minimal pair is \"select\", which simulates a mouse click in the object list, "
3243 	"versus \"Select...\", which sets the selection in editor windows. Variable names "
3244 	"that start with a capital letter would be rather ambiguous in assignments, "
3245 	"as in \"x = Get\", where \"Get\" would be a variable, versus \"x = Get mean\", "
3246 	"where \"Get mean\" is a button command. To prevent this, Praat enforces "
3247 	"a rigorous lower-case/upper-case distinction.")
3248 NORMAL (U"")
3249 NORMAL (U"#Question: how do I convert a number into a string?")
3250 NORMAL (U"Answer: a\\$  = string\\$  (a)")
3251 NORMAL (U"#Question: how do I convert a string into a number?")
3252 NORMAL (U"Answer: a = number (a\\$ )")
3253 MAN_END
3254 
3255 MAN_BEGIN (U"FAQ: Spectrograms", U"ppgb", 20030916)
3256 NORMAL (U"#Problem: the background is grey instead of white (too little contrast)")
3257 NORMAL (U"Solution: reduce the \"dynamic range\" in the spectrogram settings. The standard value is 50 dB, "
3258 	"which is fine for detecting small things like plosive voicing in well recorded speech. "
3259 	"For gross features like vowel formants, or for noisy speech, you may want to change the dynamic range "
3260 	"to 40 or even 30 dB.")
3261 MAN_END
3262 
3263 MAN_BEGIN (U"File menu", U"ppgb", 20021204)
3264 INTRO (U"One of the menus in all @editors, in the @manual, and in the @@Picture window@.")
3265 MAN_END
3266 
3267 MAN_BEGIN (U"Filtering", U"ppgb", 20100324)
3268 INTRO (U"This tutorial describes the use of filtering techniques in Praat. "
3269 	"It assumes you are familiar with the @Intro.")
3270 ENTRY (U"Frequency-domain filtering")
3271 NORMAL (U"Modern computer techniques make possible an especially simple batch filtering method: "
3272 	"multiplying the complex spectrum in the frequency domain by any real-valued filter function. "
3273 	"This leads to a zero phase shift for each frequency component. The impulse response is symmetric "
3274 	"in the time domain, which also means that the filter is %acausal: the filtered signal will show components "
3275 	"before they start in the original.")
3276 LIST_ITEM (U"• @@Spectrum: Filter (pass Hann band)...@")
3277 LIST_ITEM (U"• @@Spectrum: Filter (stop Hann band)...@")
3278 LIST_ITEM (U"• @@Sound: Filter (pass Hann band)...@")
3279 LIST_ITEM (U"• @@Sound: Filter (stop Hann band)...@")
3280 LIST_ITEM (U"• @@Sound: Filter (formula)...@")
3281 NORMAL (U"Spectro-temporal:")
3282 LIST_ITEM (U"• @@band filtering in the frequency domain@")
3283 ENTRY (U"Fast time-domain filtering")
3284 NORMAL (U"Some very fast Infinite Impulse Response (IIR) filters can be defined in the time domain. "
3285 	"These include recursive all-pole filters and pre-emphasis. These filters are causal but have non-zero phase shifts. "
3286 	"There are versions that create new Sound objects:")
3287 LIST_ITEM (U"• @@Sound: Filter (one formant)...@")
3288 LIST_ITEM (U"• @@Sound: Filter (pre-emphasis)...@")
3289 LIST_ITEM (U"• @@Sound: Filter (de-emphasis)...@")
3290 NORMAL (U"And there are in-place versions, which modify the existing Sound objects:")
3291 LIST_ITEM (U"• @@Sound: Filter with one formant (in-place)...@")
3292 LIST_ITEM (U"• @@Sound: Pre-emphasize (in-place)...@")
3293 LIST_ITEM (U"• @@Sound: De-emphasize (in-place)...@")
3294 ENTRY (U"Convolution")
3295 NORMAL (U"A Finite Impulse Response (FIR) filter can be described as a sampled sound. "
3296 	"Filtering with such a filter amounts to a %#convolution of the original sound and the filter:")
3297 LIST_ITEM (U"• @@Sounds: Convolve...@")
3298 ENTRY (U"Described elsewhere")
3299 NORMAL (U"Described in the @@Source-filter synthesis@ tutorial:")
3300 LIST_ITEM (U"• @@Sound & Formant: Filter@")
3301 LIST_ITEM (U"• @@Sound & FormantGrid: Filter@")
3302 LIST_ITEM (U"• @@LPC & Sound: Filter...@")
3303 LIST_ITEM (U"• @@LPC & Sound: Filter (inverse)@")
3304 MAN_END
3305 
3306 MAN_BEGIN (U"Formants & LPC menu", U"ppgb", 20011107)
3307 INTRO (U"A menu that occurs in the @@Dynamic menu@ for a @Sound.")
3308 NORMAL (U"This menu contains commands for analysing the formant contours of the selected Sound:")
3309 LIST_ITEM (U"@@Sound: To Formant (burg)...")
3310 LIST_ITEM (U"@@Sound: To Formant (keep all)...")
3311 LIST_ITEM (U"@@Sound: To Formant (sl)...")
3312 LIST_ITEM (U"@@Sound: To LPC (autocorrelation)...")
3313 LIST_ITEM (U"@@Sound: To LPC (covariance)...")
3314 LIST_ITEM (U"@@Sound: To LPC (burg)...")
3315 LIST_ITEM (U"@@Sound: To LPC (marple)...")
3316 LIST_ITEM (U"@@Sound: To MFCC...")
3317 MAN_END
3318 
3319 MAN_BEGIN (U"Get first formant", U"ppgb", 20011107)
3320 INTRO (U"One of the commands in the @@Query menu@ of the @SoundEditor and the @TextGridEditor.")
3321 MAN_END
3322 
3323 MAN_BEGIN (U"Get pitch", U"ppgb", 20010417)
3324 INTRO (U"One of the commands in the @@Query menu@ of the @SoundEditor and the @TextGridEditor.")
3325 MAN_END
3326 
3327 MAN_BEGIN (U"Get second formant", U"ppgb", 20011107)
3328 INTRO (U"One of the commands in the @@Query menu@ of the @SoundEditor and the @TextGridEditor.")
3329 MAN_END
3330 
3331 MAN_BEGIN (U"Goodies", U"ppgb", 20050822)
3332 INTRO (U"The title of a submenu of the @@Praat menu@.")
3333 MAN_END
3334 
3335 MAN_BEGIN (U"Info", U"ppgb", 19980101)
3336 INTRO (U"One of the fixed buttons in the @@Object window@.")
3337 ENTRY (U"Availability")
3338 NORMAL (U"You can choose this command after choosing one object.")
3339 ENTRY (U"Purpose")
3340 NORMAL (U"To get some information about the selected object.")
3341 ENTRY (U"Behaviour")
3342 NORMAL (U"The information will appear in the @@Info window@.")
3343 MAN_END
3344 
3345 MAN_BEGIN (U"Info window", U"ppgb", 20030528)
3346 INTRO (U"A text window into which many query commands write their answers.")
3347 NORMAL (U"You can select text from this window and copy it to other places.")
3348 NORMAL (U"In a @@Praat script@, you can bypass the Info window by having a query command "
3349 	"writing directly into a script variable.")
3350 NORMAL (U"Apart from the @Info command, which writes general information about the selected object, "
3351 	"the following more specific commands also write into the Info window:")
3352 MAN_END
3353 
3354 MAN_BEGIN (U"Inspect", U"ppgb", 19960904)
3355 INTRO (U"One of the fixed buttons in the @@Object window@.")
3356 NORMAL (U"You can use this command after selecting one object in the list.")
3357 NORMAL (U"The contents of the selected object will become visible in a Data Editor. "
3358 	"You can then view and change the data in the object, "
3359 	"but beware: changing the data directly in this way may render them inconsistent.")
3360 NORMAL (U"Changes that you make to the data with another Editor (e.g., a SoundEditor), "
3361 	"or with the commands under #%Modify, "
3362 	"are immediately reflected in the top-level Data Editor; "
3363 	"any subeditors are destroyed, however, because they may now refer to invalid data.")
3364 NORMAL (U"Changes that you make to the data with a Data Editor, "
3365 	"are immediately reflected in any open type-specific Editors (e.g., a SoundEditor).")
3366 MAN_END
3367 
3368 MAN_BEGIN (U"Intro", U"ppgb", 20110131)
3369 INTRO (U"This is an introductory tutorial to Praat, a computer program "
3370 	"with which you can analyse, synthesize, and manipulate speech, "
3371 	"and create high-quality pictures for your articles and thesis. "
3372 	"You are advised to work through all of this tutorial.")
3373 NORMAL (U"You can read this tutorial sequentially with the help of the \"1 >\" and \"< 1\" buttons, "
3374 	"or go to the desired information by clicking on the blue links.")
3375 LIST_ITEM (U"@@Intro 1. How to get a sound@: "
3376 	"@@Intro 1.1. Recording a sound|record@, "
3377 	"@@Intro 1.2. Reading a sound from disk|read@, "
3378 	"@@Intro 1.3. Creating a sound from a formula|formula@.")
3379 LIST_ITEM (U"@@Intro 2. What to do with a sound@: "
3380 	"@@Intro 2.1. Saving a sound to disk|write@, "
3381 	"@@Intro 2.2. Viewing and editing a sound|view@.")
3382 LIST_ITEM (U"@@Intro 3. Spectral analysis")
3383 LIST_ITEM1 (U"spectrograms: @@Intro 3.1. Viewing a spectrogram|view@, "
3384 	"@@Intro 3.2. Configuring the spectrogram|configure@, "
3385 	"@@Intro 3.3. Querying the spectrogram|query@, "
3386 	"@@Intro 3.4. Printing the spectrogram|print@, "
3387 	"@@Intro 3.5. The Spectrogram object|the Spectrogram object@.")
3388 LIST_ITEM1 (U"spectral slices: @@Intro 3.6. Viewing a spectral slice|view@, "
3389 	"@@Intro 3.7. Configuring the spectral slice|configure@, "
3390 	"@@Intro 3.8. The Spectrum object|the Spectrum object@.")
3391 LIST_ITEM (U"@@Intro 4. Pitch analysis")
3392 LIST_ITEM1 (U"pitch contours: @@Intro 4.1. Viewing a pitch contour|view@, "
3393 	"@@Intro 4.2. Configuring the pitch contour|configure@, "
3394 	"@@Intro 4.3. Querying the pitch contour|query@, "
3395 	"@@Intro 4.4. Printing the pitch contour|print@, "
3396 	"@@Intro 4.5. The Pitch object|the Pitch object@.")
3397 LIST_ITEM (U"@@Intro 5. Formant analysis")
3398 LIST_ITEM1 (U"formant contours: @@Intro 5.1. Viewing formant contours|view@, "
3399 	"@@Intro 5.2. Configuring the formant contours|configure@, "
3400 	"@@Intro 5.3. Querying the formant contours|query@, "
3401 	"@@Intro 5.4. The Formant object|the Formant object@.")
3402 LIST_ITEM (U"@@Intro 6. Intensity analysis")
3403 LIST_ITEM1 (U"intensity contours: @@Intro 6.1. Viewing an intensity contour|view@, "
3404 	"@@Intro 6.2. Configuring the intensity contour|configure@, "
3405 	"@@Intro 6.3. Querying the intensity contour|query@, "
3406 	"@@Intro 6.4. The Intensity object|the Intensity object@.")
3407 LIST_ITEM (U"@@Intro 7. Annotation")
3408 LIST_ITEM (U"@@Intro 8. Manipulation@: of "
3409 	"@@Intro 8.1. Manipulation of pitch|pitch@, "
3410 	"@@Intro 8.2. Manipulation of duration|duration@, "
3411 	"@@Intro 8.3. Manipulation of intensity|intensity@, "
3412 	"@@Intro 8.4. Manipulation of formants|formants@.")
3413 NORMAL (U"There are also more specialized tutorials:")
3414 LIST_ITEM (U"Phonetics:")
3415 LIST_ITEM1 (U"• Voice analysis (jitter, shimmer, noise): @Voice")
3416 LIST_ITEM1 (U"• Listening experiments: @@ExperimentMFC@")
3417 LIST_ITEM1 (U"• @@Sound files@")
3418 LIST_ITEM1 (U"• @@Filtering@")
3419 LIST_ITEM1 (U"• @@Source-filter synthesis@")
3420 LIST_ITEM1 (U"• @@Articulatory synthesis@")
3421 LIST_ITEM (U"Learning:")
3422 LIST_ITEM1 (U"• @@Feedforward neural networks@")
3423 LIST_ITEM1 (U"• @@OT learning@")
3424 LIST_ITEM (U"Statistics:")
3425 LIST_ITEM1 (U"• @@Principal component analysis@")
3426 LIST_ITEM1 (U"• @@Multidimensional scaling@")
3427 LIST_ITEM1 (U"• @@Discriminant analysis@")
3428 LIST_ITEM (U"General:")
3429 LIST_ITEM1 (U"• @@Printing@")
3430 LIST_ITEM1 (U"• @@Scripting@")
3431 LIST_ITEM1 (U"• @@Demo window@")
3432 ENTRY (U"The authors")
3433 NORMAL (U"The Praat program was created by Paul Boersma and David Weenink of "
3434 	"the Institute of Phonetics Sciences of the University of Amsterdam. "
3435 	"Home page: ##http://www.praat.org# or ##http://www.fon.hum.uva.nl/praat/#.")
3436 NORMAL (U"For questions and suggestions, mail to the Praat discussion list, "
3437 	"which is reachable from the Praat home page, or directly to ##paul.boersma\\@ uva.nl#.")
3438 MAN_END
3439 
3440 MAN_BEGIN (U"Intro 1. How to get a sound", U"ppgb", 20021212)
3441 INTRO (U"Most of the things most people do with Praat start with a sound. "
3442 	"There are at least three ways to get a sound:")
3443 LIST_ITEM (U"@@Intro 1.1. Recording a sound")
3444 LIST_ITEM (U"@@Intro 1.2. Reading a sound from disk")
3445 LIST_ITEM (U"@@Intro 1.3. Creating a sound from a formula")
3446 MAN_END
3447 
3448 MAN_BEGIN (U"Intro 1.1. Recording a sound", U"ppgb", 20201120)
3449 INTRO (U"To record a speech sound into Praat, you need a computer with a microphone.")
3450 NORMAL (U"To record from the microphone, perform the following steps:")
3451 LIST_ITEM (U"1. Choose @@Record mono Sound...@ from the @@New menu@ in the @@Object window@. "
3452 	"A @SoundRecorder window will appear on your screen.")
3453 LIST_ITEM (U"2. On the left in the SoundRecorder window, choose the appropriate input device, e.g. choose ##Internal microphone#. "
3454 	"(On Windows, instead right-click the loudspeaker symbol in the Start bar; see @SoundRecorder for more details.)")
3455 LIST_ITEM (U"3. Use the #Record and #Stop buttons to record a few seconds of your speech.")
3456 LIST_ITEM (U"4. Use the #Play button to hear what you have recorded.")
3457 LIST_ITEM (U"5. Repeat steps 3 and 4 until you are satisfied with your recording.")
3458 LIST_ITEM (U"6. Click the ##Save to list# button. Your recording will now appear in the Object window, "
3459 	"where it will be called \"Sound sound\".")
3460 LIST_ITEM (U"7. You can now close the SoundRecorder window.")
3461 LIST_ITEM (U"8. When you saved your sound to the Object window, some buttons appeared in that window. "
3462 	"These buttons show you what you can do with the sound. Try the #Play and @@View & Edit@ buttons.")
3463 NORMAL (U"For more information on recording, see the @SoundRecorder manual page.")
3464 MAN_END
3465 
3466 MAN_BEGIN (U"Intro 1.2. Reading a sound from disk", U"ppgb", 20041126)
3467 INTRO (U"Apart from recording a new sound from a microphone, you could read an existing sound file from your disk.")
3468 NORMAL (U"With @@Read from file...@ from the @@Open menu@, "
3469 	"Praat will be able to read most standard types of sound files, e.g. WAV files. "
3470 	"They will appear as @Sound objects in the Object window. For instance, if you open the file ##hello.wav#, "
3471 	"an object called \"Sound hello\" will appear in the list.")
3472 NORMAL (U"If you do not have a sound file on your disk, you can download a WAV file (or so) from the Internet, "
3473 	"then read that file into Praat with ##Read from file...#.")
3474 MAN_END
3475 
3476 MAN_BEGIN (U"Intro 1.3. Creating a sound from a formula", U"ppgb", 20070225)
3477 INTRO (U"If you have no microphone, no sound files on disk, and no access to the Internet, "
3478 	"you could still create a sound with @@Create Sound from formula...@ from the @@New menu@.")
3479 MAN_END
3480 
3481 MAN_BEGIN (U"Intro 2. What to do with a sound", U"ppgb", 20110131)
3482 INTRO (U"As soon as you have a @Sound in the @@List of Objects@, "
3483 	"the buttons in the @@Dynamic menu@ (the right-hand part of the @@Object window@) "
3484 	"will show you what you can do with it.")
3485 LIST_ITEM (U"@@Intro 2.1. Saving a sound to disk")
3486 LIST_ITEM (U"@@Intro 2.2. Viewing and editing a sound")
3487 MAN_END
3488 
3489 MAN_BEGIN (U"Intro 2.1. Saving a sound to disk", U"ppgb", 20110131)
3490 INTRO (U"There are several ways to write a sound to disk.")
3491 NORMAL (U"First, the @@File menu@ of the @SoundRecorder window contains commands to save the left "
3492 	"channel, the right channel, or both channels of the recorded sound to any of four standard types "
3493 	"of sound files (WAV, AIFC, NeXT/Sun, NIST). These four file types are all equally good for Praat: "
3494 	"Praat will handle them equally well on every computer. The first three of these types will "
3495 	"also be recognized by nearly all other sound-playing programs.")
3496 NORMAL (U"Then, once you have a @Sound object in the @@List of Objects@, "
3497 	"you can save it in several formats with the commands in the @@Save menu@. "
3498 	"Again, the WAV, AIFF, AIFC, NeXT/Sun, and NIST formats are equally fine.")
3499 NORMAL (U"For more information, see the @@Sound files@ tutorial.")
3500 MAN_END
3501 
3502 MAN_BEGIN (U"Intro 2.2. Viewing and editing a sound", U"ppgb", 20110212)
3503 NORMAL (U"To see the wave form of a @Sound that is in the list of objects, "
3504 	"select that Sound and click @@View & Edit@. A @SoundEditor window will appear on your screen. "
3505 	"You see a waveform (or two waveforms, if you have a stereo sound) and probably some \"analyses\" below it. "
3506 	"You can zoom in and scroll to see the various parts of the sound in detail. "
3507 	"You can select a part of the sound by dragging with the mouse. "
3508 	"To play a part of the sound, click on any of the rectangles below it. "
3509 	"To move a selected part of the sound to another location, use #Cut and #Paste from the #Edit menu. "
3510 	"You can open sound windows for more than one sound, and then cut, copy, and paste between the sounds, "
3511 	"just as you are used to do with text and pictures in word processing programs.")
3512 NORMAL (U"If your sound file is longer than a couple of minutes, "
3513 	"or if you want to see and listen to both channels of a stereo sound, "
3514 	"you may prefer to open it with @@Open long sound file...@. "
3515 	"This puts a @LongSound object into the list. In this way, most of the sound will stay in the file on disk, "
3516 	"and at most 60 seconds will be read into memory each time you play or view a part of it. "
3517 	"To change these 60 seconds to something else, e.g. 500 seconds, choose ##LongSound prefs...# from the #Preferences submenu.")
3518 MAN_END
3519 
3520 MAN_BEGIN (U"Intro 3. Spectral analysis", U"ppgb", 20070905)
3521 INTRO (U"This section describes how you can analyse the spectral content of an existing sound. "
3522 	"You will learn how to use %spectrograms and %%spectral slices%.")
3523 LIST_ITEM (U"@@Intro 3.1. Viewing a spectrogram")
3524 LIST_ITEM (U"@@Intro 3.2. Configuring the spectrogram")
3525 LIST_ITEM (U"@@Intro 3.3. Querying the spectrogram")
3526 LIST_ITEM (U"@@Intro 3.4. Printing the spectrogram")
3527 LIST_ITEM (U"@@Intro 3.5. The Spectrogram object")
3528 LIST_ITEM (U"@@Intro 3.6. Viewing a spectral slice")
3529 LIST_ITEM (U"@@Intro 3.7. Configuring the spectral slice")
3530 LIST_ITEM (U"@@Intro 3.8. The Spectrum object")
3531 MAN_END
3532 
3533 MAN_BEGIN (U"Intro 3.1. Viewing a spectrogram", U"ppgb", 20110128)
3534 INTRO (U"To see the spectral content of a sound as a function of time, "
3535 	"select a @Sound or @LongSound object and choose @@View & Edit@. "
3536 	"A @SoundEditor or @LongSoundEditor window will appear on your screen. "
3537 	"In the entire bottom half of this window you will see a greyish image, which is called a %spectrogram. "
3538 	"If you do not see it, choose @@Show spectrogram@ from the #Spectrogram menu.")
3539 NORMAL (U"The spectrogram is a @@spectro-temporal representation@ of the sound. "
3540 	"The horizontal direction of the spectrogram represents @time, the vertical direction represents @frequency. "
3541 	"The time scale of the spectrogram is the same as that of the waveform, so the spectrogram reacts "
3542 	"to your zooming and scrolling. "
3543 	"To the left of the spectrogram, you see the frequency scale. The frequency at the bottom of the spectrogram "
3544 	"is usually 0 Hz (hertz, cps, cycles per second), and a common value for the frequency at the top is 5000 Hz.")
3545 NORMAL (U"Darker parts of the spectrogram mean higher energy densities, lighter parts mean lower energy densities. "
3546 	"If the spectrogram has a dark area around a time of 1.2 seconds and a frequency of 4000 Hz, "
3547 	"this means that the sound has lots of energy for those high frequencies at that time. "
3548 	"For many examples of spectrograms of speech sounds, see the textbook by @@Ladefoged (2001)@ and "
3549 	"the reference work by @@Ladefoged & Maddieson (1996)@.")
3550 NORMAL (U"To see what time and frequency a certain part of the spectrogram is associated with, "
3551 	"just click on the spectrogram and you will see the vertical time cursor showing the time above "
3552 	"the waveform and the horizontal frequency cursor showing the frequency to the left of the spectrogram. "
3553 	"This is one of the ways to find the %formant frequencies for vowels, or the main spectral peaks "
3554 	"for fricatives.")
3555 ENTRY (U"Hey, there are white vertical stripes at the edges!")
3556 NORMAL (U"This is normal. Spectral analysis requires an %%analysis window% of a certain duration. "
3557 	"For instance, if Praat wants to know the spectrum at 1.342 seconds, it needs to include information "
3558 	"about the signal in a 10-milliseconds window around this time point, i.e., Praat will use "
3559 	"signal information about all times between 1.337 and 1.347 seconds. At the very edges of the sound, "
3560 	"this information is not available: "
3561 	"if the sound runs from 0 to 1.8 seconds, no spectrum can be computed between 0 and 0.005 "
3562 	"seconds or between 1.795 and 1.800 seconds. Hence the white stripes. If you do not see them "
3563 	"immediately when you open the sound, zoom in on the beginning or end of the sound.")
3564 NORMAL (U"When you zoom in on the middle of the sound (or anywhere not near the edges), the white stripes vanish. "
3565 	"Suddenly you see only the time stretch between 0.45 and 1.35 seconds, for instance. "
3566 	"But Praat did not forget what the signal looks like just outside the edges of this time window. "
3567 	"To display a spectrogram from 0.45 to 1.35 seconds, Praat will use information from the wave form "
3568 	"between 0.445 and 1.355 seconds, and if this is available, you will see no white stripes at the edges of the window.")
3569 ENTRY (U"Hey, it changes when I scroll!")
3570 NORMAL (U"This is normal as well, especially for long windows. If your visible time window is 20 seconds long, "
3571 	"and the window takes up 1000 screen pixels horizontally, "
3572 	"then you might think that every one-pixel-wide vertical line should represent the spectrum of 20 milliseconds of sound. "
3573 	"But for reasons of computation speed, Praat will only show the spectrum of the part of the sound "
3574 	"that lies around the centre of those 20 milliseconds, "
3575 	"not the average or sum of all the spectra in those 20 milliseconds. "
3576 	"This %undersampling of the underlying spectrogram is different from what happens in the drawing of the wave form, "
3577 	"where a vertical black line connects the minimum and maximum amplitude of all the samples that fall inside a "
3578 	"screen pixel. We cannot do something similar for spectrograms. And since scrolling goes by fixed time steps "
3579 	"(namely, 5 percent of the duration of the visible window), rather than by a whole number of screen pixels, "
3580 	"the centres of the pixels will fall in different parts of the spectrogram with each scroll. "
3581 	"Hence the apparent changes. If your visible window is shorter than a couple of seconds, "
3582 	"the scrolling spectrogram will appear much smoother.")
3583 NORMAL (U"The darkness of the spectrogram will also change when you scroll, because the visible part with the most "
3584 	"energy is defined as black. When a very energetic part of the signal scrolls out of view, the spectrogram "
3585 	"will turn darker. The next section will describe a way to switch this off.")
3586 MAN_END
3587 
3588 MAN_BEGIN (U"Intro 3.2. Configuring the spectrogram", U"ppgb", 20110128)
3589 NORMAL (U"With @@Spectrogram settings...@ from the #Spectrogram menu, "
3590 	"you can determine how the spectrogram is computed and how it is displayed. "
3591 	"These settings will be remembered across Praat sessions. "
3592 	"All these settings have standard values (\"factory settings\"), which appear "
3593 	"when you click ##Standards#.")
3594 TAG (U"%%View range% (Hz)")
3595 DEFINITION (U"the range of frequencies to display. The standard is 0 Hz at the bottom and 5000 Hz at the top. "
3596 	"If this maximum frequency is higher than the Nyquist frequency of the Sound "
3597 	"(which is half its sampling frequency), some values in the spectrogram will be zero, and the higher "
3598 	"frequencies will be drawn in white. You can see this if you record a Sound at 44100 Hz and set the "
3599 	"view range from 0 Hz to 25000 Hz.")
3600 TAG (U"%%Window length")
3601 DEFINITION (U"the duration of the analysis window. If this is 0.005 seconds (the standard), "
3602 	"Praat uses for each frame the part of the sound that lies between 0.0025 seconds before "
3603 	"and 0.0025 seconds after the centre of that frame "
3604 	"(for Gaussian windows, Praat actually uses a bit more than that). "
3605 	"The window length determines the %bandwidth of the spectral analysis, "
3606 	"i.e. the width of the horizontal line in the spectrogram of a pure sine wave (see below). "
3607 	"For a Gaussian window, the -3 dB bandwidth is 2*sqrt(6*ln(2))/(\\pi*%%Window length%), "
3608 	"or 1.2982804 / %%Window length%. "
3609 	"To get a `broad-band' spectrogram (bandwidth 260 Hz), keep the standard window length of 5 ms; "
3610 	"to get a `narrow-band' spectrogram (bandwidth 43 Hz), set it to 30 ms (0.03 seconds). "
3611 	"The other window shapes give slightly different values.")
3612 TAG (U"%%Dynamic range% (dB)")
3613 DEFINITION (U"All values that are more than %%Dynamic range% dB below the maximum (perhaps after dynamic compression, "
3614 	"see @@Advanced spectrogram settings...@) "
3615 	"will be drawn in white. Values in-between have appropriate shades of grey. Thus, if the highest "
3616 	"peak in the spectrogram has a height of 30 dB/Hz, and the dynamic range is 50 dB (which is the standard value), "
3617 	"then values below -20 dB/Hz will be drawn in white, and values between -20 dB/Hz and 30 dB/Hz will be drawn "
3618 	"in various shades of grey.")
3619 ENTRY (U"The bandwidth")
3620 NORMAL (U"To see how the window length influences the bandwidth, "
3621 	"first create a 1000-Hz sine wave with @@Create Sound from formula...@ "
3622 	"by typing $$1/2 * sin (2*pi*1000*x)$ as the formula, then click ##View & Edit#. "
3623 	"The spectrogram will show a horizontal black line. "
3624 	"You can now vary the window length in the spectrogram settings and see how the thickness "
3625 	"of the lines varies. The line gets thinner if you raise the window length. "
3626 	"Apparently, if the analysis window comprises more periods of the wave, "
3627 	"the spectrogram can tell us the frequency of the wave with greater precision.")
3628 NORMAL (U"To see this more precisely, create a sum of two sine waves, with frequencies of 1000 and 1200 Hz. "
3629 	"the formula is $$1/4 * sin (2*pi*1000*x) + 1/4 * sin (2*pi*1200*x)$. In the editor, you will see "
3630 	"a single thick band if the analysis window is short (5 ms), and two separate bands if the analysis "
3631 	"window is long (30 ms). Apparently, the frequency resolution gets better with longer analysis windows.")
3632 NORMAL (U"So why don't we always use long analysis windows? The answer is that their time resolution is poor. "
3633 	"To see this, create a sound that consists of two sine waves and two short clicks. The formula is "
3634 	"$$0.02*(sin(2*pi*1000*x)+sin(2*pi*1200*x)) + (col=10000)+(col=10200)$. "
3635 	"If you view this sound, you can see that the two clicks will overlap "
3636 	"in time if the analysis window is long, and that the sine waves overlap in frequency if the "
3637 	"analysis window is short. Apparently, there is a trade-off between time resolution and "
3638 	"frequency resolution. One cannot know both the time and the frequency with great precision.")
3639 ENTRY (U"Advanced settings")
3640 NORMAL (U"The Spectrum menu also contains @@Advanced spectrogram settings...@.")
3641 MAN_END
3642 
3643 MAN_BEGIN (U"Advanced spectrogram settings...", U"ppgb", 20120531)
3644 ENTRY (U"Optimization")
3645 TAG (U"%%Number of time steps%")
3646 DEFINITION (U"the maximum number of points along the time window for which Praat has to compute "
3647 	"the spectrum. If your screen is not wider than 1200 pixels, then the standard of 1000 is "
3648 	"appropriate, since there is no point in computing more than one spectrum per one-pixel-wide vertical line. "
3649 	"If you have a really wide screen, you may see improvement if you raise this number to 1500.")
3650 TAG (U"%%Number of frequency steps%")
3651 DEFINITION (U"the maximum number of points along the frequency axis for which Praat has to compute "
3652 	"the spectrum. If your screen is not taller than 768 pixels, then the standard of 250 is "
3653 	"appropriate, since there is no point in computing more than one spectrum per one-pixel-height horizontal line. "
3654 	"If you have a really tall screen, you may see improvement if you raise this number.")
3655 NORMAL (U"For purposes of computation speed, Praat may decide to change the time step and the frequency step. "
3656 	"This is because the time step never needs to be smaller than 1/(8\\Vr\\pi) of the window length, "
3657 	"and the frequency step never needs to be smaller than (\\Vr\\pi)/8 of the inverse of the window length. "
3658 	"For instance, if the window length is 5 ms, "
3659 	"the actual time step will never be less than 5/(8\\Vr\\pi) = 0.353 ms, "
3660 	"and the actual frequency step will never be less than (\\Vr\\pi)/8/0.005 = 44.31 Hz.")
3661 ENTRY (U"Spectrogram analysis settings")
3662 TAG (U"%%Method")
3663 DEFINITION (U"there is currently only one method available in this window for computing a spectrum from "
3664 	"a sound: the Fourier transform.")
3665 TAG (U"%%Window shape")
3666 DEFINITION (U"the shape of the analysis window. To compute the spectrum at, say, 3.850 seconds, "
3667 	"samples that lie close to 3.850 seconds are given more weight than samples further away. "
3668 	"The relative extent to which each sample contributes to the spectrum is given by the window shape. "
3669 	"You can choose from: Gaussian, Square (none, rectangular), Hamming (raised sine-squared), "
3670 	"Bartlett (triangular), Welch (parabolic), and Hanning (sine-squared). "
3671 	"The Gaussian window is superior, as it gives no %sidelobes in your spectrogram (see below); "
3672 	"it analyzes a factor of 2 slower than the other window shapes, "
3673 	"because the analysis is actually performed on twice as many samples per frame.")
3674 ENTRY (U"Sidelobes; anybody wants to win a cake?")
3675 NORMAL (U"The Gaussian window is the only shape that we can consider seriously as a candidate for "
3676 	"the analysis window. To see this, create a 1000-Hz sine wave with @@Create Sound from formula...@ "
3677 	"by typing $$1/2 * sin (2*pi*1000*x)$ as the formula, then click ##View & Edit#. "
3678 	"If the window shape is Gaussian, the spectrogram will show a horizontal black line. "
3679 	"If the window shape is anything else, the spectrogram will show many horizontal grey lines (%sidelobes), "
3680 	"which do not represent anything that is available in the signal. They are artifacts of the "
3681 	"window shapes.")
3682 NORMAL (U"We include these other window shapes only for pedagogical purposes "
3683 	"and because the Hanning and Hamming windows have traditionally been used in other programs before "
3684 	"computers were as fast as they are now (a spectrogram is computed twice as fast "
3685 	"with these other windows). Several other programs still use these inferior window shapes, and you are "
3686 	"likely to run into people who claim that the Gaussian window has disadvantages. "
3687 	"We promise such people a large cake if they can come up with sounds that look better "
3688 	"with Hanning or Hamming windows than with a Gaussian window. An example of the reverse is easy "
3689 	"to find; we have just seen one.")
3690 ENTRY (U"Spectrogram blackness settings")
3691 TAG (U"%%Autoscaling%")
3692 TAG (U"%%Maximum% (dB/Hz)")
3693 DEFINITION (U"all parts of the spectrogram that have a power above %maximum (after preemphasis) "
3694 	"will be drawn in black. The standard maximum is 100 dB/Hz, but if %autoscaling is on (which is the standard), "
3695 	"Praat will use the maximum of the visible part of the spectrogram instead; "
3696 	"this ensures that the window will always look well, but it also means that the blackness "
3697 	"of a certain part of the spectrogram will change as you scroll.")
3698 TAG (U"%%Preemphasis% (dB/octave)")
3699 DEFINITION (U"determines the steepness of a high-pass filter, "
3700 	"i.e., how much the power of higher frequencies will be raised before drawing, as compared to lower frequencies. "
3701 	"Since the spectral slope of human vowels is approximately -6 dB per octave, "
3702 	"the standard value for this setting is +6 dB per octave, "
3703 	"so that the spectrum is flattened and the higher formants look as strong as the lower ones. "
3704 	"When you raise the preemphasis, frequency bands above 1000 Hz will become darker, those below 1000 Hz will become lighter.")
3705 TAG (U"%%Dynamic compression")
3706 DEFINITION (U"determines how much stronger weak spectra should be made before drawing. "
3707 	"Normally, this parameter is between 0 and 1. If it is 0 (the standard value), there is no dynamic compression. "
3708 	"If it is 1, all spectra will be drawn equally strong, "
3709 	"i.e., all of them will contain frequencies that are drawn in black. "
3710 	"If this parameter is 0.4 and the global maximum is at 80 dB, then a spectrum with a maximum at 20 dB "
3711 	"(which will normally be drawn all white if the dynamic range is 50 dB), "
3712 	"will be raised by 0.4 * (80 - 20) = 24 dB, "
3713 	"so that its maximum will be seen at 44 dB (thus making this frame visible).")
3714 MAN_END
3715 
3716 MAN_BEGIN (U"Intro 3.3. Querying the spectrogram", U"ppgb", 20030403)
3717 NORMAL (U"If you click anywhere inside the spectrogram, a cursor cross will appear, "
3718 	"and you will see the time and frequency in red at the top and to the left of the window. "
3719 	"To see the time in the Info window, "
3720 	"choose ##Get cursor# from the #Query menu or press the F6 key. "
3721 	"To see the frequency in the Info window, "
3722 	"choose ##Get frequency# from the #Spectrum menu.")
3723 NORMAL (U"To query the power of the spectrogram at the cursor cross, "
3724 	"choose ##Get spectral power at cursor cross# from the #Spectrum menu or press the F9 key. "
3725 	"The Info window will show you the power density, expressed in Pascal^2/Hz.")
3726 MAN_END
3727 
3728 MAN_BEGIN (U"Intro 3.4. Printing the spectrogram", U"ppgb", 20070905)
3729 NORMAL (U"To print a spectrogram, or to put it in an EPS file or on the clipboard for inclusion in your word processor, "
3730 	"you first have to paint it into the @@Picture window@. "
3731 	"You do this by choosing ##Paint visible spectrogram...# "
3732 	"from the Spectrum menu in the Sound or TextGrid window. "
3733 	"From the File menu in the Picture window, you can then print it, save it to an EPS file, "
3734 	"or copy it to the clipboard (to do Paste in your word processor, for instance).")
3735 MAN_END
3736 
3737 MAN_BEGIN (U"Intro 3.5. The Spectrogram object", U"ppgb", 20070905)
3738 NORMAL (U"To do more with spectrograms, you can create a @Spectrogram object in the @@List of Objects@. "
3739 	"You do this either by choosing ##Extract visible spectrogram# "
3740 	"from the Spectrum menu in the Sound or TextGrid window, "
3741 	"or by selecting a Sound object in the list and choosing @@Sound: To Spectrogram...@ from the #Spectrum menu. "
3742 	"In either case, a new Spectrogram object will appear in the list. "
3743 	"To draw this Spectrogram object to the @@Picture window@, "
3744 	"select it and choose the @@Spectrogram: Paint...@ command. "
3745 	"From the Picture window, you can print it, save it to an EPS file, or copy it to the clipboard. "
3746 	"Many other commands are available in the @@dynamic menu@.")
3747 MAN_END
3748 
3749 MAN_BEGIN (U"Intro 3.6. Viewing a spectral slice", U"ppgb", 20030316)
3750 INTRO (U"With ##View spectral slice# from the #Spectrum menu in the @SoundEditor and the @TextGridEditor, "
3751 	"you can see the frequency spectrum at the time cursor "
3752 	"or the average frequency spectrum in the time selection.")
3753 ENTRY (U"Spectral slice at the cursor")
3754 NORMAL (U"If you click anywhere in the wave form of the SoundEditor or TextGridEditor windows, "
3755 	"a cursor will appear at that time. If you then choose ##View spectral slice#, "
3756 	"Praat will create a @Spectrum object named %slice in the Objects window and show it in a @SpectrumEditor window. "
3757 	"In this way, you can inspect the frequency contents of the signal around the cursor position.")
3758 ENTRY (U"Spectral slice from a selection")
3759 NORMAL (U"If you drag the mouse through the wave form of the SoundEditor or TextGridEditor windows, "
3760 	"a @@time selection@ will appear. If you then choose ##View spectral slice#, "
3761 	"Praat will again create a @Spectrum object named %slice in the Objects window and show it in a @SpectrumEditor window. "
3762 	"In this way, you can inspect the frequency contents of the signal in the selection.")
3763 MAN_END
3764 
3765 
3766 MAN_BEGIN (U"Intro 3.7. Configuring the spectral slice", U"ppgb", 20110128)
3767 ENTRY (U"Spectral slice at the cursor")
3768 NORMAL (U"What Praat does precisely, depends on your Spectrogram settings. "
3769 	"Suppose that the %%window length% setting is 0.005 seconds (5 milliseconds). "
3770 	"If the %%window shape% is not Gaussian, Praat will extract the part of the sound "
3771 	"that runs from 2.5 milliseconds before the cursor to 2.5 ms after the cursor. "
3772 	"Praat then multiplies this 5 ms long signal by the window shape, then computes a spectrum "
3773 	"with the method of @@Sound: To Spectrum...@, which is put into the Objects window and opened in an editor window. "
3774 	"If the window shape is Gaussian, Praat will extract a part of the sound "
3775 	"that runs from 5 milliseconds before the cursor to 5 ms after the cursor. The spectrum will then be based "
3776 	"on a `physical' window length of 10 ms, although the `effective' window length is still 5 ms "
3777 	"(see @@Intro 3.2. Configuring the spectrogram@ for details).")
3778 ENTRY (U"Spectral slice from a selection")
3779 NORMAL (U"What Praat does precisely, again depends on the %%window shape% of your Spectrogram settings. "
3780 	"Suppose that your selection is 50 ms long. Praat will extract the entire selection, "
3781 	"then multiply this 50 ms long signal by the window shape, then compute a spectrum, put it into the Objects window and open it an editor window. "
3782 	"This procedure is equivalent to choosing ##Extract windowed selection...# (with a %%relative duration% of 1.0), "
3783 	"followed by ##To Spectrum...# (with %fast switched on), followed by #Edit.")
3784 NORMAL (U"If the window is Gaussian, Praat will still only use the selection, without doubling its duration. "
3785 	"This means that the spectrum that you see in this case will mainly be based on the centre half of the selection, "
3786 	"and the signal near the edges will be largely ignored.")
3787 MAN_END
3788 
3789 MAN_BEGIN (U"Intro 3.8. The Spectrum object", U"ppgb", 20030403)
3790 NORMAL (U"To compute a Fourier frequency spectrum of an entire sound, "
3791 	"select a @Sound object and choose @@Sound: To Spectrum...|To Spectrum...@ from the #Spectrum menu. "
3792 	"A new @Spectrum object will appear in the @@List of Objects@. "
3793 	"To view or modify it (or listen to its parts), click @@View & Edit@. "
3794 	"To print it, choose one of the #Draw commands to draw the Spectrum object to the @@Picture window@ first.")
3795 MAN_END
3796 
3797 MAN_BEGIN (U"Intro 4. Pitch analysis", U"ppgb", 20070905)
3798 INTRO (U"This section describes how you can analyse the pitch contour of an existing sound.")
3799 LIST_ITEM (U"@@Intro 4.1. Viewing a pitch contour")
3800 LIST_ITEM (U"@@Intro 4.2. Configuring the pitch contour")
3801 LIST_ITEM (U"@@Intro 4.3. Querying the pitch contour")
3802 LIST_ITEM (U"@@Intro 4.4. Printing the pitch contour")
3803 LIST_ITEM (U"@@Intro 4.5. The Pitch object")
3804 MAN_END
3805 
3806 MAN_BEGIN (U"Intro 4.1. Viewing a pitch contour", U"ppgb", 20110128)
3807 NORMAL (U"To see the pitch contour of an existing sound as a function of time, "
3808 	"select a @Sound or @LongSound object and choose @@View & Edit@. "
3809 	"A @SoundEditor window will appear on your screen. "
3810 	"The bottom half of this window will contain a pitch contour, drawn as a blue line or as a sequence of blue dots. "
3811 	"If you do not see the pitch contour, choose @@Show pitch@ from the #Pitch menu.")
3812 NORMAL (U"To the right of the window, you may see three pitch values, written with blue digits: "
3813 	"at the bottom, you see the floor of the viewable pitch range, perhaps 75 Hz; at the top, "
3814 	"you see the ceiling of the pitch range, perhaps 600 Hz; and somewhere in between, you see the pitch value "
3815 	"at the cursor, or the average pitch in the selection.")
3816 MAN_END
3817 
3818 MAN_BEGIN (U"Intro 4.2. Configuring the pitch contour", U"ppgb", 20190331)
3819 NORMAL (U"With @@Pitch settings...@ from the #Pitch menu, "
3820 	"you can determine how the pitch contour is displayed and how it is computed. "
3821 	"These settings will be remembered across Praat sessions. "
3822 	"All these settings have standard values (\"factory settings\"), which appear "
3823 	"when you click #Standards.")
3824 ENTRY (U"The %%pitch range% setting")
3825 NORMAL (U"This is the most important setting for pitch analysis. The standard range is from 75 to 500 hertz, "
3826 	"which means that the pitch analysis method will only find values between 75 and 500 Hz. "
3827 	"The range that you set here will be shown to the right of the analysis window.")
3828 NORMAL (U"You should set the range to values appropriate for your speaker, "
3829 	"but a problem is that speakers vary enormously in their pitch ranges. "
3830 	"For many low-pitched (e.g. average male) voices, you may want to set the floor to 75 Hz, and the ceiling to 300 Hz; "
3831 	"for many high-pitched (e.g. average female) voices, a range of 100-500 Hz may instead be appropriate. "
3832 	"On the high side, some children can reach almost 2000 Hz when yelling; "
3833 	"on the low side, creaky voice can go as low as 40 Hz; "
3834 	"for the speakers you are investigating, you may therefore want to experiment with this setting.")
3835 NORMAL (U"Here is why you have to supply these settings. If the pitch floor is 75 Hz, "
3836 	"the pitch analysis method requires a 40-millisecond analysis window, "
3837 	"i.e., in order to measure the F0 at a time of, say, 0.850 seconds, "
3838 	"Praat needs to consider a part of the sound that runs from 0.830 to 0.870 seconds. "
3839 	"These 40 milliseconds correspond to 3 maximum pitch periods (3/75 = 0.040). "
3840 	"If you set the pitch floor down to 25 Hz, the analysis window will grow to 120 milliseconds "
3841 	"(which is again 3 maximum pitch periods), i.e., all times between 0.790 and 0.910 seconds will be considered. "
3842 	"This makes it less easy to see fast F0 changes.")
3843 NORMAL (U"So setting the floor of the pitch range is a technical requirement for the pitch analysis. "
3844 	"If you set it too low, you will miss very fast F0 changes, and if you set it too high, "
3845 	"you will miss very low F0 values. For children's voices you can often use 200 Hz, "
3846 	"although 75 Hz will still give you the same time resolution as you get for low-pitched voices.")
3847 ENTRY (U"The %units setting")
3848 NORMAL (U"This setting determines the units of the vertical pitch scale. Most people like to see the pitch range "
3849 	"in hertz, but there are several other possibilities.")
3850 ENTRY (U"Advanced settings")
3851 NORMAL (U"The Pitch menu also contains @@Advanced pitch settings...@.")
3852 MAN_END
3853 
3854 MAN_BEGIN (U"Time step settings...", U"ppgb", 20031003)
3855 INTRO (U"A command in the #View menu of the @SoundEditor and @TextGridEditor "
3856 	"to determine the time interval between consecutive measurements "
3857 	"of pitch, formants, and intensity.")
3858 ENTRY (U"Automatic time steps")
3859 NORMAL (U"It is recommended that you set the %%Time step strategy% to #Automatic. "
3860 	"In this way, Praat computes just enough pitch, formant, and intensity values to draw "
3861 	"reliable pitch, formant, and intensity contours. In general, Praat will compute 4 values "
3862 	"within an analysis window (\"four times oversampling\").")
3863 NORMAL (U"As described in @@Sound: To Pitch...@, Praat's standard time step for pitch analysis is 0.75 divided by the pitch floor, "
3864 	"e.g., if the pitch floor is 75 Hz, the time step will be 0.01 seconds. "
3865 	"In this way, there will be 4 pitch measurements within an analysis window, which is 3 / (75 Hz) = 40 milliseconds long.")
3866 NORMAL (U"As described in @@Sound: To Formant (burg)...@, Praat's standard time step for formant measurements is the %%Window length% divided by 4, "
3867 	"e.g. if the window length is 0.025 seconds, the time step will be 6.25 milliseconds.")
3868 NORMAL (U"As described in @@Sound: To Intensity...@, Praat's standard time step for intensity measurements is 0.8 divided by the pitch floor, "
3869 	"e.g. if the pitch floor is 75 Hz, the time step will be 10.6666667 milliseconds. "
3870 	"In this way, there will be 4 intensity measurements within an intensity analysis window, "
3871 	"which is 3.2 / (75 Hz) = 42.6666667 milliseconds long.")
3872 ENTRY (U"Fixed time step")
3873 NORMAL (U"You can override the automatic time step by setting the %%Time step strategy% to #Fixed. "
3874 	"The %%Fixed time step% setting then determines the time step that Praat will use: "
3875 	"if you set it to 0.001 seconds, Praat will compute pitch, formant, and intensity values for every millisecond. "
3876 	"Beware that this can slow down the editor window appreciably, because this step is much smaller "
3877 	"than usual values of the automatic time step (see above).")
3878 NORMAL (U"Enlarging the time step to e.g. 0.1 seconds will speed up the editor window "
3879 	"but may render the pitch, formant, and intensity curves less exact (they become %undersampled), "
3880 	"which will influence your measurements and the locations of the pulses.")
3881 NORMAL (U"If there are fewer than 2.0 pitch measurement points per analysis window, "
3882 	"Praat will draw the pitch curve as separate little blue disks "
3883 	"rather than as a continuous blue curve, in order to warn you of the undersampling. "
3884 	"E.g. if the pitch floor is 75 Hz, Praat will draw the pitch curve as disks if the time step is greater than 0.02 seconds.")
3885 ENTRY (U"View-dependent time step")
3886 NORMAL (U"Another way to override the standard time step is by setting the %%Time step strategy% to ##View-dependent#. "
3887 	"The %%Number of time steps per view% setting then determines the time step that Praat will use: "
3888 	"if you set it to 100, Praat will always compute 100 pitch, formant, and intensity values within the view window. "
3889 	"More precisely: if you zoom the view window to 3 seconds, Praat will show you 100 pitch, formant, and intensity points at distances "
3890 	"of 0.03 seconds (or fewer than 100, if you are near the left or right edge of the signal). "
3891 	"As with the %%Fixed time step% setting, Praat will draw the pitch as separate disks in case of undersampling. "
3892 	"You may want to use this setting if you want the pitch curve to be drawn equally fast independently of the degree "
3893 	"of zooming.")
3894 MAN_END
3895 
3896 MAN_BEGIN (U"Advanced pitch settings...", U"ppgb", 20110808)
3897 INTRO (U"A command in the #Pitch menu of the @SoundEditor or @TextGridEditor windows. "
3898 	"Before changing the advanced pitch settings, make sure you understand "
3899 	"@@Intro 4.2. Configuring the pitch contour@.")
3900 ENTRY (U"View range different from analysis range")
3901 NORMAL (U"Normally, the range of pitch values that can be seen in the editor window is equal to the range of pitch values "
3902 	"that the analysis algorithm can determine. If you set the analysis range from 75 to 500 Hz, this will be the range "
3903 	"you see in the editor window as well. If the pitch values in the curve happen to be between 350 and 400 Hz, "
3904 	"you may want to zoom in to the 350-400 Hz pitch region. "
3905 	"You will usually do this by changing the pitch range in the @@Pitch settings...@ window. "
3906 	"However, the analysis range will also change in that case, so that the curve itself may change. "
3907 	"If you do not want that, you can change the %%View range% settings "
3908 	"from \"0.0 (= auto)\" - \"0.0 (= auto)\" to something else, perhaps \"350\" - \"400\".")
3909 ENTRY (U"Pitch analysis settings")
3910 NORMAL (U"For information about these, see @@Sound: To Pitch (ac)...@. The standard settings are best in most cases. "
3911 	"For some pathological voices, you will want to set the voicing threshold to much less than the standard of 0.45, "
3912 	"in order to get pitch values even in irregular parts of the signal.")
3913 MAN_END
3914 
3915 MAN_BEGIN (U"Intro 4.3. Querying the pitch contour", U"ppgb", 20040614)
3916 NORMAL (U"With @@Get pitch@ from the #Pitch menu in the @SoundEditor or @TextGridEditor, "
3917 	"you get information about the pitch at the cursor or in the selection. "
3918 	"If a cursor is visible in the window, ##Get pitch# writes to the @@Info window@ "
3919 	"the linearly interpolated pitch at that time; "
3920 	"if a time selection is visible inside the window, ##Get pitch# writes to the @@Info window@ "
3921 	"the mean (average) pitch in the visible part of that selection; "
3922 	"otherwise, ##Get pitch# writes the average pitch in the visible part of the sound.")
3923 MAN_END
3924 
3925 MAN_BEGIN (U"Intro 4.4. Printing the pitch contour", U"ppgb", 20070905)
3926 NORMAL (U"To print a pitch contour, or to put it in an EPS file or on the clipboard for inclusion in your word processor, "
3927 	"you first have to draw it into the @@Picture window@. "
3928 	"You do this by choosing ##Draw visible pitch contour...# "
3929 	"from the Pitch menu in the Sound or TextGrid window. "
3930 	"From the File menu in the Picture window, you can then print it, save it to an EPS file, "
3931 	"or copy it to the clipboard (to do Paste in your word processor, for instance).")
3932 MAN_END
3933 
3934 MAN_BEGIN (U"Intro 4.5. The Pitch object", U"ppgb", 20110128)
3935 NORMAL (U"The pitch contour that is visible in the @SoundEditor or @TextGridEditor window, "
3936 	"can be copied as a separate @Pitch object to the @@List of Objects@. To do this, "
3937 	"choose @@Extract visible pitch contour@ from the #Pitch menu.")
3938 NORMAL (U"Another way to get a separate Pitch object is to select a @Sound object in the list "
3939 	"choose @@Sound: To Pitch...@ (preferred) or any of the other methods from the @@Periodicity menu@.")
3940 NORMAL (U"To view and modify the contents of a Pitch object, select it and choose @@View & Edit@. "
3941 	"This creates a @PitchEditor window on your screen.")
3942 NORMAL (U"To save a pitch contour to disk, select the @Pitch object in the list and choose one of the commands in the @@Save menu@.")
3943 NORMAL (U"Later on, you can read the saved file again with @@Read from file...@ from the @@Open menu@.")
3944 NORMAL (U"To draw a @Pitch object to the @@Picture window@, select it and choose any of the commands in the @@Draw menu@. "
3945 	"From the Picture window, you can print it, save it to an EPS file, or copy it to the clipboard for inclusion in your word processor.")
3946 MAN_END
3947 
3948 MAN_BEGIN (U"Advanced pulses settings...", U"ppgb", 20110220)
3949 INTRO (U"A command in the #Pulses menu of the @SoundEditor or @TextGridEditor windows. "
3950 	"Before changing the advanced pulses settings, make sure you understand "
3951 	"the @@Voice@ tutorial.")
3952 NORMAL (U"For information about the ##Maximum period factor# setting, see @@PointProcess: Get jitter (local)...@. "
3953 	"The standard setting is best in most cases. "
3954 	"The ##Period floor# and ##Period ceiling# settings derive from the pitch floor and pitch ceiling (@@Pitch settings...@), "
3955 	"according to a formula given in @@Voice 2. Jitter@.")
3956 MAN_END
3957 
3958 MAN_BEGIN (U"Intro 5. Formant analysis", U"ppgb", 20030316)
3959 INTRO (U"This section describes how you can analyse the formant contours of an existing sound.")
3960 LIST_ITEM (U"@@Intro 5.1. Viewing formant contours")
3961 LIST_ITEM (U"@@Intro 5.2. Configuring the formant contours")
3962 LIST_ITEM (U"@@Intro 5.3. Querying the formant contours")
3963 LIST_ITEM (U"@@Intro 5.4. The Formant object")
3964 MAN_END
3965 
3966 MAN_BEGIN (U"Intro 5.1. Viewing formant contours", U"ppgb", 20110128)
3967 NORMAL (U"To see the formant contours of a sound as functions of time, select a @Sound or @LongSound object and choose @@View & Edit@. "
3968 	"A @SoundEditor window will appear on your screen. "
3969 	"The analysis part of this window will contain formant contours, drawn as red speckles. "
3970 	"If you do not see the formant contours, choose @@Show formant@ from the #Formant menu.")
3971 MAN_END
3972 
3973 MAN_BEGIN (U"Intro 5.2. Configuring the formant contours", U"ppgb", 20030316)
3974 NORMAL (U"The formant analysis parameters, with you can set with the #Formant menu, are important. "
3975 	"For a female voice, you may want to set the maximum frequency to 5500 Hz; "
3976 	"for a male voice, set it to 5000 Hz instead. "
3977 	"For more information about analysis parameters, see @@Sound: To Formant (burg)...@.")
3978 MAN_END
3979 
3980 MAN_BEGIN (U"Intro 5.3. Querying the formant contours", U"ppgb", 20040616)
3981 NORMAL (U"With @@Get first formant@ from the Formant menu in the @SoundEditor or @TextGridEditor, "
3982 	"you get information about the first formant at the cursor or in the selection. "
3983 	"If there is a cursor, ##Get first formant# writes to the @@Info window@ the linearly interpolated first formant at that time. "
3984 	"If there is a true selection, ##Get first formant# writes to the @@Info window@ the mean first formant in the visble part of that selection. "
3985 	"The same goes for @@Get second formant@ and so on.")
3986 MAN_END
3987 
3988 MAN_BEGIN (U"Intro 5.4. The Formant object", U"ppgb", 20030316)
3989 NORMAL (U"The formant contours that are visible in the @SoundEditor or @TextGridEditor window, "
3990 	"can be copied as a separate @Formant object to the @@List of Objects@. To do this, "
3991 	"choose @@Extract visible formant contour@ from the Formant menu.")
3992 NORMAL (U"Another way to get a separate Formant object is to select a @Sound object in the list "
3993 	"choose @@Sound: To Formant (burg)...@ (preferred) or any of the other methods "
3994 	"from the @@Formants & LPC menu@.")
3995 ENTRY (U"Saving formant contours to disk")
3996 NORMAL (U"To save formant contours to disk, select the @Formant object in the list and choose one of the commands in the @@Save menu@.")
3997 NORMAL (U"Later on, you can read the saved file again with @@Read from file...@ from the @@Open menu@.")
3998 ENTRY (U"Drawing formant contours")
3999 NORMAL (U"To draw a @Formant object to the @@Picture window@, select it and choose any of the commands in the @@Draw menu@. "
4000 	"From the Picture window, you can print it, save it to an EPS file, or copy it to the clipboard for inclusion in your word processor.")
4001 MAN_END
4002 
4003 MAN_BEGIN (U"Intro 6. Intensity analysis", U"ppgb", 20030316)
4004 INTRO (U"This section describes how you can analyse the intensity contour of an existing sound.")
4005 LIST_ITEM1 (U"@@Intro 6.1. Viewing an intensity contour")
4006 LIST_ITEM1 (U"@@Intro 6.2. Configuring the intensity contour")
4007 LIST_ITEM1 (U"@@Intro 6.3. Querying the intensity contour")
4008 LIST_ITEM1 (U"@@Intro 6.4. The Intensity object")
4009 MAN_END
4010 
4011 MAN_BEGIN (U"Intro 6.1. Viewing an intensity contour", U"ppgb", 20110128)
4012 INTRO (U"To see the intensity contour of a sound as a function of time, select a @Sound or @LongSound object and choose @@View & Edit@. "
4013 	"A @SoundEditor window will appear on your screen. "
4014 	"The analysis part of this window will contain an intensity contour, drawn as a yellow or green line "
4015 	"(choose ##Show intensity# from the #Intensity menu if it is not visible). "
4016 	"This also works in the @TextGridEditor.")
4017 MAN_END
4018 
4019 MAN_BEGIN (U"Intro 6.2. Configuring the intensity contour", U"ppgb", 20041123)
4020 INTRO (U"With ##Intensity settings...# from the #Intensity menu, "
4021 	"you can control how the intensity contour is computed and how it is shown.")
4022 ENTRY (U"The view range")
4023 NORMAL (U"By changing these two numbers you can set the vertical scale. "
4024 	"The standard setting is from 50 to 100 dB, but if you are interested in the power of the background noise "
4025 	"you may want to set it to the range from 0 to 100 dB.")
4026 ENTRY (U"The averaging method")
4027 NORMAL (U"Averaging is what occurs if you make a @@time selection@ (rather than setting the cursor at a single time). "
4028 	"The green number in dB to the left or right side of the intensity contour will show the average "
4029 	"intensity in the selection. The same value is what you get when choosing ##Get intensity# from "
4030 	"the #Intensity menu. You can choose any of the three averaging methods "
4031 	"available for @@Intensity: Get mean...@, or choose for the #median value in the selection.")
4032 ENTRY (U"Pitch floor")
4033 NORMAL (U"The intensity curve is %smoothed, since you usually do not want the intensity curve to go up and down with "
4034 	"the intensity variations within a pitch period. To avoid such pitch-synchronous variations, "
4035 	"the intensity at every time point is a weighted average over many neighbouring time points. "
4036 	"The weighting is performed by a Gaussian (`double Kaiser') window that has a duration that is determined by the "
4037 	"##Minimum pitch# setting (see @@Intro 4.2. Configuring the pitch contour@). "
4038 	"To see more detail than usual, raise the minimum pitch; to get more smoothing than usual, lower it. "
4039 	"For more information, see @@Sound: To Intensity...@.")
4040 ENTRY (U"Subtract mean pressure or not?")
4041 NORMAL (U"Many microphones, microphone preamplifiers, or other components in the recording system "
4042 	"can add a constant level to the air pressure (a %%DC offset%). "
4043 	"You can see this at quiet locations in the wave form, "
4044 	"where the average pressure is not zero but the background noise hovers about some non-zero value. "
4045 	"You will usually not want to take this constant pressure seriously, i.e. the intensity curve should "
4046 	"normally not take into account the energy provided by this constant pressure level. "
4047 	"If you switch on the ##Subtract mean pressure# switch (whose standard setting is also on), "
4048 	"the intensity value at a time point is computed by first subtracting the mean pressure around this point, "
4049 	"and then applying the Gaussian window.")
4050 MAN_END
4051 
4052 MAN_BEGIN (U"Intro 6.3. Querying the intensity contour", U"ppgb", 20041123)
4053 INTRO (U"To ask for the intensity at the cursor, or the average intensity in the visible part of the selection, "
4054 	"choose ##Get intensity# from the #Intensity menu or press the F11 key. You get the same value in dB that is visible "
4055 	"to the left or right side of the intensity curve, but with more digits.")
4056 MAN_END
4057 
4058 MAN_BEGIN (U"Intro 6.4. The Intensity object", U"ppgb", 20041123)
4059 NORMAL (U"To print an intensity contour, or to put it in an EPS file or on the clipboard for inclusion in your word processor, "
4060 	"you first have to create an @Intensity object in the @@List of Objects@. "
4061 	"You do this either by choosing ##Extract visible intensity contour# "
4062 	"from the #Intensity menu in the SoundEditor or TextGridEditor window, "
4063 	"or by selecting a Sound object in the list and choosing @@Sound: To Intensity...@. "
4064 	"In either case, a new Intensity object will appear in the list. "
4065 	"To draw the Intensity object to the @@Picture window@, select it and choose ##Draw...#. "
4066 	"From the Picture window, you can print it, save it to an EPS file, or copy it to the clipboard.")
4067 MAN_END
4068 
4069 MAN_BEGIN (U"Intro 7. Annotation", U"ppgb", 20110129)
4070 INTRO (U"You can annotate existing @Sound objects and sound files (@LongSound objects).")
4071 NORMAL (U"The labelling data will reside in a @TextGrid object. This object is separate "
4072 	"from the sound, which means that you will often see two objects in the list: a Sound or LongSound, "
4073 	"and a TextGrid.")
4074 ENTRY (U"Creating a TextGrid")
4075 NORMAL (U"You create a new empty TextGrid from the Sound or LongSound with @@Sound: To TextGrid...@ "
4076 	"or @@LongSound: To TextGrid...@ from the #Annotate menu (which shows up in the Objects window if you select a Sound or LongSound). In this way, the time domain "
4077 	"of the @TextGrid will automatically equal that of the sound (if you choose @@Create TextGrid...@ from "
4078 	"the @@New menu@ instead, you will have to supply the time domain by yourself).")
4079 NORMAL (U"When you create a TextGrid, you specify the names of the %tiers. For instance, if you want to segment "
4080 	"the sound into words and into phonemes, you may want to create two tiers and call them "
4081 	"\"words\" and \"phonemes\" (you can easily add, remove, and rename tiers later). "
4082 	"Since both of these tiers are %%interval tiers% (you label the intervals between the word and phoneme "
4083 	"boundaries, not the boundaries themselves), you specify \"phonemes words\" for %%Tier names%, "
4084 	"and you leave the %%Point tiers% empty.")
4085 ENTRY (U"View and edit")
4086 NORMAL (U"You can edit a TextGrid object all by itself, but you will normally want to see "
4087 	"the sound in the editor window as well. To achieve this, you select both the Sound (or LongSound) and "
4088 	"the TextGrid, and click @@View & Edit@. A @TextGridEditor will appear on your screen. "
4089 	"Like the Sound editor, the TextGrid editor will show you a spectrogram, a pitch contour, a formant contour, "
4090 	"and an intensity contour. This editor will allow "
4091 	"you to add, remove, and edit labels, boundaries, and tiers. Under Help in the TextGridEditor, you will "
4092 	"find the @TextGridEditor manual page. You are strongly advised to read it, because it will show you "
4093 	"how you can quickly zoom (drag the mouse), play (click a rectangle), or edit a label (just type).")
4094 ENTRY (U"Save")
4095 NORMAL (U"You will normally write the TextGrid to disk with @@Save as text file...@ "
4096 	"or @@Save as short text file...@. It is true that @@Save as binary file...@ will also work, but the others "
4097 	"give you a file you can read with any text editor.")
4098 NORMAL (U"However you saved it, you can read the TextGrid into Praat later with @@Read from file...@.")
4099 MAN_END
4100 
4101 MAN_BEGIN (U"Intro 8. Manipulation", U"ppgb", 20021212)
4102 LIST_ITEM (U"@@Intro 8.1. Manipulation of pitch")
4103 LIST_ITEM (U"@@Intro 8.2. Manipulation of duration")
4104 LIST_ITEM (U"@@Intro 8.3. Manipulation of intensity")
4105 MAN_END
4106 
4107 MAN_BEGIN (U"Intro 8.1. Manipulation of pitch", U"ppgb", 20200901)
4108 INTRO (U"To modify the pitch contour of an existing @Sound object, "
4109 	"you select this @Sound and click ##To Manipulation#. "
4110 	"A @Manipulation object will then appear in the list. "
4111 	"You can then click @@View & Edit@ to raise a @ManipulationEditor, "
4112 	"which will show the pitch contour (@PitchTier) as a series of thick blue dots. "
4113 	"To reduce the number of dots, choose ##Stylize pitch (2 st)# "
4114 	"from the #Pitch menu; it will then be easy to drag the dots "
4115 	"around the time–pitch area.")
4116 NORMAL (U"If you click any of the rectangles "
4117 	"(or choose any of the #Play commands from the #View menu), "
4118 	"you will hear the modified sound. By shift-clicking, you will hear "
4119 	"the original sound.")
4120 NORMAL (U"To get the modified sound as a separate object, "
4121 	"choose ##Publish resynthesis# from the @@File menu@.")
4122 NORMAL (U"If you modify the duration curve as well (see @@Intro 8.2. Manipulation of duration@), "
4123 	"the modified sound will be based on the modified pitch and duration.")
4124 ENTRY (U"Cloning a pitch contour")
4125 NORMAL (U"To use the pitch contour of one Manipulation object as the pitch contour of another Manipulation object, "
4126 	"you first choose ##Extract pitch tier# for the first Manipulation object, "
4127 	"then select the resulting PitchTier object together with the other Manipulation object "
4128 	"(e.g. by a click on the PitchTier and a @@Command-click@ on the Manipulation), "
4129 	"and choose ##Replace pitch tier#.")
4130 ENTRY (U"Precise manipulation of pitch")
4131 NORMAL (U"If you know exactly what pitch contour you want, "
4132 	"you can create an empty PitchTier with @@Create PitchTier...@ from the New menu, "
4133 	"then add points with @@PitchTier: Add point...@.")
4134 NORMAL (U"For instance, suppose you want to have a pitch that falls from 350 to 150 Hz in one second. "
4135 	"You create the PitchTier, then add a point at 0 seconds and a frequency of 350 Hz, "
4136 	"and a point at 1 second with a frequency of 150 Hz. "
4137 	"You can put this PitchTier into a Manipulation object in the way described above.")
4138 MAN_END
4139 
4140 MAN_BEGIN (U"Intro 8.2. Manipulation of duration", U"ppgb", 20200901)
4141 INTRO (U"You can use Praat to modify the relative durations in an existing sound.")
4142 NORMAL (U"First, you select a @Sound object and click \"To Manipulation\". "
4143 	"A @Manipulation object will then appear in the list. "
4144 	"You can then click @@View & Edit@ to raise a @ManipulationEditor, "
4145 	"which will show an empty @DurationTier. "
4146 	"You can add targets to this tier by choosing \"Add duration point at cursor\" "
4147 	"from the \"Dur\" menu. The targets will show up as blue dots, which you can easily drag "
4148 	"around the duration area.")
4149 NORMAL (U"If you click any of the rectangles "
4150 	"(or choose any of the @Play commands from the @View menu), "
4151 	"you will hear the modified sound. By shift-clicking, you will hear "
4152 	"the original sound.")
4153 NORMAL (U"To get the modified sound as a separate object, "
4154 	"choose ##Publish resynthesis# from the @@File menu@.")
4155 NORMAL (U"If you modify the pitch curve as well (see @@Intro 8.1. Manipulation of pitch@), "
4156 	"the modified sound will be based on the modified duration and pitch.")
4157 ENTRY (U"Precise manipulation of duration")
4158 NORMAL (U"If you know exactly the times and relative durations, it is advisable to write a script (see @Scripting). "
4159 	"Suppose, for instance, that you have a 355-ms piece of sound, and you want to shorten the first 85 ms to 70 ms, "
4160 	"and the remaining 270 ms to 200 ms.")
4161 NORMAL (U"In your first 85 ms, your relative duration should be 70/85, "
4162 	"and during the last 270 ms, it should be 200/270. "
4163 	"The DurationTier does linear interpolation, so it can only be approximate these precise times, "
4164 	"but fortunately to any precision you like:")
4165 CODE (U"Create DurationTier: \"shorten\", 0, 0.085 + 0.270")
4166 CODE (U"Add point: 0.000, 70/85")
4167 CODE (U"Add point: 0.084999, 70/85")
4168 CODE (U"Add point: 0.085001, 200/270")
4169 CODE (U"Add point: 0.355, 200/270")
4170 NORMAL (U"To put this DurationTier back into a Manipulation object, you select the two objects together "
4171 	"(e.g. a click on the DurationTier and a @@Command-click@ on the Manipulation), "
4172 	"and choose ##Replace duration tier#.")
4173 MAN_END
4174 
4175 MAN_BEGIN (U"Intro 8.3. Manipulation of intensity", U"ppgb", 20110128)
4176 INTRO (U"You can modify the intensity contour of an existing sound.")
4177 NORMAL (U"While the pitch and duration of a sound can be modified with the @ManipulationEditor "
4178 	"(see @@Intro 8.1. Manipulation of pitch@ and @@Intro 8.2. Manipulation of duration@), "
4179 	"the modification of the intensity curve is done in a different way.")
4180 NORMAL (U"You can create an @IntensityTier with the command @@Create IntensityTier...@ "
4181 	"from the @@New menu@. With @@View & Edit@, you can add points to this tier. "
4182 	"You can then \"multiply\" this tier with a sound, by selecting the @Sound and the "
4183 	"IntensityTier together and clicking @@Sound & IntensityTier: Multiply|Multiply@. "
4184 	"The points in the IntensityTier represent relative intensities in dB; "
4185 	"therefore, the sound pressure values in the Sound are multiplied by 10^^(dB/20)^.")
4186 NORMAL (U"Instead of an IntensityTier, you can use an @AmplitudeTier; "
4187 	"when you click #Multiply for a selected Sound and AmplitudeTier, "
4188 	"the sound pressure values in the Sound are directly multiplied by the values in the AmplitudeTier.")
4189 MAN_END
4190 
4191 MAN_BEGIN (U"Intro 8.4. Manipulation of formants", U"ppgb", 20010408)
4192 INTRO (U"The manipulation of formant contours cannot be as straightforward as the manipulation "
4193 	"of pitch, duration, or intensity contours. See the @@Source-filter synthesis@ tutorial "
4194 	"for an explanation of how formants can be modified in Praat.")
4195 MAN_END
4196 
4197 
4198 /*
4199  * Who uses Praat?
4200  * phonetics
4201  * linguistics
4202  * speech pathology
4203  * psychology
4204  * bioacoustics: e.g.
4205 hapalemur, crow, monkey, frog, turtle dove, grasshopper, cricket, alligator, crocodile,
4206 gecko, elephant, swallow, chicken, dolphin, humpback, [killer] whale, [electric] fish,
4207 sparrow, meerkat, [fruit] bat, lion, parrot, red deer, sperm whale, [bearded] seal, mouse, cracid, chacma baboon
4208 * music
4209 */
4210 
4211 MAN_BEGIN (U"Labelling", U"ppgb", 20010408)
4212 INTRO (U"See @@Intro 7. Annotation@.")
4213 MAN_END
4214 
4215 MAN_BEGIN (U"List of Objects", U"ppgb", 20210228)
4216 INTRO (U"A list in the left-hand part of the @@Object window@.")
4217 ENTRY (U"Purpose")
4218 NORMAL (U"If you select one or more @objects in this list, "
4219 	"the possible actions that you can perform with the selected objects "
4220 	"will appear in the @@Dynamic menu@.")
4221 ENTRY (U"How to select objects")
4222 NORMAL (U"To select one object (and deselect all the others), click on the object.")
4223 NORMAL (U"To extend the selection, drag the mouse or use Shift-click.")
4224 NORMAL (U"To change the selection of one object (without changing the others), use @@Command-click@.")
4225 MAN_END
4226 
4227 MAN_BEGIN (U"New menu", U"ppgb", 20161013)
4228 INTRO (U"The ##New menu# is one of the menus in the @@Object window@. "
4229 	"You use this menu to create new objects from scratch. It contains the following commands:")
4230 LIST_ITEM (U"• @@Record mono Sound...@")
4231 LIST_ITEM (U"• @@Record stereo Sound...@")
4232 LIST_ITEM (U"• @@Create Sound from formula...@")
4233 LIST_ITEM (U"• @@Create Sound as tone complex...")
4234 LIST_ITEM (U"• @@Create Sound as gammatone...")
4235 LIST_ITEM (U"• @@Create Sound as Shepard tone...")
4236 LIST_ITEM (U"• @@Create Matrix...@ (from a formula)")
4237 LIST_ITEM (U"• @@Create simple Matrix...@ (from a formula)")
4238 LIST_ITEM (U"• @@Create empty PointProcess...@")
4239 LIST_ITEM (U"• @@Create Poisson process...@")
4240 LIST_ITEM (U"• @@Create PitchTier...@")
4241 LIST_ITEM (U"• @@Create DurationTier...@")
4242 LIST_ITEM (U"• @@Create IntensityTier...@")
4243 LIST_ITEM (U"• @@Create FormantGrid...@")
4244 LIST_ITEM (U"• @@Create Strings as file list...@")
4245 LIST_ITEM (U"• @@Create TextGrid...@")
4246 LIST_ITEM (U"• @@OT learning@ tutorial")
4247 LIST_ITEM (U"• @@Create tongue-root grammar...@")
4248 NORMAL (U"To create new objects from files on disk, use the @@Open menu@ instead. "
4249 	"Objects can also often be create from other objects, with commands that start with ##To#.")
4250 MAN_END
4251 
4252 MAN_BEGIN (U"Object window", U"ppgb", 20140212)
4253 INTRO (U"One of the two main windows in the Praat program.")
4254 ENTRY (U"Subdivision")
4255 LIST_ITEM (U"To the left: the @@List of Objects@.")
4256 LIST_ITEM (U"To the right: the @@Dynamic menu@.")
4257 ENTRY (U"Fixed buttons")
4258 NORMAL (U"The following buttons appear below the List of Objects:")
4259 LIST_ITEM (U"• @@Rename...")
4260 LIST_ITEM (U"• @@Info")
4261 LIST_ITEM (U"• @@Copy...")
4262 LIST_ITEM (U"• @@Remove")
4263 LIST_ITEM (U"• @@Inspect")
4264 ENTRY (U"Menus")
4265 LIST_ITEM (U"The Object window contains several fixed menus: "
4266 	"the #Praat, #New, #Open, and #Help menus. "
4267 	"It also contains the #Save menu, whose contents vary with the kinds of selected objects, "
4268 	"and must, therefore, be considered part of the dynamic menu.")
4269 ENTRY (U"The Praat menu")
4270 LIST_ITEM (U"• @@New Praat script@: creates an empty @@ScriptEditor@")
4271 LIST_ITEM (U"• @@Open Praat script...@: creates a @@ScriptEditor@ with a script from disk")
4272 LIST_ITEM (U"• The ##Goodies submenu#: for doing things (like using the Calculator) "
4273 	"that do not create new objects and do not depend on the kinds of selected objects.")
4274 LIST_ITEM (U"• The ##Preferences submenu#: for program-wide preferences, "
4275 	"like audio input and output settings.")
4276 LIST_ITEM (U"• ##Buttons...#: raises a @@ButtonEditor@")
4277 LIST_ITEM (U"• (@@Add menu command...@)")
4278 LIST_ITEM (U"• (@@Add action command...@)")
4279 LIST_ITEM (U"• @@Quit")
4280 ENTRY (U"Other menus")
4281 LIST_ITEM (U"• The @@New menu@: for creating objects from scratch.")
4282 LIST_ITEM (U"• The @@Open menu@: for reading objects from file into memory.")
4283 LIST_ITEM (U"• The @@Save menu@: for writing objects from memory to file.")
4284 LIST_ITEM (U"• The ##Help menu#: for viewing the manual.")
4285 MAN_END
4286 
4287 MAN_BEGIN (U"Periodicity menu", U"ppgb", 20010417)
4288 INTRO (U"A menu that occurs in the @@Dynamic menu@ for a @Sound.")
4289 NORMAL (U"This menu contains commands for analysing the pitch contour of the selected Sound:")
4290 LIST_ITEM (U"@@Sound: To Pitch...")
4291 LIST_ITEM (U"@@Sound: To Pitch (ac)...")
4292 LIST_ITEM (U"@@Sound: To Pitch (cc)...")
4293 LIST_ITEM (U"@@Sound: To Harmonicity (cc)...")
4294 LIST_ITEM (U"@@Sound: To Harmonicity (ac)...")
4295 MAN_END
4296 
4297 MAN_BEGIN (U"Pitch settings...", U"ppgb", 20030316)
4298 INTRO (U"A command in the Pitch menu of the @SoundEditor and @TextGridEditor windows. "
4299 	"See @@Intro 4.2. Configuring the pitch contour@.")
4300 MAN_END
4301 
4302 MAN_BEGIN (U"Play", U"ppgb", 20021212)
4303 INTRO (U"A command that is available if you select a @Sound, @Pitch, or @PointProcess object. "
4304 	"It gives you an acoustic representation of the selected object, if your loudspeakers are on "
4305 	"and you did not \"mute\" your computer sound system.")
4306 NORMAL (U"A Play button is also available in the @SoundRecorder window "
4307 	"and in the @View menu of the @SoundEditor or @TextGridEditor. In the editors, "
4308 	"you will usually play a sound by clicking on any of the rectangles around the data.")
4309 MAN_END
4310 
4311 MAN_BEGIN (U"Query", U"ppgb", 20021218)
4312 INTRO (U"Query commands give you information about objects.")
4313 NORMAL (U"Most query commands start with the word #%Get or sometimes the word #%Count. "
4314 	"You will find these commands in two places: under the #Query menu that usually appears if you "
4315 	"select an @@Objects|object@ in the list, and in the #Query menus of the @editors.")
4316 ENTRY (U"Behaviour")
4317 NORMAL (U"If you click a query command, the answer will be written to the @@Info window@.")
4318 ENTRY (U"Scripting")
4319 NORMAL (U"In a script, you can still use query commands to write the information to the Info window "
4320 	"but you can also use any query command to put the information into a variable. "
4321 	"(see @@Scripting 6.3. Query commands@). In such a case, the value will not be written into the Info window.")
4322 ENTRY (U"Query commands in the Praat program")
4323 NORMAL (U"The Praat program contains the following query commands:")
4324 MAN_END
4325 
4326 MAN_BEGIN (U"Query menu", U"ppgb", 20010417)
4327 INTRO (U"One of the menus in most @editors.")
4328 MAN_END
4329 
4330 MAN_BEGIN (U"Quit", U"ppgb", 20050822)
4331 INTRO (U"One of the commands in the @@Praat menu@.")
4332 ENTRY (U"Purpose")
4333 NORMAL (U"To leave the program.")
4334 ENTRY (U"Behaviour")
4335 NORMAL (U"All @objects not written to a file will be lost. "
4336 	"However, file-based objects (like large lexica) will be saved correctly.")
4337 ENTRY (U"Usage")
4338 NORMAL (U"To save your data to a disk file before quitting, choose a command from the @@Save menu@.")
4339 MAN_END
4340 
4341 MAN_BEGIN (U"Read from file...", U"ppgb", 20111018)
4342 INTRO (U"One of the commands in the @@Open menu@.")
4343 ENTRY (U"Purpose")
4344 NORMAL (U"To read one or more @objects from a file on disk.")
4345 ENTRY (U"Behaviour")
4346 NORMAL (U"Many kinds of files are recognized:")
4347 LIST_ITEM (U"1. Text files that are structured as described under @@Save as text file...@; "
4348 	"these can contain an object of any type, or a collection of objects.")
4349 LIST_ITEM (U"2. Files that were produced by @@Save as binary file...@ (any type).")
4350 LIST_ITEM (U"3. Files in a LISP text format (only for object types that can be written to a LISP file).")
4351 LIST_ITEM (U"4. Files that were made recognizable by the libraries built on Praat. "
4352 	"For instance, the phonetics library adds recognizers for many kinds of sound files.")
4353 NORMAL (U"If the file contains more than one object, these objects will appear in the list, "
4354 	"and their names will be the same as the names that they had "
4355 	"when they were saved with ##Save as text file...# or ##Save as binary file...#.")
4356 ENTRY (U"Examples")
4357 LIST_ITEM (U"• If the file contains only one Pitch object and is called \"hallo.pit\", "
4358 	"an object with the name \"Pitch hallo\" will appear in the list of objects. "
4359 	"You may have more objects with the same name.")
4360 LIST_ITEM (U"• If the file contains one object of type Pitch, named \"hallo\", "
4361 	"and one object of type Polygon, named \"kromme\", "
4362 	"there will appear two objects in the list, "
4363 	"called \"Pitch hallo\" and \"Polygon kromme\".")
4364 MAN_END
4365 
4366 MAN_BEGIN (U"Open menu", U"ppgb", 20110111)
4367 INTRO (U"One of the menus in the @@Object window@.")
4368 NORMAL (U"With the Open menu, you read one or more @objects from a file on disk into memory. "
4369 	"The resulting object(s) will appear in the @@List of Objects@.")
4370 NORMAL (U"The Open menu contains the command @@Read from file...@, which recognizes most file types, "
4371 	"and perhaps several other commands for reading unrecognizable file types (e.g., raw sound data), "
4372 	"or for interpreting known file types in a different way "
4373 	"(e.g., reading two mono sounds from one stereo sound file):")
4374 MAN_END
4375 
4376 MAN_BEGIN (U"Remove", U"ppgb", 20021212)
4377 INTRO (U"One of the fixed buttons in the @@Object window@.")
4378 NORMAL (U"You can choose this command after selecting one or more @objects in the list.")
4379 NORMAL (U"The selected objects will permanently disappear from the list, "
4380 	"and the computer memory that they occupied will be freed.")
4381 NORMAL (U"To save your data before removing, choose a command from the @@Save menu@.")
4382 MAN_END
4383 
4384 MAN_BEGIN (U"Rename...", U"ppgb", 20111018)
4385 INTRO (U"One of the fixed buttons in the @@Object window@.")
4386 ENTRY (U"Availability")
4387 NORMAL (U"You can choose this command after selecting one object of any type.")
4388 ENTRY (U"Purpose")
4389 NORMAL (U"You can give the selected object a new name.")
4390 ENTRY (U"Behaviour")
4391 NORMAL (U"If you type special symbols or spaces, the Object window will replace them with underscores.")
4392 MAN_END
4393 
4394 MAN_BEGIN (U"Resource fork", U"ppgb", 20030316)
4395 INTRO (U"One of the two %forks of a Macintosh file (the other is the %%data fork%). "
4396 	"If a Macintosh file is moved to another platform directly, the resource fork is lost. "
4397 	"To backup your Macintosh files, use compression, for instance with #DropStuff\\tm.")
4398 MAN_END
4399 
4400 MAN_BEGIN (U"Save menu", U"ppgb", 20211015)
4401 INTRO (U"One of the menus in the @@Object window@.")
4402 ENTRY (U"Purpose")
4403 NORMAL (U"With the #Save menu, you write one or more selected @objects from memory to a file on disk. "
4404 	"The data can be read in again with one of the commands in the @@Open menu@ "
4405 	"(most often simply with @@Read from file...@).")
4406 ENTRY (U"Usage: save your work")
4407 NORMAL (U"You will often choose a command from this menu just before clicking the @Remove button "
4408 	"or choosing the @Quit command.")
4409 ENTRY (U"Fixed commands")
4410 NORMAL (U"If no object is selected, the #Save menu is empty. "
4411 	"If any object is selected, it will at least contain the following commands:")
4412 LIST_ITEM (U"• @@Save as text file...")
4413 LIST_ITEM (U"• @@Save as short text file...")
4414 LIST_ITEM (U"• @@Save as binary file...")
4415 ENTRY (U"Dynamic commands")
4416 NORMAL (U"Depending on the type of the selected object, the following commands may be available "
4417 	"in the #Save menu:")
4418 MAN_END
4419 
4420 MAN_BEGIN (U"Save as binary file...", U"ppgb", 20110129)
4421 INTRO (U"One of the commands in the @@Save menu@.")
4422 ENTRY (U"Availability")
4423 NORMAL (U"You can choose this command after selecting one or more @objects.")
4424 ENTRY (U"Behaviour")
4425 NORMAL (U"The Object window will ask you for a file name. "
4426 	"After you click OK, the objects will be written to a binary file on disk.")
4427 ENTRY (U"Usage")
4428 NORMAL (U"The file can be read again with @@Read from file...@.")
4429 ENTRY (U"File format")
4430 NORMAL (U"These files are in a device-independent binary format, "
4431 	"and can be written and read on any machine.")
4432 MAN_END
4433 
4434 MAN_BEGIN (U"Save as short text file...", U"ppgb", 20110129)
4435 INTRO (U"One of the commands in the @@Save menu@.")
4436 ENTRY (U"Availability")
4437 NORMAL (U"You can choose this command after selecting one or more @objects.")
4438 ENTRY (U"Behaviour")
4439 NORMAL (U"The Object window will ask you for a file name. "
4440 	"After you click OK, the objects will be written to a text file on disk.")
4441 ENTRY (U"File format")
4442 NORMAL (U"The format is much shorter than the one described at @@Save as text file...@. "
4443 	"Most of the comments are gone, and there is normally one piece of data per line.")
4444 NORMAL (U"The file can be read again with the all-purpose @@Read from file...@.")
4445 MAN_END
4446 
4447 MAN_BEGIN (U"Save as text file...", U"ppgb", 20110129)
4448 INTRO (U"One of the commands in the @@Save menu@.")
4449 ENTRY (U"Availability")
4450 NORMAL (U"You can choose this command after selecting one or more @objects.")
4451 ENTRY (U"Behaviour")
4452 NORMAL (U"The Object window will ask you for a file name. "
4453 	"After you click OK, the objects will be written to a text file on disk.")
4454 ENTRY (U"File format")
4455 NORMAL (U"If you selected a single object, e.g., of type Pitch, "
4456 	"the file will start with the lines:")
4457 CODE (U"File type = \"ooTextFile\"")
4458 CODE (U"Object class = \"Pitch\"")
4459 NORMAL (U"After this, the pitch data will follow.")
4460 LIST_ITEM (U"If you selected more than one object, e.g., `Pitch hallo' and `Polygon kromme', "
4461 	"the file will look like:")
4462 CODE (U"File type = \"ooTextFile\"")
4463 CODE (U"Object class = \"Collection\"")
4464 CODE (U"size = 2")
4465 CODE (U"item []:")
4466 CODE (U"    item [1]:")
4467 CODE (U"        class = \"Pitch\"")
4468 CODE (U"        name = \"hallo\"")
4469 CODE (U"        (pitch data...)")
4470 CODE (U"    item [2]:")
4471 CODE (U"        class = \"Polygon\"")
4472 CODE (U"        name = \"kromme\"")
4473 CODE (U"        (polygon data...)")
4474 NORMAL (U"The file can be read again with @@Read from file...@, "
4475 	"which, by the way, does not need the verbosity of the above example. "
4476 	"The following minimal format will also be read correctly:")
4477 CODE (U"\"ooTextFile\"")
4478 CODE (U"\"Collection\"  2")
4479 CODE (U"\"Pitch\"  \"hallo\"  (pitch data...)")
4480 CODE (U"\"Polygon\"  \"kromme\"  (polygon data...)")
4481 NORMAL (U"Thus, all text that is not a free-standing number and is not enclosed in double quotes or < >, "
4482 	"is considered a comment, as is all text following an exclamation mark (`!') on the same line.")
4483 MAN_END
4484 
4485 MAN_BEGIN (U"Segmentation", U"ppgb", 20010408)
4486 INTRO (U"See @@Intro 7. Annotation@.")
4487 MAN_END
4488 
4489 MAN_BEGIN (U"Show formant", U"ppgb", 20030316)
4490 INTRO (U"One of the commands in the Formant menu of the @SoundEditor and the @TextGridEditor.")
4491 NORMAL (U"See @@Intro 5. Formant analysis@.")
4492 MAN_END
4493 
4494 MAN_BEGIN (U"Show intensity", U"ppgb", 20030316)
4495 INTRO (U"One of the commands in the Intensity menu of the @SoundEditor and the @TextGridEditor.")
4496 NORMAL (U"See @@Intro 6. Intensity analysis@.")
4497 MAN_END
4498 
4499 MAN_BEGIN (U"Show pitch", U"ppgb", 20030316)
4500 INTRO (U"One of the commands in the Pitch menu of the @SoundEditor and the @TextGridEditor.")
4501 NORMAL (U"See @@Intro 4. Pitch analysis@.")
4502 MAN_END
4503 
4504 MAN_BEGIN (U"Show pulses", U"ppgb", 20030316)
4505 INTRO (U"One of the commands in the Pulses menu of the @SoundEditor and the @TextGridEditor.")
4506 NORMAL (U"See @Voice.")
4507 MAN_END
4508 
4509 MAN_BEGIN (U"Show spectrogram", U"ppgb", 20030316)
4510 INTRO (U"One of the commands in the Spectrogram menu of the @SoundEditor and the @TextGridEditor.")
4511 NORMAL (U"See @@Intro 3. Spectral analysis@.")
4512 MAN_END
4513 
4514 MAN_BEGIN (U"Source-filter synthesis", U"ppgb", 20050713)
4515 INTRO (U"This tutorial describes how you can do acoustic synthesis with Praat. "
4516 	"It assumes that you are familiar with the @Intro.")
4517 ENTRY (U"1. The source-filter theory of speech production")
4518 NORMAL (U"The source-filter theory (@@Fant (1960)|Fant 1960@) hypothesizes that an acoustic speech signal can be seen "
4519 	"as a %source signal (the glottal source, or noise generated at a constriction in the vocal tract), "
4520 	"%filtered with the resonances in the cavities of the vocal tract downstream from the glottis "
4521 	"or the constriction. The %%Klatt synthesizer% (@@Klatt & Klatt (1990)|Klatt & Klatt 1990@), for instance, "
4522 	"is based on this idea.")
4523 NORMAL (U"In the Praat program, you can create a %source signal from scratch of from an existing "
4524 	"speech signal, and you can create a %filter from scratch or extract it from an existing speech signal. "
4525 	"You can manipulate (change, adapt) both the source and the filter before doing "
4526 	"the actual synthesis, which combines the two.")
4527 LIST_ITEM (U"@@Source-filter synthesis 1. Creating a source from pitch targets")
4528 LIST_ITEM (U"@@Source-filter synthesis 2. Filtering a source")
4529 LIST_ITEM (U"@@Source-filter synthesis 3. The ba-da continuum")
4530 LIST_ITEM (U"@@Source-filter synthesis 4. Using existing sounds")
4531 MAN_END
4532 
4533 MAN_BEGIN (U"Source-filter synthesis 1. Creating a source from pitch targets", U"ppgb", 20140421)
4534 INTRO (U"Creating a glottal source signal for speech synthesis involves creating a @PointProcess, "
4535 	"which is a series of time points that should represent the exact moments of glottal closure.")
4536 NORMAL (U"You may want to start with creating a well-defined pitch contour. "
4537 	"Suppose you want to create a sound with a duration of half a second with a pitch that falls from 300 to 200 Hz "
4538 	"during that time. You first create an empty @PitchTier by choosing @@Create PitchTier...@ from the #New menu "
4539 	"(I call this PitchTier \"empty\" because it does not contain any pitch information yet); "
4540 	"you may want to name the PitchTier \"source\" and have it start at 0 seconds and end at 0.5 seconds. "
4541 	"Once the PitchTier exists and is selected, you can ##View & Edit# it to add pitch points (pitch targets) to it at certain times "
4542 	"(or you choose @@PitchTier: Add point...@ from the #Modify menu repeatedly). "
4543 	"You could add a pitch point of 150 Hz at time 0.0 and a pitch point of 100 Hz at time 0.5. "
4544 	"In the PitchTier window, you can see that the pitch curve falls linearly "
4545 	"from 150 to 100 Hz during its time domain:")
4546 SCRIPT (4.5, 2.5,
4547 	U"Create PitchTier... source 0 0.5\n"
4548 	"Add point... 0.0 150\n"
4549 	"Add point... 0.5 100\n"
4550 	"Draw... 0 0 0 200 yes lines and speckles\n"
4551 	"Text top... no %%An F0 linearly falling between two points\n"
4552 	"One mark left... 100 yes yes no\n"
4553 	"Remove\n"
4554 )
4555 NORMAL (U"You can hear the falling pitch by clicking on the rectangles in the PitchTier window "
4556 	"(or by clicking ##Play pulses#, #Hum, or ##Play sine# in the Objects window).")
4557 NORMAL (U"From this PitchTier, you can create a @PointProcess with @@PitchTier: To PointProcess@. "
4558 	"The resulting PointProcess now represents a series of glottal pulses. To make some parts of this "
4559 	"point process voiceless, you can use @@PointProcess: Remove points between...@. "
4560 	"It is advisable to make the very beginning and end of this point process voiceless, so that the filtered sound "
4561 	"will not start or end abruptly. In the following example, the first and last 20 ms are devoiced, "
4562 	"and a stretch of 70 ms in the middle "
4563 	"is made voiceless as well, perhaps because you want to simulate a voiceless plosive there:")
4564 SCRIPT (4.5, 2.5,
4565 	U"pitchTier = Create PitchTier... source 0 0.5\n"
4566 	"Add point... 0.0 150\n"
4567 	"Add point... 0.5 100\n"
4568 	"pulses = To PointProcess\n"
4569 	"Remove points between... 0 0.02\n"
4570 	"Remove points between... 0.24 0.31\n"
4571 	"Remove points between... 0.48 0.5\n"
4572 	"Draw... 0 0 yes\n"
4573 	"Text top... no %%The times of the glottal pulses\n"
4574 	"One mark bottom... 0.24 yes yes no\n"
4575 	"One mark bottom... 0.31 yes yes no\n"
4576 	"plus pitchTier\n"
4577 	"Remove\n"
4578 )
4579 NORMAL (U"Now that we have a glottal point process (a glottal pulse train), the only thing left "
4580 	"is to turn it into a sound by choosing @@PointProcess: To Sound (phonation)...@. "
4581 	"If you use the standard settings of this command (but with ##Adaptation factor# set to 0.6), the result will be a @Sound with "
4582 	"reasonable glottal flow derivatives centred around each of the original pulses in the point process. "
4583 	"You can check this by selecting the Sound and choosing ##View & Edit#:")
4584 SCRIPT (4.5, 2.5,
4585 	U"pitchTier = Create PitchTier... source 0 0.5\n"
4586 	"Add point... 0.0 150\n"
4587 	"Add point... 0.5 100\n"
4588 	"pulses = To PointProcess\n"
4589 	"Remove points between... 0 0.02\n"
4590 	"Remove points between... 0.24 0.31\n"
4591 	"Remove points between... 0.48 0.5\n"
4592 	"source = To Sound (phonation)... 44100 0.6 0.05 0.7 0.03 3.0 4.0\n"
4593 	"Draw... 0 0 0 0 yes curve\n"
4594 	"Text top... no %%The source waveform\n"
4595 	"One mark bottom... 0.24 yes yes no\n"
4596 	"One mark bottom... 0.31 yes yes no\n"
4597 	"plus pitchTier\n"
4598 	"plus pulses\n"
4599 	"Remove\n"
4600 )
4601 NORMAL (U"You will also see that the amplitude of the first two glottal wave shapes of every voiced stretch "
4602 	"is (realistically) somewhat smaller than the amplitudes of the following wave shapes; "
4603 	"This is the result of setting ##Adaptation factor# to 0.6.")
4604 NORMAL (U"What you have now is what we call a %%glottal source signal%. It does two things: it contains information on the glottal flow, "
4605 	"and it already takes into account one aspect of the %filter, namely the radiation at the lips. "
4606 	"This combination is standard procedure in acoustic synthesis.")
4607 NORMAL (U"The glottal source signal sounds as a voice without a vocal tract. "
4608 	"The following section describes how you add vocal-tract resonances, i.e. the %filter.")
4609 ENTRY (U"Automation")
4610 NORMAL (U"In a clean Praat script, the procedure described above will look as follows:")
4611 CODE (U"pitchTier = Create PitchTier: \"source\", 0, 0.5")
4612 CODE (U"Add point: 0.0, 150")
4613 CODE (U"Add point: 0.5, 100")
4614 CODE (U"pulses = To PointProcess")
4615 CODE (U"Remove points between: 0, 0.02")
4616 CODE (U"Remove points between: 0.24, 0.31")
4617 CODE (U"Remove points between: 0.48, 0.5")
4618 CODE (U"source = To Sound (phonation): 44100, 0.6, 0.05, 0.7, 0.03, 3.0, 4.0")
4619 CODE (U"removeObject: pitchTier, pulses")
4620 CODE (U"selectObject: source")
4621 MAN_END
4622 
4623 MAN_BEGIN (U"Source-filter synthesis 2. Filtering a source", U"ppgb", 20140421)
4624 INTRO (U"Once you have a glottal source signal, you are ready to create a filter that represents "
4625 	"the resonances of the vocal tract, as a function of time. In other words, you create a @FormantGrid object.")
4626 NORMAL (U"For a vowel spoken by an average (i.e. adult female) human voice, tradition assumes five formants in the range "
4627 	"between 0 and 5500 hertz. This number comes from a computation of the formants of a "
4628 	"straight tube, which has resonances at wavelengths of four tube lengths, four thirds of a tube length, "
4629 	"four fifths, and so on. For a straight tube 16 centimetres long, the shortest wavelength is 64 cm, "
4630 	"which, with a sound velocity of 352 m/s, means a resonance frequency of 352/0.64 = 550 hertz. "
4631 	"The other resonances will be at 1650, 2750, 3850, and 4950 hertz.")
4632 NORMAL (U"You can create a @FormantGrid object with @@Create FormantGrid...@ from the #New menu (submenu #Tiers):")
4633 CODE (U"Create FormantGrid: \"filter\", 0, 0.5, 10, 550, 1100, 60, 50")
4634 NORMAL (U"This creates a FormantGrid with 10 formants and a single frequency value for each formant: %F__1_ is 550 Hz "
4635 	"and the higher formants are spaced 1100 Hz apart, i.e., they are "
4636 	"1650, 2750, 3850, 4950, 6050, 7150, 8250, 9350, and 10450 hertz; "
4637 	"the ten bandwidths start at 60 Hz and have a spacing of 50 Hz, "
4638 	"i.e., they are 60, 110, 160, 210, 260, 310, 360, 410, 460, and 510 hertz.")
4639 NORMAL (U"You can then create formant contours with @@FormantGrid: Add formant point...@:")
4640 CODE (U"Remove formant points between: 1, 0, 0.5")
4641 CODE (U"Add formant point: 1, 0.00, 100")
4642 CODE (U"Add formant point: 1, 0.05, 700")
4643 CODE (U"Remove formant points between: 2, 0, 0.5")
4644 CODE (U"Add formant point: 2, 0.00, 500")
4645 CODE (U"Add formant point: 2, 0.05, 1100")
4646 NORMAL (U"This example creates a spectral specification whose %F__1_ rises from 100 to 700 hertz during the "
4647 	"first 50 milliseconds (as for any obstruent), and whose %F__2_ rises from 500 to 1100 hertz. "
4648 	"The other eight formants keep their original values, as do the ten bandwidths. "
4649 	"The resulting sound may be a [ba]-like formant transition.")
4650 NORMAL (U"To get the final acoustic result (the sound), you select the glottal source signal "
4651 	"together with the FormantGrid and choose @@Sound & FormantGrid: Filter@.")
4652 NORMAL (U"The resulting sound will have a fairly straight intensity contour. You can change this with "
4653 	"the #Formula command (@@Sound: Formula...@), or by multiplying the source signal or the "
4654 	"acoustic result with an @Intensity or @IntensityTier object.")
4655 MAN_END
4656 
4657 MAN_BEGIN (U"Source-filter synthesis 3. The ba-da continuum", U"ppgb", 20140421)
4658 INTRO (U"As an example, we are going to create a male [ba]-[da] continuum in six steps. The acoustic difference "
4659 	"between [ba] and [da] is the initial %F__2_, which is 500 Hz for [ba], and 2500 Hz for [da].")
4660 NORMAL (U"We use the same @PitchTier throughout, to model a falling intonation contour:")
4661 CODE (U"Create PitchTier: \"f0\", 0.00, 0.50")
4662 CODE (U"Add point: 0.00, 150")
4663 CODE (U"Add point: 0.50, 100")
4664 NORMAL (U"The first and last 50 milliseconds are voiceless:")
4665 CODE (U"To PointProcess")
4666 CODE (U"Remove points between: 0.00, 0.05")
4667 CODE (U"Remove points between: 0.45, 0.50")
4668 NORMAL (U"Generate the glottal source signal:")
4669 CODE (U"To Sound (phonation): 44100, 0.6, 0.05, 0.7, 0.03, 3.0, 4.0")
4670 NORMAL (U"During the labial or coronal closure, the sound is almost silent, so we use an @IntensityTier "
4671 	"that models this:")
4672 CODE (U"Create IntensityTier: \"intens\", 0.00, 0.50")
4673 CODE (U"Add point: 0.05, 60")
4674 CODE (U"Add point: 0.10, 80")
4675 NORMAL (U"Generate the source signal:")
4676 CODE (U"#plusObject: \"Sound f0\"")
4677 CODE (U"Multiply")
4678 CODE (U"Rename: \"source\"")
4679 NORMAL (U"The ten sounds are generated in a loop:")
4680 CODE (U"#for i #from 1 #to 10")
4681 	CODE1 (U"f2_locus = 500 + (2500/9) * (i - 1) ; variable names start with lower case!")
4682 	CODE1 (U"Create FormantGrid: \"filter\", 0.0, 0.5, 9, 800, 1000, 60, 80")
4683 	CODE1 (U"Remove formant points between: 1, 0.0, 0.5")
4684 	CODE1 (U"Add formant point: 1, 0.05, 100")
4685 	CODE1 (U"Add bandwidth point: 1, 0.05, 50")
4686 	CODE1 (U"Add formant point: 2, 0.05, f2_locus")
4687 	CODE1 (U"Add bandwidth point: 2, 0.05, 100")
4688 	CODE1 (U"#plusObject: \"Sound source\"")
4689 	CODE1 (U"Filter (no scale)")
4690 	CODE1 (U"Rename: \"bada\" + string\\$  (i)")
4691 	CODE1 (U"#removeObject: \"FormantGrid filter\"")
4692 CODE (U"#endfor")
4693 NORMAL (U"Clean up:")
4694 CODE (U"#removeObject: \"Sound source\", \"Sound f0\", \"IntensityTier intens\",")
4695 CODE (U"... \"PointProcess f0\", \"PitchTier f0\"")
4696 NORMAL (U"In this example, filtering was done without automatic scaling, so that "
4697 	"the resulting signals have equal intensities in the areas where they have "
4698 	"equal formants. You will probably want to multiply all these signals with "
4699 	"the same value in order to bring their amplitudes in a suitable range "
4700 	"between -1 and +1 Pascal.")
4701 MAN_END
4702 
4703 MAN_BEGIN (U"Source-filter synthesis 4. Using existing sounds", U"ppgb", 20170828)
4704 ENTRY (U"1. How to extract the %filter from an existing speech sound")
4705 NORMAL (U"You can separate source and filter with the help of the technique of %%linear prediction% "
4706 	"(see @@Sound: LPC analysis@). This technique tries to approximate a given frequency spectrum with "
4707 	"a small number of peaks, for which it finds the mid frequencies and the bandwidths. "
4708 	"If we do this for an overlapping sequence of windowed parts of a sound signal "
4709 	"(i.e. a %%short-term analysis%), we get a quasi-stationary approximation of the signal's "
4710 	"spectral characteristics as a function of time, i.e. a smoothed version of the @Spectrogram.")
4711 NORMAL (U"For a speech signal, the peaks are identified with the resonances (%formants) of the vocal tract. "
4712 	"Since the spectrum of a vowel spoken by an average human being falls off with approximately "
4713 	"6 dB per octave, %%pre-emphasis% is applied to the signal before the linear-prediction analysis, "
4714 	"so that the algorithm will not try to match only the lower parts of the spectrum.")
4715 NORMAL (U"For an adult female human voice, tradition assumes five formants in the range "
4716 	"between 0 and 5500 hertz, say at 550, 1650, 2750, 3850, and 4950 hertz. For the linear prediction in "
4717 	"Praat, you will have to implement this 5500-Hz band-limiting by resampling the original "
4718 	"speech signal to 11 kHz. For a male voice, you would use 10 kHz; for a young child, 20 kHz.")
4719 NORMAL (U"To perform the resampling, you use @@Sound: Resample...@: "
4720 	"you select a @Sound object, and click ##Resample...#. "
4721 	"In the rest of this tutorial, I will use the syntax that you would use in a script, "
4722 	"though you will usually do these things by clicking on objects and buttons. Thus:")
4723 CODE (U"#selectObject: \"Sound hallo\"")
4724 CODE (U"Resample: 11000, 50")
4725 NORMAL (U"You can then perform a linear-prediction analysis on the resampled sound "
4726 	"with @@Sound: To LPC (burg)...@:")
4727 CODE (U"#selectObject: \"Sound hallo_11000\"")
4728 CODE (U"To LPC (burg): 10, 0.025, 0.005, 50")
4729 NORMAL (U"This says that your analysis is done with 10 linear-prediction parameters "
4730 	"(which will yield at most five formant-bandwidth pairs), with an analysis window "
4731 	"effectively 25 milliseconds long, with time steps of 5 milliseconds (so that the windows "
4732 	"will appreciably overlap), and with a pre-emphasis frequency of 50 Hz (which is the point "
4733 	"above which the sound will be amplified by 6 dB/octave prior to the analysis proper).")
4734 NORMAL (U"As a result, an object called \"LPC hallo\" will appear in the list of objects. "
4735 	"This @LPC object is a time function with 10 %%linear-prediction coefficients% in each %%time frame%. "
4736 	"These coefficients are rather opaque even to the expert (try to view them with @Inspect), "
4737 	"but they are the raw material from which formant and bandwidth values can be computed. "
4738 	"To see the smoothed @Spectrogram associated with the LPC object, choose @@LPC: To Spectrogram...@:")
4739 CODE (U"#selectObject: \"LPC hallo_11000\"")
4740 CODE (U"To Spectrogram: 20, 0, 50")
4741 CODE (U"Paint: 0, 0, 0, 0, 50, 0, 0, \"yes\"")
4742 NORMAL (U"Note that when drawing this Spectrogram, you will want to set the pre-emphasis to zero "
4743 	"(the fifth 0 in the last line), because pre-emphasis has already been applied in the analysis.")
4744 NORMAL (U"You can get and draw the formant-bandwidth pairs from the LPC object, "
4745 	"with @@LPC: To Formant@ and @@Formant: Speckle...@:")
4746 CODE (U"#selectObject: \"LPC hallo_11000\"")
4747 CODE (U"To Formant")
4748 CODE (U"Speckle: 0, 0, 5500, 30, \"yes\"")
4749 NORMAL (U"Note that in converting the @LPC into a @Formant object, you may have lost some "
4750 	"information about spectral peaks at very low frequencies (below 50 Hz) or at very high "
4751 	"frequencies (near the @@Nyquist frequency@ of 5500 Hz. Such peaks usually try to fit "
4752 	"an overall spectral slope (if the 6 dB/octave model is inappropriate), and are not seen "
4753 	"as related with resonances in the vocal tract, so they are ignored in a formant analysis. "
4754 	"For resynthesis purposes, they might still be important.")
4755 NORMAL (U"Instead of using the intermediate LPC object, you could have done a formant analysis "
4756 	"directly on the original Sound, with @@Sound: To Formant (burg)...@:")
4757 CODE (U"#selectObject: \"Sound hallo\"")
4758 CODE (U"To Formant (burg): 0.005, 5, 5500, 0.025, 50")
4759 NORMAL (U"A @Formant object has a fixed sampling (time step, frame length), and for every "
4760 	"%%formant frame%, it contains a number of formant-bandwidth pairs.")
4761 NORMAL (U"From a Formant object, you can create a @FormantGrid with @@Formant: Down to FormantGrid@. "
4762 	"A FormantGrid object contains a number of tiers with time-stamped %%formant points% and %%bandwidth points%.")
4763 NORMAL (U"Any of these three types (@LPC, @Formant, and @FormantGrid) can represent the %filter "
4764 	"in source-filter synthesis.")
4765 ENTRY (U"2. How to extract the %source from an existing speech sound")
4766 NORMAL (U"If you are only interested in the %filter characteristics, you can get by with @Formant objects. "
4767 	"To get at the %source signal, however, you need the raw @LPC object: "
4768 	"you select it together with the resampled @Sound, and apply %%inverse filtering%:")
4769 CODE (U"#selectObject: \"Sound hallo_11000\", \"LPC hallo_11000\"")
4770 CODE (U"Filter (inverse)")
4771 NORMAL (U"A new Sound named \"hallo_11000\" will appear in the list of objects "
4772 	"(you could rename it to \"source\"). "
4773 	"This is the estimated source signal. Since the LPC analysis was designed to yield a spectrally "
4774 	"flat filter (through the use of pre-emphasis), this source signal represents everything in the "
4775 	"speech signal that cannot be attributed to the resonating cavities. Thus, the \"source signal\" "
4776 	"will consist of the glottal volume-velocity source (with an expected spectral slope of "
4777 	"-12 dB/octave for vowels) and the radiation characteristics at the lips, which cause a "
4778 	"6 dB/octave spectral rise, so that the resulting spectrum of the \"source signal\" "
4779 	"is actually the %derivative of the glottal flow, with an expected spectral slope of -6 dB/octave.")
4780 NORMAL (U"Note that with inverse filtering you cannot measure the actual spectral slope of the source signal. "
4781 	"Even if the actual slope is very different from -6 dB/octave, formant extraction will try to "
4782 	"match the pre-emphasized spectrum. Thus, by choosing a pre-emhasis of -6 dB/octave, "
4783 	"you %impose a slope of -6 dB/octave on the source signal.")
4784 ENTRY (U"3. How to do the synthesis")
4785 NORMAL (U"You can create a new Sound from a source Sound and a filter, in at least four ways.")
4786 NORMAL (U"If your filter is an @LPC object, you select it and the source, and choose @@LPC & Sound: Filter...@:")
4787 CODE (U"#selectObject: \"Sound source\", \"LPC filter\"")
4788 CODE (U"Filter: \"no\"")
4789 NORMAL (U"If you had computed the source and filter from an LPC analysis, this procedure should give "
4790 	"you back the original Sound, except that windowing has caused 25 milliseconds at the beginning "
4791 	"and end of the signal to be set to zero.")
4792 NORMAL (U"If your filter is a @Formant object, you select it and the source, and choose @@Sound & Formant: Filter@:")
4793 CODE (U"#selectObject: \"Sound source\", \"Formant filter\"")
4794 CODE (U"Filter")
4795 NORMAL (U"If you had computed the source and filter from an LPC analysis, this procedure will not generally give "
4796 	"you back the original Sound, because some linear-prediction coefficients will have been ignored "
4797 	"in the conversion to formant-bandwidth pairs.")
4798 NORMAL (U"If your filter is a @FormantGrid object, you select it and the source, and choose @@Sound & FormantGrid: Filter@:")
4799 CODE (U"#selectObject: \"Sound source\", \"FormantGrid filter\"")
4800 CODE (U"Filter")
4801 NORMAL (U"Finally, you could just know the %%impulse response% of your filter (in a @Sound object). "
4802 	"You then select both Sound objects, and choose @@Sounds: Convolve...@:")
4803 CODE (U"#selectObject: \"Sound source\", \"Sound filter\"")
4804 CODE (U"Convolve: \"integral\", \"zero\"")
4805 NORMAL (U"As a last step, you may want to bring the resulting sound within the [-1; +1] range:")
4806 CODE (U"Scale peak: 0.99")
4807 ENTRY (U"4. How to manipulate the filter")
4808 NORMAL (U"You can hardly change the values in an @LPC object in a meaningful way: "
4809 	"you would have to manually change its rather opaque data with the help of @Inspect.")
4810 NORMAL (U"A @Formant object can be changed in a friendlier way, with @@Formant: Formula (frequencies)...@ "
4811 	"and @@Formant: Formula (bandwidths)...@. For instance, to multiply all formant frequencies by 0.9, "
4812 	"you do")
4813 CODE (U"#selectObject: \"Formant filter\"")
4814 CODE (U"Formula (frequencies): \"self * 0.9\"")
4815 NORMAL (U"To add 200 hertz to all values of %F__2_, you do")
4816 CODE (U"Formula (frequencies): ~ if row = 2 then self + 200 else self fi")
4817 NORMAL (U"A @FormantGrid object can be changed by adding or removing points:")
4818 LIST_ITEM (U"@@FormantGrid: Add formant point...@")
4819 LIST_ITEM (U"@@FormantGrid: Add bandwidth point...@")
4820 LIST_ITEM (U"@@FormantGrid: Remove formant points between...@")
4821 LIST_ITEM (U"@@FormantGrid: Remove bandwidth points between...@")
4822 ENTRY (U"5. How to manipulate the source signal")
4823 NORMAL (U"You can manipulate the source signal in the same way you that would manipulate any sound, "
4824 	"for instance with the @ManipulationEditor.")
4825 MAN_END
4826 
4827 MAN_BEGIN (U"Spectrogram settings...", U"ppgb", 20030316)
4828 INTRO (U"A command in the Spectrogram menu of the @SoundEditor and @TextGridEditor windows. "
4829 	"See @@Intro 3.2. Configuring the spectrogram@.")
4830 MAN_END
4831 
4832 MAN_BEGIN (U"Technical", U"ppgb", 20120915)
4833 INTRO (U"The title of a submenu of the @@Praat menu@.")
4834 MAN_END
4835 
4836 MAN_BEGIN (U"Types of objects", U"ppgb", 20190928)
4837 INTRO (U"Praat contains the following types of objects and @Editors. "
4838 	"For an introduction and tutorials, see @Intro.")
4839 NORMAL (U"General purpose:")
4840 LIST_ITEM (U"• @Matrix: a sampled real-valued function of two variables")
4841 LIST_ITEM (U"• @Polygon")
4842 LIST_ITEM (U"• @PointProcess: a point process (@PointEditor)")
4843 LIST_ITEM (U"• @Sound: a sampled continuous process (@SoundEditor, @SoundRecorder, @@Sound files@)")
4844 LIST_ITEM (U"• @LongSound: a file-based version of a sound (@LongSoundEditor)")
4845 LIST_ITEM (U"• @Strings")
4846 LIST_ITEM (U"• @Distributions, @PairDistribution")
4847 LIST_ITEM (U"• @Table, @TableOfReal")
4848 LIST_ITEM (U"• @Permutation")
4849 LIST_ITEM (U"• @ParamCurve")
4850 NORMAL (U"Periodicity analysis:")
4851 LIST_ITEM (U"• Tutorials:")
4852 LIST_ITEM1 (U"• @@Intro 4. Pitch analysis")
4853 LIST_ITEM1 (U"• @@Intro 6. Intensity analysis")
4854 LIST_ITEM1 (U"• @Voice (jitter, shimmer, noise)")
4855 LIST_ITEM (U"• @Pitch: articulatory fundamental frequency, acoustic periodicity, or perceptual pitch (@PitchEditor)")
4856 LIST_ITEM (U"• @Harmonicity: degree of periodicity")
4857 LIST_ITEM (U"• @Intensity, @IntensityTier: intensity contour")
4858 LIST_ITEM (U"• @Electroglottogram")
4859 NORMAL (U"Spectral analysis:")
4860 LIST_ITEM (U"• Tutorials:")
4861 LIST_ITEM1 (U"• @@Intro 3. Spectral analysis")
4862 LIST_ITEM1 (U"• @@Intro 5. Formant analysis")
4863 LIST_ITEM (U"• @Spectrum: complex-valued equally spaced frequency spectrum (@SpectrumEditor)")
4864 LIST_ITEM (U"• @Ltas: long-term average spectrum")
4865 LIST_ITEM (U"• Spectro-temporal: @Spectrogram, @BarkSpectrogram, @MelSpectrogram")
4866 LIST_ITEM (U"• @Formant: acoustic formant contours")
4867 LIST_ITEM (U"• @LPC: coefficients of Linear Predictive Coding, as a function of time")
4868 LIST_ITEM (U"• @Cepstrum, @CC, @LFCC, @MFCC (cepstral coefficients)")
4869 LIST_ITEM (U"• @Excitation: excitation pattern of basilar membrane")
4870 LIST_ITEM (U"• @Excitations: an ensemble of #Excitation objects")
4871 LIST_ITEM (U"• @Cochleagram: excitation pattern as a function of time")
4872 NORMAL (U"Labelling and segmentation (see @@Intro 7. Annotation@):")
4873 LIST_ITEM (U"• @TextGrid (@TextGridEditor)")
4874 NORMAL (U"Listening experiments:")
4875 LIST_ITEM (U"• @ExperimentMFC")
4876 NORMAL (U"Manipulation of sound:")
4877 LIST_ITEM (U"• Tutorials:")
4878 LIST_ITEM1 (U"• @@Intro 8.1. Manipulation of pitch")
4879 LIST_ITEM1 (U"• @@Intro 8.2. Manipulation of duration")
4880 LIST_ITEM1 (U"• @@Intro 8.3. Manipulation of intensity")
4881 LIST_ITEM1 (U"• @@Filtering")
4882 LIST_ITEM1 (U"• @@Source-filter synthesis")
4883 LIST_ITEM (U"• @PitchTier (@PitchTierEditor)")
4884 LIST_ITEM (U"• @Manipulation (@ManipulationEditor): @@overlap-add@")
4885 LIST_ITEM (U"• @DurationTier")
4886 LIST_ITEM (U"• @FormantGrid")
4887 NORMAL (U"Articulatory synthesis (see the @@Articulatory synthesis@ tutorial):")
4888 LIST_ITEM (U"• @Speaker: speaker characteristics of a woman, a man, or a child")
4889 LIST_ITEM (U"• #Articulation: snapshot of articulatory specifications (muscle activities)")
4890 LIST_ITEM (U"• @Artword: articulatory target specifications as functions of time")
4891 LIST_ITEM (U"• (@VocalTract: area function)")
4892 NORMAL (U"Neural net package:")
4893 LIST_ITEM (U"• @FFNet: feed-forward neural net")
4894 LIST_ITEM (U"• @PatternList")
4895 LIST_ITEM (U"• @Categories: for classification (#CategoriesEditor)")
4896 NORMAL (U"Numerical and statistical analysis:")
4897 LIST_ITEM (U"• @Eigen: eigenvectors and eigenvalues")
4898 LIST_ITEM (U"• @Polynomial, @Roots, @ChebyshevSeries, @LegendreSeries, @ISpline, @MSpline")
4899 LIST_ITEM (U"• @Covariance: covariance matrix")
4900 LIST_ITEM (U"• @Confusion: confusion matrix")
4901 LIST_ITEM (U"• @@Discriminant analysis@: @Discriminant")
4902 LIST_ITEM (U"• @@Principal component analysis@: @PCA")
4903 LIST_ITEM (U"• @Correlation, @ClassificationTable, @SSCP")
4904 LIST_ITEM (U"• @DTW: dynamic time warping")
4905 NORMAL (U"@@Multidimensional scaling@:")
4906 LIST_ITEM (U"• @Configuration (@Salience)")
4907 LIST_ITEM (U"• @@Kruskal analysis@: @Dissimilarity (@Weight), @Similarity")
4908 LIST_ITEM (U"• @@INDSCAL analysis@: @Distance, @ScalarProduct")
4909 LIST_ITEM (U"• @@Correspondence analysis@: @ContingencyTable")
4910 NORMAL (U"Optimality-theoretic learning (see the @@OT learning@ tutorial)")
4911 LIST_ITEM (U"• @OTGrammar (@OTGrammarEditor)")
4912 NORMAL (U"Bureaucracy")
4913 LIST_ITEM (U"• @WordList, @SpellingChecker")
4914 MAN_END
4915 
4916 MAN_BEGIN (U"Unicode", U"ppgb", 20110129)
4917 INTRO (U"Praat is becoming a fully international program: "
4918 	"the texts in Praat's TextGrids, Tables, scripts, or Info window (and elsewhere) can contain many types of characters "
4919 	"(see @@special symbols@). "
4920 	"For this reason, Praat saves its text files in one of two possible formats: ASCII or UTF-16.")
4921 ENTRY (U"ASCII text files")
4922 NORMAL (U"If your TextGrid (or Table, or script, or Info window...) contains only characters that can be encoded as ASCII, "
4923 	"namely the characters !\\\" \\# \\$ \\% &\\' ()*+,-./0123456789:;<=>?\\@  "
4924 	"ABCDEFGHIJKLMNOPQRSTUVWXYZ[\\bs]\\^ \\_ ` abcdefghijklmnopqrstuvwxyz{|}~, "
4925 	"then when you say @@Save as text file...@ or #Save, Praat will write an ASCII text file, "
4926 	"which is a text file in which every character is encoded in a single byte (8 bits). "
4927 	"All programs that can read plain text files can read such files produced by Praat.")
4928 ENTRY (U"UTF-16 text files")
4929 NORMAL (U"If your TextGrid (or Table, or script, or Info window...) contains one or more characters that cannot be encoded as ASCII, "
4930 	"for instance West-European characters such as \\ao\\c,\\e'\\o\"\\ss\\?d, East-European characters such as \\c<\\l/\\o:\\s<\\uo\\z', "
4931 	"or Hebrew characters such as \\?+\\B+\\G+\\M%\\vO\\sU, "
4932 	"then when you say @@Save as text file...@ or #Save, Praat will write an UTF-16 text file, "
4933 	"which is a text file in which every character is encoded in two bytes (and some very rare characters in four bytes). "
4934 	"Many programs can read such text files, for instance NotePad, WordPad, Microsoft Word, and TextWrangler.")
4935 ENTRY (U"What if my other programs cannot read UTF-16 text files?")
4936 NORMAL (U"If you want to export your Table to Microsoft Excel or to SPSS, or if you want your TextGrid file to be read "
4937 	"by somebody else's Perl script, then there will be no problem if your Table contains only ASCII characters (see above). "
4938 	"But if your Table contains any other (i.e. non-ASCII) characters, you may be in trouble, because Praat will write the Table "
4939 	"as an UTF-16 text file, and not all of the programs just mentioned can read such files yet.")
4940 NORMAL (U"What you can do is go to ##Text writing preferences...# in the #Preferences submenu of the #Praat menu, "
4941 	"and there set the output encoding to ##UTF-8#. Praat will from then on save your text files in the UTF-8 format, "
4942 	"which means one byte for every ASCII character and 2 to 4 bytes for every non-ASCII character. "
4943 	"Especially on Linux, many programs understand UTF-8 text and will display the correct characters. "
4944 	"Programs such as SPSS do not understand UTF-8 but will still display ASCII characters correctly; "
4945 	"for instance, the names München and Wałęsa may appear as M\\A~\\:-nchen and Wa\\Ao,\\A\"\\TMsa or so.")
4946 NORMAL (U"If you can get by with West-European characters (on Windows), "
4947 	"then you may choose ##try ISO Latin-1, then UTF-16# for the output encoding. "
4948 	"It is possible (but not guaranteed) that programs like SPSS then display your West-European text correctly. "
4949 	"This trick is of limited use, because it will not work if your operating system is set to a \"codepage\" "
4950 	"differently from ISO Latin-1 (or \"ANSI\"), or if you need East-European or Hebrew characters, or if you want "
4951 	"to share your text files with Macintosh users.")
4952 NORMAL (U"If you already have some UTF-16 text files and you want to convert them to UTF-8 or ISO Latin-1 (the latter only if "
4953 	"they do not contain non-West-European characters), then you can read them into Praat and save them again "
4954 	"(with the appropriate output encoding setting). "
4955 	"Other programs, such a NotePad and TextWrangler, can also do this conversion.")
4956 NORMAL (U"Finally, it is still possible to make sure that all texts are ASCII, e.g. you type the characters ß and ő "
4957 	"as \\bsss and \\bso: respectively. See @@special symbols@.")
4958 MAN_END
4959 
4960 MAN_BEGIN (U"View", U"ppgb", 20010512)
4961 INTRO (U"One of the menus in several @editors and in the @manual.")
4962 MAN_END
4963 
4964 }
4965 
4966 /*
4967 > I would like to be able to extract the duration
4968 > and pitch measurements of several words in each utterance
4969 
4970 # A Sound and a TextGrid have to be selected first.
4971 textgrid = selected ("TextGrid")
4972 sound = selected ("Sound")
4973 select 'sound'
4974 To Pitch... 0.001 75 600
4975 pitch = selected ("Pitch")
4976 select 'textgrid'
4977 numberOfIntervals = Get number of intervals... 1
4978 filedelete out.txt
4979 for interval to numberOfIntervals
4980    select 'textgrid'
4981    tmin = Get starting point... 1 interval
4982    tmax = Get end point... 1 interval
4983    duration = tmax - tmin
4984    select 'pitch'
4985    f0 = Get quantile... tmin tmax 0.50 Hertz
4986    fileappend out.txt 'duration:6' 'f0:3''newline$'
4987 endfor
4988 0.225953 377.677
4989 0.170586 376.039
4990 0.328049 376.521
4991 0.275413 378.538
4992 */
4993 
4994 /*
4995 echo Band powers:
4996 binWidth = Get bin width
4997 approximateDuration = 1 / binWidth
4998 call band 125 160
4999 call band 160 200
5000 call band 200 250
5001 call band 5000 6300
5002 
5003 procedure band fmin fmax
5004    bandEnergy = Get band energy... fmin fmax
5005    rmsPressure_Pascal = sqrt (bandEnergy / approximateDuration)
5006    intensity_dB = 20 * log10 (rmsPressure_Pascal / 2e-5)
5007    printline 'fmin'...'fmax': 'intensity_dB:2' dB
5008 endproc
5009 */
5010 
5011 /* drawing overwrites until Erase all */
5012 /* pitch in readable format */
5013 
5014 /* End of file manual_tutorials.cpp */
5015