docbook/kst/.gitignore

@@ -0,0 +1 @@
+*.html

docbook/kst/alternatehtml/alternate-index.html

@@ -531,7 +531,7 @@
 </span></dt><dd><p>
 Instead of specifying values for <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" style="background-color: rgb(240,240,240);   color: rgb(0,0,0);">From</span>, <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" style="background-color: rgb(240,240,240);   color: rgb(0,0,0);">to</span>, and
 <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" style="background-color: rgb(240,240,240);   color: rgb(0,0,0);">Num bins</span>, you can click <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" style="background-color: rgb(240,240,240);   color: rgb(0,0,0);">Auto Bin</span> to automatically generate
-values for all three fields based based on the lowest and highest values, as well as the number
+values for all three fields based on the lowest and highest values, as well as the number
 of elements found in the source vector.
 </p></dd></dl></div></div><div class="sect3"><div class="titlepage"><div><h4 class="title"><a name="yaxisnormalization"></a>Y Axis Normalization</h4></div></div><p>
 This section is used to specify the type of normalization used for the y axis of the histogram.
@@ -2198,7 +2198,7 @@
 same source file, sample ranges and fft lengths are used for all Power
 Spectra requested from the command line.
 </p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="option"><tt>-l P</tt></span></span></dt><dd><p>
-The length of the FFT used in power specra
+The length of the FFT used in power spectra
 estimation is 2^P.
 </p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="option"><tt>-h H</tt></span></span></dt><dd><p>
 The source for histograms.  For ASCII files, this

docbook/kst/commandline-chapter.docbook

@@ -124,7 +124,7 @@ Spectra requested from the command line.
 <term><option>-l P</option></term>
 <listitem>
 <para>
-The length of the FFT used in power specra
+The length of the FFT used in power spectra
 estimation is 2^P.
 </para>
 </listitem>

docbook/kst/data-chapter.docbook

@@ -1042,7 +1042,7 @@ Enter the total number of bins to use in the <guilabel>Num bins</guilabel> field
 <para>
 Instead of specifying values for <guilabel>From</guilabel>, <guilabel>to</guilabel>, and
 <guilabel>Num bins</guilabel>, you can click <guibutton>Auto Bin</guibutton> to automatically generate
-values for all three fields based based on the lowest and highest values, as well as the number
+values for all three fields based on the lowest and highest values, as well as the number
 of elements found in the source vector.
 </para>
 </listitem>

docbook/kst/index.docbook

@@ -1,8 +1,6 @@
 <?xml version="1.0" ?>
-  <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
+  <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" "dtd/kdedbx45.dtd" [
 
- <!ENTITY kappname "kst">
- <!ENTITY package "kdeextragear-2">
  <!ENTITY kst "<application>Kst</application>">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % English "INCLUDE" > <!-- change language only here -->
@@ -26,7 +24,7 @@
  <!ENTITY eventmonitoring-chapter SYSTEM "eventmonitoring-chapter.docbook">
  ]>
 
-<book lang="&language;">
+<book id="kst" lang="&language;">
 
 <bookinfo>
 <title>The &kst; Handbook</title>
@@ -44,10 +42,14 @@
 <affiliation><address><email>phil@kde.org</email></address>
 </affiliation>
 </author>
-</authorgroup>
-
-
+<author>
+<firstname>Barth</firstname>
+<othername></othername>
+<surname>Netterfield</surname>
+<affiliation><address><email>netterfield@astro.utoronto.ca</email></address></affiliation>
+</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
+</authorgroup>
 
 <copyright>
 <year>2004</year>
@@ -59,6 +61,11 @@
 <holder>The University of Toronto</holder>
 </copyright>
 
+<copyright>
+<year>2017</year>
+<holder>C. Barth Netterfield</holder>
+</copyright>
+
 <!-- Translators: put here the copyright notice of the translation -->
 <!-- Put here the FDL notice.  Read the explanation in fdl-notice.docbook
      and in the FDL itself on how to use it. -->
@@ -73,8 +80,8 @@ Please respect the format of the date (YYYY-MM-DD) and of the version
 (V.MM.LL), it could be used by automation scripts.
 Do NOT change these in the translation. -->
 
-<date>2005-04-14</date>
-<releaseinfo>1.2.0</releaseinfo>
+<date>2017-01-31</date>
+<releaseinfo>Kst 2.0.0</releaseinfo>
 
 <!-- Abstract about this handbook -->
 
@@ -90,8 +97,6 @@ Please at least include KDE, the KDE package it is in, the name
 
 <keywordset>
 <keyword>KDE</keyword>
-<keyword>kdeextragear</keyword>
-<keyword>kdeextragear-2</keyword>
 <keyword>Kst</keyword>
 <keyword>plotting</keyword>
 <keyword>plot</keyword>

docbook/kst/intro-chapter.docbook

@@ -8,14 +8,14 @@
 <itemizedlist>
 <listitem><para>Robust plotting of live "streaming" data.</para></listitem>
 <listitem><para>Powerful keyboard and mouse plot manipulation.</para></listitem>
-<listitem><para>Powerful plugins and extensions support.</para></listitem>
+<listitem><para>Plugin support.</para></listitem>
 <listitem><para>Large selection of built-in plotting and data manipulation functions,
 such as histograms, equations, and power spectra.</para></listitem>
 <listitem><para>Color mapping and contour mapping capabilities for three-dimensional data.</para></listitem>
-<listitem><para>Monitoring of events and notifications support.</para></listitem>
 <listitem><para>Built-in filtering and curve fitting capabilities.</para></listitem>
 <listitem><para>Convenient command-line interface.</para></listitem>
 <listitem><para>Powerful graphical user interface.</para></listitem>
+<listitem><para>Python bindings for scripting.</para></listitem>
 
 </itemizedlist>
 </para>
@@ -85,7 +85,7 @@ and save it as <filename>simpledata.dat</filename>:
 of this file an x vector, and the second column as a y vector, enter the following:
 </para>
 <para>
-<userinput><command>kst -x 1 -y 2 simpledata.dat</command></userinput>
+<userinput><command>kst2 simpledata.dat  -x 1 -y 2</command></userinput>
 </para>
 <para>
 &kst; should start with the plot displayed:
@@ -111,45 +111,17 @@ power spectra can be performed as well.  For a complete list of command-line opt
 
 
 <para>
-If &kst; is started without any command-line options, a QuickStart dialog is shown by default:
-</para>
-<screenshot>
-<screeninfo>The QuickStart dialog</screeninfo>
-<mediaobject>
-<imageobject>
-<imagedata fileref="Screenshot-kst-quickstart.png" format="PNG" />
-</imageobject>
-<textobject>
-<phrase>The QuickStart dialog</phrase>
-</textobject>
-</mediaobject>
-</screenshot>
-
-<para>
-The QuickStart dialog provides both a convenient facility for opening previously saved &kst; sessions
-and a shortcut to the data wizard. To open an existing &kst; session, either select a file from the
-<guilabel>Recent files</guilabel> list, or enter a path in the textbox underneath, and click
-<guibutton>Open File</guibutton>.  Clicking the button
-to the right of the textbox displays a file browser dialog that can be used to graphically browse to a
-&kst; file.  If this is your first time using &kst;, you most likely will not have any saved sessions.
-In this case, the data wizard can be used to quickly import data and produce plots.
-To start the data wizard, click the <guimenuitem>Data Wizard...</guimenuitem> button.
-The data wizard walks through specification of a data file, selection of fields, and selection of plot options.
+If &kst; is started without any command-line options, an unfilled kst window is shown.  From there, a common
+first step is to create plots from the Data Wizard (click the <guimenuitem>Data Wizard...</guimenuitem> toolbar button
+or press 'w').
+The data wizard walks through the specification of a data file, selection of fields, and selection of plot options.
 For detailed descriptions of
 the data wizard options and settings, refer to the <link linkend="datawizard">Data Wizard</link> section.
 </para>
-<tip>
-<para>
-If you do not want the QuickStart dialog to be displayed at startup, simply uncheck
-<guilabel>Show this dialog at startup</guilabel> at the bottom of the QuickStart dialog.  The QuickStart
-dialog can also be toggled by selecting <guimenuitem>Configure Kst...</guimenuitem> from the
-<guimenu>Settings</guimenu> menu and clicking on <guilabel>Show QuickStart dialog on startup</guilabel>.
-</para>
-</tip>
 
 <para>
 Any plot displayed in &kst; can be manipulated.  For example, dragging a rectangle anywhere within a plot
-will zoom in to that section of the plot.  Holding <keycap>Ctrl</keycap> or <keycap>Shift</keycap> while
+will zoom in to that section of the plot.  Holding &Ctrl; or &Shift; while
 dragging will zoom in on the x or y axis only, respectively, and tapping the arrow keys scrolls a plot.
 See
 <link linkend="workingwithplotsandwindows">Working with Plots and Window</link> for more details on

docbook/kst/kst.1

@@ -61,7 +61,7 @@ The source for power spectra\&. For ASCII files, this is the column\&. For binar
 
 .TP
 \fB\-l P\fR
-The length of the FFT used in power specra estimation is 2^P\&.
+The length of the FFT used in power spectra estimation is 2^P\&.
 
 .TP
 \fB\-h H\fR

docbook/kst/plotsandwindows-chapter.docbook

@@ -591,7 +591,7 @@ the plot dialog settings are applied.
 The list of existing plot markers for this plot are listed under <guilabel>Defined plot markers</guilabel>.
 To remove plot markers, highlight the desired markers in the list and click the <guibutton>Remove</guibutton> button.
 Multiple markers can be selected for removal by clicking and dragging within the list, or by holding down the
-<keycap>Shift</keycap> or <keycap>Ctrl</keycap> key and clicking on items in the list. To remove all plot markers
+&Shift; or &Ctrl; key and clicking on items in the list. To remove all plot markers
 for this plot, click the <guilabel>Remove All</guilabel> button.  Note that plot marker
 additions or removals made from the <guilabel>Markers</guilabel> tab are not applied unless
 the plot dialog settings are applied.
@@ -952,9 +952,9 @@ a certain time range, if the x axis happens to represent a time vector.
 </para>
 <tip>
 <para>
-You can quickly switch to X Mouse Zoom mode by holding down <keycap>Ctrl</keycap>.  The mouse
+You can quickly switch to X Mouse Zoom mode by holding down &Ctrl;.  The mouse
 cursor will change to indicate the new mode. Releasing
- <keycap>Ctrl</keycap> will return you to the previous mouse zoom mode.
+ &Ctrl; will return you to the previous mouse zoom mode.
 </para>
 </tip>
 
@@ -970,9 +970,9 @@ is concentrated around a horizontal line.
 </para>
 <tip>
 <para>
-You can quickly switch to Y Mouse Zoom mode by holding down <keycap>Shift</keycap>.  The mouse
+You can quickly switch to Y Mouse Zoom mode by holding down &Shift;.  The mouse
 cursor will change to indicate the new mode. Releasing
- <keycap>Shift</keycap> will return you to the previous mouse zoom mode.
+ &Shift; will return you to the previous mouse zoom mode.
 </para>
 </tip>
 </sect3>
@@ -1021,19 +1021,19 @@ The actual zoom level is not changed.</entry>
 </row>
 <row>
 <entry><guimenuitem>X-Zoom Maximum</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Ctrl</keycap><keycap>M</keycap></keycombo></entry>
+<entry><keycombo action="simul">&Ctrl;<keycap>M</keycap></keycombo></entry>
 <entry>Sets the x axis scale such that the x values for all data points are between the
 minimum and maximum of the x axis.  The y axis scale is unaltered.</entry>
 </row>
 <row>
 <entry><guimenuitem>X-Zoom Out</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Shift</keycap><keysym>Right</keysym></keycombo></entry>
+<entry><keycombo action="simul">&Shift;<keysym>Right</keysym></keycombo></entry>
 <entry>For a non-logarithmic x axis, increases the length of the x axis by a factor of approximately 0.5, without changing the
 midpoint of the x axis.  The y axis scale is unaltered.</entry>
 </row>
 <row>
 <entry><guimenuitem>X-Zoom In</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Shift</keycap><keysym>Left</keysym></keycombo></entry>
+<entry><keycombo action="simul">&Shift;<keysym>Left</keysym></keycombo></entry>
 <entry>For a non-logarithmic x axis, decreases the length of the x axis by a factor of approximately 0.5, without changing the
 midpoint of the x axis. The y axis scale is unaltered.</entry>
 </row>
@@ -1044,19 +1044,19 @@ midpoint of the x axis. The y axis scale is unaltered.</entry>
 </row>
 <row>
 <entry><guimenuitem>Y-Zoom Maximum</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Shift</keycap><keycap>M</keycap></keycombo></entry>
+<entry><keycombo action="simul">&Shift;<keycap>M</keycap></keycombo></entry>
 <entry>Sets the y axis scale such that the y values for all data points are between the
 minimum and maximum of the y axis.  The x axis scale is unaltered.</entry>
 </row>
 <row>
 <entry><guimenuitem>Y-Zoom Out</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Shift</keycap><keysym>Up</keysym></keycombo></entry>
+<entry><keycombo action="simul">&Shift;<keysym>Up</keysym></keycombo></entry>
 <entry>For a non-logarithmic y axis, increases the length of the y axis by a factor of approximately 0.5, without changing the
 midpoint of the y axis.  The x axis scale is unaltered.</entry>
 </row>
 <row>
 <entry><guimenuitem>Y-Zoom In</guimenuitem></entry>
-<entry><keycombo action="simul"><keycap>Shift</keycap><keysym>Down</keysym></keycombo></entry>
+<entry><keycombo action="simul">&Shift;<keysym>Down</keysym></keycombo></entry>
 <entry>For a non-logarithmic y axis, decreases the length of the y axis by a factor of approximately 0.5, without changing the
 midpoint of the y axis.  The x axis scale is unaltered.</entry>
 </row>
@@ -1111,8 +1111,8 @@ You can also scroll left or right in a plot by using the mouse wheel (if availab
 <para>
 To quickly go forwards or backwards along the x axis, select <guimenuitem>Back 1 Screen</guimenuitem>
 or <guimenuitem>Advance 1 Screen</guimenuitem> from the <guimenu>Range</guimenu> menu.  The keyboard
-shortcuts, <keycombo action="simul"><keycap>Ctrl</keycap><keysym>Left</keysym></keycombo> and
-<keycombo action="simul"><keycap>Ctrl</keycap><keysym>Right</keysym></keycombo> respectively, can be
+shortcuts, <keycombo action="simul">&Ctrl;<keysym>Left</keysym></keycombo> and
+<keycombo action="simul">&Ctrl;<keysym>Right</keysym></keycombo> respectively, can be
 used as well.
 </para>
 </tip>
@@ -1309,7 +1309,7 @@ until the plot is the desired shape and size.
 <title>Selecting Multiple Plots and Grouping Plots</title>
 <para>
 Two or more plots can be selected together in layout mode.  To select the plots,
-hold down the <keycap>Shift</keycap> key and either sequentially click on each plot you wish to
+hold down the &Shift; key and either sequentially click on each plot you wish to
 select, or drag to draw a dotted rectangle around a group of plots.  The selected plots
 will be indicated by a gray border around each plot:
 </para>

docbook/kst/scripttutorial/scripttutorial.docbook

@@ -74,7 +74,7 @@ Please at least include KDE, the KDE package it is in, the name
 <chapter id="RunningaKstScript">
 <title>Running a KstScript</title>
 <para>
-&kjs; is a JavaScript binding to &kst;.  There are three ways to to run a &kjs;
+&kjs; is a JavaScript binding to &kst;.  There are three ways to run a &kjs;
 </para>
 
 <itemizedlist>