Re: [LAU] qjackctl (documentation)

From: <hollunder@email-addr-hidden>
Date: Thu Apr 17 2008 - 23:09:36 EEST

On Thu, 17 Apr 2008 20:25:15 +0800
"Ray Rashif" <schivmeister@email-addr-hidden> 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@email-addr-hidden
http://lists.linuxaudio.org/mailman/listinfo/linux-audio-user
Received on Fri Apr 18 00:15:06 2008

This archive was generated by hypermail 2.1.8 : Fri Apr 18 2008 - 00:15:06 EEST