Subplot attributes documentation: px is invalid margin type

[glwagner]

The docs for subplot attributes suggests Measures.px as a type for the kwargs *_margin, eg:

Attribute	Aliases	Default	Type	Description
margin		1.0mm	Measure (multiply by mm, px, etc)	Base for individual margins... not directly used. Specifies the extra padding around subplots.

but

julia> using Measures: px
ERROR: UndefVarError: px not defined

My first thought was to submit a simple PR, but I wasn't able to find where this was written immediately since this part of docs are generated (and I hope I'm not misreading the docs!)

[BeastyBlacksmith]

did you try Plots.px?

[glwagner]

Hm. I don't know why this issue was resolved since the docs are still confusing to me. To clarify the situation, there are "measures" that are defined in Plots rather than Measures:

julia> using Measures: px
ERROR:
UndefVarError: px not defined

julia> using Plots: px

julia> px
0.254mm

Some are defined in both:

julia> using Plots: mm

julia> mm
1.0mm

julia> using Measures: mm

julia> mm
1.0mm

mm is part of both Measures and Plots, but px only part of Plots. Note that px is not exported:

julia> using Plots

julia> px
ERROR: UndefVarError: px not defined

so users need to know to obtain px from Plots. Perhaps all "measures" are defined in Plots.jl?

[t-bltg]

Well, yes pct and px are defined in Plots only, see here and currently not exposed to the user.

Linked:

• Allow relative positioning of annotations Plots.jl#3634 (comment)
• Discussing pct Plots.jl#3635

[glwagner]

If all relevant Measures for plotting are exported by Plots.jl, then a comment can be included at the top of docs for subplot attributes --- something like "Measures can be obtained from Plots; for example using Plots: px." Or something even more useful.

[t-bltg]

If it were just me, I'd integrate px and pct in either Measures.jl or Unitful.jl.