Csound Csound-dev Csound-tekno Search About

[Cs-dev] API docs

Date2013-04-23 17:42
FromVictor Lazzarini
Subject[Cs-dev] API docs
AttachmentsNone  None  
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
tel.: +353 1 708 3545
Victor dot Lazzarini AT nuim dot ie




Date2013-04-23 18:32
FromAndres Cabrera
SubjectRe: [Cs-dev] API docs
AttachmentsNone  None  
Changed. Any other suggestions?


On Tue, Apr 23, 2013 at 9:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel



Date2013-04-23 18:42
FromVictor Lazzarini
SubjectRe: [Cs-dev] API docs
AttachmentsNone  None  
Thanks. not right now, but I've been improving bits of the comment text in csound.h.

I am also wondering whether we should offer some new examples in addition to the minimal one in csound.h, showing the
new compile and parameter setting functions.

Victor

On 23 Apr 2013, at 18:32, Andres Cabrera wrote:

Changed. Any other suggestions?


On Tue, Apr 23, 2013 at 9:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel


------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
tel.: +353 1 708 3545
Victor dot Lazzarini AT nuim dot ie




Date2013-04-23 19:54
FromAndres Cabrera
SubjectRe: [Cs-dev] API docs
AttachmentsNone  None  
I think that's definitely a good idea. Whether it should go in the csound header or the wiki or the manual, I'm not sure...

Cheers,
Andrés


On Tue, Apr 23, 2013 at 10:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
Thanks. not right now, but I've been improving bits of the comment text in csound.h.

I am also wondering whether we should offer some new examples in addition to the minimal one in csound.h, showing the
new compile and parameter setting functions.

Victor

On 23 Apr 2013, at 18:32, Andres Cabrera wrote:

Changed. Any other suggestions?


On Tue, Apr 23, 2013 at 9:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel


------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel



Date2013-04-23 20:38
FromMichael Gogins
SubjectRe: [Cs-dev] API docs
AttachmentsNone  None  
Anyone who uses the API will probably look at the header, and if it is in the header it will get into the API reference manual via doxygen. So it should go into the header.

Regards,
Mike


On Tue, Apr 23, 2013 at 2:54 PM, Andres Cabrera <mantaraya36@gmail.com> wrote:
I think that's definitely a good idea. Whether it should go in the csound header or the wiki or the manual, I'm not sure...

Cheers,
Andrés


On Tue, Apr 23, 2013 at 10:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
Thanks. not right now, but I've been improving bits of the comment text in csound.h.

I am also wondering whether we should offer some new examples in addition to the minimal one in csound.h, showing the
new compile and parameter setting functions.

Victor

On 23 Apr 2013, at 18:32, Andres Cabrera wrote:

Changed. Any other suggestions?


On Tue, Apr 23, 2013 at 9:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel


------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel



------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel




--
Michael Gogins
Irreducible Productions
http://www.michael-gogins.com
Michael dot Gogins at gmail dot com

Date2013-04-23 21:00
FromRory Walsh
SubjectRe: [Cs-dev] API docs
AttachmentsNone  None  

I agree with Mike. I think the header is the best place for

On 23 Apr 2013 20:39, "Michael Gogins" <michael.gogins@gmail.com> wrote:
Anyone who uses the API will probably look at the header, and if it is in the header it will get into the API reference manual via doxygen. So it should go into the header.

Regards,
Mike


On Tue, Apr 23, 2013 at 2:54 PM, Andres Cabrera <mantaraya36@gmail.com> wrote:
I think that's definitely a good idea. Whether it should go in the csound header or the wiki or the manual, I'm not sure...

Cheers,
Andrés


On Tue, Apr 23, 2013 at 10:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
Thanks. not right now, but I've been improving bits of the comment text in csound.h.

I am also wondering whether we should offer some new examples in addition to the minimal one in csound.h, showing the
new compile and parameter setting functions.

Victor

On 23 Apr 2013, at 18:32, Andres Cabrera wrote:

Changed. Any other suggestions?


On Tue, Apr 23, 2013 at 9:42 AM, Victor Lazzarini <Victor.Lazzarini@nuim.ie> wrote:
When responding to Jim Hearon today I realised that some of the module names in the API docs are misleading.
In special http://csound.sourceforge.net/doc/html/group__FILEIO.html is not specifically to do witn FILE IO, but with
setting IO parameters (input, midi input, output, etc), some of which can be file or not.

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel


------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel

Dr Victor Lazzarini
Senior Lecturer
Dept. of Music
NUI Maynooth Ireland
Victor dot Lazzarini AT nuim dot ie




------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel



------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel




--
Michael Gogins
Irreducible Productions
http://www.michael-gogins.com
Michael dot Gogins at gmail dot com

------------------------------------------------------------------------------
Try New Relic Now & We'll Send You this Cool Shirt
New Relic is the only SaaS-based application performance monitoring service
that delivers powerful full stack analytics. Optimize and monitor your
browser, app, & servers with just a few lines of code. Try New Relic
and get this awesome Nerd Life shirt! http://p.sf.net/sfu/newrelic_d2d_apr
_______________________________________________
Csound-devel mailing list
Csound-devel@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/csound-devel