Path: csiph.com!usenet.pasdenom.info!news.albasani.net!newsfeed.freenet.ag!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <pierre.quentel@gmail.com>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.001
X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'operator': 0.03; 'syntax': 0.03; 'subject:Python': 0.05; 'differently': 0.07; 'python': 0.09; 'integers': 0.09; 'tends': 0.09; 'to:addr:comp.lang.python': 0.09; 'underlying': 0.09; 'cc:addr:python-list': 0.10; "(it's": 0.16; 'for,': 0.16; 'notes"': 0.16; 'still,': 0.16; 'instance': 0.17; 'names.': 0.22; 'cc:2**0': 0.23; 'cc:no real name:2**0': 0.24; 'cc:addr:python.org': 0.25; 'header:In-Reply-To:1': 0.25; 'header :User-Agent:1': 0.26; 'received:209.85.212': 0.28; 'document,': 0.29; 'code': 0.31; 'cases,': 0.33; 'received:google.com': 0.34; 'received:209.85': 0.35; 'something': 0.35; 'explain': 0.36; 'but': 0.36; 'method': 0.36; 'uses': 0.37; '(for': 0.37; 'quite': 0.37; 'rather': 0.37; 'received:209': 0.37; 'subject:: ': 0.38; 'skip:" 10': 0.40; 'between': 0.63; 'different': 0.63; 'explanations': 0.65; 'harder': 0.65; 'strings)': 0.84; '"how': 0.91
Newsgroups: comp.lang.python
Date: Sat, 22 Dec 2012 00:54:08 -0800 (PST)
In-Reply-To: <mailman.1188.1356165094.29569.python-list@python.org>
Complaints-To: groups-abuse@google.com
Injection-Info: glegroupsg2000goo.googlegroups.com; posting-host=193.49.124.107; posting-account=cEyVOAoAAAAQ26Zg5AgQClqyybEKp-yz
References: <c0be76ec-d55b-4f6c-9892-a80b482ff5bb@googlegroups.com> <50D256B3.4070709@udel.edu> <mailman.1082.1355964916.29569.python-list@python.org> <96edb672-dabd-4ab8-9e7c-3fa7f4a91437@googlegroups.com> <mailman.1143.1356089120.29569.python-list@python.org> <c1663198-d1b0-4e7d-b8d8-e1b6d63b4f55@googlegroups.com> <mailman.1146.1356094682.29569.python-list@python.org> <44335f22-555a-4806-b24a-7d4cb1d8e529@googlegroups.com> <mailman.1154.1356104892.29569.python-list@python.org> <4ddee631-b5b5-4cb4-82b0-00ca403b773e@googlegroups.com> <CAPTjJmo-int9pT3iO+bGC9i4GgeeydHGD=Z94DtZKgiS9MhyWQ@mail.gmail.com> <CALwzidm0Q3wYESnMGQzBcdUhMXgwmnXFHgieJ_AhtWTECxO2Pg@mail.gmail.com> <CALwzidmh25wsKopUcpCGLy2fpZQeEq=NF2SWVv9=m3wvrgfMoQ@mail.gmail.com> <mailman.1179.1356134903.29569.python-list@python.org> <30bf668f-56e5-482f-b540-5cfa136348d1@googlegroups.com> <mailman.1188.1356165094.29569.python-list@python.org>
User-Agent: G2/1.0
X-Google-Web-Client: true
X-Google-IP: 193.49.124.107
MIME-Version: 1.0
Subject: Re: Brython - Python in the browser
From: Pierre Quentel <pierre.quentel@gmail.com>
To: comp.lang.python@googlegroups.com
Content-Type: text/plain; charset=ISO-8859-1
Cc: python-list@python.org
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Message-ID: <mailman.1189.1356166456.29569.python-list@python.org>
Lines: 8
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1356166456 news.xs4all.nl 6922 [2001:888:2000:d::a6]:59247
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:35346

> Still, it tends to be a lot harder to explain, document, and read
> documentation for, something that uses operators weirdly, rather than
> keyword-searchable method names.

You don't explain how to use the Python syntax (for instance the operator %, which behaves very differently between integers and strings) by explaining what happens in the underlying C code in the different cases, do you ?

I would put the above explanations in the "implementation notes" of Brython, but not on the "how to use Brython" documentation, which is quite simple to explain with <= and + (it's in the section "Handling of HTML documents" in the docs)