On Thu, 17 Apr 2008 20:25:15 +0800 "Ray Rashif" <schivmeister@xxxxxxxxx> wrote: > Posted the following in your other mail: > > http://w3.linux-magazine.com/issue/67/JACK_Audio_Server.pdf > > Let's take a look at what QJackCtl is, before we talk about its > documentation. Someone else in another related-mail mentioned that > the need for documentation isn't that much significant since the > application - or rather utility - is a rather straightforward one. It > is afterall, a front-end to the JACK server. It lets you manage > connections, execute commands/scripts alongside, set server options > with a GUI, and err..that's about it. Your best friend indeed, but > one whom you can understand easily, given the right attitude. > > Start == Self-explanatory > Stop == " " > Messages == " " (jack-specific) > Status == " " > Connect == " " > Patchbay == " " (you could find out what it does by just checking it > out; experimenting) > Quit == You really need an explanation? > Setup == " " > > Ok so we now take a look at Setup. Sure, things need to be explained > here. That's just what the above JACK document in PDF format does. > Other things which aren't brought into detail are fairly common > knowledge, or sense. Alright now try searching for this PDF file from > Google, that way we can gauge how difficult/easy it is to stumble > upon. True enough, there isn't anything else similar out there so we > can say "proper" documentation of the program is scarce. I really > like your stance on this issue and with more people like you this > particular lack of "professionalism" can definitely be nullified. Now > I'm inspired enough to do some writing too ;) > There could be other confusing elements, the user initially doesn't necessarily know that start refers to the server, not the transport, if he even knows that there is a transport, or a server that needs starting. It's all not hard once you know a few basics, but many new users appear to have trouble. To find working settings appears to be the most common one. I agree that having a nice qjackctl documentation would be a good thing, but where to display it? Where will it be found easily? _______________________________________________ Linux-audio-user mailing list Linux-audio-user@xxxxxxxxxxxxxxxxxxxx http://lists.linuxaudio.org/mailman/listinfo/linux-audio-user
