"cached" member of Text class appearing in docs

While looking up some information, I came across this hideousness:

http://matplotlib.org/api/artist_api.html?highlight=text#matplotlib.text.Text.cached

Why is this member made public? I would have thought it should be “private”?

Wow. It definitely should be private, or at the very least excluded from the docs, through whatever mechanism Sphinx gives us. I really hope no one is using that as a public API -- I think it's ok to just privatize this post haste without a deprecation period.

Mike

···

On 09/16/2013 12:39 PM, Benjamin Root wrote:

While looking up some information, I came across this hideousness:

http://matplotlib.org/api/artist_api.html?highlight=text#matplotlib.text.Text.cached

Why is this member made public? I would have thought it should be "private"?

------------------------------------------------------------------------------
LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99!
1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint
2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack includes
Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13.
http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk

_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

--
                    _

\/|o _|_ _. _ | | \.__ __|__|_|_ _ _ ._ _
>>(_| |(_|(/_| |_/|(_)(/_|_ |_|_)(_)(_)| | |

http://www.droettboom.com

I don't know if this is related but
http://matplotlib.org/api/artist_api.html?highlight=drawstyle#matplotlib.lines.Line2D.lineStyles

seems a similar kind of problem

Thanks
Federico

···

On Mon, Sep 16, 2013 at 2:14 PM, Michael Droettboom <mdroe@...31...> wrote:

Wow. It definitely should be private, or at the very least excluded from
the docs, through whatever mechanism Sphinx gives us. I really hope no one
is using that as a public API -- I think it's ok to just privatize this post
haste without a deprecation period.

Mike

On 09/16/2013 12:39 PM, Benjamin Root wrote:

While looking up some information, I came across this hideousness:

http://matplotlib.org/api/artist_api.html?highlight=text#matplotlib.text.Text.cached

Why is this member made public? I would have thought it should be "private"?

------------------------------------------------------------------------------
LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99!
1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint
2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack
includes
Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13.
http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk

_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

--
                   _
>\/|o _|_ _. _ | | \.__ __|__|_|_ _ _ ._ _
> >>(_| |(_|(/_| |_/|(_)(/_|_ |_|_)(_)(_)| | |

http://www.droettboom.com

------------------------------------------------------------------------------
LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99!
1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint
2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack
includes
Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13.
http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

--
Y yo que culpa tengo de que ellas se crean todo lo que yo les digo?

-- Antonio Alducin --

Thanks for pointing that out. I think that's one is a little more debatable -- it does have some use to document.

Mike

···

On 09/23/2013 08:11 PM, Federico Ariza wrote:

I don't know if this is related but
http://matplotlib.org/api/artist_api.html?highlight=drawstyle#matplotlib.lines.Line2D.lineStyles

seems a similar kind of problem

Thanks
Federico

On Mon, Sep 16, 2013 at 2:14 PM, Michael Droettboom <mdroe@...31...> wrote:

Wow. It definitely should be private, or at the very least excluded from
the docs, through whatever mechanism Sphinx gives us. I really hope no one
is using that as a public API -- I think it's ok to just privatize this post
haste without a deprecation period.

Mike

On 09/16/2013 12:39 PM, Benjamin Root wrote:

While looking up some information, I came across this hideousness:

http://matplotlib.org/api/artist_api.html?highlight=text#matplotlib.text.Text.cached

Why is this member made public? I would have thought it should be "private"?

------------------------------------------------------------------------------
LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99!
1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint
2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack
includes
Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13.
http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk

_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

--
                    _
>\/|o _|_ _. _ | | \.__ __|__|_|_ _ _ ._ _
> >>(_| |(_|(/_| |_/|(_)(/_|_ |_|_)(_)(_)| | |

http://www.droettboom.com

------------------------------------------------------------------------------
LIMITED TIME SALE - Full Year of Microsoft Training For Just $49.99!
1,500+ hours of tutorials including VisualStudio 2012, Windows 8, SharePoint
2013, SQL 2012, MVC 4, more. BEST VALUE: New Multi-Library Power Pack
includes
Mobile, Cloud, Java, and UX Design. Lowest price ever! Ends 9/20/13.
http://pubads.g.doubleclick.net/gampad/clk?id=58041151&iu=/4140/ostg.clktrk
_______________________________________________
Matplotlib-devel mailing list
Matplotlib-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/matplotlib-devel

--
                    _

\/|o _|_ _. _ | | \.__ __|__|_|_ _ _ ._ _
>>(_| |(_|(/_| |_/|(_)(/_|_ |_|_)(_)(_)| | |

http://www.droettboom.com