Path: utzoo!utgpu!news-server.csri.toronto.edu!rutgers!cs.utexas.edu!swrinde!zaphod.mps.ohio-state.edu!think.com!news!mjab From: mjab@nanna.think.com (Michael J. A. Berry) Newsgroups: comp.lang.apl Subject: Re: Coding Standards Message-ID: Date: 6 Sep 90 18:28:08 GMT References: <8703@latcs1.oz.au> Sender: news@Think.COM Organization: Thinking Machines Corporation, Cambridge MA, USA Lines: 35 In-Reply-To: burns@latcs1.oz.au's message of 5 Sep 90 01:26:37 GMT In article <8703@latcs1.oz.au> burns@latcs1.oz.au (Jonathan Burns) writes: I've been hacking out little graphics demonstrations, but now I want to build a library of functions and constants. To keep track of existing functions, I fill out a form: ........................................................................... Calling form: Same as the header line, i.e. what's after the del when editing. Arguments: Name: Type: any Rank: any Shape: any . . . In other words, I don't think the documentation appropriate to most other languages is appropriate to apl. More useful documentation is "what is this function for" (N.B. not "how does it do it, the APL says that ...). -Michael -- ============================================= Michael J. A. Berry Internet: mjab@think.com uucp: {harvard, uunet}!think!mjab telephone: (617) 876-1111 =============================================