Re: gnuplot manual misprint (no.35)

[Bastian M. <bma...@we...>]

Thanks for noticing. Some of your observations were caused by a specific 
change made by me. I disabled some html anchors in gnuplot.doc, like this:

^ <a name="start-up"></a>

I thought they were leftovers from times when the (real) HTML 
documentation was generated directly from gnuplot.doc.
It turns out that really doc2tex(!) interprets them.

In addition to the anchor definitions you have found

   "start-up", "Time/Date data", "Time/date", "positive", "negative"

the following have also been removed by me:

   "save set", "set style <style>", "arrowtype", "arrowwidth"

We could easily put those definitions back in, but I doubt that this is 
the best solution. Any propositions?

I will look at doc2* to find out what other surprises there are.

Bastian


Am 22.02.2011 12:08, schrieb Shigeharu TAKENO:
> shige 02/22 2011
> ----------------
>
> In docs/gnuplot.doc of current CVS version
>
>   C RCS $Id: gnuplot.doc,v 1.651 2011/02/21 17:58:39 markisch Exp $
>
> I found the following points:
>
> 1) they may not be referenced by the .tex document translated by
>    doc2tex (`start-up`, `positive`, `negative`, `Time/date`, and
>    `Seeking-assistance`)
> 2) they may be misprints (strings ->  string, stdout ->  string,
>    interpolation ->  interpolate)
> 3) they may not be translated to tabular lines correctly in win
>    help (for rand)
>
> ----- From here -----
> --- gnuplot.doc.ORG	2011-02-22 19:28:07.000000000 +0900
> +++ gnuplot.doc	2011-02-22 19:32:49.000000000 +0900
> @@ -674,7 +674,7 @@
>    If GNUTERM is defined, it is used as the name of the terminal type to be
>    used.  This overrides any terminal type sensed by `gnuplot` on start-up, but
>    is itself overridden by the .gnuplot (or equivalent) start-up file
> - (see `start-up`) and, of course, by later explicit changes.
> + (see `startup`) and, of course, by later explicit changes.
>
>    GNUHELP may be defined to be the pathname of the HELP file (gnuplot.gih).
>
> @@ -854,11 +854,11 @@
>   ^<tr>	<td>gprintf("format",x)</td>	<td>any</td>	<td>string result from applying gnuplot's format parser</td></tr>
>   ^<tr>	<td>sprintf("format",x,...)</td>	<td>multiple</td>	<td>string result from C-language sprintf</td></tr>
>   ^<tr>	<td>strlen("string")</td>	<td>string</td>	<td>int length of string</td></tr>
> -^<tr>	<td>strstrt("string","key")</td>	<td>strings</td>	<td>int index of first character of substring "key"</td></tr>
> +^<tr>	<td>strstrt("string","key")</td>	<td>string</td>	<td>int index of first character of substring "key"</td></tr>
>   ^<tr>	<td>substr("string",beg,end)</td>	<td>multiple</td>	<td>string "string"[beg:end]</td></tr>
>   ^<tr>	<td>strftime("timeformat",t)</td>	<td>any</td>	<td>string result from applying gnuplot's time parser</td></tr>
>   ^<tr>	<td>strptime("timeformat",s)</td>	<td>string</td>	<td>seconds since year 2000 as given in string s</td></tr>
> -^<tr>	<td>system("command")</td>	<td>string</td>	<td>stdout containing output stream of shell command</td></tr>
> +^<tr>	<td>system("command")</td>	<td>string</td>	<td>string containing output stream of shell command</td></tr>
>   ^<tr>	<td>word("string",n)</td>	<td>string, int</td>	<td>returns the nth word in "string"</td></tr>
>   ^<tr>	<td>words("string")</td>	<td>string</td>	<td>returns the number of words in "string"</td></tr>
>   ^</tbody>
> @@ -1226,10 +1226,10 @@
>   ?rand
>   #rand(x)&  int&  pseudo random number in the interval [0:1] \\
>   %rand(x)@int@pseudo random number in the interval [0:1]
> - `rand(0)`  returns a pseudo random number in the interval [0:1]
> - `rand(-1)` resets both seeds to a standard value.
> - `rand(x)`  for integer 0<  x<  2^31-1 sets both internal seeds to x
> - `rand({x,y})` for integer 0<  x,y<  2^31-1 sets seed1 to x and seed2 to y.
> +  `rand(0)`  returns a pseudo random number in the interval [0:1]
> +  `rand(-1)` resets both seeds to a standard value.
> +  `rand(x)`  for integer 0<  x<  2^31-1 sets both internal seeds to x
> +  `rand({x,y})` for integer 0<  x,y<  2^31-1 sets seed1 to x and seed2 to y.
>   4 real
>   ?expressions functions real
>   ?functions real
> @@ -9960,7 +9960,7 @@
>    is interpolated m-times and n-times in the respective direction.  For negative
>    m and n, the interpolation frequency is chosen so that there will be at least
>    |m| and |n| points drawn; you can consider this as a special gridding function.
> - Zeros, i.e. `interpolation 0,0`, will automatically choose an optimal number of
> + Zeros, i.e. `interpolate 0,0`, will automatically choose an optimal number of
>    interpolated surface points.
>   4 deprecated_options
>   ?pm3d deprecated_options
> @@ -10106,7 +10106,7 @@
>    mapping functions are listed by `show palette rgbformulae`.  Default is
>    `7,5,15`, some other examples are `3,11,6`, `21,23,3` or `3,23,21`.  Negative
>    numbers, like `3,-11,-6`, mean inverted color (i.e.  1-gray passed into the
> - formula, see also `positive` and `negative` options below).
> + formula).
>
>    Some nice schemes in RGB color space
>       7,5,15   ... traditional pm3d (black-blue-red-yellow)
> @@ -11438,7 +11438,7 @@
>    the UNIX98 spec, but conventions vary widely and two-digit year values are
>    inherently ambiguous.
>
> - See also `set xdata` and `Time/date` for more information.
> + See also `set xdata` and `time/date` for more information.
>
>    Example:
>          set timefmt "%d/%m/%Y\t%H:%M"
> @@ -11697,7 +11697,7 @@
>    for this  unless the `set format x "string"` has supplied something that does
>    not look like a decimal format (more than one '%' or neither %f nor %g).
>
> - See also `Time/date` for more information.
> + See also `time/date` for more information.
>   3 xdtics
>   ?commands set xdtics
>   ?commands unset xdtics
> @@ -12972,7 +12972,7 @@
>    Or upload the report to the gnuplot web site on SourceForge.
>    Please give complete information on the version of gnuplot you are using
>    and, if possible, a test script that demonstrates the bug.
> - See `Seeking-assistance`.
> + See `seeking-assistance`.
>
>    The sections below list problems known to be present in gnuplot version 4.4 at
>    the time of release.  Some of these are actually bugs in external support
> ----- To here -----
>
> +========================================================+
>   Shigeharu TAKENO     NIigata Institute of Technology
>                         kashiwazaki,Niigata 945-1195 JAPAN
>   sh...@ie...   TEL(&FAX): +81-257-22-8161
> +========================================================+
>
> ------------------------------------------------------------------------------
> Index, Search&  Analyze Logs and other IT data in Real-Time with Splunk
> Collect, index and harness all the fast moving IT data generated by your
> applications, servers and devices whether physical, virtual or in the cloud.
> Deliver compliance at lower cost and gain new business insights.
> Free Software Download: http://p.sf.net/sfu/splunk-dev2dev
> _______________________________________________
> gnuplot-beta mailing list
> gnu...@li...
> https://lists.sourceforge.net/lists/listinfo/gnuplot-beta