{smcl}
{* 04may2004}{...}
{hline}
help for {hi:scheme_files}{right:manual:  forthcoming}
{hline}

{title:Description of scheme file format}

{red:This is a partial draft of the scheme file documentation}

{p 3 3 2}
A {help scheme} specifies the overall look of a graph and is defined by a
scheme file.  The entries in a scheme file specify the look for a specific
attribute of a specific graph element, such as the color of a symbol or the
size of text.

{p 3 3 2}
The information provied here is primaily of use to those creating their own
graphics schemes.  We describe in detail the format of scheme files and
outline the effects entries in the scheme file have on graphs.  For an
overview of graphics schemes, see help {help schemes}.

{title:Remarks}

{p 3 3 2}
Remarks are presented under the headings:

 	{hi:1. What is a scheme-file entry?}
	{hi:2. Plot entries} 
	{hi:3. Composite entries} 
	{hi:4. Scheme file entry definitions}
		{hi:5.1 xyz entries}
	{hi:6. Advanced scheme file entry definitions}
	{hi:2. Creating your own schemes !! move down}
 	{hi:7. Example scheme file}
 	{hi:8. Suggestions}
		!! just try it, -discard-
 	{hi:9. Glossary}

{title:2. Creating your own schemes}


{title:1. What is a scheme-file entry?} 

{p 3 3 2}
Each entry in a scheme file specifies either how a particular attribute of a
graph element looks.  For example, 

	{cmd:symbolsize matrix medium}

{p 3 3 2}
specifies that the size of symbols used in scatterplot matrices is to be
{cmd:medium}.  We know this because the first word of the entry specifies the
styletype, or attribute affected, for the entry; the second word the graph
element or thing that is affected (in this case matrix is short for
scatterplot matrix); and the 3rd word the style to be applied to the specific
attribute of the element.

{p 3 3 2}
We could change {cmd:medium} to {cmd:small} or {cmd:large} or any of the
predefined styles for {help markersizestyle}, or we could specify a number for
the size.  This number is scaled so that 100 would be the full height of the
graph (or width if the width were smaller than the height), see help 
{help relativesize} for a discussion.  The available options for the styles
that may be specified, the 3rd word, are documented in the tables of entries
in Section 4.

{p 3 3 2}
As a second example, we could change the text color for axis titles from
{cmd:black} to {cmd:red} by changing the line,

	{cmd:color axis_title black}
{p 3 3 2}
to{p_end}
	{cmd:color axis_title red}

{p 3 3 2}
The available styles for {cmd:color} entries are the {it:colorstyles} and it
is worth noting that this includes explicit RGB values, rather than just named
colors, see help {help colorstyle} for more information and a discussion of
RGB values.  What this means is we could have changed the entry to

	{cmd:color axis_title "255 0 0"}

{p 3 3 2}
a bright red.  Note that the RGB values, and any style using more than one
token or word, must be enclosed in quotes.


{title:2. Plot entries} 

{p 3 3 2}
In addition to standard entries, scheme files have many entries for up to 15
plots.  What is a plot?  When you type

	{cmd:. scatter y1 y2 x}

{p 3 3 2}
the set of plotted markers for y1 versus x is the first plot and y2 versus x is the second plot.  The markers for the first plot look different from those
for the second plot {c -} perhaps different colors, or sizes, or both.  With
different graph commands, we might have two lines that differ, or two sets of
bars, or two pie slices, but in all cases we refer to these as plot1 and plot2
and their looks are controlled by {it:pstyles}, see help {help pstyle}.

{p 3 3 2}
An entry to set the marker size for the 2nd plot might be,

	{cmd:symbolsize p2 medium}
	
{p 3 3 2}
where {cmd:p2} specifies plot2.  

{p 3 3 2}
As it turns out, most of Stata's official schemes use the same size markers
for all plots.  Rather than having 15 entries to set the maker size, we simply
omit the plot number, and use the following single entry that applies to all
plots,

	{cmd:symbolsize p medium}

{p 3 3 2}
We will see later how to base your own scheme on another scheme, such as the
official {help scheme_s2:s2color} scheme, and in that case we must take some
care using just {cmd:p}.  Since {cmd:s2color} defines only one symbolsize for
all plots, we could change the size of all symbols to {cmd:large} by adding
the line,

	{cmd:symbolsize p large}

{p 3 3 2}
If {cmd:s2color} had been more specific and included entries to separately
define marker sizes for plot1 - plot15, then those more specific entries
would take precedence over our entry that did not specify a plot number.
We would need to make individual entries for {cmd:p1}, {cmd:p2}, etc.

{p 3 3 2}
Note that there are many attributes for graph plot elements and so there are
many plot entries.  In addition to marker size, there are entries for marker
color,

	{cmd:color p1 navy}

{p 3 3 2}
marker symbol (shape),

	{cmd:symbol p circle}
 
{p 3 3 2}
and sets of entries for lines, boxes, and other plot elements.


{p 3 3 2}
We pulled these two examples from the {cmd:s2color} scheme and you will note
that the marker colors are different for each plot while the marker symbols
are all circles.

{p 3 3 2}
Plot entries can be even more specific than plot number.  Some entries can be
directed at a particular kind of plot.  For example, the entry

	{cmd:color p3line yellow}

{p 3 3 2}
will make the 3rd line plot yellow, but will not affect the color of scatters,
bars, or other plot types.  While the {cmd:s2color} scheme does not take
advantage of this, it is possible to create schemes with different colors and
intensites for each plot type -- scatter, line, bar, pie slice, etc.


{title:3. Composite entries} 

{p 3 3 2}
When we said that each entry specifies a particular attribute, that was a
simplification.  Some entries specify how the specific attributes will be
assigned for a collection of attributes for a graph element.  We will call the
entries for these collections composite entries.

{p 3 3 2}
Textboxes, for example, are used for titles, captions, and many other graph
text elements.  There are 11 attributes associated with a textbox, e.g. the
size of the text, the color of the text, the color of the background, and
more, see help {help textboxstyle} for the full list.  Changing a
{it:textboxstyle} entry, which is a composite entry, will potentially change
all 11 of these attributes.

{p 3 3 2}
Let's look at two composite entries for textboxstyles,

	{cmd:textboxstyle axis_title axis_title}
	{cmd:textboxstyle title      heading}

{p 3 3 2}
The frist entry specifies that the {it:textboxstyle} for axis titles is to be
the {cmd:axis_title} style.  That seems like a good default.  Similarly, the
second line specifies that the {it:textboxstyle} for graph titles is to be the
{cmd:heading} style.  

{p 3 3 2}
We could make axis titles look just like graph titles by changing the
specified {it:textboxstyle} of the first entry from {cmd:axis_title} to
{cmd:heading},

	{cmd:textboxstyle axis_title heading}

{p 3 3 2}
Now, all axis titles will look like graph titles -- they will have the same
text size, the same text color, etc.

{p 3 3 2}
Note that changes to composite entries can interact with the effects of other
entries.  In section 3 we changed the color of axis title text by changing the
{cmd:color axis_title black} entry to {cmd:color axis_title black}.  Now that
the composite {it:textboxstyle} entry for axis titles no longer specifies the
{cmd:axis_title} style, but rather the {cmd:heading} style, our color change
will have no effect.  We would need to change the {cmd:color heading black}
entry to {cmd:color heading red} to change the color of axis titles.  This
would also change the color of graph titles, because the two are now sharing
the {cmd:heading} {it:textboxstyle}.


{title:4. Scheme file entry definitions}

{p 3 3 2}
The tables in this section show the entries classified by the attribute that
is being controlled, e.g. color or size.  Each line in the table represents
and entry.  The first two words identify the attribute and graph element or
overall category and are typed exactly as they appear into a scheme file.  The
third word is the style or look being specified for the element and attribute.
It is shown in the table as a stylename that is linked to a further
description of the style and list of names or values that would be valid third
words for the entry in a scheme file.  

{p 3 3 2}
Each entry is followed by a short description identifying how the entry
affects the look of graphs.  Note that these description are true for most
schemes, but some schemes may not employ the entry for the stated purpose.
Schemes allow composite entries to be modified and this can lead to the use of
other entries changing, as shown earlier in Section 3.  The use of entries for
the size, color, or pattern of objects are particularly likely to changed by
composite entries.


{space 3}{title:4.x. Line thickness entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the thickness of lines and outlines, see 
{help linewidthstyle}.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:linewidth p} {space 11}{it:{help linewidthstyle:linewidth}}}
	default thickness for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:linewidth p}{it:#} {space 10}{it:{help linewidthstyle:linewidth}}}
	override default thickness for the #th plot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:mark} {space 6}{it:{help linewidthstyle:linewidth}}}
	override outline thickness for the #th marker (usually scatter) 
	plot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:bar} {space 7}{it:{help linewidthstyle:linewidth}}}
	override thickness for the #th bar plot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:box} {space 7}{it:{help linewidthstyle:linewidth}}}
	override thickness for the #th boxplot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:area} {space 6}{it:{help linewidthstyle:linewidth}}}
	override thickness for the #th area plot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:connect} {space 3}{it:{help linewidthstyle:linewidth}}}
	override thickness of connecting line for the #th plot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:boxmark} {space 3}{it:{help linewidthstyle:linewidth}}}
	override outline thickness for the outside value markers of the #th 
	boxplot{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:dotmark} {space 3}{it:{help linewidthstyle:linewidth}}}
	override outline thickness for the markers of the #th dot plot
	from {help graph dot}{p_end}
{p2col:{cmd:linewidth p}{it:#}{cmd:other} {space 5}{it:{help linewidthstyle:linewidth}}}
	override outline thickness for the #th other area plotted; rarely 
	used{p_end}

{p2col:{cmd:linewidth ci}     {space 10}{it:{help linewidthstyle:linewidth}}}
	confidence interval line thickness, when drawn as lines{p_end}
{p2col:{cmd:linewidth ci2}    {space 9}{it:{help linewidthstyle:linewidth}}}
	second confidence interval line thickness, when drawn as lines{p_end}
{p2col:{cmd:linewidth ci_area} {space 5}{it:{help linewidthstyle:linewidth}}}
	confidence interval outline thickness, when drawn as an area{p_end}
{p2col:{cmd:linewidth ci2_area} {space 4}{it:{help linewidthstyle:linewidth}}}
	second confidence interval outline thickness, when drawn as
	an area{p_end}
{p2col:{cmd:linewidth histogram} {space 3}{it:{help linewidthstyle:linewidth}}}
	line thickness for histogram bars{p_end}
	
{p2col:{cmd:linewidth plotregion} {space 2}{it:{help linewidthstyle:linewidth}}}
	plotregion outline thickness{p_end}
{p2col:{cmd:linewidth matrix_plotregion} {space 0}{it:{help linewidthstyle:linewidth}}}{p_end}
{p2col:} plotregion outline thickness for {help graph matrix}{p_end}
{p2col:{cmd:linewidth legend}  {space 6}{it:{help linewidthstyle:linewidth}}}
	legend outline thickness{p_end}

{p2col:{cmd:linewidth major_grid} {space 2}{it:{help linewidthstyle:linewidth}}}
	grid line thickness for all grids{p_end}

{p2col:{cmd:linewidth xyline}  {space 6}{it:{help linewidthstyle:linewidth}}}
	thickness of lines drawn using the {cmd:xline()} and {cmd:yline()}
	options, see help {help added_line_options}{p_end}
{p2col:{cmd:linewidth refline} {space 5}{it:{help linewidthstyle:linewidth}}}
	reference lines thickness{p_end}
{p2col:{cmd:linewidth refmarker} {space 3}{it:{help linewidthstyle:linewidth}}}
	reference markers outline thickness{p_end}
{p2col:{cmd:linewidth matrixmark} {space 2}{it:{help linewidthstyle:linewidth}}}
	scatterplot matrices markers outline style{p_end}
{p2col:{cmd:linewidth dot_line} {space 4}{it:{help linewidthstyle:linewidth}}}
	thickness of lines for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:linewidth dot_area} {space 4}{it:{help linewidthstyle:linewidth}}}
	outline thickness for rectangle type dot lines drawn 
	by {help graph dot}{p_end} 
{p2col:{cmd:linewidth dotmark}  {space 5}{it:{help linewidthstyle:linewidth}}}
	marker outline thickness for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:linewidth pie}      {space 9}{it:{help linewidthstyle:linewidth}}}
	pie slice outline thickness{p_end}
{p2col:{cmd:linewidth sunflower} {space 3}{it:{help linewidthstyle:linewidth}}}
	sunflower petal thickness{p_end}

{p2col:{cmd:linewidth foreground} {space 2}{it:{help linewidthstyle:linewidth}}}
	default thickness for foreground lines; rarely used{p_end}
{p2line}


{space 3}{title:4.x. Linestyle entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These composite entries specify the collection of attributes that make up the
look of a line, including lines drawn for plots, lines drawn around boxes,
axis lines, etc., see help {it:{help linestyle}}.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:linestyle p}            {space 11}{it:{help linestyle}}}
	default {it:linestyle} for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:linestyle p}{it:#}      {space 10}{it:{help linestyle}}}
	override default {it:linestyle} for the #th plot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:mark} {space 6}{it:{help linestyle}}}
	override outline style for the #th marker (usually scatter) plot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:bar} {space 7}{it:{help linestyle}}}
	override {it:linestyle} for the #th bar plot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:box} {space 7}{it:{help linestyle}}}
	override {it:linestyle} for the #th boxplot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:area} {space 6}{it:{help linestyle}}}
	override {it:linestyle} for the #th area plot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:connect} {space 3}{it:{help linestyle}}}
	override connecting {it:linestyle} for the #th plot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:boxmark} {space 3}{it:{help linestyle}}}
	override outline style for the outside value markers of the #th 
	boxplot{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:dotmark} {space 3}{it:{help linestyle}}}
	override outline style for the markers of the #th dot plot
	from {help graph dot}{p_end}
{p2col:{cmd:linestyle p}{it:#}{cmd:other} {space 5}{it:{help linestyle}}}
	override {it:linestyle} for the #th other area plotted; rarely 
	used{p_end}

{p2col:{cmd:linestyle ci}           {space 10}{it:{help linestyle}}}
	{it:linestyle} for confidence intervals, when drawn as lines{p_end}
{p2col:{cmd:linestyle ci2}          {space 9}{it:{help linestyle}}}
	{it:linestyle} for second confidence intervals, when drawn as
	lines{p_end}
{p2col:{cmd:linestyle ci_area}      {space 5}{it:{help linestyle}}}
	{it:linestyle} for confidence interval outlines, when drawn as an 
	area{p_end}
{p2col:{cmd:linestyle ci2_area}      {space 4}{it:{help linestyle}}}
	{it:linestyle} for second confidence interval outlines, when drawn as
	an area{p_end}
{p2col:{cmd:linestyle histogram}     {space 3}{it:{help linestyle}}}
	{it:linestyle} for histogram bars{p_end}
	
{p2col:{cmd:linestyle plotregion}   {space 2}{it:{help linestyle}}}
	plotregion outline style{p_end}
{p2col:{cmd:linestyle matrix_plotregion} {space 0}{it:{help linestyle}}}{p_end}
{p2col:} plotregion outline style for {help graph matrix}{p_end}
{p2col:{cmd:linestyle legend}       {space 6}{it:{help linestyle}}}
	legend outline style{p_end}
{p2col:{cmd:linestyle textbox}      {space 5}{it:{help linestyle}}}
	{it:linestyle} for most textboxes, including titles and text added
	with the {cmd:text()} option{p_end}
{p2col:{cmd:linestyle mat_label_box} {space 0}{it:{help linestyle}}}{p_end}
{p2col:} outline style for diagonal labels of scatterplot matrices{p_end}

{p2col:{cmd:linestyle axis}         {space 8}{it:{help linestyle}}}
	axis {it:linestyle} for most axes{p_end}
{p2col:{cmd:linestyle axis_withgrid} {space 0}{it:{help linestyle}}}{p_end}
{p2col:} axis {it:linestyle} for axes that by default have a grid{p_end}
{p2col:{cmd:linestyle tick}         {space 8}{it:{help linestyle}}}
	axis major tick {it:linestyle}{p_end}
{p2col:{cmd:linestyle minor_tick}   {space 2}{it:{help linestyle}}}
	axis minor tick {it:linestyle}{p_end}
{p2col:{cmd:linestyle major_grid}   {space 2}{it:{help linestyle}}}
	grid {it:linestyle} for all grids{p_end}

{p2col:{cmd:linestyle xyline}       {space 6}{it:{help linestyle}}}
	{it:linestyle} of lines drawn using the {cmd:xline()} and {cmd:yline()}
	options, see help {help added_line_options}{p_end}
{p2col:{cmd:linestyle refline}      {space 5}{it:{help linestyle}}}
	{it:linestyle} for reference lines{p_end}
{p2col:{cmd:linestyle refmarker}    {space 3}{it:{help linestyle}}}
	reference markers outline style{p_end}
{p2col:{cmd:linestyle matrixmark}   {space 2}{it:{help linestyle}}}
	scatterplot matrices marker's outline style{p_end}
{p2col:{cmd:linestyle box_whiskers} {space 0}{it:{help linestyle}}}
	whisker {it:linestyle} when custom whisker lines are specified with
	{help graph box}{p_end}
{p2col:{cmd:linestyle box_median}   {space 2}{it:{help linestyle}}}
	median {it:linestyle} when custom median lines are specified with
	{help graph box}{p_end}
{p2col:{cmd:linestyle dotmark}      {space 5}{it:{help linestyle}}}
	marker outline style for dot lines from {help graph dot}{p_end}
{p2col:{cmd:linestyle dotchart}     {space 4}{it:{help linestyle}}}
	{it:linestyle} for lines sometimes used by {help graph dot} to
	represent dot lines.{p_end}
{p2col:{cmd:linestyle dotchart_area} {space 0}{it:{help linestyle}}}{p_end}
{p2col:} outline style for rectangles sometimes used by {help graph dot} 
	to represent dot lines{p_end}
{p2col:{cmd:linestyle pie_lines}     {space 3}{it:{help linestyle}}}
	pie slice outline style{p_end}
{p2col:{cmd:linestyle sunflowerlf} {space 1}{it:{help linestyle}}}
	light sunflower petal {it:linestyle}{p_end}
{p2col:{cmd:linestyle sunflowerdf} {space 1}{it:{help linestyle}}}
	dark sunflower petal {it:linestyle}{p_end}
{p2col:{cmd:linestyle sunflowerlb} {space 1}{it:{help linestyle}}}
	light sunflower background outline style{p_end}
{p2col:{cmd:linestyle sunflowerdb} {space 1}{it:{help linestyle}}}
	dark sunflower background outline style{p_end}

{p2col:{cmd:linestyle foreground}   {space 2}{it:{help linestyle}}}
	default {it:linestyle} for foreground lines; rarely used{p_end}
{p2col:{cmd:linestyle background}   {space 2}{it:{help linestyle}}}
	default {it:linestyle} for lines rendered as background; rarely 
	used {p_end}
{p2line}


{space 3}{title:4.x. Shadestyle entries}
{p2colset 4 38 41 0}
{p 3 3 2}
These composite entries specify the collection of attributes that make up the
color and color intensity of a filled area, see help {it:{help shadestyle}}.
Shadestyles appear only in scheme files and are rarely changed.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:shadestyle p}            {space 10}{it:{help shadestyle}}}
	default {it:shadestyle} for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:shadestyle p}{it:#}      {space 9}{it:{help shadestyle}}}
	override {it:shadestyle} for the #th plot{p_end}
{p2col:{cmd:shadestyle p}{it:#}{cmd:bar} {space 6}{it:{help shadestyle}}}
	override {it:shadestyle} for the #th bar plot{p_end}
{p2col:{cmd:shadestyle p}{it:#}{cmd:box} {space 6}{it:{help shadestyle}}}
	override {it:shadestyle} for the #th boxplot{p_end}
{p2col:{cmd:shadestyle p}{it:#}{cmd:area} {space 5}{it:{help shadestyle}}}
	override {it:shadestyle} for the #th area plot{p_end}
{p2col:{cmd:shadestyle p}{it:#}{cmd:pie} {space 6}{it:{help shadestyle}}}
	override {it:shadestyle} for the #th pie slice{p_end}

{p2col:{cmd:shadestyle foreground}   {space 1}{it:{help shadestyle}}}
	default fill for foreground areas{p_end}
{p2col:{cmd:shadestyle background}   {space 1}{it:{help shadestyle}}}
	default fill for background areas{p_end}

{p2col:{cmd:shadestyle ci}           {space 9}{it:{help shadestyle}}}
	{it:shadestyle} for confidence interval ({cmd:ci}) 
	{help pstyle}{p_end}
{p2col:{cmd:shadestyle ci2}           {space 8}{it:{help shadestyle}}}
	{it:shadestyle} for second confidence interval ({cmd:ci2}) 
	{help pstyle}{p_end}
{p2col:{cmd:shadestyle histogram}     {space 2}{it:{help shadestyle}}}
	{it:shadestyle} for filling histogram bars{p_end}
{p2col:{cmd:shadestyle sunflowerlb} {space 0}{it:{help shadestyle}}}
	light sunflower background {it:shadestyle}{p_end}
{p2col:{cmd:shadestyle sunflowerdb} {space 0}{it:{help shadestyle}}}
	dark sunflower background {it:shadestyle}{p_end}
{p2col:{cmd:shadestyle dotchart}      {space 3}{it:{help shadestyle}}}
	{it:shadestyle} for fill of rectangles sometimes used to represent 
	dot lines by {cmd:graph dot}{p_end}

{p2col:{cmd:shadestyle plotregion}    {space 1}{it:{help shadestyle}}}
	plotregion {it:shadestyle}{p_end}
{p2col:{cmd:shadestyle matrix_plotregion} {it:{help shadestyle}}}{p_end}
{p2col:} plotregion {it:shadestyle} for {help graph matrix}{p_end}
{p2col:{cmd:shadestyle legend}        {space 5}{it:{help shadestyle}}}
	legend background {it:shadestyle}{p_end}
{p2line}


{space 3}{title:4.x. Margin entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the {help marginstyle:margins} placed around
textboxes, plotregions, graphregions, and other graph elements.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:margin graph}        {space 7}{it:{help marginstyle}}}
	default margin around graphs{p_end}
{p2col:{cmd:margin combinegraph} {space 0}{it:{help marginstyle}}}
	outer margin of {help graph combine}{p_end}
{p2col:{cmd:margin matrixgraph}  {space 1}{it:{help marginstyle}}}
	outer margin of {help graph matrix}{p_end}
{p2col:{cmd:margin piegraph}     {space 4}{it:{help marginstyle}}}
	outer margin of {help graph pie}{p_end}
{p2col:{cmd:margin by_indiv}     {space 4}{it:{help marginstyle}}}
	margin around individual graphs of by graphs{p_end}

{p2col:{cmd:margin plotregion}   {space 2}{it:{help marginstyle}}}
	default margin for plotregions{p_end}
{p2col:{cmd:margin bargraph}     {space 4}{it:{help marginstyle}}}
	margin for plotregions of {help graph bar}{p_end}
{p2col:{cmd:margin hbargraph}    {space 3}{it:{help marginstyle}}}
	margin for plotregions of {help graph_bar:graph hbar}{p_end}
{p2col:{cmd:margin boxgraph}     {space 4}{it:{help marginstyle}}}
	margin for plotregions of {help graph box}{p_end}
{p2col:{cmd:margin hboxgraph}    {space 3}{it:{help marginstyle}}}
	margin for plotregions of {help graph_box:graph hbar}{p_end}
{p2col:{cmd:margin dotgraph}     {space 4}{it:{help marginstyle}}}
	margin for plotregions of {help graph dot}{p_end}
{p2col:{cmd:margin hdotgraph}    {space 3}{it:{help marginstyle}}}
	margin for plotregions of {help graph_dot:graph hbar}{p_end}
{p2col:{cmd:margin matrix_plotreg} {it:{help marginstyle}}}{p_end}
{p2col:}margin for plotregions of {help graph matrix}{p_end}
{p2col:{cmd:margin piegraph_region} {it:{help marginstyle}}}{p_end}
{p2col:}margin for plotregions of {help graph pie}{p_end}

{p2col:{cmd:margin heading}      {space 5}{it:{help marginstyle}}}
	titles margin{p_end}
{p2col:{cmd:margin subheading}   {space 2}{it:{help marginstyle}}}
	subtitles margin{p_end}
{p2col:{cmd:margin body}         {space 8}{it:{help marginstyle}}}
	captions, notes, and numbered titles (e.g., {cmd:t1title}) margin{p_end}
{p2col:{cmd:margin axis_title}   {space 2}{it:{help marginstyle}}}
	axis titles margin{p_end}
{p2col:{cmd:margin label}        {space 7}{it:{help marginstyle}}}
	margin around added text, option {cmd:text()}{p_end}
{p2col:{cmd:margin key_label}    {space 3}{it:{help marginstyle}}}
	margin around legend key label text{p_end}
{p2col:{cmd:margin text}         {space 8}{it:{help marginstyle}}}
	default margin around text, if not otherwise specified{p_end}
{p2col:{cmd:margin textbox}      {space 5}{it:{help marginstyle}}}
	default margin around outside of textbox, if not otherwise 
	specified{p_end}

{p2col:{cmd:margin legend}       {space 6}{it:{help marginstyle}}}
	margin around legends, but inside the legend box{p_end}
{p2col:{cmd:margin legend_boxmargin} {it:{help marginstyle}}}{p_end}
{p2col:}margin around outside of a legend's box{p_end}
{p2col:{cmd:margin legend_key_region} {it:{help marginstyle}}}{p_end}
{p2col:}margin around the area of the legend where keys are drawn{p_end}

{p2col:{cmd:margin matrix_label} {space 0}{it:{help marginstyle}}}
	margin for variable labels on diagonal of scatterplot matrices{p_end}
{p2col:{cmd:margin matrix_lab_box} {space 0}{it:{help marginstyle}}}{p_end}
{p2col:}margin for box around variable labels on diagonal of scatterplot 
	matrices{p_end}
{p2line}

{space 3}{title:4.x. Markerstyle entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These composite entries specify the collection of attributes that make up the
look of markers.  A {it:markerstyle} groups several basic style attributes,
such as marker size and fill color, under a single style, see help 
{it:{help markerstyle}}

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:marker p}         {space 9}{it:{help markerstyle}}}
	default marker for all graph families, plot types, and plots{p_end}
{p2col:{cmd:marker p}{it:#}   {space 8}{it:{help markerstyle}}}
	override marker for the #th plot{p_end}
{p2col:{cmd:marker p}{it:#}{cmd:box} {space 5}{it:{help markerstyle}}}
	override marker for the #th boxplot{p_end}
{p2col:{cmd:marker p}{it:#}{cmd:dot} {space 5}{it:{help markerstyle}}}
	override marker for the #th dot plot{p_end}

{p2col:{cmd:marker matrix}    {space 4}{it:{help markerstyle}}}
	marker for scatterplot matrices{p_end}
{p2col:{cmd:marker box_marker} {space 0}{it:{help markerstyle}}}
	median marker for box plots{p_end}
{p2col:{cmd:marker sunflower} {space 1}{it:{help markerstyle}}}
	sunflower plot markers{p_end}
{p2col:{cmd:marker dots}      {space 6}{it:{help markerstyle}}}
	marker for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:marker histogram} {space 1}{it:{help markerstyle}}}
	histogram marker, rarely used{p_end}
{p2col:{cmd:marker ci}        {space 8}{it:{help markerstyle}}}
	marker for confidence interval ({cmd:ci}) {help pstyle}{p_end}
{p2col:{cmd:marker ci2}       {space 7}{it:{help markerstyle}}}
	marker for second confidence interval ({cmd:ci2}) {help pstyle}{p_end}
{p2line}

{p2colset 4 44 47 0}
{space 3}{title:4.x. Line pattern symbol entries}

{p 3 3 2}
These entries specify the {help linepatternstyle:patterns} used for 
lines and outlines.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:linepattern p}         {space 9}{it:{help linepatternstyle}}}
	default line pattern for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:linepattern p}{it:#}   {space 8}{it:{help linepatternstyle}}}
	override default pattern for the #th plot{p_end}
{p2col:{cmd:linepattern p}{it:#}{cmd:line} {space 4}{it:{help linepatternstyle}}}
	override pattern for the #th line plot{p_end}
{p2col:{cmd:linepattern p}{it:#}{cmd:bar} {space 5}{it:{help linepatternstyle}}}
	override pattern for the #th bar plot{p_end}
{p2col:{cmd:linepattern p}{it:#}{cmd:area} {space 4}{it:{help linepatternstyle}}}
	override pattern for the #th area plot{p_end} 
{p2col:{cmd:linepattern p}{it:#}{cmd:other} {space 3}{it:{help linepatternstyle}}}
	override pattern for the #th other area plotted; rarely used{p_end}
{p2col:{cmd:linepattern p}{it:#}{cmd:box} {space 5}{it:{help linepatternstyle}}}
	override pattern for the #th boxplot (whiskers and median marker){p_end}

{p2col:{cmd:linepattern histogram}  {space 1}{it:{help linepatternstyle}}}
	outline pattern for histogram bars{p_end}

{p2col:{cmd:linepattern major_grid} {space 0}{it:{help linepatternstyle}}}
	line pattern for major grids{p_end}
{p2col:{cmd:linepattern minor_grid} {space 0}{it:{help linepatternstyle}}}
	line pattern for major grids{p_end}
{p2col:{cmd:linepattern grid}       {space 6}{it:{help linepatternstyle}}}
	default line pattern for grids{p_end}
{p2col:{cmd:linepattern xyline}     {space 4}{it:{help linepatternstyle}}}
	line pattern of lines drawn using the {cmd:xline()} and {cmd:yline()}
	options, see help {help added_line_options}{p_end}
{p2col:{cmd:linepattern refline}    {space 3}{it:{help linepatternstyle}}}
	line pattern for reference lines{p_end}
{p2col:{cmd:linepattern ci}           {space 8}{it:{help linepatternstyle}}}
	line pattern for confidence interval ({cmd:ci}) lines 
	{help pstyle}{p_end}
{p2col:{cmd:linepattern ci2}        {space 7}{it:{help linepatternstyle}}}
	outline pattern for second set of confidence interval 
	({cmd:ci}) {help pstyle}{p_end}
{p2col:{cmd:linepattern dot_area}   {space 2}{it:{help linepatternstyle}}}
	pattern of outlines for rectangle type dot lines drawn 
	by {help graph dot}{p_end} 
{p2col:{cmd:linepattern legend}     {space 4}{it:{help linepatternstyle}}}
	outline pattern for legends{p_end}
{p2col:{cmd:linepattern plotregion} {space 0}{it:{help linepatternstyle}}}
	outline pattern for plotregions{p_end}
{p2col:{cmd:linepattern matrix_plotregion} {space 0}{it:{help linepatternstyle}}}{p_end}
{p2col:}outline pattern for plotregions of {help graph matrix}}{p_end}

{p2col:{cmd:linepattern foreground} {space 0}{it:{help linepatternstyle}}}
	default outline pattern for foreground areas; rarely used{p_end}
{p2col:{cmd:linepattern background} {space 0}{it:{help linepatternstyle}}}
	default outline pattern for background areas{p_end}
{p2line}

{space 3}{title:4.x. Marker symbol entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the {help symbolstyle:symbols} used for markers.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:symbol p}         {space 8}{it:{help symbolstyle}}}
	default marker symbol for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:symbol p}{it:#}   {space 7}{it:{help symbolstyle}}}
	override symbol for the #th plot's markers{p_end}
{p2col:{cmd:symbol p}{it:#}{cmd:box} {space 4}{it:{help symbolstyle}}}
	override symbol for the #th boxplot's markers{p_end}
{p2col:{cmd:symbol p}{it:#}{cmd:dot} {space 4}{it:{help symbolstyle}}}
	override symbol for the #th dot plot's markers{p_end}

{p2col:{cmd:symbol matrix}    {space 3}{it:{help symbolstyle}}}
	marker symbol used for scatterplot matrices, {help graph matrix}{p_end}
{p2col:{cmd:symbol sunflower} {space 0}{it:{help symbolstyle}}}
	sunflower marker symbol{p_end}
{p2col:{cmd:symbol ci}        {space 7}{it:{help symbolstyle}}}
	marker symbol for confidence interval ({cmd:ci}) {help pstyle};
	rarely used{p_end}
{p2col:{cmd:symbol ci2}       {space 6}{it:{help symbolstyle}}}
	marker symbol for second confidence interval ({cmd:ci2}) {help pstyle};
	rarely used{p_end}
{p2col:{cmd:symbol refmarker} {space 0}{it:{help symbolstyle}}}
	symbol for reference markers{p_end}
{p2col:{cmd:symbol histogram} {space 0}{it:{help symbolstyle}}}
	histogram marker symbol; rarely used{p_end}
{p2col:{cmd:symbol dots}      {space 5}{it:{help symbolstyle}}}
	symbol used for dots on dot lines by {help graph dot}{p_end}
{p2line}


{space 3}{title:4.x. Axis tick entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the suggested number of axis ticks.  For a discussion of
suggested number of ticks, see the {cmd:#} rule in help 
{help axis_label_options}.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:numticks_g horizontal_major} {space 1}{it:#}}
	major ticks for horizontal axes{p_end}
{p2col:{cmd:numticks_g vertical_major}   {space 3}{it:#}}
	major ticks for vertical axes{p_end}
{p2col:{cmd:numticks_g horizontal_minor} {space 1}{it:#}}
	minor ticks for horizontal axes{p_end}
{p2col:{cmd:numticks_g vertical_minor}   {space 3}{it:#}}
	minor ticks for vertical axes{p_end}
{p2col:{cmd:numticks_g horizontal_tmajor} {space 0}{it:#}}
	major ticks for horizontal axes that do not by
	default show tick labels{p_end}
{p2col:{cmd:numticks_g vertical_tmajor}   {space 2}{it:#}}
	major ticks for vertical axes that do not by
	default show tick labels{p_end}
{p2col:{cmd:numticks_g horizontal_tminor} {space 0}{it:#}}
	minor ticks for horizontal axes that do not by
	default show tick labels{p_end}
{p2col:{cmd:numticks_g vertical_tminor}   {space 2}{it:#}}
	minor ticks for vertical axes that do not by
	default show tick labels{p_end}
{p2col:{cmd:numticks_g major}      {space 12}{it:#}}
	default suggested number of major ticks, if other not specified{p_end}
{p2line}

{space 3}{title:4.x. Marker size entries}
{p2colset 4 41 44 0}
{p 3 3 2}
These entries specify the {help markersizestyle:size} of markers.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:symbolsize p}      {space 8}{it:{help markersizestyle}}}
	default size of markers for all graph families, plot types, and 
	plots{p_end}
{p2col:{cmd:symbolsize p}{it:#} {space 7}{it:{help markersizestyle}}}
	override size for the #th plot's markers plots{p_end}
{p2col:{cmd:symbolsize p}{it:#}{cmd:box} {space 4}{it:{help markersizestyle}}}
	override size for the #th box plot's markers plots{p_end}
{p2col:{cmd:symbolsize p}{it:#}{cmd:dot} {space 4}{it:{help markersizestyle}}}
	override size for the #th dot plot's markers plots{p_end}
{p2col:{cmd:symbolsize matrix} {space 3}{it:{help markersizestyle}}}
	base marker size for {cmd:graph matrix}{p_end}
{p2col:{cmd:symbolsize sunflower} {space 0}{it:{help markersizestyle}}}
	sunflower marker size{p_end}
{p2col:{cmd:symbolsize ci} {space 7}{it:{help markersizestyle}}}
	marker size for reference markers{p_end}
{p2col:{cmd:symbolsize ci} {space 7}{it:{help markersizestyle}}}
	marker size for confidence interval {help pstyle}{p_end}
{p2col:{cmd:symbolsize ci2} {space 6}{it:{help markersizestyle}}}
	marker size for second confidence interval {help pstyle}{p_end}
{p2col:{cmd:symbolsize refmarker} {space 0}{it:{help markersizestyle}}}
	reference marker size{p_end}
{p2col:{cmd:symbolsize histogram} {space 0}{it:{help markersizestyle}}}
	size of histogram markers, rarely used{p_end}
{p2col:{cmd:symbolsize dots} {space 5}{it:{help markersizestyle}}}
	size of markers for dot lines used by {cmd:graph dot}{p_end}
{p2col:{cmd:symbolsize symbol} {space 3}{it:{help markersizestyle}}}
	default size of markers when not otherwise specified{p_end}
{p2line}

{space 3}{title:4.1. Text size entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the {help textsizestyle:size} of text.{p_end}

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:gsize body}      {space 6}{it:{help textsizestyle}}}
	captions text size{p_end}
{p2col:{cmd:gsize small_body}{space 1}{it:{help textsizestyle}}}
	note text size{p_end}
{p2col:{cmd:gsize {space 0}heading}   {space 3}{it:{help textsizestyle}}}
	title text size{p_end}
{p2col:{cmd:gsize subheading}{space 1}{it:{help textsizestyle}}}
	subtitles and numbered titles size, e.g., {cmd:t1title}{p_end}
{p2col:{cmd:gsize axis_title}{space 1}{it:{help textsizestyle}}}
	axis title text size{p_end}
{p2col:{cmd:gsize matrix_label}{space 0}{it:{help textsizestyle}}}
	variable labels on diagonal of scatterplot matrices{p_end}
{p2col:{cmd:gsize label}     {space 5}{it:{help textsizestyle}}}
	size of added text, option {cmd:text()}{p_end}
{p2col:{cmd:gsize tick_label} {space 0}{it:{help textsizestyle}}}
	axis tick label size for major ticks{cmd:text()}{p_end}
{p2col:{cmd:gsize minortick_label} {it:{help textsizestyle}}}{p_end}
{p2col:} axis tick label size for minor ticks{p_end}
{p2col:{cmd:gsize key_label} {space 1}{it:{help textsizestyle}}}
	legend key label text size{cmd:text()}{p_end}
{p2col:{cmd:gsize small_label} {space 0}{it:{help textsizestyle}}}
	default size of small labels, if chosen{cmd:text()}{p_end}
{p2col:{cmd:gsize plabel}    {space 4}{it:{help textsizestyle}}}
	default size of marker labels{p_end}
{p2col:{cmd:gsize p}{it:#}{cmd:label} {space 3}{it:{help textsizestyle}}}
	override size for the #th plot's marker labels{p_end}
{p2col:{cmd:gsize pboxlabel} {space 0}{it:{help textsizestyle}}}
	default size of marker labels for box plots{p_end}
{p2col:{cmd:gsize p}{it:#}{cmd:boxlabel} {space 3}{it:{help textsizestyle}}}
	override size for the #th boxplot's marker labels{p_end}
{p2col:{cmd:gsize filled_text} {space 0}{it:{help textsizestyle}}}
	default text size for some {help textboxstyle:textboxstyles}{p_end}
{p2col:{cmd:gsize text}      {space 6}{it:{help textsizestyle}}}
	default text size when other size not specified{p_end}
{p2line}


{space 3}{title:4.1. Length entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the size of gaps, lengths, and other distances.  Note
that either {it:{help textsizestyle:textsizestyles}} or 
{it:{help relsize:relsizes}} may be used for these entries.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:gsize tick}      {space 6}{it:{help textsizestyle}}}
	major tick length on an axis{p_end}
{p2col:{cmd:gsize minortick} {space 1}{it:{help textsizestyle}}}
	minor tick length on an axis{p_end}
{p2col:{cmd:gsize tickgap}   {space 3}{it:{help textsizestyle}}}
	added distance between an axis tick its label{p_end}
{p2col:{cmd:gsize notickgap} {space 1}{it:{help textsizestyle}}}
	added distance between an axis labels for axis styles that do not draw
	ticks{p_end}
{p2col:{cmd:gsize axis_title_gap} {it:{help textsizestyle}}}{p_end}
{p2col:} added distance between the labels for an axis and the axis 
	title{p_end}
{p2col:{cmd:gsize axis_space} {space 1}{it:{help textsizestyle}}}
	space placed outside an axis{p_end}
{p2col:{cmd:gsize alternate_gap} {space 0}{it:{help textsizestyle}}}
	additional gap between tick labels when each labels alternates
	lines with the prior label{p_end}
{p2col:{cmd:gsize label_gap} {space 3}{it:{help textsizestyle}}}
	distance between markers and their labels{p_end}
{p2col:{cmd:gsize barlabel_gap} {space 0}{it:{help textsizestyle}}}
	added distance bars and their labels{p_end}
{p2col:{cmd:gsize pielabel_gap} {space 1}{it:{help textsizestyle}}}
	distance of pie labels from center of pie{p_end}
{p2col:{cmd:gsize pie_explode} {space 2}{it:{help textsizestyle}}}
	distance to explode pie slices{p_end}
{p2col:{cmd:gsize legend_row_gap} {space 0}{it:{help textsizestyle}}}
	distance between rows of keys in a legend{p_end}
{p2col:{cmd:gsize legend_col_gap} {space 0}{it:{help textsizestyle}}}
	distance between columns of keys in a legend{p_end}
{p2col:{cmd:gsize legend_key_xsize} {space 0}{it:{help textsizestyle}}}
	length of keys other than markers, e.g., lines and boxes, in a 
	legend {p_end}
{p2col:{cmd:gsize legend_key_ysize} {space 0}{it:{help textsizestyle}}}
	height of keys in a legend {p_end}
{p2col:{cmd:gsize legend_key_gap} {space 0}{it:{help textsizestyle}}}
	gap between legend marker and legend label for most 
	{help legendstyle:legendstyles}{p_end}
{p2col:{cmd:gsize key_gap} {space 6}{it:{help textsizestyle}}}
	gap between legend marker and legend label for other 
	{help legendstyle:legendstyles}{p_end}
{p2col:{cmd:gsize dot_rectangle} {space 0}{it:{help textsizestyle}}}
	width of rectangles sometimes used by {cmd: graph dot} to represent 
	dot lines{p_end}
{p2col:{cmd:gsize gap}       {space 7}{it:{help textsizestyle}}}
	default length of gaps; rarely used{p_end}
{p2line}


{space 3}{title:4.x. Gaps for bar, boxes, and dots}
{p2colset 4 32 35 0}
{p 3 3 2}
These entries specify the size of gaps between bars for bar charts, boxes for
boxplots, and dots for dot charts.  All values for {it:#}s are in percentages
of bar and box widths.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:relsize bar_gap}      {space 8}{it:#}}
	distance between bars not in an {cmd:over()} group{p_end}
{p2col:{cmd:relsize bar_groupgap} {space 3}{it:#}}
	distance between bars in the first {cmd:over()} group{p_end}
{p2col:{cmd:relsize bar_supgroupgap} {space 0}{it:#}}
	distance between bars in the second {cmd:over()} group{p_end}
{p2col:{cmd:relsize bar_outergap} {space 3}{it:#}}
	distance between the outermost bars and the left and right boundaries
	of the plotregion{p_end}
{p2col:{cmd:relsize box_gap}      {space 8}{it:#}}
	distance between boxs not in an {cmd:over()} group{p_end}
{p2col:{cmd:relsize box_groupgap} {space 3}{it:#}}
	distance between boxs in the first {cmd:over()} group{p_end}
{p2col:{cmd:relsize box_supgroupgap} {space 0}{it:#}}
	distance between boxs in the second {cmd:over()} group{p_end}
{p2col:{cmd:relsize box_outergap} {space 3}{it:#}}
	distance between the outermost boxs and the left and right boundaries
	of the plotregion{p_end}
{p2col:{cmd:relsize dot_gap}      {space 8}{it:#}}
	distance between dot lines not in an {cmd:over()} group{p_end}
{p2col:{cmd:relsize dot_groupgap} {space 3}{it:#}}
	distance between dot lines in the first {cmd:over()} group{p_end}
{p2col:{cmd:relsize dot_supgroupgap} {space 0}{it:#}}
	distance between dot liness in the second {cmd:over()} group{p_end}
{p2col:{cmd:relsize dot_outergap} {space 3}{it:#}}
        distance between the outermost dot liness and the left and right
        boundaries of the plotregion{p_end} {p2line}


{space 3}{title:4.3. Color entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries specify the {help colorstyle:color} of graph elements.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:color heading}   {space 6}{it:{help colorstyle}}}
	title text color{p_end}
{p2col:{cmd:color subheading} {space 3}{it:{help colorstyle}}}
	subtitle text color{p_end}
{p2col:{cmd:color axis_title} {space 3}{it:{help colorstyle}}}
	axis title text color{p_end}
{p2col:{cmd:color matrix_label}{space 1}{it:{help colorstyle}}}
	text color for diagonal variable labels on scatterplot matrices{p_end}
{p2col:{cmd:color key_label}  {space 4}{it:{help colorstyle}}}
	legend key label text color{p_end}
{p2col:{cmd:color tick_label} {space 3}{it:{help colorstyle}}}
	axis tick label text color{p_end}
{p2col:{cmd:color label} {space 8}{it:{help colorstyle}}}
	label text color not otherwise specified{p_end}

{p2col:{cmd:color filled_text} {space 2}{it:{help colorstyle}}}
	text color for some filled textboxes{p_end}
{p2col:{cmd:color textbox}   {space 6}{it:{help colorstyle}}}
	background color for most textboxes{p_end}
{p2col:{cmd:color mat_label_box}{space 1}{it:{help colorstyle}}}
	background color for labels on diagonal of scatterplot matrices{p_end}
{p2col:{cmd:color filled}   {space 6}{it:{help colorstyle}}}
	background color for some filled textboxes{p_end}
{p2col:{cmd:color box}       {space 10}{it:{help colorstyle}}}
	box background color, for other boxes not otherwise specified{p_end}
{p2col:{cmd:color bylabel_outline} {space 2}{it:{help colorstyle}}}
	default outline color for individual graph subtitles on by graphs{p_end}
{p2col:{cmd:color p}         {space 12}{it:{help colorstyle}}}
	default color for plots; rarely used{p_end}

{p2col:{cmd:color p}{it:#}   {space 11}{it:{help colorstyle}}}
	default color for the #th plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:line}{space 9}{it:{help colorstyle}}}
	override color for the #th line plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:bar}{space 9}{it:{help colorstyle}}}
	override color for the #th bar plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:barline}{space 5}{it:{help colorstyle}}}
	override outline color for the #th bar plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:area}{space 9}{it:{help colorstyle}}}
	override fill color for the #th area plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:arealine}{space 5}{it:{help colorstyle}}}
	override outline color for the #th area plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:pie}{space 9}{it:{help colorstyle}}}
	override fill color for the #th pie slice{p_end}
{p2col:{cmd:color p}{it:#}{cmd:mark}{space 9}{it:{help colorstyle}}}
	override color for the #th marker (usually scatter) plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:markfill}{space 9}{it:{help colorstyle}}}
	override fill color for the #th marker (usually scatter) plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:markline}{space 9}{it:{help colorstyle}}}
	override line color for the #th marker (usually scatter) plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:label}{space 9}{it:{help colorstyle}}}
	override text color for the labels of the #th marker (usually 
	scatter) plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:barline}{space 5}{it:{help colorstyle}}}
	override outline color for the #th bar plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:box}{space 9}{it:{help colorstyle}}}
	override fill color for the #th boxplot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:boxline}{space 5}{it:{help colorstyle}}}
	override outline color for the #th boxplot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:boxmarkfill}{space 1}{it:{help colorstyle}}}
	override fill color for the outside value markers of the #th 
	boxplot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:boxmarkline}{space 1}{it:{help colorstyle}}}
	override outline color for the outside value markers of the #th 
	boxplot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:label}{space 9}{it:{help colorstyle}}}
	override text color for the labels of the outside value markers 
	of the #th box plot{p_end}
{p2col:{cmd:color p}{it:#}{cmd:dotmarkfill}{space 1}{it:{help colorstyle}}}
	override fill color for the markers of the #th dot plot
	from {help graph dot}{p_end}
{p2col:{cmd:color p}{it:#}{cmd:dotmarkline}{space 1}{it:{help colorstyle}}}
	override outline color for the markers of the #th dot plot
	from {cmd:graph dot}{p_end}
{p2col:{cmd:color p}{it:#}{cmd:other}{space 9}{it:{help colorstyle}}}
	override fill color for the #th plot of other areas; rarely used{p_end}
{p2col:{cmd:color p}{it:#}{cmd:otherline}{space 9}{it:{help colorstyle}}}
	override line color for the #th plot of other areas; rarely used{p_end}

{p2col:{cmd:color ci_line} {space 8}{it:{help colorstyle}}}
	line color for ci (confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color ci2_line} {space 7}{it:{help colorstyle}}}
	line color for ci2 (2nd confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color ci_area} {space 7}{it:{help colorstyle}}}
	fill color of areas for ci (confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color ci2_area} {space 7}{it:{help colorstyle}}}
	fill color of areas for ci (2nd confidence interval) 
	{help pstyle}{p_end}
{p2col:{cmd:color ci_arealine} {space 2}{it:{help colorstyle}}}
	outline color of areas for ci (confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color ci2_arealine} {space 1}{it:{help colorstyle}}}
	outline color of areas for ci (2nd confidence interval) 
	{help pstyle}{p_end}
{p2col:{cmd:color ci_symbol}  {space 6}{it:{help colorstyle}}}
	marker color for ci (confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color ci2_symbol} {space 5}{it:{help colorstyle}}}
	marker color for ci2 (confidence interval) {help pstyle}{p_end}
{p2col:{cmd:color pieline} {space 9}{it:{help colorstyle}}}
	outline color of pie slices for {help graph pie}{p_end}
{p2col:{cmd:color matrix} {space 9}{it:{help colorstyle}}}
	fill color of markers for {help graph matrix}{p_end}
{p2col:{cmd:color matrixmarkline} {space 0}{it:{help colorstyle}}}
	outline color of markers for {help graph matrix}{p_end}
{p2col:{cmd:color refmarker} {space 6}{it:{help colorstyle}}}
	reference marker fill color{p_end}
{p2col:{cmd:color refmarkline} {space 0}{it:{help colorstyle}}}
	reference marker outline color{p_end}
{p2col:{cmd:color histogram} {space 6}{it:{help colorstyle}}}
	histogram bar fill color{p_end}
{p2col:{cmd:color sunflower} {space 6}{it:{help colorstyle}}}
	sunflower marker color{p_end}
{p2col:{cmd:color sunflowerlb} {space 3}{it:{help colorstyle}}}
	light sunflower background color{p_end}
{p2col:{cmd:color sunflowerlf} {space 3}{it:{help colorstyle}}}
	light sunflower line color{p_end}
{p2col:{cmd:color sunflowerdb} {space 3}{it:{help colorstyle}}}
	dark sunflower background color{p_end}
{p2col:{cmd:color sunflowerdf} {space 3}{it:{help colorstyle}}}
	dark sunflower line color{p_end}
{p2col:{cmd:color histogram_line} {space 1}{it:{help colorstyle}}}
	histogram bar outline color{p_end}
{p2col:{cmd:color dot_line} {space 1}{it:{help colorstyle}}}
	color of lines for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:color dot_area} {space 6}{it:{help colorstyle}}}
	color of outlines for rectangle type dot lines sometimes drawn 
	by {help graph dot}{p_end} 
{p2col:{cmd:color dot_arealine} {space 3}{it:{help colorstyle}}}
	fill color of rectangle type dot lines sometimes drawn 
	by {help graph dot}{p_end} 
{p2col:{cmd:color dots} {space 12}{it:{help colorstyle}}}
	fill color of markers for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:color dotmarkline} {space 2}{it:{help colorstyle}}}
	outline color of markers for dot lines drawn by {help graph dot}{p_end}
{p2col:{cmd:color xyline} {space 9}{it:{help colorstyle}}}
	color of lines drawn using the {cmd:xline()} and {cmd:yline()}
	options, see help {help added_line_options}{p_end}
{p2col:{cmd:color refline} {space 6}{it:{help colorstyle}}}
	reference line color{p_end}

{p2col:{cmd:color plotregion} {space 3}{it:{help colorstyle}}}
	plotregion fill color{p_end}
{p2col:{cmd:color plotregion_line} {space 0}{it:{help colorstyle}}}
	plotregion outline color{p_end}
{p2col:{cmd:color matrix_plotregion} {space 3}{it:{help colorstyle}}}
	plotregion fill color for {cmd:graph matrix}{p_end}
{p2col:{cmd:color matplotregion_line} {space 3}{it:{help colorstyle}}}
	plotregion outline color for {cmd:graph matrix}{p_end}
{p2col:{cmd:color legend} {space 3}{it:{help colorstyle}}}
	legend fill color{p_end}
{p2col:{cmd:color legend_line} {space 3}{it:{help colorstyle}}}
	legend outline color{p_end}
{p2line}


{space 3}{title:4.x. Textstyle entries}
{p2colset 4 37 40 0}
{p 3 3 2}
These composite entries specify the {it:{help textstyle}} of graph text
elements and also the boxed {help textboxstyle:style} of boxed text elements.
See help {help textbox} for the distinction between {it:textboxstyle} and
{it:textstyle}.  In scheme files, both styles are {it:textboxstyle}s and the
additional attributes of a {it:textboxstyle} are simply ignored when applied
to a graph element that cannot be boxed.

{p 3 3 2}
As discussed more fully in {it:{help textboxstyle}} and {it:{help textstyle}},
the {it:textboxstyle} groups several basic style attributes, such as text
color and text size, under a single style.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:textboxstyle title}     {space 1}{it:{help textboxstyle}}}
	titles of graphs{p_end}
{p2col:{cmd:textboxstyle tick}      {space 2}{it:{help textstyle}}}
	overall style of axis ticks (!!){p_end}
{p2col:{cmd:textboxstyle p{it:#}}   {space 4}{it:{help textboxstyle}}}
	labels for the #th plot{p_end}
{p2col:!! and about 20 more}{p_end}
{p2line}


{space 3}{title:4.x. Other settings for all graphs}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries control additional graph characteristics for all graphs.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:graphsize y}      {space 12}{it:#}}
	height of available graph area (in inches){p_end}
{p2col:{cmd:graphsize x}      {space 12}{it:#}}
	width of available graph area (in inches){p_end}

{p2col:{cmd:numstyle legend_rows}     {space 3}{it:#}}
	number of columns for the keys in legends{p_end}
{p2col:{cmd:numstyle legend_rows}      {space 3}{it:#}}
	number of rows for the keys in legends{p_end}

{p2col:{cmd:numstyle grid_outer_tol}  {space 0}{it:#}}
	tolerance for drawing top and bottom grid lines (usually < 1
	and rarely used){p_end}
{p2line}



{space 3}{title:4.x. Other settings for specific graph families}
{p2colset 4 37 40 0}
{p 3 3 2}
These entries control additional graph characteristics for specific families
of graphs.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:numstyle dot_num_dots}    {space 6}{it:#}}
	number of dots used to fill the ruler lines of {cmd:graph dot}{p_end}
{p2col:{cmd:numstyle dot_extend_high} {space 0}{{cmd:0}|{cmd:1}}}
	whether to extend the dots in {cmd:graph dot} through the right
	margin of the {help plotregion}{p_end}
{p2col:{cmd:numstyle dot_extend_low}   {space 1}{{cmd:0}|{cmd:1}}}
	whether to extend the dots in {cmd:graph dot} through the left
	margin of the {help plotregion}{p_end}

{p2col:{cmd:numstyle pie_angle}    {space 9}{it:#}}
	angle at which to begin drawing first pie slice 
	for {cmd:graph pie}}{p_end}

{p2col:{cmd:numstyle max_wted_symsize} {space 2}{it:#}}
	affects maximum size of symbols is weighted scatter 
	plots; rarely used{p_end}
{p2line}


{p2colreset}

{p 3 3 2}
Hi

{title:5. Advanced scheme file entry definitions}
{p 3 3 2}
These are advanced and rarely used scheme file entries. 

{space 3}{title:5.x. Scatterplot matrix axis options}
{p2colset 4 41 44 0}
{p 3 3 2}
These entries are additional options that are to be used on scatterplot
matrices, {cmd:graph matrix}.  For example,

	{cmd:special matrix yaxis "ylabels(#2, angle(horizontal) axis(Y)"}

{p 3 3 2}
requests that approximately two ticks be used on scatterplot matrices and that
they labels be horizontal.  Note that the {cmd:axis(Y)} directive is required
for y-axes and that similarly {cmd:axis(X)} would be required for x-axes.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:special matrix_yaxis} {space 0}{help axis_options}}
	additional options for the x-axes{p_end}
{p2col:{cmd:special matrix_xaxis} {space 0}{help axis_options}}
	additional options for the y-axes{p_end}
{p2line}

{space 3}{title:5.x. Scaling for {cmd:by}, {cmd:combine}, and {cmd:matrix} graphs}
{p2colset 4 29 32 0}
{p 3 3 2}
These entries control the rate at which the size of text, markers, and line
widths are scaled (decreased) as the number of graphs plotted increases for 
{cmd:graph, by()}, {cmd:graph combine}, and {cmd:graph matrix}.

{p2col:entry} description{p_end}
{p2line}
{p2col:{cmd:special by_slope1}      {space 5}{it:#}}
	rate of scaling prior to the knot for {cmd:by} graphs (1){p_end}
{p2col:{cmd:special by_knot1}      {space 6}{it:#}}
	point at which scaling changes from slope1 to slope2 for {cmd:by}
	graphs(3){p_end}
{p2col:{cmd:special by_slope2}      {space 5}{it:#}}
	rate of scaling after the knot for {cmd:by} graphs (1){p_end}
{p2col:{cmd:special combine_slope1}  {space 0}{it:#}}
	rate of scaling prior to the knot for {cmd:graph combine} (1){p_end}
{p2col:{cmd:special combine_knot1}   {space 1}{it:#}}
	point at which scaling changes from slope1 to slope2 for 
	{cmd:graph combine}(1){p_end}
{p2col:{cmd:special combine_slope2}  {space 0}{it:#}}
	rate of scaling after the knot for {cmd:graph combine} (1){p_end}
{p2col:{cmd:special matrix_slope1}   {space 1}{it:#}}
	rate of scaling prior to the knot for {cmd:graph matrix} (1){p_end}
{p2col:{cmd:special matrix_knot1}    {space 2}{it:#}}
	point at which scaling changes from slope1 to slope2 for 
	{cmd:graph matrix}(2){p_end}
{p2col:{cmd:special matrix_slope2}   {space 1}{it:#}}
	rate of scaling after the knot for {cmd:graph matrix} (1){p_end}
{p2line}
{p 3 7 2}
(1) Generally, 0<{it:#}<1 for slopes, with 0 being no scaling and 1 scaling in
near direct proportion to the ceiling of the square root of the number of
graphs.{p_end} 
{p 3 7 2}
(2) When the ceiling of the square root of the exceeds the value of the knot,
the rate of scaling moves from slope1 to slope2.{p_end}

{p 3 3 2}
The forumla for the scaling factor is a spline based on the slopes and knots.
Let,

	s1 = slope1
	s2 = slope2
	k  = knot
	n  = ceiling(sqrt(number_of_graphs))

{p 3 3 2}
The scaling factor is then

{p 8 12 4}
	s = 1 - s1(n-1)/n + indicator(n>k)(s2-s1)(n-k)/n

{p 3 3 2}
where s is the proportion of the unscaled size.  s close to 0 mplies very
small sizes and s=1 implies no scaling.

{p2colreset}

{title:7. Example new scheme}

{p 3 3 2}
Hi

{title:8. Suggestions}

{p 3 3 2}
Hi
!! play around
!! can we have tabs in scheme files??  Format??
!! "not otherwise specified" means varies to much from scheme to scheme to
matter, or rarely used in schemes, or you might hit this playing composite
entries but unlikely otherwise (and you probably don't care because you were
probably getting everything you wanted from the composite entry).

{title:9. Glossary}

{p2colset 4 15 15 2}
{p2col:{cmd:plot}}A specific line, scatter, series of bars, pie slice, or
other representation of a value or series of values to be graphed.  For
example, {cmd:scatter y1 y2 x} creates two plots {c -} a scatter of {cmd:y1}
against {cmd:x} and a second scatter of {cmd:y2} against {cmd:x}.  In this
example, the first scatter would get its "look" from the styles named {cmd:p1}
while the second scatter would get its "look" from the styles named {cmd:p2}.
Generally each plot has its own particular "look" or style, i.e. color, size,
line thickness, etc, though it is always possible to assign different plots
the same style.{p_end}

{p2col:{cmd:composite entry}}xyz


{p2colreset}

{title:Also see}

    Manual:  {hi:[G] schemes}

{p 4 13 2}
Online:  help for
{it:{help schemes}},
{it:{help scheme_option}},
{help set_scheme};
{help scheme_economist},
{help scheme_s2},
{help scheme_s1},
{help scheme_sj}
{p_end}

