turnoff2 is missing an example

in the section Front Ends some lines about Cabbage can be added.

Don't work without special hardware?

• can they be made to work - even in non-realtime/offline.

WARNING: could not open library '/Users/rboulanger/Desktop/CCsoundQt-d-cs6.app/Contents/MacOS/../Frameworks/CsoundLib64.framework/Resources/Opcodes64/libwiimote.dylib' (-1)
STARTING FILE
Creating options
Creating orchestra
Creating score
rtmidi: virtual_keyboard module enabled
rtaudio: PortAudio module enabled ...
using blocking interface
error: syntax error, unexpected T_IDENT (token "asig") from file /Library/Frameworks/CsoundLib64.framework/Resources/Manual/examples/cudasliding.csd (1)
line 20:

asig <<<
Parsing failed due to invalid input!
Stopping on parser failure
cannot compile orchestra

i think the section Real-Time Audio, that starts here: http://csound.github.io/docs/manual/UsingRealTime.html
can be reorganized: under the heading "Using Csound" there is only talk about "Realtime I/O on Linux", while the next page shows "Windows Real-Time Audio". And even one page further there is talk about Realtime Audio for the Mac, but for a long time i read the words: Coming Soon... :)

Is it not better to change all this into a chapter "Realtime I/O", so Audio and Midi, and then talk about: On Linux, On Windows, On the Mac?
I do not have a Mac, i have no idea if something has to be said about Realtime I/O on a Mac.

Using Mac OSX 10.9 with macports version of [email protected]_0 and
[email protected]_0 (Makefile suggests using the 0.20 branch of fop rather
than 1.0), attempted to build pdf version of 6.02 manual, duplicate "ids"
cause errors like:

[ERROR]
file:/Downloads/sourceforge.net/csound/manual6/Csound6.02_manual.fo:81805:256
The id "IndexTurnoff" already exists in this document

It seems there are duplicate id's declared in the source for: FlagsDaemon,
IndexDaemon, FlagsMinusPort, IndexMinusPprt, FlagsMinusSched, IndexSchedule,
and IndexTurnoff. [IndexMinusPprt is correct but may be an unintentional mis-spelling]

Got the pdf to gen by renaming (both instances of) the second occurrence of
each in the .fo file. Not sure what I'm going to do with the 3,296 page pdf
but I have one now.

grep "bmscan" *.html reveals that there still about 20 references to the opcode bmscan.
Is it save to eliminate all these references?

Note that most examples in the manual that use samples are able to "locate" them from the manual example itself. In this case, one needs to set up paths, or environment variables, or copy the example .csd plus the needed hrtf.dat files to a folder or the desktop. It is working great, but requires more work than most examples to get it to work.

some parameters are missing

Since the 3 Loris opcodes are no longer part of the Csound tree (since 5.15), i think they can be moved to the Deprecated Orchestra Opcodes and GEN Routines section.

Also, the Loris Opcodes text in Spectral Processing should mention that they are no longer supported.
Perhaps the word Deprecated can be placed in manual/index.html behind Spectral Processing, Loris Opcodes ?

In the JackoInit opcode manual it says:

Syntax
JackoInit SclientName, ServerName

then

SclientName -- The name of the Jack client; normally, should be "csound".
ServerName -- The name of the Jack daemon; normally, will be "default".

But in the example:

instr 1

JackoInit "default", "csound"
JackoInfo

endin

Not sure if the error is in the csound example (switched parameters) or if this opcode is broken as well.

For

JackoInit "jackd", "csound"

I get

csound -b2048 -B4096 -+rtaudio=jack -odac -+jack_client=csnd-aeolus.csd --env:CSNOSTOP=yes /home/hlolli/Programs/csoundqt-0.9.0-src/bin/csnd-aeolus.csd
virtual_keyboard real time MIDI plugin for Csound
WARNING: STK opcodes not available: define environment variable RAWWAVE_PATH
(points to rawwaves directory) to use STK opcodes.
0dBFS level = 32768.0
Csound version 6.07 (double samples) Nov 26 2015
libsndfile-1.0.25
Reading options from $HOME/.csound6rc
UnifiedCSD: /home/hlolli/Programs/csoundqt-0.9.0-src/bin/csnd-aeolus.csd
STARTING FILE
Creating options
Creating orchestra
Creating score
rtaudio: JACK module enabled
rtmidi: ALSA Raw MIDI module enabled
WARNING: STK opcodes not available: define environment variable RAWWAVE_PATH
(points to rawwaves directory) to use STK opcodes.
instr jackin uses instrument number 2
Elapsed time at end of orchestra compile: real: 0.003s, CPU: 0.003s
sorting score ...
... done
Elapsed time at end of score sort: real: 0.003s, CPU: 0.003s
--Csound version 6.07 (double samples) Nov 26 2015
graphics suppressed, ascii substituted
0dBFS level = 1.0
Cannot connect to server socket err = No such file or directory
Cannot connect to server request channel
jack server is not running or cannot be started
Could not create Jack client "csound" -- is Jack server "jackd" running? Status: 17
inactive allocs returned to freespace
end of score. overall amps: 0.00000 0.00000
overall samples out of range: 0 0
0 errors in performance
Elapsed time at end of performance: real: 0.007s, CPU: 0.003s

Press return to continue

(obviously jack is running on my machine)

Would be great to have a manpage and .csd on this (and related) opcodes. Dr.B.

http://csound.github.io/docs/manual/SigioQueries.html is missing the filevalid opcode

perhaps some work can be done on this .csd to give it more of a "plate" sound. Dr.B.

In the experimental section all the information about the conditions of experimental opcodes should be given. This allows more people to participate in the experiment - knowing that these are really experimental and not (yet) part of the official edition of Csound.
How to install it, where to find dependent packages...
OR
(even better) create a link on /manual/html/ExperimentalTop.html to point to the Csound Wiki of github : https://github.com/csound/manual/wiki
where all experiments and gained knowledge can be shared

First candidates are: Cuda opcodes and Loris opcodes

it may be just me, but i had no idea what "signum" is.
Perhaps a link to Wikipedia can be added?
https://en.wikipedia.org/wiki/Sign_function

subinstrinit is missing example

sndload needs an example

Victor tells me that "due to licensing issues" these opcodes are not distributed with the binary builds of Csound. Perhaps it should be noted in the manual that one needs to build from sources to explore these opcodes - (and there might be others in the category too?) And. there need to be clear, step-by-step instructions in the manual for how to build from sources on each OS.

STARTING FILE
Creating options
Creating orchestra
Creating score
rtaudio: PortAudio module enabled ...
using blocking interface
Elapsed time at end of orchestra compile: real: 0.001s, CPU: 0.001s
sorting score ...
... done
Elapsed time at end of score sort: real: 0.001s, CPU: 0.001s
--Csound version 6.06 (double samples) Sep 29 2015
midi channel 1 using instr 1
midi channel 2 using instr 1
midi channel 3 using instr 1
midi channel 4 using instr 1
midi channel 5 using instr 1
midi channel 6 using instr 1
midi channel 7 using instr 1
midi channel 8 using instr 1
midi channel 9 using instr 1
midi channel 10 using instr 1
midi channel 11 using instr 1
midi channel 12 using instr 1
midi channel 13 using instr 1
midi channel 14 using instr 1
midi channel 15 using instr 1
midi channel 16 using instr 1
0dBFS level = 1.0
orch now loaded
audio buffered in 1024 sample-frame blocks
PortAudio V19-devel (built Sep 4 2014 22:30:30)
0: adc0 (Built-in Microph)
PortAudio: selected input device 'Built-in Microph'
reading 4096-byte blks of shorts from adc (RAW)
0: dac0 (Built-in Output)
PortAudio: selected output device 'Built-in Output'
writing 2048 sample blks of 64-bit floats to dac
SECTION 1:
ftable 1:
new alloc for instr 1:
new alloc for instr 1:
instr 1: ipch = 277.190
new alloc for instr 1:
PERF ERROR in instr 1: vco2: not initialised
asig vco2 .7 ipch 0 0 0 0
note aborted
PERF ERROR in instr 1: vco2: not initialised
asig vco2 .7 ipch 0 0 0 0
note aborted
B 0.000 .. 0.500 T 0.500 TT 0.500 M: 0.81636 0.81636
Score finished in csoundPerformKsmps().
inactive allocs returned to freespace
end of score. overall amps: 0.81636 0.81636
overall samples out of range: 0 0
2 errors in performance
Elapsed time at end of performance: real: 0.774s, CPU: 0.049s
closing device
22 2048 sample blks of 64-bit floats written to dac

This page is empty - should be filled with sensible text

add --num-threads=xx to CommandFlags

http://csound.github.io/docs/manual/SiggenNoise.html
pinker can be added

See csound/csound#455 . GEN23 goes into an infinite loop on some inputs, and does not behave as documented on others. The code will probably have to change, and I'm not sure exactly what format it should read, but at such time as that is sorted out, the documentation should also be updated to accurately reflect what the code does.

ephasor has no info nor an example

According to this mail, we have an Alsa midi sequencer driver, but up until now i don't know how to use it because of the lack of good documentation.

Here is the mail about its announcement:

Selected post Aug 27, 2012; 9:41am
Re: Suggestion for rtmidi=alsa ...
Tito Latini

In reply to this post by jpff
In git (no documentation).

Memorandum about the syntax of the connections:

-M address_list
-Q address_list

where:

address_list ::= address[,address,...]

address ::= client_number[:port_number]
address ::= client_name[:port_number]

client_number and port_number are integers >= 0

The default port_number is 0.

client_name is a string where the first char is not a number
(I can change it if it is a limitation)

Example with `CsOptions':

;; Also the follow is valid
;; -M "20,USB MIDI Controller:1,128:3,keykit:1"
;;
;; Here is an extreme example that uses the characters ','
;; and ':' in the name of the client.
;;
;; -M "Uno,Due,Tre:4"
;;
;; The name of the client is Uno,Due,Tre:4 and the port is 0.
;; Idem but the port is 1 (it also works without escape for ':')
;;
;; -M "Uno,Due,Tre:4:1"
;;

tito

Here is the output in Blue of one of my efforts to understand it:

Render Command ( csound -+msg_color=false -+rtaudio=JACK -o dac:system:playback_ -d -m135 -+rtmidi=alsaseq -M 20,"Csound" /home/menno/bluedata/2015/tempCsd5074643857423571650.csd --env:SFDIR=/home/menno/bluedata/2015 )
UnifiedCSD: /home/menno/bluedata/2015/tempCsd5074643857423571650.csd
STARTING FILE
Creating orchestra
Creating score
Error: define environment variable RAWWAVE_PATH
(points to rawwaves directory) to use STK opcodes.
rtaudio: JACK module enabled
ftable 1:
ftable 2:
ftable 3:
Elapsed time at end of orchestra compile: real: 0.008s, CPU: 0.008s
sorting score ...
... done
Elapsed time at end of score sort: real: 0.008s, CPU: 0.008s
--Csound version 6.04 (double samples) Mar 7 2015
midi channel 1 using instr 1
midi channel 2 using instr 2
midi channel 3 using instr 3
midi channel 4 using instr 4
midi channel 5 using instr 1
midi channel 6 using instr 1
midi channel 7 using instr 1
midi channel 8 using instr 1
midi channel 9 using instr 1
midi channel 10 using instr 1
midi channel 11 using instr 1
midi channel 12 using instr 1
midi channel 13 using instr 1
midi channel 14 using instr 1
midi channel 15 using instr 1
midi channel 16 using instr 1
displays suppressed
0dBFS level = 1.0
ALSASEQ: opened MIDI input sequencer
ALSASEQ: created input port 'Csound' 130:0
ALSASEQ: connected from 20:0
ALSASEQ: connection failed from "Csound", port 0 (Operation not permitted)
orch now loaded
audio buffered in 256 sample-frame blocks
0: dac:system:playback_ (system:playback_)
1: dac:PulseAudio JACK Source:front-left (PulseAudio JACK Source:front-left)
2: dac:PulseAudio JACK Source:front-right (PulseAudio JACK Source:front-right)
3: dac:PulseAudio JACK Source:rear-left (PulseAudio JACK Source:rear-left)
4: dac:PulseAudio JACK Source:rear-right (PulseAudio JACK Source:rear-right)
5: dac:PulseAudio JACK Source:front-center (PulseAudio JACK Source:front-center)
6: dac:PulseAudio JACK Source:lfe (PulseAudio JACK Source:lfe)
7: dac:PulseAudio JACK Source:side-left (PulseAudio JACK Source:side-left)
8: dac:PulseAudio JACK Source:side-right (PulseAudio JACK Source:side-right)
9: dac:PulseAudio JACK Source:aux (PulseAudio JACK Source:aux)
WARNING: not autoconnecting input channel 1
(needs manual connection)
WARNING: not autoconnecting input channel 2
(needs manual connection)
writing 512 sample blks of 64-bit floats to dac:system:playback_
SECTION 1:
ftable 4:
*** error reading MIDI device: -2 (Unknown MIDI error)
*** error reading MIDI device: -2 (Unknown MIDI error)

The --realtime flag is not documented in the current manual

Not a biggie, but why does "rifft" show up in the manual between "inz" and "JackoAudioIn"?

How does one use these opcodes in their instruments? Working .csds are essential educational tools. Hopefully they can be added. Dr.B.

http://csound.github.io/docs/manual/SigmodSpeciale.html is missing the exciter opcode

http://csound.github.io/docs/manual/SiggenWavguide.html has several waveguide physical modelling opcodes that can be integrated with the Models and Emulations section?

There is no man-page and no .csd for this "experimental" opcode. Is this even the "name" of the opcode? OpenCL?

tabrec is missing example

In http://csound.github.io/docs/manual/UsingRealTime.html i read about Linux Midi:
"MIDI Input
Csound does not automatically create its own ALSA sequencer port. It creates an ALSA raw midi port each time it runs"

I am using a Linux system with Jack and have set the Midi Driver option of Alsa to Midi Sequencer - instead of Midi Raw Mode. So this works. But i would like to know more about the differences between them and when to choose one.
At least the option of Midi Sequencer could be mentioned - personally i don't know much about the Midi Sequencer itself, apart from being newer. I'd like more info.

On the page http://csound.github.io/docs/manual/Configuring.html there is still talk about OPCODEDIR64 etc., but Csound6 needs OPCODE6DIR64

Personally i think the "old" OPCODEDIR64 etc. can stay, but it must be clear that with Csound6 there is another situation

Again - not a biggie, but why does "slicearray" show up in the manual between "tabplay" and "tabsum"?

http://www.csounds.com/manual/html/BuildingCsound.html
opening para etc still refers to obtaining sources from sourceforge and to csound5 git pull:

"This section focuses on the main Csound 5 build system, which uses SCons, a Python program that replaces make for cross-platform configuration and building.
"When building Csound from source instead of using a precompiled package, you first need to obtain the sources for a release of Csound at http://www.sourceforge.net/projects/csound. The source packages have either a zip or tar.gz extension.
"The latest (possibly unstable) Csound source code is also available through GIT. The Csound GIT front page is located at: http://csound.git.sourceforge.net/git/gitweb-index.cgi. Using git for just checking out and compiling is pretty easy. Install GIT for your platform and use this command to clone the Csound5 git repository:
"git clone git://git.code.sf.net/p/csound/csound5-git
"
etc
thanks,

David (Worrall)

http://csound.github.io/docs/manual/SiggenModels.html
a reference to http://csound.github.io/docs/manual/STKTop.html can be made on this page, or even better: merge the two pages to one and make mention of the third party issue of the STK opcodes

http://csound.github.io/docs/manual/SpectralNonstand.html
i read:
"These unit generators are experimental, and subject to change between releases, they will also be joined by others later."
Since the succes of the pvs opcodes i don't think that this will be the case.

STARTING FILE
Creating options
Creating orchestra
Creating score
rtaudio: PortAudio module enabled ...
using blocking interface
error: syntax error, unexpected T_IDENT (token "vstinit") from file /Users/rboulanger/Desktop/vst4cs.csd (1)
line 14:

gipianoteq vstinit <<<
Unexpected untyped word gipianoteq when expecting a variable
Parsing failed due to invalid input!
Stopping on parser failure
cannot compile orchestra

the page += is named = , so there are 2 pages named =

Would be great to be able to explore these new opcodes.

the section Csound Links should mention the 2 Csound home pages we have nowadays.

also, in the same section, the links to the csound mailing list can be updated

loscilx needs good info and a good example

rifft seems to be called irfft in the manual