Reading the documentation

[pnorman]

I was trying to read the documentation to double-check the properties to set a width and colour on a LineSymbolizer. I ran into a few problems

• The fact that the "line" item under symbolizers corresponds to a LineSymbolizer element isn't documented
• The property for width used to be stroke-width, not line-width. Has this changed?
• The property for color used to be stroke, not line-color. Has this changed?

[dch0ph]

mapnik-reference seems an awkward mix of documenting mapnik properties and how they are translated to CartoCSS, e.g.

    "line": {

       "stroke": {
           "css": "line-color",
           "default-value": "black",
          "type": "color",
           "expression":true,
           "default-meaning": "black and fully opaque (alpha = 1), same as rgb(0,0,0) or rgba(0,0,0,1).",
           "doc": "The color of a drawn line."
      },

As you say, it's not obvious that line is referring to LineSymbolizer.

The stroke property of LineSymbolizer corresponds to line-color in CartoCSS.

This makes mapnik-reference a confusing source of mapnik documentation, since the "properties" relate to CartoCSS not the underlying mapnik Symbolizers. (The fact that the mapnik property is stroke is hidden).