This is the mail archive of the guile@cygnus.com mailing list for the guile project.

Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]

Re: generating a manual from annotations in source code


    Mark> We are not describing how the implementation works.  We are
    Mark> describing the various APIs and how the programmer should
    Mark> use them.

    Karl>  But isn't that almost the same thing?  An understanding of
    Karl>  how it works internally can assist in designing good
    Karl>  programs around it.  [discussion about efficiency]

Dude, are you saying that a good program is designed with performance
in mind?

I strongly disagree with that opinion.  A good program design will
outlast a particular implementation of the interpreter and its speed
hangups.

There are performance issues discussed in any book on Scheme because
they are inherent in the language.  For example, you should know that
a list is best accessed at the head (with car), whereas a vector
allows random access in constant time, and thus you choose a vector
over a list for some tasks.