*** /tmp/,RCSt1a22231	Tue Apr 16 16:12:43 1991
--- AtPlotter.man	Tue Apr 16 15:47:11 1991
***************
*** 28,39 ****
  
  The axes and plots are treated as sub-objects of the widget and each has
  its own set of resources.  New plots types can be displayed by
! subclassing an existing plot type.
  
  .SH CLASSES
  The Plotter widget is a subclass of Constraint.  The class pointer
  is atPlotterWidgetClass, and the class name is AtPlotter.
  
  .SH RESOURCES
  The Plotter widget inherits all the resources of the Core, Composite,
  and Constraint widget classes. 
--- 28,96 ----
  
  The axes and plots are treated as sub-objects of the widget and each has
  its own set of resources.  New plots types can be displayed by
! subclassing an existing plot type.  The axes and plots are subclasses
! of Object and are not Widgets. They should 
! .I not
! be managed or created with the 
! .B XtCreateManagedWidget()
! call, as corruption of the plot data will occur.  (As a hint, if the
! linewidth in the generated PostScript is 256 (hence filling up the
! graph area with black), then you have probably attempted to manage the
! plot object.)
  
  .SH CLASSES
  The Plotter widget is a subclass of Constraint.  The class pointer
  is atPlotterWidgetClass, and the class name is AtPlotter.
  
+ .SH PRIVATE CHILD OBJECTS
+ There are six private children of the Plotter widget:
+ .BR xaxis ", " yaxis ", " y2axis ", "
+ .BR xframeaxis ", " yframeaxis ", and " y2frameaxis .
+ They are all created at widget creation time and are AtAxis objects.
+ (Programs can get the object pointer using the
+ .BI AtPlotterGet object ()
+ routines.)  Resources for each of these axes can be set in the usual
+ way.  There are three main axis objects and three frame axis objects.
+ The X axis is along the bottom of the graph, and all plots use the
+ same X scale.  There are two Y axes that are completely equivalent,
+ called the Y and Y2 axes.  The Y axis is on the left of the main graph
+ area, the Y2 axis is on the right.  A given graph may use either or
+ both Y axes.  (The
+ .B useY2Axis
+ constraint variable for each plot determines which Y axis it is
+ associated with.)
+ 
+ In addition to being used for scaling, each of the three main axes can
+ be independently displayed or not displayed by setting the 
+ .B displayed
+ constraint resource for the axis object.  (Previous versions insisted
+ on displaying the X and Y axes, and had an AtPlotter resource to
+ control the display of the Y2 axis.)  The results of setting the
+ .B displayed
+ resource to 
+ .B false
+ for both 
+ .B yaxis 
+ and
+ .B y2axis
+ is undefined.
+ 
+ The three frame axes are used when the 
+ .B framedAxis
+ resource is set to
+ .BR True .
+ In this case, the xframeaxis is always drawn, the yframe axis is drawn if
+ the y2 axis is not being displayed, and the y2frameaxis is drawn if the
+ yaxis is not being displayed.  The 
+ .B displayed
+ constraint resource is ignored for frame axes.
+ The 
+ .B autoNumber
+ resource of frame axes is forced to
+ .BR False ,
+ and the numbering of frame axes is forces to be the same as for the
+ corresponding main axis by the AtPlotter widget code.
+ 
  .SH RESOURCES
  The Plotter widget inherits all the resources of the Core, Composite,
  and Constraint widget classes. 
***************
*** 66,72 ****
  XtNfloatingX	Boolean	False
  XtNfloatingY	Boolean	False
  XtNframedAxes	Boolean	False
- XtNshowY2Axis	Boolean False
  XtNshowLegend	Boolean	True
  XtNlegendWidth	short	100
  XtNlegendSpacing	short	3
--- 123,128 ----
***************
*** 80,88 ****
  XtNselectCallback	XtCallbackList	NULL
  XtNdoubleSelectCallback	XtCallbackList	NULL
  XtNerrorCallback	XtCallbackList	NULL
- XtNxaxis	AtAxisObject	dynamic
- XtNyaxis	AtAxisObject	dynamic
- XtNy2axis	AtAxisObject	NULL
  .TE
  
  .IP XtNfontFamily
--- 136,141 ----
***************
*** 150,159 ****
  resource and XtNfloatingAxes are both set to True, the results are
  un-specified.  
  
- .IP XtNshowY2Axis
- Specifies whether the second Y2 axis should be displayed at the right of
- the plotting area
- 
  .IP XtNshowLegend
  Specifies whether the legend should be drawn.
  
--- 203,208 ----
***************
*** 216,230 ****
  If no procedures are specified, the widget will output any warnings to
  standard error using \fBXtWarning()\fP.
  
- .IP XtNxaxis
- The AtAxisObject corresponding to the plotter widget's x-axis.
- 
- .IP XtNyaxis
- The AtAxisObject corresponding to the plotter widget's y-axis.
- 
- .IP XtNy2axis
- The AtAxisObject corresponding to the plotter widget's y2-axis.
- 
  .SH "PLOTTER CONSTRAINT RESOURCES"
  The AtPlotter widget is a constraint widget, which means that it
  provides resources that each of its children (the individual plots that
--- 265,270 ----
***************
*** 281,287 ****
  	AtPlotterWidget \fIplotter\fP;
  AtAxisObject AtPlotterGetXFrameAxis(\fIplotter\fP)
  	AtPlotterWidget \fIplotter\fP;
! AtAxisObject AtPlotterGetYFrameAxis(\fIplotter\fP)
  	AtPlotterWidget \fIplotter\fP;
  void AtPlotterGetPlotExtents(\fIplotter\fP, *\fIxmin\fP, *\fIxmax\fP, *\fIymin\fP, *\fIymax\fP)
  	AtPlotterWidget \fIplotter\fP;
--- 321,327 ----
  	AtPlotterWidget \fIplotter\fP;
  AtAxisObject AtPlotterGetXFrameAxis(\fIplotter\fP)
  	AtPlotterWidget \fIplotter\fP;
! AtAxisObject AtPlotterGetY2FrameAxis(\fIplotter\fP)
  	AtPlotterWidget \fIplotter\fP;
  void AtPlotterGetPlotExtents(\fIplotter\fP, *\fIxmin\fP, *\fIxmax\fP, *\fIymin\fP, *\fIymax\fP)
  	AtPlotterWidget \fIplotter\fP;
***************
*** 342,347 ****
--- 382,392 ----
  
  .IP AtPlotterGetYFrameAxis()
  Returns the y-frame-axis AtAxisObject of \fIplotter\fP.  If
+ \fIplotter\fP's XtNframedAxes resource is False, the returned value is
+ undefined.
+ 
+ .IP AtPlotterGetY2FrameAxis()
+ Returns the y2-frame-axis AtAxisObject of \fIplotter\fP.  If
  \fIplotter\fP's XtNframedAxes resource is False, the returned value is
  undefined.