From MAILER-DAEMON Sun Sep 08 08:38:21 2019
Received: from list by lists.gnu.org with archive (Exim 4.90_1)
	id 1i6wST-0000Nc-1z
	for mharc-bug-plotutils@gnu.org; Sun, 08 Sep 2019 08:38:21 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:43464)
 by lists.gnu.org with esmtp (Exim 4.90_1)
 (envelope-from <robert.l.masterson@gmail.com>) id 1i6nH6-0003hX-Qh
 for bug-plotutils@gnu.org; Sat, 07 Sep 2019 22:50:02 -0400
Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71)
 (envelope-from <robert.l.masterson@gmail.com>) id 1i6nH4-00036j-T1
 for bug-plotutils@gnu.org; Sat, 07 Sep 2019 22:50:00 -0400
Received: from mail-ot1-x333.google.com ([2607:f8b0:4864:20::333]:33891)
 by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16)
 (Exim 4.71) (envelope-from <robert.l.masterson@gmail.com>)
 id 1i6nH4-000367-K1
 for bug-plotutils@gnu.org; Sat, 07 Sep 2019 22:49:58 -0400
Received: by mail-ot1-x333.google.com with SMTP id z26so91656oto.1
 for <bug-plotutils@gnu.org>; Sat, 07 Sep 2019 19:49:57 -0700 (PDT)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025;
 h=mime-version:reply-to:from:date:message-id:subject:to;
 bh=lMgahfJ4HBCdR9ddT6A1plnJ35Y1UZB8DcbH/9MSiPw=;
 b=NOkS5JYeS0q6H+esKB6fS7MSoJu8XotCZ/UB6T2DlmcW8khYdRmz0yJ9WKJ3EBO1bl
 wYjhF/lp3kEiEeSTGsmtzU2MVhqLvgSax2BBGNtN3Ug7tZ1OusnWp15yy36dX+nj/m3n
 wdJDJz4tyH1FoTlsMTcrG98sHZyeAYHwDlBIQ6vqh6xs7TOcfo6a1bWjQaAi2gaxAqkj
 ekSpSchxy4SNmNsPqJ+iN90xTfPhzYggFhbVnTKZ0/Zw91aMHRoRcADB+X7jtn6cXTie
 MHL7nNNHsZKxFslSsjnTubYmwYNTcqt46ocoZZ8c98QIHLPndEmYbvOHFCSsEo5zxDrQ
 0kBA==
X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed;
 d=1e100.net; s=20161025;
 h=x-gm-message-state:mime-version:reply-to:from:date:message-id
 :subject:to;
 bh=lMgahfJ4HBCdR9ddT6A1plnJ35Y1UZB8DcbH/9MSiPw=;
 b=CtCn0vJpuIal5hzE/EJivPJ73QVSQCCM3TjJwITkNwOuNldTbVzt+f1RanC6fJCzOe
 zB8XfJtpIFRc/QufWmlNjlXciJvOr8DFs6l+VpB3nOvkUFLefEt/nEAkzjReFz43WZtK
 lVtNZbJoiXCMVVwJqJBAmZJn08QNEOznUzvuCmeY2zXAT93tvpQcAwDjvKmBDzAGunrO
 pAqCCQ6QgsB3N5pwyLRbSzEQaMbXa89v124gye39LU8Awxb/QHVpHmm0YOA62uMeSoJe
 Gy9j5mYczLaglcke05wyunU0zelEPBIXzDkj4u7RLEMf7L/LO48GDozVFGSe0LqPWXG5
 IGww==
X-Gm-Message-State: APjAAAU8EY4DmzChGVTEJsZN7yiutg+qdRWgHW14w9oRl3WEOCkm9zXF
 QBlsYq5r/akqHp2eikduFBPRfK8tyEsewXtM9ZPCBX5g
X-Google-Smtp-Source: APXvYqxgzOGJAYR/MEp6aTiBKcWFz8pyNqR7gt1D1olJiAq3BlWGTCx+2EvlUOcYIj7NBwAKdJjtSBBNruIkyxDI6UQ=
X-Received: by 2002:a9d:774c:: with SMTP id t12mr14978880otl.30.1567910996531; 
 Sat, 07 Sep 2019 19:49:56 -0700 (PDT)
MIME-Version: 1.0
Reply-To: Robert.L.Masterson@gmail.com
From: "Robert L. Masterson" <robert.l.masterson@gmail.com>
Date: Sat, 7 Sep 2019 22:45:20 -0400
Message-ID: <CAHST7bduA-mp-ORavrhkAtJo=tLFpNEmHo6rfbQaCSVm_Cex=w@mail.gmail.com>
To: bug-plotutils@gnu.org
Content-Type: multipart/alternative; boundary="000000000000fcdf37059201b93c"
X-detected-operating-system: by eggs.gnu.org: Genre and OS details not
 recognized.
X-Received-From: 2607:f8b0:4864:20::333
X-Mailman-Approved-At: Sun, 08 Sep 2019 08:38:19 -0400
Subject: [Bug-plotutils] GNU graph (GNU plotutils) fails to accept data
 files with labeled points, which UNIX V7 graph supported
X-BeenThere: bug-plotutils@gnu.org
X-Mailman-Version: 2.1.23
Precedence: list
List-Id: "Bug reports for the GNU plotting utilities,
 including the libplot graphics export library."
 <bug-plotutils.gnu.org>
List-Unsubscribe: <https://lists.gnu.org/mailman/options/bug-plotutils>,
 <mailto:bug-plotutils-request@gnu.org?subject=unsubscribe>
List-Archive: <https://lists.gnu.org/archive/html/bug-plotutils>
List-Post: <mailto:bug-plotutils@gnu.org>
List-Help: <mailto:bug-plotutils-request@gnu.org?subject=help>
List-Subscribe: <https://lists.gnu.org/mailman/listinfo/bug-plotutils>,
 <mailto:bug-plotutils-request@gnu.org?subject=subscribe>
X-List-Received-Date: Sun, 08 Sep 2019 02:50:02 -0000

--000000000000fcdf37059201b93c
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

To whom it may concern,

This bug report is for GNU graph; the bug appears to exist in all versions
based on the current (post-1995) plotutils, but the bug was not present in
the earlier GNU version of graph that was part of the 1991 "GNU Graphics
Utilities" package.

GNU graph is a missing an important feature that makes it unable to process
a large class of data files supported by UNIX V7 graph (and all subsequent
versions of graph derived from it) and by the graph that was distributed as
part of the GNU Graphics Utilities.  Particularly, the default "ASCII"
format to GNU graph supports only numbers specifying the point location
(either coordinate pairs, or single values if the --auto-abscissa option is
specified) and does not support the optional label for the point that is
supported by UNIX V7 graph.  In fact, GNU graph stops processing a data
file without any error diagnostic as soon as it encounters the first label.

While stopping processing without any error diagnostic is clearly a bug, it
seems more of an oversight that the point label functionality was not
included in the current GNU graph.  The comprehensive plotutils
documentation describes the various data formats, and labels are not
mentioned.  In other words, the lack of point labels is consistent with the
current GNU graph's documentation.  (But not with the previous GNU Graphics
Utilities graph's documentation, which describes point labels in the data
format in some detail.)

I find it odd that this functionality was not included in the replacement
for the earlier GNU graph, because the text rendering capabilities of the
modern GNU graph (as exercised, for example, by axis labels) are vastly
superior to what was available in either V7 graph or the GNU graphics
version of graph, but support for files containing point labels was not
implemented.  I consider this a bug, but if it was a conscious
implementation decision to make GNU graph incompatible with UNIX V7 graph
and the previous GNU version, I suggest reconsidering that decision.

For reference, the relevant portion of the UNIX V7 graph(1g) manual is
provided below.  I underlined the key language concerning the supported
data format.

*NAME*
        graph =E2=80=93 draw a graph

*SYNOPSIS*
        graph [ option ] ...

*DESCRIPTION*
        *Graph* with no options takes pairs of numbers from the standard
input as abscissas and ordinates of a graph. Successive points are
connected by straight lines. The graph is encoded on the standard output
for display by the *plot*(1) filters.

        *If the coordinates of a point are followed by a nonnumeric string,
that string is printed as a label beginning on the point. Labels may be
surrounded with quotes "...", in which case they may be empty or contain
blanks and numbers; labels never contain newlines.*

...

And here is the description of point labels in graph data files from the
former GNU implementation, in the GNU Graphics Utilities documentation:
The format of input to graph
<http://www.math.utah.edu/docs/info/graphics_toc.html#SEC4>

As mentioned above, by default graph reads ascii pairs of values, x and y
coordinates, from the standard input or files specified on the command
line. *Optional labels may be placed after each coordinate in the data
file. The label ends at the end of the line: *

*3.0  0.4 this is a label for point (3.0, 0.4).
*

* The label must be enclosed in double quotes if it would otherwise be
appear to be a coordinate: *

*3.0  0.4 "5.0 looks like a value."*

You can use the `-b' to break lines after each label in the input. Use a
pair of empty double quotes if you need to break a line, but do not need a
label.

0.0  0.0
2.0  0.0
1.0  0.2
""
0.0  0.1
2.0  0.2
4.0  0.3

You can also break cuves using `-M' option to break lines whenever the
abscissal values between successive pairs of points decrease. When using
`-M', each continuous curve has monotonically increasing abscissal values.

0.0  0.0 *first data set*
2.0  0.0
4.0  0.2
0.0  0.1 *second data set
*2.0  0.2
4.0  0.3

graph will automatically generate abscissal values for you if you specify
the `-a' option. Only ordinate values are given in the data, and the data
is then assumed to be equally sampled along the abscissa. The values
following `-a' on the command line specify the sampling interval and the
abscissal value of the first data point.
0.0 0.1 0.2 *label for point (2.0, 0.2)* 0.3 0.2 0.3


Thank you.

Sincerely,

Robert L. Masterson
Robert.L.Masterson@gmail.com

--000000000000fcdf37059201b93c
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div di=
r=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"ltr"><div dir=3D"lt=
r"><div dir=3D"ltr"><br></div><div>To whom it may concern,<br><br></div><di=
v>This bug report is for GNU graph; the bug appears to exist in all version=
s based on the current (post-1995) plotutils, but the bug was not present i=
n the earlier GNU version of graph that was part of the 1991 &quot;GNU Grap=
hics Utilities&quot; package.<br><br>GNU graph is a missing an important fe=
ature that makes it unable to process a large class of data files supported=
 by UNIX V7 graph (and all subsequent versions of graph derived from it) an=
d by the graph that was distributed as part of the GNU Graphics Utilities.=
=C2=A0 Particularly, the default &quot;ASCII&quot; format to GNU graph supp=
orts only numbers specifying the point location (either coordinate pairs, o=
r single values if the --auto-abscissa option is specified) and does not su=
pport the optional label for the point that is supported by UNIX V7 graph.=
=C2=A0 In fact, GNU graph stops processing a data file without any error di=
agnostic as soon as it encounters the first label.<br><br></div><div>While =
stopping processing without any error diagnostic is clearly a bug, it seems=
 more of an oversight that the point label functionality was not included i=
n the current GNU graph.=C2=A0 The comprehensive plotutils documentation de=
scribes the various data formats, and labels are not mentioned.=C2=A0 In ot=
her words, the lack of point labels is consistent with the current GNU grap=
h&#39;s documentation.=C2=A0 (But not with the previous GNU Graphics Utilit=
ies graph&#39;s documentation, which describes point labels in the data for=
mat in some detail.)<br></div><div><br></div><div>I find it odd that this f=
unctionality was not included in the replacement for the earlier GNU graph,=
 because the text rendering capabilities of the modern GNU graph (as exerci=
sed, for example, by axis labels) are vastly superior to what was available=
 in either V7 graph or the GNU graphics version of graph, but support for f=
iles containing point labels was not implemented.=C2=A0 I consider this a b=
ug, but if it was a conscious implementation decision to make GNU graph inc=
ompatible with UNIX V7 graph and the previous GNU version, I suggest recons=
idering that decision.<br><br></div><div>For reference, the relevant portio=
n of the UNIX V7 graph(1g) manual is provided below.=C2=A0 I underlined the=
 key language concerning the supported data format.<br></div><div><br clear=
=3D"all"></div><div dir=3D"ltr"><div style=3D"font-size:15px;font-family:se=
rif;margin-left:40px"><b>NAME</b></div><div style=3D"font-size:16.6667px;fo=
nt-family:serif;margin-left:40px">=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=C2=
=A0 graph =E2=80=93  draw a graph</div><div style=3D"font-size:15px;font-fa=
mily:serif;margin-left:40px"><br><b>SYNOPSIS</b></div><div style=3D"font-si=
ze:16.6667px;font-family:serif;margin-left:40px">=C2=A0=C2=A0=C2=A0=C2=A0=
=C2=A0=C2=A0=C2=A0 graph [  option  ]  ...</div><div style=3D"font-size:15p=
x;font-family:serif;margin-left:40px"><br><b>DESCRIPTION</b></div><div styl=
e=3D"font-size:16.6667px;font-family:serif;margin-left:40px">=C2=A0=C2=A0=
=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0 <i>Graph</i> with  no  options  takes  pairs=
  of  numbers  from  the  standard  input  as  abscissas  and  ordinates  o=
f  a graph.   Successive  points  are  connected  by  straight  lines.   Th=
e  graph  is  encoded  on  the  standard  output for  display  by  the <i>p=
lot</i>(1)  filters.<br><br></div><div style=3D"font-size:16.6667px;font-fa=
mily:serif"><div style=3D"margin-left:40px">=C2=A0=C2=A0=C2=A0=C2=A0=C2=A0=
=C2=A0=C2=A0 <u>If  the  coordinates  of  a  point  are  followed  by  a  n=
onnumeric  string,  that  string  is  printed  as  a  label  beginning  on =
 the  point.   Labels  may  be  surrounded  with  quotes  &quot;...&quot;, =
 in  which  case  they  may  be  empty  or contain  blanks  and  numbers;  =
labels  never  contain  newlines.</u><br><br>...<br></div><u><br></u></div>=
And here is the description of point labels in graph data files from the fo=
rmer GNU implementation, in the GNU Graphics Utilities documentation:<br><h=
2 style=3D"margin-left:40px"><a name=3D"SEC4" href=3D"http://www.math.utah.=
edu/docs/info/graphics_toc.html#SEC4">The format of input to <code>graph</c=
ode></a></h2><div style=3D"margin-left:40px">

</div><p style=3D"margin-left:40px">
As mentioned above, by default <code>graph</code> reads ascii pairs of valu=
es,
x and y coordinates, from the standard input or files specified on the
command line.  <u>Optional labels may be placed after each coordinate in
the data file.  The label ends at the end of the line:
</u></p><div style=3D"margin-left:40px">

</div><pre style=3D"margin-left:40px"><u>3.0  0.4 this is a label for point=
 (3.0, 0.4).
</u></pre><div style=3D"margin-left:40px">

</div><p style=3D"margin-left:40px"><u>
The label must be enclosed in double quotes if it would otherwise be
appear to be a coordinate:

</u></p><div style=3D"margin-left:40px">

</div><pre style=3D"margin-left:40px"><u>3.0  0.4 &quot;5.0 looks like a va=
lue.&quot;</u>
</pre><div style=3D"margin-left:40px">

</div><p style=3D"margin-left:40px">
You can use the <samp>`-b&#39;</samp> to break lines after each label in th=
e input.
Use a pair of empty double quotes if you need to break a line, but do
not need a label.
</p><div style=3D"margin-left:40px">

</div><pre style=3D"margin-left:40px">0.0  0.0
2.0  0.0
1.0  0.2
&quot;&quot;
0.0  0.1
2.0  0.2
4.0  0.3
</pre><div style=3D"margin-left:40px">

</div><p style=3D"margin-left:40px">
You can also break cuves using <samp>`-M&#39;</samp> option to break lines =
whenever
the abscissal values between successive pairs of points decrease.  When
using <samp>`-M&#39;</samp>, each continuous curve has monotonically increa=
sing
abscissal values.
</p><div style=3D"margin-left:40px">

</div><pre style=3D"margin-left:40px">0.0  0.0 <u>first data set</u>
2.0  0.0
4.0  0.2
0.0  0.1 <u>second data set
</u>2.0  0.2
4.0  0.3
</pre><div style=3D"margin-left:40px">

</div><p style=3D"margin-left:40px">
<code>graph</code> will automatically generate abscissal values for you if =
you
specify the <samp>`-a&#39;</samp> option.  Only ordinate values are given i=
n the
data, and the data is then assumed to be equally sampled along the
abscissa.  The values following <samp>`-a&#39;</samp> on the command line s=
pecify
the sampling interval and the abscissal value of the first data
point.
</p><div style=3D"margin-left:40px">

0.0
0.1
0.2 <u>label for point (2.0, 0.2)</u>
0.3
0.2
0.3
<br></div><pre><br></pre></div><div dir=3D"ltr">Thank you.<br>=C2=A0<br><di=
v dir=3D"ltr" class=3D"gmail_signature">Sincerely,<br><br>Robert L. Masters=
on<br><a href=3D"mailto:Robert.L.Masterson@gmail.com" target=3D"_blank">Rob=
ert.L.Masterson@gmail.com</a><br></div></div></div></div></div></div></div>=
</div></div></div></div>

--000000000000fcdf37059201b93c--


