RE: [Nasm-devel] one more outbin.c ... and counting ...

[Michael K T. L. <mi...@ne...>]

> Take a look at what I said in the doc about it, if you get a chance.
> Probably needs more to be clear, but see if I got it right as far as I
> got.

Looks good so far.  A couple things worth pointing out, but may or may
not need mentioning in the documentation:

\b Arguments to \c{org}, \c{start}, and \c{vstart} are critical 
expressions. See \k{crit}.

I think we need an example here, so people know to use parenthesis for
expressions (e.g., 'align=(1 << 4)').  Whoops, just realized you don't
have align in there.  Align does take an expression so we should list
that one too.

If a \c{.text} section is not given an \c{ORG} statement, it is
allocated \c{ORG 0} by default.

Org doesn't necessarily have anything to do with .text.  If it makes the
doc easier, then I don't see too much harm describing it the way you
have it.  Just a thought...

\b The \c{.bss} section will be placed after all other sections, 
unless \c{start=}, \c{vstart=}, \c{follows=}, or \c{vfollows=} 
has been specified.

The current behavior is that the .bss section defaults to follow the
last progbits section.  Unless we're planning on changing this behavior,
we should probably be specific about it in the docs.  Just replace
'after all other sections' with 'after the last progbits section'.

\b All sections are aligned on dword boundaries, unless a higher level
of alignment has been specified.

Alignment values of 1 and 2 are allowed as well.  An alignment of 1 is
really the same as no alignment.  This should probably read 'unless a
different alignment has been specified'.

One other thing: we may need to mention the section.<secname>.start
label at some point.  This could probably wait though.
 
> I went ahead and made some changes to insns.dat, too. Hope I got it
right!

Not afraid of CVS anymore, Frank?  :P

> Mike and Trevor - what e-mail addresses (if any) do you want in the
> AUTHORS file?

Use mterlo1 at uic dot edu, in some bot unfriendly form please.

Mike