conventions for .texi files



Jay Belanger wrote:

> @macro var{bar}
> <\bar\>
> @end macro
> 
> would work, or perhaps 
> 
> @ifinfo
> @macro var{bar}
> <\bar\>
> @end macro
> @end ifinfo

OK, I misunderstood before. Thanks for the clarification.

Experimenting a little bit, I see that texinfo is happy to 
have @var nested in @defun and @code, so we can have stuff
like ``@defun save (@var{filename}, all)'' and
``@code{save (@var{filename}, all)''. That would be great!

Would we want to put @var on every user-definable argument?
It certainly makes sense when there are both user-definable and
keyword arguments for a function, as with ``save''. But maybe
it's too much when the arguments are simpler -- would we want
to see ``sin (<x>)'' ? I guess I'd rather see ``sin (<x>)'' 
than apply @var inconsistently. Comments?

regards,
Robert Dodier


		
__________________________________ 
Do you Yahoo!? 
Send holiday email and support a worthy cause. Do good. 
http://celebrity.mail.yahoo.com