From cddaebdad589716bfd0c128a683174ab03300697 Mon Sep 17 00:00:00 2001 From: sletz Date: Wed, 8 Jul 2009 16:30:49 +0000 Subject: [PATCH] Correct documentation generation and readme files. git-svn-id: http://subversion.jackaudio.org/jack/jack2/trunk/jackmp@3585 0c269be4-1314-0410-8aa9-9f06e86f4224 --- README | 12 ------------ common/jack/jack.h | 6 +++--- doxyfile | 2 +- windows/Setup/src/README | 7 +------ 4 files changed, 5 insertions(+), 22 deletions(-) diff --git a/README b/README index f11e26f9..a15b3d66 100644 --- a/README +++ b/README @@ -137,8 +137,6 @@ The binary elements are : - JackRouter.dll : an ASIO/JACK driver that allows ASIO compatible applications to become JACK clients and access the JACK server. ASIO "jackified" applications appear with their names. Ableton Live, Samplitude, Reason, Arturia applications have been successfully tested. To install it, use "regsvr32 JackRouter.dll" in a terminal (use regsvr32 /u JackRouter.dll to uninstall). [VISTA special note: regsvr32 has to be used with "administrator" priviledges to properly register JackRouter.dll (Start Menu -> All Programs -> Accessories -> Right Click on Command Prompt -> Run As Administrator)]. A JackRouter.ini file is used by the driver to read parameters : an [IO] section allows to setup the number of input/output jack ports for the application and a [AUTO_CONNECT] section allows to setup jack ports autoconnection mode to machine input/output. -All dll are compiled in "release" mode. The "Debug" folder contains debug version of all dlls and libraries. MSVCRTD.dll and MSVCP60D.dll debug dll are also included. - WARNING !! WARNING !! Depending of the used interface and driver settings, the PortAudio layer may add additionnal buffering between the real card interrupt and the jack server callback. This usually result in *unregular* calls of the jack server callback (for example if jack server used a 256 frames buffer and the card used a 512 frames, the jack server callback will be called twice every card interrupt). For proper functionning of jack server and clients in this case, the jack server has to be started in "synchronous" mode, using the "-S" parameter. @@ -156,16 +154,6 @@ Automatic server launch Starting from the 0.64 version, automatic server launch from client is implemented : when the server is not yet running, and if the client uses the "jack_client_open" API, the server will be started automatically. The server configuration is saved in a ".jackdrc" file located in the user home folder. The Qjackctl tool allows to save its configuration in this . jackdrc (setting can be done in Qjackctl Setup/Misc). If no configuration file is found, a default setup will be used. WARNING : automatic server launch is not implemented on Windows - ----------------- -Loopback driver ----------------- - -An experimental loopback driver allows to manually "pipeline" applications connected in sequence, and thus parallelize sequential sub-graph. Lets say we have A ==> B graph, by using the loopback driver, it can be rewritten as : A ==> loopback driver ==> B. At each cycle, the loopback driver copy buffers received on its input ports (at the previous cycle) to its output ports. The resulting graph become parallel and thus can take profit of multi-processors machines, at each cycle A and B can be activated in parallel. Note that the loopback driver add a one buffer delay in the connection, which may be relevant in more complex graphs when having global synchronicity between clients is a desirable property. - -To activate loopback driver, use : - -- jackd (jackdmp) ... -L n ... where n is the number of input/output ports. ------------------ Validations tools diff --git a/common/jack/jack.h b/common/jack/jack.h index 2a31cbaf..1a904476 100644 --- a/common/jack/jack.h +++ b/common/jack/jack.h @@ -108,6 +108,7 @@ jack_client_t * jack_client_open (const char *client_name, * \bold THIS FUNCTION IS DEPRECATED AND SHOULD NOT BE USED IN * NEW JACK CLIENTS * +* @deprecated Please use jack_client_open(). */ jack_client_t * jack_client_new (const char *client_name); @@ -212,8 +213,7 @@ int jack_is_realtime (jack_client_t *client); * \bold THIS FUNCTION IS DEPRECATED AND SHOULD NOT BE USED IN * NEW JACK CLIENTS. * - * It should be replace by use of @ jack_cycle_wait and @ jack_cycle_signal functions. - * + * @deprecated Please use jack_cycle_wait() and jack_cycle_signal() functions. */ jack_nframes_t jack_thread_wait (jack_client_t*, int status); @@ -835,7 +835,7 @@ int jack_port_set_alias (jack_port_t *port, const char *alias); */ int jack_port_unset_alias (jack_port_t *port, const char *alias); -/* +/** * Get any aliases known for @port. * * @return the number of aliases discovered for the port diff --git a/doxyfile b/doxyfile index 84f79166..930b9eaf 100644 --- a/doxyfile +++ b/doxyfile @@ -304,7 +304,7 @@ WARN_LOGFILE = # directories like "/usr/src/myproject". Separate the files or directories # with spaces. -INPUT = common posix macosx macosx/coreaudio/ linux linux/alsa windows windows/portaudio common/jack/control.h +INPUT = common posix macosx macosx/coreaudio/ linux linux/alsa windows windows/portaudio common/jack/ # If the value of the INPUT tag contains directories, you can use the # FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp diff --git a/windows/Setup/src/README b/windows/Setup/src/README index 5ba3bc3a..2a474287 100644 --- a/windows/Setup/src/README +++ b/windows/Setup/src/README @@ -3,12 +3,7 @@ JACK on Windows ============================================= This installer will install everything to use Jack Audio Connection Kit (JACK) (www.jackaudio.org) on Windows. - -============================================= -Microsoft Runtime Libraries -============================================= - -In order to use this software, you will need the Microsoft Visual C++ 2008 redistributable package. This package is freely available on the Microsoft download center. Please be sure you install the correct version (2008). This package is required by portaudio to run windows specific audio drivers (MME, DSound and ASIO). + ============================================= QJACKCTL on Windows