Thread: [matplotlib-devel] "cached" member of Text class appearing in docs

Brought to you by: cjgohlke, dsdale, efiring, heeres, and 8 others

matplotlib-devel

[matplotlib-devel] "cached" member of Text class appearing in docs

From: Benjamin R. <ben...@ou...> - 2013-09-16 16:39:47

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"?

Re: [matplotlib-devel] "cached" member of Text class appearing in docs

From: Michael D. <md...@st...> - 2013-09-16 18:14:40

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
> Mat...@li...
> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel


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

http://www.droettboom.com

Re: [matplotlib-devel] "cached" member of Text class appearing in docs

From: Federico A. <ari...@gm...> - 2013-09-24 00:12:10

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 <md...@st...> 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
> Mat...@li...
> 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
> Mat...@li...
> 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 --

Re: [matplotlib-devel] "cached" member of Text class appearing in docs

From: Michael D. <md...@st...> - 2013-09-24 15:05:47

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 <md...@st...> 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
>> Mat...@li...
>> 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
>> Mat...@li...
>> https://lists.sourceforge.net/lists/listinfo/matplotlib-devel
>>
>
>


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

http://www.droettboom.com