Re: gnuplot manual misprint (no.26)

[Shigeharu T. <sh...@ie...>]

shige 07/22 2008
----------------

I will add some explanations for my last report.

I wrote:
> In docs/gnuplot.doc of current CVS version
> 
>  ROS $Id: gnuplot.doc,v 1.518 2008/07/07 16:37:16 sfeam Exp $
> 
> I found some points 
> 
> 1) that seem to be misprints, 

They are:

 line 1 ("ROS" should be "RCS" ?)
 line 8103 ("nex" should be "next" ?)
 line 9371 (""set view map"" should be "`set view map`" ?)
 line 11524 ("`Seeking-assistance`" should be "`seeking-assistance`" ?)


> 2) for "see `...`" system of doc2tex, or

doc2tex add "\pageref{}" and "\index{}" for the `...` strings 
between "[sS]ee" and "[).]". So, for example, the following line 
(line 1575) include two `...` part between "see" and ".":

  Please see `plot datafile using` for an explanation of the 
  `using` syntax.

so doc2tex expand it to

  Please see {\bf plot datafile using (p.~\pageref{plot datafile using})
  \index{using}} for an explanation of the 
  {\bf using (p.~\pageref{using})\index{using}} syntax.

If we modify the line to

  For an explanation of the `using` syntax, please see 
  `plot datafile using`. 

doc2tex will expand it to
  
  For an explanation of the {\bf using} syntax, 
  please see {\bf plot datafile using (p.~\pageref{plot datafile using})
  \index{using}}.

I think the latter result is better.

Such lines are:

 line 1575
 line 9239-9240
 line 11104


> 3) for "  " (double space) at the top of line of doc2tex.

doc2tex enclose lines starting double spaces by 

 \preverbatim
 \begin{verbatim}

and

 \end{verbatim}
 \postverbatim

But there are some lines which are starting double spaces and 
they don't seem to be surrounded by *{verbatim}. They are:

 line 2500
 line 5506-5510
 line 8925
 line 9386
 line 9493


> I send the unified diff file for them.
> 
> ----- From here -----
> --- gnuplot.doc.ORG     2008-07-11 20:51:20.000000000 +0900
> +++ gnuplot.doc 2008-07-11 20:58:14.000000000 +0900
> @@ -1,4 +1,4 @@
> -C ROS $Id: gnuplot.doc,v 1.518 2008/07/07 16:37:16 sfeam Exp $
> +C RCS $Id: gnuplot.doc,v 1.518 2008/07/07 16:37:16 sfeam Exp $
>  C
>  C Copyright (C) 1986 - 1993, 1998, 1999, 2000, 2001, 2004   Thomas Williams, Colin Kelley et al.
>  C
> @@ -1572,7 +1572,7 @@
>  
>         plot 'file' using 1:( $4<0 ? 1/0 : ($2+$3)/2 )
>  
> - Please see `plot datafile using` for an explanation of the `using` syntax.
> + For an explanation of the `using` syntax, please see `plot datafile using`.
>  
>  3 Gnuplot-defined variables
>  ?gnuplot-defined variables
> @@ -2497,7 +2497,7 @@
>     # Plot with crossbars on the whiskers, crossbars are 50% of full width
>     plot 'stat.dat' using 1:3:2:6:5 with candlesticks whiskerbars 0.5
>  
> -  See `set boxwidth`, `set bars` and `set style fill`.
> + See `set boxwidth`, `set bars` and `set style fill`.
>  2 circles
>  ?commands set style circles
>  ?set style circles
> @@ -5503,11 +5503,11 @@
>   The optional parameter is ignored for single plot-windows terminal, i.e. `pm`
>   and `win`.
>  
> -  If the window is not raised under X11, then (1) they don't run in the same
> -  X11 session (telnet or ssh session, for example), or (2) raising is blocked
> -  by your window manager. On KDE, you may like to go to the KDE Control Center
> -  => Desktop => Window Behaviour => Advanced and set the "Focus stealing
> -  prevention level" to None (default is Low).
> + If the window is not raised under X11, then (1) they don't run in the same
> + X11 session (telnet or ssh session, for example), or (2) raising is blocked
> + by your window manager. On KDE, you may like to go to the KDE Control Center
> + => Desktop => Window Behaviour => Advanced and set the "Focus stealing
> + prevention level" to None (default is Low).
>  2 refresh
>  ?commands refresh
>  ?refresh
> @@ -8100,7 +8100,7 @@
>   the mouse position. Labels are drawn with the current setting of `mouseformat`.
>   The `labeloptions` string is passed to the `set label` command.  The default is
>   "point pointstyle 1" which will plot a small plus at the label position.
> - Temporary labels will disappear at the nex `replot` or mouse zoom operation.
> + Temporary labels will disappear at the next `replot` or mouse zoom operation.
>   Persistent labels can be removed by holding the Ctrl-Key down while clicking
>   Button 2 on the label's point. The threshold for how close you must be to the
>   label is also determined by the `pointsize`.
> @@ -8922,7 +8922,7 @@
>  ^ <a href="http://zimg.sourceforge.net">
>             http://zimg.sourceforge.net
>  ^ </a>
> -  ).
> + ).
>  
>   `set palette gray` switches to a gray only palette. `set palette rgbformulae`,
>   `set palette defined`, `set palette file` and `set palette functions` switch
> @@ -9236,8 +9236,8 @@
>   r = f(t), where t is an angle of rotation.  The trange controls the domain
>   (the angle) of the function, and the x and y ranges control the range of the
>   graph in the x and y directions.  Each of these ranges, as well as the
> - rrange, may be autoscaled or set explicitly.  See `set xrange` for details
> - of all the `ranges` commands.
> + rrange, may be autoscaled or set explicitly. For details of all the
> + `ranges` commands, see `set xrange`.
>  
>   Example:
>         set polar
> @@ -9368,7 +9368,7 @@
>   values (1.0).
>  
>   `ratio` and `square` have no effect on 3D plots, but do affect 3D projections
> - created using "set view map".
> + created using `set view map`.
>  
>   Examples:
>  
> @@ -9383,7 +9383,7 @@
>  
>   See also
>  ^ <a href="http://www.gnuplot.info/demo/airfoil.html">
> -  airfoil demo.
> + airfoil demo.
>  ^ </a>
>  3 style
>  ?set style
> @@ -9490,7 +9490,7 @@
>         set style arrow 1 nohead lw 2
>         set arrow arrowstyle 1
>  
> -  See also `set arrow` for further examples.
> + See also `set arrow` for further examples.
>  
>  4 set style data
>  ?commands set style data
> @@ -11101,7 +11101,7 @@
>   `splot` provides only a single x, y, and z axis; there is no equivalent to the
>   x2 and y2 secondary axes provided by `plot`.
>  
> - See `plot` for features common to the `plot` command; only differences are
> + For features common to the `plot` command, see `plot`; only differences are
>   discussed in detail here.
>  
>   Syntax:
> @@ -11521,7 +11521,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.2 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
+========================================================+