Great, that is exactly what I mean. Thanks for looking into this On Mon, Dec 12, 2011 at 2:51 PM, Jeff Forcier <[email protected]> wrote: > On Mon, Dec 12, 2011 at 7:00 AM, Jorge Vargas <[email protected]> wrote: > >> However >> since you do that while looking at the docs you will need to figure >> out in which package the actual function is. Which basically means >> clicking every link in >> http://fabric.readthedocs.org/en/1.3.3/index.html#core-api and >> scouting for hte function you actually need, specially if you are >> new/don't remember well the exact name of each function. > > OK, I see what you mean. I agree it's a problem and it's actually > bugged me for a while. I just updated ticket #104 to explicitly > reference this problem (namely, the toctree on the docs index page > should really be updated with full or partial lists of the functions > within -- as-is it's a crapshoot like you mentioned.) > > https://github.com/fabric/fabric/issues/104 > > Until that is solved, note that you *can* always use the Sphinx built > in module search -- it's there for this reason, if far from perfect > (esp. for simply-named functions that are also English words.) > > There's also the builtin index (linked in top right of most pages): > > http://docs.fabfile.org/en/1.3.3/genindex.html > > Thanks, > Jeff > > >> On Sun, Nov 27, 2011 at 4:49 PM, Jeff Forcier <[email protected]> wrote: >>>> I was wondering if this was left out on purpose. >>> >>> Pretty much -- it would be duplicative. Anything listed under "Core >>> API docs" on the main page, is in fabric.api. So "from fabric.api >>> import *" gets you all the decorators, context managers, operations >>> etc (in one flat namespace.) >>> >>> If you can elaborate on your use case re: looking things up and why >>> it's not working for you, we're always open to docs improvements. >>> >>> Thanks, >>> Jeff >>> >>> -- >>> Jeff Forcier >>> Unix sysadmin; Python/Ruby engineer >>> http://bitprophet.org > > > > -- > Jeff Forcier > Unix sysadmin; Python/Ruby engineer > http://bitprophet.org
_______________________________________________ Fab-user mailing list [email protected] https://lists.nongnu.org/mailman/listinfo/fab-user
