Csound Csound-dev Csound-tekno Search About

[Cs-dev] Updates

Date2005-02-03 03:34
From"Michael Gogins"
Subject[Cs-dev] Updates
Zeroth, welcome to Istvan Varga as a Csound developer, and thanks for your 
contributions and energy.

First, the ability to restart CsoundVST has vanished, perhaps because of 
recent changes by Istvan.

I would appreciate it if people who make big changes to Csound would test 
that they can run and restart CsoundVST when they are done. This tests the 
re-entrancy (in the sense of being able to stop and restart) of the Csound 
API. The re-entrancy is also important when using Csound from Python.

Second, I have updated SConstruct to build the new plugin audio drivers on 
Windows.

Third, I have updated the manual module in CVS with a new makefile and 
sources for a Csound 5 docbook manual. The Csound 5 manual reuses sources 
from the Csound 4.23 manual wherever possible. However, it has new 
introductory materal, new installation and compilation instructions, a users 
guide, and new material on extending Csound. All sources for the Csound 5 
version should into into the manual/csound5 directory. All opcodes peculiar 
to Csound 5 should go into the manual/csound5/opcodes directory. Opcodes 
common to both versions of Csound should go in the usual place.

>From now on, it would be appreciated if those who contribute code to Csound 
5 update the Csound 5 manual, or add to it, to document their work.

Also, the Csound 5 manual has reference entries for the Loris opcodes, the 
vst4cs VST plugin opcodes, my version of the fluid opcodes (but not Steven 
Yi's version), and the Python opcodes.

Again, thanks to Steven Yi for getting me a toolchain I can use. 




-------------------------------------------------------
This SF.Net email is sponsored by: IntelliVIEW -- Interactive Reporting
Tool for open source databases. Create drag-&-drop reports. Save time
by over 75%! Publish reports on the web. Export to DOC, XLS, RTF, etc.
Download a FREE copy at http://www.intelliview.com/go/osdn_nl
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net

Date2005-02-03 05:12
Fromsteven yi
SubjectRe: [Cs-dev] Updates
Hi Michael,

I was taking a look at the two manuals and was wondering why we need to 
split the two manuals between version 4 and 5.  I think if we can keep 
the sections separate as well as mark opcodes and features as being 
"Since Csound 5", users will not be confused.  On the other hand, I can 
see already there will be a need to have more and more duplicated files 
between the 4 and 5 branch that differ only slightly, just to handle how 
the entities resolve and how things are organized.  I think as long as 
we mark what is 5 and what is not, put the csound5 information in it's 
own section (pretty much as you have with the csound5 sections), that 
things will be much easier to keep up to date.  Although I have been 
spending time with the documentation system and trying to get things 
going smoothly with that, it's not exactly the most enjoyable work for 
me, especially as I have plenty to work on with blue documentation and 
blue itself.  The prospect of having to manage the differences between 
the two manuals is not exactly that appealing to me and I think that 
making a single version manual would be the most ideal for me.

For an example of what I'm thinking, see:

http://docbook.org/tdg/en/html/docbook.html

Notice how on that page in the reference section there are standout 
"V4.0" and "V4.2" images that denote tags that are only available in 
newer versions.  I think the same type of standout graphic would be 
appropriate. 

Let me know what you think of this proposal. 

Thanks,
steven


Michael Gogins wrote:

>
> Third, I have updated the manual module in CVS with a new makefile and 
> sources for a Csound 5 docbook manual. The Csound 5 manual reuses 
> sources from the Csound 4.23 manual wherever possible. However, it has 
> new introductory materal, new installation and compilation 
> instructions, a users guide, and new material on extending Csound. All 
> sources for the Csound 5 version should into into the manual/csound5 
> directory. All opcodes peculiar to Csound 5 should go into the 
> manual/csound5/opcodes directory. Opcodes common to both versions of 
> Csound should go in the usual place.
>
>> From now on, it would be appreciated if those who contribute code to 
>> Csound 
>
> 5 update the Csound 5 manual, or add to it, to document their work.
>
> Also, the Csound 5 manual has reference entries for the Loris opcodes, 
> the vst4cs VST plugin opcodes, my version of the fluid opcodes (but 
> not Steven Yi's version), and the Python opcodes.
>
> Again, thanks to Steven Yi for getting me a toolchain I can use.
>



-------------------------------------------------------
This SF.Net email is sponsored by: IntelliVIEW -- Interactive Reporting
Tool for open source databases. Create drag-&-drop reports. Save time
by over 75%! Publish reports on the web. Export to DOC, XLS, RTF, etc.
Download a FREE copy at http://www.intelliview.com/go/osdn_nl
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net