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

Piergiorgio Sartor <[email protected]> Wed, 27 Aug 2025 22:21:08 +0200
Newsgroups comp.lang.python
Organization A noiseless patient Spider
Message-ID <[email protected]>
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