Number: 1232

Date: 24-May-84 16':09':27

Submitter: Sannella.PA

Source: Feuerman.pasa

Subject: Inprove documentation of macros in Interlisp

Assigned To: 

Attn: Documentation

Status: Open

In/By: 

Problem Type: Documentation

Impact: Moderate

Difficulty: Moderate

Frequency: Everytime

Priority: Hopefully

System: Language Support

Subsystem: Compiler, Code Format

Machine: 

Disk: 

Lisp Version: 

Source Files: 

Microcode Version: 

Memory Size: 

File Server: 

Server Software Version: 

Disposition: 

Description: '
Date': 21 May 84 17':24 PDT'
From': Feuerman.pasa'
Subject': Re': File Package-Compiler Problem'
In-reply-to': LispSupport.pa''s message of 21 May 84 16':33':57 PDT (Monday)'
To': LispSupport.pa'
cc': Feuerman.pasa'
'
I think I''ll agree with you about not wanting to fix the situation (notice I''m not calling it a bug).  It would be a good idea to document in the MACRO section.'
'
By the way, I wish that the documentation in that MACRO section could be better.  It''s not entirely obvious to me exactly what the difference is between the several implementations of MACROS.  The different ways are'
	LAMBDA or NLAMBDA'
	NIL expression or list expression'
	OPENLAMBDA'
	etc.'
What does each do?  How about more examples of each, and not just of odd cases (I''m referring to the example at the top of page 5.19, that uses recursion).'
'
Just some suggestions.'
'
--Ken.'
'
-----'
'
Date': 21 MAY 84 23':39 PDT'
From': MASINTER.PA'
Subject': suggestions for MACRO documentation'
To':   feuerman.pasa'
cc':   lispsupport'
'
Thanks, Ken. I think your suggestions are reasonable. I''ve revised macro handling a little and I think that we should definitely rewrite the macro chapter -- most other Lisp dialects really ''play up'' macros.'


Workaround: 

Test Case: 

Edit-By: masinter

Edit-Date: 13-Jul-84 16':12':53