Lee:

This is a really good point. One where we can agree completely. We are so long between major releases, but constantly doing interim releases, that we probably should update the documentation as we go along with the code as it is developed.

The only reason 1.6.0 is not out today is we have spent two weeks derailed on other things and jhave not been able to finish the documentation. The official download document from Flex is ALWAYS for the last official release and thusyour problem.

As such, I added a documentation directory to the svn stuff. Again, this will not be its final resting place but I feel that if Flex is going to tout the latest and greatest, the documentation should try to keep up. Now that open office and word can both write the document, I see no reason not to use doc format.

I would make a further suggestion to Flex. That we break the document into sections. It is a trivial matter to print from page X to Y using CutePDF. This will involve work and I do not wish to delay 1.6.0's release with this so I would expect the documentation to be upgraded to this slowly while the monolithic version comes out. This would require changing the pagination to be section based such a I-1, I-2 and then II-1,2, etc. But this would mean you could change an entire section of the manual and it would not impact any of the other sections. As you can see, this implies effort that we cannot allow to stop release of 1.6.0.
Your points are very well taken.

Bob



Lee A Crocker wrote:
I went to look at the website where perf resides, and
this is the authors blurb regarding that applet:

perf (download source) (download executable) This is a simple Win32 utility I use to figure out
whether a machine has support for the high-resolution
performance counters necessary for microsecond-level
timers in user land. It just calls the
QueryPerformanceFrequency() Win32 API and throws up a
dialog with yay/nay and some statistics

So I think when perf reports "High resolution counters
supported" that is the main bit of information.

As to the manual I am reading the .pdf file I
downloaded from the flex website.  I have no idea how
old or up to date this is.  In fact it never occurred
to me this might be an obsolete manual.
I know this was discussed some months ago on the
reflector, before I made my SDR purchase, but since
the reflector's server (aka mailman) is not readily
searchable (although mailman can be made to have a
completely searchable automatically updating archeive
since all the reflectors over on contesting.com are
set up like this), that information is as good as
lost, and I haven't found the page in the manual where
it discusses K1EL keyers that use special PTT
techniques over serial ports.
No I do not have the archeive residing on a PC based
email client.  So any suggestions I just use the
search function in my email client is not a useful
suggestion.  I use a web based email client and read
the reflector from the flex server.




--
Robert W. McGwier, Ph.D.
Center for Communications Research
805 Bunn Drive
Princeton, NJ 08540
(609)-924-4600


Reply via email to