Groups > comp.lang.python > #197544

Re: can you improve this text-only beginner copy program?

Path	csiph.com!eternal-september.org!feeder.eternal-september.org!.POSTED!not-for-mail
From	Piergiorgio Sartor <piergiorgio.sartor.this.should.not.be.used@nexgo.REMOVETHIS.de>
Newsgroups	comp.lang.python
Subject	Re: can you improve this text-only beginner copy program?
Date	Wed, 27 Aug 2025 22:21:08 +0200
Organization	A noiseless patient Spider
Lines	28
Message-ID	<ku54ol-j54.ln1@lazy.lzy> (permalink)
References	<87a53kdfpx.fsf@somewhere.edu> <copying-20250827160810@ram.dialup.fu-berlin.de> <87ms7kbt35.fsf@somewhere.edu>
MIME-Version	1.0
Content-Type	text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding	7bit
Injection-Date	Wed, 27 Aug 2025 20:25:31 +0000 (UTC)
Injection-Info	dont-email.me; posting-host="6f2a5403a40fdcbe184cee247dac92a9"; logging-data="969275"; mail-complaints-to="abuse@eternal-september.org"; posting-account="U2FsdGVkX18Lqs/eAgs/KToZxk/FnzVg"
User-Agent	Mozilla Thunderbird
Cancel-Lock	sha1:Ga7pWeI00UxYAdoREIsKJpFhy0A=
In-Reply-To	<87ms7kbt35.fsf@somewhere.edu>
Content-Language	it, en-GB
Xref	csiph.com comp.lang.python:197544

Show key headers only | View raw

On 27/08/2025 18.57, Ethan Carter wrote:
[...]
>>>   """Copies text file named S to text file named D."""
>>
>>    This is not entirely clear, since case is significant in Python
>>    ("S" is not the same as "s"), and it is ambiguous whether it refers
>>    to a file actually named "S" or to a file whose name is provided as
>>    a str object bound to the name "s" in the function's source code.
> 
> This is how docstrings are traditionally written in GNU EMACS ELISP
> code---they upcase argument names of the procedure being documented.  I
> can't recall who taught me this, but I believe it was Robert Chassel in
> his book ``An Introduction to Emacs Lisp'' that's included in the GNU
> EMACS itself.

That's because LISP has a difficult relationship
with case (sensitive / insensitive).

In any environment strictly case sensitive, it's
obviously not a good idea to change case at will.

So, don't use LISP docstrings style in Python...

bye,

-- 

piergiorgio

Back to comp.lang.python | Previous | Next — Previous in thread | Next in thread | Find similar

Thread

can you improve this text-only beginner copy program? Ethan Carter <ec1828@somewhere.edu> - 2025-08-27 11:03 -0300
  Re: can you improve this text-only beginner copy program? ram@zedat.fu-berlin.de (Stefan Ram) - 2025-08-27 15:12 +0000
    Re: can you improve this text-only beginner copy program? Ethan Carter <ec1828@somewhere.edu> - 2025-08-27 13:57 -0300
      Re: can you improve this text-only beginner copy program? ram@zedat.fu-berlin.de (Stefan Ram) - 2025-08-27 17:45 +0000
      Re: can you improve this text-only beginner copy program? Piergiorgio Sartor <piergiorgio.sartor.this.should.not.be.used@nexgo.REMOVETHIS.de> - 2025-08-27 22:21 +0200
      Re: can you improve this text-only beginner copy program? Mark Bourne <nntp.mbourne@spamgourmet.com> - 2025-08-28 21:05 +0100
        Re: can you improve this text-only beginner copy program? (Posting On Python-List Prohibited) Lawrence D’Oliveiro <ldo@nz.invalid> - 2025-08-28 22:17 +0000
  Re: can you improve this text-only beginner copy program? ram@zedat.fu-berlin.de (Stefan Ram) - 2025-08-27 21:09 +0000
    Re: can you improve this text-only beginner copy program? Mark Bourne <nntp.mbourne@spamgourmet.com> - 2025-08-28 21:15 +0100
      Re: can you improve this text-only beginner copy program? ram@zedat.fu-berlin.de (Stefan Ram) - 2025-08-28 20:50 +0000
  Re: can you improve this text-only beginner copy program? (Posting On Python-List Prohibited) Lawrence D’Oliveiro <ldo@nz.invalid> - 2025-08-28 01:36 +0000

csiph-web