Re: Documentation for car and cdr

[Mario Domenech Goulart]

On Wed, 25 Jan 2006 23:51:38 +0100 address@hidden (Kim F. Storm) wrote:

> Luc Teirlinck <address@hidden> writes:
>
>> Describing basic concepts like car, cdr, cons cell, list and so on is
>> the task of manuals, not of docstrings.  If somebody is not familiar
>> with the basic concepts, they have to read a manual, where those
>> concepts can be put into the proper context, _not_ individual docstrings.
>
> I fully agree, but notice that the doc strings for car and cdr 
> say that the arg is "list".  I think that part of the confusion
> is that a "pure" list does have a head and a tail and car==head
> and cdr==tail.

Thanks for focusing this point, Kim.  I think it's certainly part of the
confusion (specially if you are used to Scheme...).


> It might better to change the arg from "list" to "cons"

I agree.


Best wishes,
Mario