Thank you for your reasoned and accurate reply, Jason. I want to again make clear that I'm not trying to attack either you or your very useful product. I find the Flirc to be a wonderful device that fills an absolute need in a lot of hardware situations where other devices are lacking. In no way do I believe you or your product is a total failure. Quite to the contrary, you've clearly designed a solid piece of kit that has great software that backs it up... if only it was documented. The fact that someone must rely on tooltips for even basic documentation and that even short (but useful) help for flirc_util commands must be found directly through flirc_util is the only issue I'm expressing. I've documented software and written manuals most of my career and I can't imagine that writing a twenty page manual would take more than a weekend. Documentation has a lifecycle that doesn't need to produce perfection at the start... it continues to improve throughout the life of a product in my experience.
I have indeed read through all of the articles you have on your troubleshooting page and find them well written and focused. I believe you've done very well with that online resource and it is a required and valuable one for any hardware or software product. I have also found some great information and clearly dedicated support that both you and some passionate users provide on this forum, again a resource that is implemented well and is, I believe, another of those required and valuable tools needed for any hardware or software product.
I've had no issue personally figuring out and using record_api as well as a few other of those useful commandline functions once I've dug in a bit. But I'm not the average user. This product absolutely needs a beginner and intermediate user's basic pdf manual that is easily downloaded right next to the software. One that steps a neophyte user (that this piece of hardware is mostly focused at) through the concepts of the product, not just its implementation (but that as well, of course). One that duplicates the help provided in the commandline utility in addition to basic usage guidelines. Somewhere for someone I recommend this hardware to begin at the first day it arrives in the mail.
I very much look forward to recommending the Flirc once again once that documentation lifecycle has begun. I'll certainly not be steering people *away* from the Flirc, but will focus my active recommendations only on the more advanced users I run across from now on, those who won't be frustrated with some digging as it stands. In the meantime, I'll very much be enjoying the use of the device in my own home.
Thanks again, Jason. Have a wonderful weekend.