Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!ecngs!feeder2.ecngs.de!newsfeed.freenet.ag!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.000 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'beginner': 0.05; 'builtin': 0.07; 'python': 0.09; 'objects.': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'sep': 0.09; 'tab': 0.09; 'terry': 0.09; 'volunteer': 0.11; 'subject:python': 0.11; 'index': 0.13; '(there': 0.16; '193': 0.16; 'blindly': 0.16; 'entries.': 0.16; 'index.': 0.16; 'markup,': 0.16; 'occurences': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'reedy': 0.16; 'subject:search': 0.16; 'wrote:': 0.17; 'duplicate': 0.17; 'jan': 0.18; '>>>': 0.18; 'windows': 0.19; 'fairly': 0.21; 'this:': 0.23; 'header:In-Reply-To:1': 0.25; 'header:User-Agent:1': 0.26; 'common': 0.26; 'entries': 0.27; "doesn't": 0.28; 'header:X-Complaints-To:1': 0.28; 'searches': 0.29; 'function': 0.30; 'info': 0.32; 'print': 0.32; 'defining': 0.33; 'indexed': 0.33; 'text,': 0.33; 'to:addr:python-list': 0.33; 'version': 0.34; 'entered': 0.34; 'especially': 0.35; 'pm,': 0.35; 'there': 0.35; 'received:org': 0.36; 'rather': 0.37; 'subject:: ': 0.38; 'things': 0.38; 'page': 0.38; 'to:addr:python.org': 0.39; 'header:Received:5': 0.40; 'help': 0.40; 'containing': 0.61; 'more': 0.63; 'online': 0.70; 'intelligent': 0.71; 'friend': 0.81; 'algorithm,': 0.84; 'received:fios.verizon.net': 0.84; 'top.': 0.84; 'ranked': 0.97 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Terry Reedy Subject: Re: python docs search for 'print' Date: Tue, 04 Sep 2012 18:58:52 -0400 References: <50464153.5090402@gmail.com> Mime-Version: 1.0 Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit X-Gmane-NNTP-Posting-Host: pool-173-75-251-66.phlapa.fios.verizon.net User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:15.0) Gecko/20120824 Thunderbird/15.0 In-Reply-To: X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 28 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1346799556 news.xs4all.nl 6990 [2001:888:2000:d::a6]:37160 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:28432 On 9/4/2012 6:32 PM, Terry Reedy wrote: > >> On Tue, Sep 4, 2012 at 1:58 PM, David Hoese wrote: >>> A friend made me aware of this: >>> When a python beginner (2.x) quick searches for "print" on >>> docs.python.org, >>> the print function doesn't even come up in the top 20 results. > > In the Windows Help version of the docs, enter print in the index tab > and print builtin function is at the top. Same is true of the online > index. (There are only three 'print' entries. There is a duplicate for > the builtin and one for the fixer. Moral: look for things that would be > indexed in the index. Searching for a word in text, especially a common > one like print, brings in lots of junk. Search rather blindly searches pages for words. As an experiment, I entered 'print' on the search tab of the 3.3 Windows-version doc. It found 193 pages containing 'print'. The builtin functions page was ranked 75. It is a fairly long page with just 3 occurences of 'print'. To repeat, use the index to find defining entries for Python objects. If someone wants to volunteer to write a more intelligent search algorithm, that incorporates info from the index and markup, feel free. -- Terry Jan Reedy