OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

office-formula message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: Re: [office-formula] Parameter naming conventions

• From: Andreas J Guelzow <aguelzow@math.concordia.ab.ca>
• To: office-formula@lists.oasis-open.org
• Date: Mon, 04 Sep 2006 18:59:58 -0600

```On Mon, 2006-04-09 at 15:18 -0400, David A. Wheeler wrote:
> So far I have heard tremendous silence about naming conventions for
> function parameters.  Which makes sense, because they have absolutely
> no effect on the correctness of the spec.  But for the spec to have a "finished"
> look, we really should pick a single convention for us all to use. It helps readers
> slightly by having a single convention.  ANd the current pseudo-convention for
> Uppercase parameter names doesn't look as pretty in formulas.
>
> So, here' s what I propose by "fiat":
> * Types need to be in UpperCamelCase.
> * Parameter names need to be lowerCamelCase.
>    Try to use the same name between different functions for the same thing.
>    Where practical, make them
>    meaningful (indicating MEANING not type), e.g.,
>    "basis" for date calculation basis (where 0=360-day year), etc.
>    Use "x" for math functions taking one numerical parameter,
>    "x" and "y" for math functions taking two numerical parameters.
>
> Anyone have a crisis with this, please let us know.

I think we should not force all math functions to use x and y as there
variable names, but choose appropriate names:
COMBIN(x;y) looks strange it should probably be COMBIN(n;k) since the
arguments are integers. x;y looks like they are reals. Similarly the
second argument of BETADIST should probably be the greek letter alpha
rather than y.

Andreas

--
Andreas J. Guelzow
Pyrenean Shepherds
--
Prof. Dr. Andreas J. Guelzow
Dept. of Mathematical & Computing Sciences
Concordia University College of Alberta

```

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]