[Ktechlab-devel] Please document the pins on the D-type flip-flop and Adder

[Petter Reinholdtsen]

After having spend a few hours playing with ktechlab, a very nice
piece of software to play with, I have one serious complaint.  The
component help for some of the digital components are way to short.
For example, the pins on the D-Type Flip-Flow are not described.  I
spent a long time before I was able to understand how 'Set' and '>'
was supposed to be used.  Perhaps instead of 

  The output state is set from the input state
  when the clock is pulsed.

you can write something like

  The output state Q (and the inverse output state Q' is set from the
  input state D when the clock > is pulsed.  [I'm not sure when I need
  Rst and Set, so I leave that documentation to someone else. :)]

The Adder is the same way lacking accessible description.  Perhaps
something like this?

  1 bit adder. adding the value from A, B and the input carry (>) and
  outputting the result as two bits, bit 0 on S and bit 1 on C.

Are there plans to provide N-bit adders with a bus as input?

The RAM and Clock components on the other hand have very good
documentation.

I've been able to get my simple CPU "running", or to put it another
way, I've managed to get the program counter ticking and hooked it up
to the memory.  Next step is the ALU. :)

I just thought I should take a short break to ask for better
documentation.

I got a minor usability issue as well.  When I look for the component
I need, it would be convenient if the component help section on the
left of the screen was updated with the documentation for the
component I select in the list of available components on the right of
the screen.  As it is now, I have to draw the component to the drawing
board and select it there to see if it is the one I am looking for.
If this is implemented it would probably be a good idea to show the
pinout of the component to make it easier to see if it is the part one
is looking for.

Anyway, keep up the good work.  I'm not on the list, so please keep me
on CC.

Friendly,
-- 
Petter Reinholdtsen
Happy playing with ktechlab