public inbox for cgen@sourceware.org
 help / color / mirror / Atom feed
* machine generated documentation for cgen ports
@ 2003-06-11  7:48 Doug Evans
  2003-06-11 12:34 ` Ben Elliston
  0 siblings, 1 reply; 6+ messages in thread
From: Doug Evans @ 2003-06-11  7:48 UTC (permalink / raw)
  To: binutils, cgen

There's still a TON of work to be done before the documentation
is usable to more than just the maintainers of the port,
and what's there now may only be of MARGINAL use to port maintainers.
If one doesn't have access to a real reference manual and one wants to look
at the layout of a particular instruction, what's there now is potentially
useful.  One obviously has to keep in mind that what's there isn't
authoritative.

Anyways I'm at a needed stopping point, so fyi ...

If you check the bottom of the cgen home page http://sources.redhat.com/cgen/
you'll see links to documentation generated from the cpu files.

Feedback is certainly welcome.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: machine generated documentation for cgen ports
  2003-06-11  7:48 machine generated documentation for cgen ports Doug Evans
@ 2003-06-11 12:34 ` Ben Elliston
  2003-06-11 15:50   ` Doug Evans
  0 siblings, 1 reply; 6+ messages in thread
From: Ben Elliston @ 2003-06-11 12:34 UTC (permalink / raw)
  To: cgen

Doug Evans <dje@sebabeach.org> writes:

> Feedback is certainly welcome.

It looks good.  Of course, what I was expecting was a nice tabular
layout of bit patterns for instructions, but I'm sure you've thought
of that already.

Cheers, Ben

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: machine generated documentation for cgen ports
  2003-06-11 12:34 ` Ben Elliston
@ 2003-06-11 15:50   ` Doug Evans
  2003-06-11 20:53     ` Ben Elliston
  0 siblings, 1 reply; 6+ messages in thread
From: Doug Evans @ 2003-06-11 15:50 UTC (permalink / raw)
  To: Ben Elliston; +Cc: cgen

Ben Elliston writes:
 > Doug Evans <dje@sebabeach.org> writes:
 > 
 > > Feedback is certainly welcome.
 > 
 > It looks good.  Of course, what I was expecting was a nice tabular
 > layout of bit patterns for instructions, but I'm sure you've thought
 > of that already.

Can you be more specific?

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: machine generated documentation for cgen ports
  2003-06-11 15:50   ` Doug Evans
@ 2003-06-11 20:53     ` Ben Elliston
  2003-06-11 21:17       ` Doug Evans
  0 siblings, 1 reply; 6+ messages in thread
From: Ben Elliston @ 2003-06-11 20:53 UTC (permalink / raw)
  To: Doug Evans; +Cc: cgen

Doug Evans <dje@transmeta.com> writes:

>  > > Feedback is certainly welcome.

>  > It looks good.  Of course, what I was expecting was a nice tabular
>  > layout of bit patterns for instructions, but I'm sure you've thought
>  > of that already.

> Can you be more specific?

Well, for each instruction, draw a box, partition it by the defined
ifields and label them with their names and bit ranges.

Ben

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: machine generated documentation for cgen ports
  2003-06-11 20:53     ` Ben Elliston
@ 2003-06-11 21:17       ` Doug Evans
  2003-06-13  1:17         ` Ben Elliston
  0 siblings, 1 reply; 6+ messages in thread
From: Doug Evans @ 2003-06-11 21:17 UTC (permalink / raw)
  To: Ben Elliston; +Cc: cgen

Ben Elliston writes:
 > Doug Evans <dje@transmeta.com> writes:
 > >  > It looks good.  Of course, what I was expecting was a nice tabular
 > >  > layout of bit patterns for instructions, but I'm sure you've thought
 > >  > of that already.
 > 
 > > Can you be more specific?
 > 
 > Well, for each instruction, draw a box, partition it by the defined
 > ifields and label them with their names and bit ranges.

That's what's done now.  I'm only using html tables so
perhaps the result can be prettier.

Are you seeing something different?

btw, I think either the bottom row should print numbers in binary
or perhaps even better would be to print another row with the constant
values in binary.

^ permalink raw reply	[flat|nested] 6+ messages in thread

* Re: machine generated documentation for cgen ports
  2003-06-11 21:17       ` Doug Evans
@ 2003-06-13  1:17         ` Ben Elliston
  0 siblings, 0 replies; 6+ messages in thread
From: Ben Elliston @ 2003-06-13  1:17 UTC (permalink / raw)
  To: Doug Evans; +Cc: cgen

Doug Evans <dje@transmeta.com> writes:

> That's what's done now.  I'm only using html tables so perhaps the
> result can be prettier.

Ah -- sorry, I overlooked that.  It's not bad.

> btw, I think either the bottom row should print numbers in binary or
> perhaps even better would be to print another row with the constant
> values in binary.

Agreed.

Ben

^ permalink raw reply	[flat|nested] 6+ messages in thread

end of thread, other threads:[~2003-06-13  1:17 UTC | newest]

Thread overview: 6+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2003-06-11  7:48 machine generated documentation for cgen ports Doug Evans
2003-06-11 12:34 ` Ben Elliston
2003-06-11 15:50   ` Doug Evans
2003-06-11 20:53     ` Ben Elliston
2003-06-11 21:17       ` Doug Evans
2003-06-13  1:17         ` Ben Elliston

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).