Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!1.eu.feeder.erje.net!bcyclone04.am1.xlned.com!bcyclone04.am1.xlned.com!newsfeed.xs4all.nl!newsfeed8.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.020 X-Spam-Evidence: '*H*': 0.96; '*S*': 0.00; 'creighton': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'python': 0.11; ':-)': 0.14; 'thu,': 0.15; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'laura': 0.18; 'arguments': 0.22; 'suppose': 0.22; '2015': 0.23; 'header:User-Agent:1': 0.26; 'question': 0.26; 'header:X-Complaints-To:1': 0.26; 'ahead.': 0.29; 'late': 0.34; 'to:addr:python-list': 0.35; 'being': 0.36; 'too': 0.36; 'subject:: ': 0.37; 'received:org': 0.38; 'to:addr:python.org': 0.39; 'introduction': 0.63; 'sharing': 0.64; 'hate': 0.66; 'hoping': 0.73; '+1000,': 0.84; '_o__)': 0.84; 'received:125': 0.84 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Ben Finney Subject: Re: Documenting a function signature Date: Fri, 19 Jun 2015 10:41:02 +1000 References: <557fdbd6$0$11097$c3e8da3@news.astraweb.com> <55818b3c$0$1665$c3e8da3$5496439d@news.astraweb.com> <55819878$0$1658$c3e8da3$5496439d@news.astraweb.com> <85egl9ubj5.fsf_-_@benfinney.id.au> <201506182138.t5ILcj8Q008705@fido.openend.se> Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Gmane-NNTP-Posting-Host: jigong.madmonks.org X-Public-Key-ID: 0xAC128405 X-Public-Key-Fingerprint: 517C F14B B2F3 98B0 CB35 4855 B8B2 4C06 AC12 8405 X-Public-Key-URL: http://www.benfinney.id.au/contact/bfinney-pubkey.asc X-Post-From: Ben Finney User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/24.4 (gnu/linux) Cancel-Lock: sha1:aF1CX8Le+fqPv2uannBg/XZ4GdU= X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.20+ 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: 21 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1434674481 news.xs4all.nl 2917 [2001:888:2000:d::a6]:53544 X-Complaints-To: abuse@xs4all.nl X-Received-Bytes: 3695 X-Received-Body-CRC: 4165063833 Xref: csiph.com comp.lang.python:92862 Laura Creighton writes: > In a message of Thu, 18 Jun 2015 10:04:46 +1000, Ben Finney writes: > >Since the introduction of keyword-only arguments in Python functions, > >the question arises of how to communicate this in documentation. > > I suppose it is way too late to scream "I hate keyword-only > arguments"! It's never too late for screams, go right ahead. If you're hoping those screams will result in the keyword-arguments not being part of Python now and in the future; yes, I think it's too late for that :-) -- \ “If sharing a thing in no way diminishes it, it is not rightly | `\ owned if it is not shared.” —Augustine of Hippo (354–430 CE) | _o__) | Ben Finney