[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
Re: CL function's docstrings
From: |
Richard Stallman |
Subject: |
Re: CL function's docstrings |
Date: |
Wed, 18 May 2005 01:20:42 -0400 |
2) Change the argument names to match the docstrings.
Pros: it is the cleaner way.
Cons: lot of change in the cl* files; less coherence between argument
names
among functions.
3) Change the docstrings to match the argument names.
Pro: easy.
Cons: names are often much less descriptive than the ones already
existing.
For each function, it is possible to change the argument names,
the doc string, or both.
How about if you do whatever is best so as to use the best possible names
in each function?