attributes help messages
authormeitham
Fri, 27 Nov 2009 16:35:29 +0000
changeset 3271 c14b161b62bf
parent 3270 4453e42114e4
child 3272 10f6899a18a5
attributes help messages
src/reportlab/graphics/charts/barcharts.py
src/reportlab/graphics/charts/legends.py
src/reportlab/graphics/charts/linecharts.py
src/reportlab/graphics/charts/lineplots.py
src/reportlab/graphics/charts/piecharts.py
src/reportlab/graphics/charts/spider.py
src/reportlab/graphics/charts/textlabels.py
src/reportlab/graphics/widgetbase.py
--- a/src/reportlab/graphics/charts/barcharts.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/barcharts.py	Fri Nov 27 16:35:29 2009 +0000
@@ -32,9 +32,9 @@
         fillColor = AttrMapValue(isColorOrNone, desc='Color of the bar interior area.'),
         strokeWidth = AttrMapValue(isNumber, desc='Width of the bar border.'),
         strokeDashArray = AttrMapValue(isListOfNumbersOrNone, desc='Dash array of a line.'),
-        symbol = AttrMapValue(None, desc='A widget to be used instead of a normal bar.'),
+        symbol = AttrMapValue(None, desc='A widget to be used instead of a normal bar.',advancedUsage=1),
         name = AttrMapValue(isString, desc='Text to be associated with a bar (eg seriesname)'),
-        swatchMarker = AttrMapValue(NoneOr(isSymbol), desc="None or makeMarker('Diamond') ..."),
+        swatchMarker = AttrMapValue(NoneOr(isSymbol), desc="None or makeMarker('Diamond') ...",advancedUsage=1),
         )
 
     def __init__(self):
@@ -49,7 +49,7 @@
     "Abstract base class, unusable by itself."
 
     _attrMap = AttrMap(BASE=PlotArea,
-        useAbsolute = AttrMapValue(isNumber, desc='Flag to use absolute spacing values.'),
+        useAbsolute = AttrMapValue(isNumber, desc='Flag to use absolute spacing values.',advancedUsage=1),
         barWidth = AttrMapValue(isNumber, desc='The width of an individual bar.'),
         groupSpacing = AttrMapValue(isNumber, desc='Width between groups of bars.'),
         barSpacing = AttrMapValue(isNumber, desc='Width between individual bars.'),
@@ -59,10 +59,10 @@
         data = AttrMapValue(None, desc='Data to be plotted, list of (lists of) numbers.'),
         barLabels = AttrMapValue(None, desc='Handle to the list of bar labels.'),
         barLabelFormat = AttrMapValue(None, desc='Formatting string or function used for bar labels.'),
-        barLabelCallOut = AttrMapValue(None, desc='Callout function(label)\nlabel._callOutInfo = (self,g,rowNo,colNo,x,y,width,height,x00,y00,x0,y0)'),
+        barLabelCallOut = AttrMapValue(None, desc='Callout function(label)\nlabel._callOutInfo = (self,g,rowNo,colNo,x,y,width,height,x00,y00,x0,y0)',advancedUsage=1),
         barLabelArray = AttrMapValue(None, desc='explicit array of bar label values, must match size of data if present.'),
-        reversePlotOrder = AttrMapValue(isBoolean, desc='If true, reverse common category plot order.'),
-        naLabel = AttrMapValue(NoneOrInstanceOfNA_Label, desc='Label to use for N/A values.'),
+        reversePlotOrder = AttrMapValue(isBoolean, desc='If true, reverse common category plot order.',advancedUsage=1),
+        naLabel = AttrMapValue(NoneOrInstanceOfNA_Label, desc='Label to use for N/A values.',advancedUsage=1),
         annotations = AttrMapValue(None, desc='list of callables, will be called with self, xscale, yscale.'),
         )
 
--- a/src/reportlab/graphics/charts/legends.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/legends.py	Fri Nov 27 16:35:29 2009 +0000
@@ -133,9 +133,9 @@
         deltax = AttrMapValue(isNumberOrNone, desc="x-distance between neighbouring swatches"),
         deltay = AttrMapValue(isNumberOrNone, desc="y-distance between neighbouring swatches"),
         dxTextSpace = AttrMapValue(isNumber, desc="Distance between swatch rectangle and text"),
-        autoXPadding = AttrMapValue(isNumber, desc="x Padding between columns if deltax=None"),
-        autoYPadding = AttrMapValue(isNumber, desc="y Padding between rows if deltay=None"),
-        yGap = AttrMapValue(isNumber, desc="Additional gap between rows"),
+        autoXPadding = AttrMapValue(isNumber, desc="x Padding between columns if deltax=None",advancedUsage=1),
+        autoYPadding = AttrMapValue(isNumber, desc="y Padding between rows if deltay=None",advancedUsage=1),
+        yGap = AttrMapValue(isNumber, desc="Additional gap between rows",advancedUsage=1),
         dx = AttrMapValue(isNumber, desc="Width of swatch rectangle"),
         dy = AttrMapValue(isNumber, desc="Height of swatch rectangle"),
         columnMaximum = AttrMapValue(isNumber, desc="Max. number of items per column"),
@@ -143,22 +143,22 @@
         colorNamePairs = AttrMapValue(None, desc="List of color/name tuples (color can also be widget)"),
         fontName = AttrMapValue(isString, desc="Font name of the strings"),
         fontSize = AttrMapValue(isNumber, desc="Font size of the strings"),
-        fillColor = AttrMapValue(isColorOrNone, desc=""),
+        fillColor = AttrMapValue(isColorOrNone, desc="swatches filling color"),
         strokeColor = AttrMapValue(isColorOrNone, desc="Border color of the swatches"),
         strokeWidth = AttrMapValue(isNumber, desc="Width of the border color of the swatches"),
-        swatchMarker = AttrMapValue(NoneOr(AutoOr(isSymbol)), desc="None, Auto() or makeMarker('Diamond') ..."),
-        callout = AttrMapValue(None, desc="a user callout(self,g,x,y,(color,text))"),
+        swatchMarker = AttrMapValue(NoneOr(AutoOr(isSymbol)), desc="None, Auto() or makeMarker('Diamond') ...",advancedUsage=1),
+        callout = AttrMapValue(None, desc="a user callout(self,g,x,y,(color,text))",advancedUsage=1),
         boxAnchor = AttrMapValue(isBoxAnchor,'Anchor point for the legend area'),
-        variColumn = AttrMapValue(isBoolean,'If true column widths may vary (default is false)'),
-        dividerLines = AttrMapValue(OneOf(0,1,2,3,4,5,6,7),'If 1 we have dividers between the rows | 2 for extra top | 4 for bottom'),
-        dividerWidth = AttrMapValue(isNumber, desc="dividerLines width"),
-        dividerColor = AttrMapValue(isColorOrNone, desc="dividerLines color"),
-        dividerDashArray = AttrMapValue(isListOfNumbersOrNone, desc='Dash array for dividerLines.'),
-        dividerOffsX = AttrMapValue(SequenceOf(isNumber,emptyOK=0,lo=2,hi=2), desc='divider lines X offsets'),
-        dividerOffsY = AttrMapValue(isNumber, desc="dividerLines Y offset"),
-        colEndCallout = AttrMapValue(None, desc="a user callout(self,g, x, xt, y,width, lWidth)"),
+        variColumn = AttrMapValue(isBoolean,'If true column widths may vary (default is false)',advancedUsage=1),
+        dividerLines = AttrMapValue(OneOf(0,1,2,3,4,5,6,7),'If 1 we have dividers between the rows | 2 for extra top | 4 for bottom',advancedUsage=1),
+        dividerWidth = AttrMapValue(isNumber, desc="dividerLines width",advancedUsage=1),
+        dividerColor = AttrMapValue(isColorOrNone, desc="dividerLines color",advancedUsage=1),
+        dividerDashArray = AttrMapValue(isListOfNumbersOrNone, desc='Dash array for dividerLines.',advancedUsage=1),
+        dividerOffsX = AttrMapValue(SequenceOf(isNumber,emptyOK=0,lo=2,hi=2), desc='divider lines X offsets',advancedUsage=1),
+        dividerOffsY = AttrMapValue(isNumber, desc="dividerLines Y offset",advancedUsage=1),
+        colEndCallout = AttrMapValue(None, desc="a user callout(self,g, x, xt, y,width, lWidth)",advancedUsage=1),
         subCols = AttrMapValue(None,desc="subColumn properties"),
-        swatchCallout = AttrMapValue(None, desc="a user swatch callout(self,g,x,y,i,(col,name),swatch)"),
+        swatchCallout = AttrMapValue(None, desc="a user swatch callout(self,g,x,y,i,(col,name),swatch)",advancedUsage=1),
         )
 
     def __init__(self):
--- a/src/reportlab/graphics/charts/linecharts.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/linecharts.py	Fri Nov 27 16:35:29 2009 +0000
@@ -24,9 +24,9 @@
         strokeWidth = AttrMapValue(isNumber, desc='Width of a line.'),
         strokeColor = AttrMapValue(isColorOrNone, desc='Color of a line.'),
         strokeDashArray = AttrMapValue(isListOfNumbersOrNone, desc='Dash array of a line.'),
-        symbol = AttrMapValue(NoneOr(isSymbol), desc='Widget placed at data points.'),
-        shader = AttrMapValue(None, desc='Shader Class.'),
-        filler = AttrMapValue(None, desc='Filler Class.'),
+        symbol = AttrMapValue(NoneOr(isSymbol), desc='Widget placed at data points.',advancedUsage=1),
+        shader = AttrMapValue(None, desc='Shader Class.',advancedUsage=1),
+        filler = AttrMapValue(None, desc='Filler Class.',advancedUsage=1),
         name = AttrMapValue(isStringOrNone, desc='Name of the line.'),
         )
 
@@ -108,8 +108,8 @@
     """
 
     _attrMap = AttrMap(BASE=LineChart,
-        useAbsolute = AttrMapValue(isNumber, desc='Flag to use absolute spacing values.'),
-        lineLabelNudge = AttrMapValue(isNumber, desc='Distance between a data point and its label.'),
+        useAbsolute = AttrMapValue(isNumber, desc='Flag to use absolute spacing values.',advancedUsage=1),
+        lineLabelNudge = AttrMapValue(isNumber, desc='Distance between a data point and its label.',advancedUsage=1),
         lineLabels = AttrMapValue(None, desc='Handle to the list of data point labels.'),
         lineLabelFormat = AttrMapValue(None, desc='Formatting string or function used for data point labels.'),
         lineLabelArray = AttrMapValue(None, desc='explicit array of line label values, must match size of data if present.'),
@@ -120,9 +120,9 @@
         categoryAxis = AttrMapValue(None, desc='Handle of the category axis.'),
         categoryNames = AttrMapValue(isListOfStringsOrNone, desc='List of category names.'),
         data = AttrMapValue(None, desc='Data to be plotted, list of (lists of) numbers.'),
-        inFill = AttrMapValue(isBoolean, desc='Whether infilling should be done.'),
-        reversePlotOrder = AttrMapValue(isBoolean, desc='If true reverse plot order.'),
-        annotations = AttrMapValue(None, desc='list of callables, will be called with self, xscale, yscale.'),
+        inFill = AttrMapValue(isBoolean, desc='Whether infilling should be done.',advancedUsage=1),
+        reversePlotOrder = AttrMapValue(isBoolean, desc='If true reverse plot order.',advancedUsage=1),
+        annotations = AttrMapValue(None, desc='list of callables, will be called with self, xscale, yscale.',advancedUsage=1),
         )
 
     def __init__(self):
--- a/src/reportlab/graphics/charts/lineplots.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/lineplots.py	Fri Nov 27 16:35:29 2009 +0000
@@ -26,11 +26,11 @@
         strokeWidth = AttrMapValue(isNumber, desc='Width of a line.'),
         strokeColor = AttrMapValue(isColorOrNone, desc='Color of a line.'),
         strokeDashArray = AttrMapValue(isListOfNumbersOrNone, desc='Dash array of a line.'),
-        symbol = AttrMapValue(None, desc='Widget placed at data points.'),
-        shader = AttrMapValue(None, desc='Shader Class.'),
-        filler = AttrMapValue(None, desc='Filler Class.'),
+        symbol = AttrMapValue(None, desc='Widget placed at data points.',advancedUsage=1),
+        shader = AttrMapValue(None, desc='Shader Class.',advancedUsage=1),
+        filler = AttrMapValue(None, desc='Filler Class.',advancedUsage=1),
         name = AttrMapValue(isStringOrNone, desc='Name of the line.'),
-        inFill = AttrMapValue(isBoolean, desc='If true flood fill to x axis'),
+        inFill = AttrMapValue(isBoolean, desc='If true flood fill to x axis',advancedUsage=1),
         )
 
 class Shader(_SetKeyWordArgs):
@@ -79,8 +79,8 @@
     X and Y versions of this class).
     """
     _attrMap = AttrMap(BASE=PlotArea,
-        reversePlotOrder = AttrMapValue(isBoolean, desc='If true reverse plot order.'),
-        lineLabelNudge = AttrMapValue(isNumber, desc='Distance between a data point and its label.'),
+        reversePlotOrder = AttrMapValue(isBoolean, desc='If true reverse plot order.',advancedUsage=1),
+        lineLabelNudge = AttrMapValue(isNumber, desc='Distance between a data point and its label.',advancedUsage=1),
         lineLabels = AttrMapValue(None, desc='Handle to the list of data point labels.'),
         lineLabelFormat = AttrMapValue(None, desc='Formatting string or function used for data point labels.'),
         lineLabelArray = AttrMapValue(None, desc='explicit array of line label values, must match size of data if present.'),
@@ -91,9 +91,9 @@
         xValueAxis = AttrMapValue(None, desc='Handle of the x axis.'),
         yValueAxis = AttrMapValue(None, desc='Handle of the y axis.'),
         data = AttrMapValue(None, desc='Data to be plotted, list of (lists of) x/y tuples.'),
-        annotations = AttrMapValue(None, desc='list of callables, will be called with self, xscale, yscale.'),
-        behindAxes = AttrMapValue(isBoolean, desc='If true use separate line group.'),
-        gridFirst = AttrMapValue(isBoolean, desc='If true use draw grids before axes.'),
+        annotations = AttrMapValue(None, desc='list of callables, will be called with self, xscale, yscale.',advancedUsage=1),
+        behindAxes = AttrMapValue(isBoolean, desc='If true use separate line group.',advancedUsage=1),
+        gridFirst = AttrMapValue(isBoolean, desc='If true use draw grids before axes.',advancedUsage=1),
         )
 
     def __init__(self):
@@ -800,7 +800,7 @@
                     outerBorderOn = AttrMapValue(isBoolean, desc="Is there an outer border (continuation of axes)"),
                     outerBorderColor = AttrMapValue(isColorOrNone, desc="Color of outer border (if any)"),
                     background = AttrMapValue(isColorOrNone, desc="Background color (if any)"),
-                    labelOffset = AttrMapValue(isNumber, desc="Space between label and Axis (or other labels)"),
+                    labelOffset = AttrMapValue(isNumber, desc="Space between label and Axis (or other labels)",advancedUsage=1),
                     axisTickLengths = AttrMapValue(isNumber, desc="Lenth of the ticks on both axes"),
                     axisStrokeWidth = AttrMapValue(isNumber, desc="Stroke width for both axes"),
                     xLabel = AttrMapValue(isString, desc="Label for the whole X-Axis"),
--- a/src/reportlab/graphics/charts/piecharts.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/piecharts.py	Fri Nov 27 16:35:29 2009 +0000
@@ -63,9 +63,9 @@
         fillColor = AttrMapValue(isColorOrNone,desc=''),
         strokeColor = AttrMapValue(isColorOrNone,desc=''),
         strokeDashArray = AttrMapValue(isListOfNumbersOrNone,desc=''),
-        strokeLineCap = AttrMapValue(OneOf(0,1,2),desc="Line Cap parameter o, 1 or 2"),
-        strokeLineJoin = AttrMapValue(OneOf(0,1,2),desc="Line Join parameter 0, 1 or 2"),
-        strokeMiterLimit = AttrMapValue(isNumber,desc=''),
+        strokeLineCap = AttrMapValue(OneOf(0,1,2),desc="Line cap 0=butt, 1=round & 2=square"),
+        strokeLineJoin = AttrMapValue(OneOf(0,1,2),desc="Line join 0=miter, 1=round & 2=bevel"),
+        strokeMiterLimit = AttrMapValue(isNumber,desc='miter limit control miter line joins'),
         popout = AttrMapValue(isNumber,desc="how far of centre a wedge to pop."),
         fontName = AttrMapValue(isString,desc=''),
         fontSize = AttrMapValue(isNumber,desc=''),
--- a/src/reportlab/graphics/charts/spider.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/spider.py	Fri Nov 27 16:35:29 2009 +0000
@@ -36,12 +36,12 @@
 class StrandProperty(PropHolder):
 
     _attrMap = AttrMap(
-        strokeWidth = AttrMapValue(isNumber),
-        fillColor = AttrMapValue(isColorOrNone),
-        strokeColor = AttrMapValue(isColorOrNone),
-        strokeDashArray = AttrMapValue(isListOfNumbersOrNone),
-        symbol = AttrMapValue(EitherOr((isStringOrNone,isSymbol)), desc='Widget placed at data points.'),
-        symbolSize= AttrMapValue(isNumber, desc='Symbol size.'),
+        strokeWidth = AttrMapValue(isNumber,desc='width'),
+        fillColor = AttrMapValue(isColorOrNone,desc='filling color'),
+        strokeColor = AttrMapValue(isColorOrNone,desc='stroke color'),
+        strokeDashArray = AttrMapValue(isListOfNumbersOrNone,desc='dashing pattern, e.g. (3,2)'),
+        symbol = AttrMapValue(EitherOr((isStringOrNone,isSymbol)), desc='Widget placed at data points.',advancedUsage=1),
+        symbolSize= AttrMapValue(isNumber, desc='Symbol size.',advancedUsage=1),
         name = AttrMapValue(isStringOrNone, desc='Name of the strand.'),
         )
 
@@ -56,11 +56,11 @@
 
 class SpokeProperty(PropHolder):
     _attrMap = AttrMap(
-        strokeWidth = AttrMapValue(isNumber),
-        fillColor = AttrMapValue(isColorOrNone),
-        strokeColor = AttrMapValue(isColorOrNone),
-        strokeDashArray = AttrMapValue(isListOfNumbersOrNone),
-        labelRadius = AttrMapValue(isNumber),
+        strokeWidth = AttrMapValue(isNumber,desc='width'),
+        fillColor = AttrMapValue(isColorOrNone,desc='filling color'),
+        strokeColor = AttrMapValue(isColorOrNone,desc='stroke color'),
+        strokeDashArray = AttrMapValue(isListOfNumbersOrNone,desc='dashing pattern, e.g. (2,1)'),
+        labelRadius = AttrMapValue(isNumber,desc='label radius',advancedUsage=1),
         visible = AttrMapValue(isBoolean,desc="True if the spoke line is to be drawn"),
         )
 
@@ -79,8 +79,8 @@
 
 class StrandLabel(SpokeLabel):
     _attrMap = AttrMap(BASE=SpokeLabel,
-            format = AttrMapValue(EitherOr((isStringOrNone,isCallable)),"Format for the label"),
-            dR = AttrMapValue(isNumberOrNone,"radial shift for label"),
+            format = AttrMapValue(EitherOr((isStringOrNone,isCallable)),desc="Format for the label"),
+            dR = AttrMapValue(isNumberOrNone,desc="radial shift for label"),
             )
     def __init__(self,**kw):
         self.format = ''
--- a/src/reportlab/graphics/charts/textlabels.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/charts/textlabels.py	Fri Nov 27 16:35:29 2009 +0000
@@ -91,32 +91,32 @@
     # framework.
 
     _attrMap = AttrMap(
-        x = AttrMapValue(isNumber),
-        y = AttrMapValue(isNumber),
-        dx = AttrMapValue(isNumber),
-        dy = AttrMapValue(isNumber),
-        angle = AttrMapValue(isNumber),
-        boxAnchor = AttrMapValue(isBoxAnchor),
-        boxStrokeColor = AttrMapValue(isColorOrNone),
-        boxStrokeWidth = AttrMapValue(isNumber),
-        boxFillColor = AttrMapValue(isColorOrNone),
-        boxTarget = AttrMapValue(OneOf('normal','anti','lo','hi')),
-        fillColor = AttrMapValue(isColorOrNone),
-        strokeColor = AttrMapValue(isColorOrNone),
-        strokeWidth = AttrMapValue(isNumber),
-        text = AttrMapValue(isString),
-        fontName = AttrMapValue(isString),
-        fontSize = AttrMapValue(isNumber),
-        leading = AttrMapValue(isNumberOrNone),
-        width = AttrMapValue(isNumberOrNone),
-        maxWidth = AttrMapValue(isNumberOrNone),
-        height = AttrMapValue(isNumberOrNone),
-        textAnchor = AttrMapValue(isTextAnchor),
+        x = AttrMapValue(isNumber,desc=''),
+        y = AttrMapValue(isNumber,desc=''),
+        dx = AttrMapValue(isNumber,desc='width of label'),
+        dy = AttrMapValue(isNumber,desc='height of label'),
+        angle = AttrMapValue(isNumber,desc='angle of label: default (0), 90 is vertical, 180 is upside down, etc'),
+        boxAnchor = AttrMapValue(isBoxAnchor,desc='anchoring point of the label'),
+        boxStrokeColor = AttrMapValue(isColorOrNone,desc='border color of the box'),
+        boxStrokeWidth = AttrMapValue(isNumber,desc='border width'),
+        boxFillColor = AttrMapValue(isColorOrNone,desc='the filling color of the box'),
+        boxTarget = AttrMapValue(OneOf('normal','anti','lo','hi'),desc="one of ('normal','anti','lo','hi')"),
+        fillColor = AttrMapValue(isColorOrNone,desc='label text color'),
+        strokeColor = AttrMapValue(isColorOrNone,desc='label text border color'),
+        strokeWidth = AttrMapValue(isNumber,desc='label text border width'),
+        text = AttrMapValue(isString,desc='the actual text to display'),
+        fontName = AttrMapValue(isString,desc='the name of the font used'),
+        fontSize = AttrMapValue(isNumber,desc='the size of the font'),
+        leading = AttrMapValue(isNumberOrNone,desc=''),
+        width = AttrMapValue(isNumberOrNone,desc='the width of the label'),
+        maxWidth = AttrMapValue(isNumberOrNone,desc='maximum width the label can grow to'),
+        height = AttrMapValue(isNumberOrNone,desc='the height of the text'),
+        textAnchor = AttrMapValue(isTextAnchor,desc='the anchoring point of the text inside the label'),
         visible = AttrMapValue(isBoolean,desc="True if the label is to be drawn"),
-        topPadding = AttrMapValue(isNumber,'padding at top of box'),
-        leftPadding = AttrMapValue(isNumber,'padding at left of box'),
-        rightPadding = AttrMapValue(isNumber,'padding at right of box'),
-        bottomPadding = AttrMapValue(isNumber,'padding at bottom of box'),
+        topPadding = AttrMapValue(isNumber,desc='padding at top of box'),
+        leftPadding = AttrMapValue(isNumber,desc='padding at left of box'),
+        rightPadding = AttrMapValue(isNumber,desc='padding at right of box'),
+        bottomPadding = AttrMapValue(isNumber,desc='padding at bottom of box'),
         )
 
     def __init__(self,**kw):
@@ -292,25 +292,25 @@
 
 class LabelDecorator:
     _attrMap = AttrMap(
-        x = AttrMapValue(isNumberOrNone),
-        y = AttrMapValue(isNumberOrNone),
-        dx = AttrMapValue(isNumberOrNone),
-        dy = AttrMapValue(isNumberOrNone),
-        angle = AttrMapValue(isNumberOrNone),
-        boxAnchor = AttrMapValue(isBoxAnchor),
-        boxStrokeColor = AttrMapValue(isColorOrNone),
-        boxStrokeWidth = AttrMapValue(isNumberOrNone),
-        boxFillColor = AttrMapValue(isColorOrNone),
-        fillColor = AttrMapValue(isColorOrNone),
-        strokeColor = AttrMapValue(isColorOrNone),
-        strokeWidth = AttrMapValue(isNumberOrNone),
-        fontName = AttrMapValue(isNoneOrString),
-        fontSize = AttrMapValue(isNumberOrNone),
-        leading = AttrMapValue(isNumberOrNone),
-        width = AttrMapValue(isNumberOrNone),
-        maxWidth = AttrMapValue(isNumberOrNone),
-        height = AttrMapValue(isNumberOrNone),
-        textAnchor = AttrMapValue(isTextAnchor),
+        x = AttrMapValue(isNumberOrNone,desc=''),
+        y = AttrMapValue(isNumberOrNone,desc=''),
+        dx = AttrMapValue(isNumberOrNone,desc=''),
+        dy = AttrMapValue(isNumberOrNone,desc=''),
+        angle = AttrMapValue(isNumberOrNone,desc=''),
+        boxAnchor = AttrMapValue(isBoxAnchor,desc=''),
+        boxStrokeColor = AttrMapValue(isColorOrNone,desc=''),
+        boxStrokeWidth = AttrMapValue(isNumberOrNone,desc=''),
+        boxFillColor = AttrMapValue(isColorOrNone,desc=''),
+        fillColor = AttrMapValue(isColorOrNone,desc=''),
+        strokeColor = AttrMapValue(isColorOrNone,desc=''),
+        strokeWidth = AttrMapValue(isNumberOrNone),desc='',
+        fontName = AttrMapValue(isNoneOrString,desc=''),
+        fontSize = AttrMapValue(isNumberOrNone,desc=''),
+        leading = AttrMapValue(isNumberOrNone,desc=''),
+        width = AttrMapValue(isNumberOrNone,desc=''),
+        maxWidth = AttrMapValue(isNumberOrNone,desc=''),
+        height = AttrMapValue(isNumberOrNone,desc=''),
+        textAnchor = AttrMapValue(isTextAnchor,desc=''),
         visible = AttrMapValue(isBoolean,desc="True if the label is to be drawn"),
         )
 
--- a/src/reportlab/graphics/widgetbase.py	Thu Nov 26 17:00:13 2009 +0000
+++ b/src/reportlab/graphics/widgetbase.py	Fri Nov 27 16:35:29 2009 +0000
@@ -311,14 +311,14 @@
     """
 
     _attrMap = AttrMap(
-        strokeWidth = AttrMapValue(isNumber),
-        strokeLineCap = AttrMapValue(isNumber),
-        strokeLineJoin = AttrMapValue(isNumber),
-        strokeMiterLimit = AttrMapValue(None),
-        strokeDashArray = AttrMapValue(isListOfNumbersOrNone),
-        strokeOpacity = AttrMapValue(isNumber),
-        strokeColor = AttrMapValue(isColorOrNone),
-        fillColor = AttrMapValue(isColorOrNone),
+        strokeWidth = AttrMapValue(isNumber,desc='width of the stroke line'),
+        strokeLineCap = AttrMapValue(isNumber,desc='Line cap 0=butt, 1=round & 2=square',advancedUsage=1),
+        strokeLineJoin = AttrMapValue(isNumber,desc='Line join 0=miter, 1=round & 2=bevel',advancedUsage=1),
+        strokeMiterLimit = AttrMapValue(None,desc='miter limit control miter line joins',advancedUsage=1),
+        strokeDashArray = AttrMapValue(isListOfNumbersOrNone,desc='dashing patterns e.g. (1,3)'),
+        strokeOpacity = AttrMapValue(isNumber,desc='level of transparency (alpha) accepts values between 0..1',advancedUsage=1),
+        strokeColor = AttrMapValue(isColorOrNone,desc='the color of the stroke'),
+        fillColor = AttrMapValue(isColorOrNone,desc='the filling color'),
         desc = AttrMapValue(isString),
         )