Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.lang.python > #197544

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

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 2025-08-27 22:21 +0200
Organization A noiseless patient Spider
Message-ID <ku54ol-j54.ln1@lazy.lzy> (permalink)
References <87a53kdfpx.fsf@somewhere.edu> <copying-20250827160810@ram.dialup.fu-berlin.de> <87ms7kbt35.fsf@somewhere.edu>

Show all headers | 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 | NextPrevious 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