Csound Csound-dev Csound-tekno Search About

Manual....

Date1997-02-11 19:09
From"Thomas R. Trenka"
SubjectManual....
Fellow CSounders--

Regarding the manual, perhaps it is time to work out a common format,
one in which new ugens and a version update list would be a standard
part.

What I propose is this:  a manual that would add addendums for each
version update, placed on a common FTP site (Bath would be my
suggestion), in PDF and Postscript formats, as well as MS Word.
I would be willing to keep the manual updated, and I would use a format
that would be broken down into sections (ugens, score, GENs, and
appendixes) so that anything new could just be added on with a 
minimum of page renumbering.

What I would also suggest is that a common format be made for the
introduction of new ugens, to follow the format given in the original
CSound manual.  Submissions would include parameters, explanation
and usage, and a short example of implimentation.  Anyone else 
interested?

Thomas Trenka
University of Minnesota
tren0009@gold.tc.umn.edu




Received: from stork2.maths.bath.ac.uk by omphalos.maths.Bath.AC.UK id aa04678;
          11 Feb 97 20:20 GMT
Received: from goggins.bath.ac.uk by stork.maths.Bath.AC.UK id aa22848;
          11 Feb 97 20:20 GMT
Received: from hermes.ex.ac.uk by goggins.bath.ac.uk with SMTP (PP);
          Tue, 11 Feb 1997 20:20:44 +0000
Received: from noether [144.173.8.10] by hermes via SMTP (UAA28946);
          Tue, 11 Feb 1997 20:11:27 GMT
Received: from hermes.ex.ac.uk by noether.maths.exeter.ac.uk;
          Tue, 11 Feb 97 20:11:21 GMT
Received: from ella.mills.edu [144.91.3.20] by hermes via ESMTP (UAA28938);
          Tue, 11 Feb 1997 20:11:19 GMT
Received: from localhost by ella.mills.edu 
          via SMTP (940816.SGI.8.6.9/930416.SGI)	 id MAA16252;
          Tue, 11 Feb 1997 12:11:22 -0800
Date: Tue, 11 Feb 1997 12:11:21 -0800 (PST)
From: Mike Berry 
To: "Thomas R. Trenka" 
Cc: csound list 
Subject: Re: Manual....
In-Reply-To: <3300c3cc35a3116@mhub1.tc.umn.edu>
Message-Id: 
Mime-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-csound-outgoing@maths.ex.ac.uk
Precedence: bulk

	I have already done this in the Mac online manual, which, of
course, is only readable on a Mac.  If you don't have one, I would be
happy to send you what I have done in .rtf format.  I have all but the
3.45 ugens included.  The mac online naturally does not have sections like
how to format the Unix command line.  I would suggest that each of the
machine specific sections be stored as a separate document.
	The online version is a DOCMaker application.  I don't know if
there is something similar available for PC's, but the format works very
well on Macs.

Mike Berry
mikeb@mills.edu





Received: from stork2.maths.bath.ac.uk by omphalos.maths.Bath.AC.UK id aa05254;
          11 Feb 97 21:54 GMT
Received: from goggins.bath.ac.uk by stork.maths.Bath.AC.UK id ac25950;
          11 Feb 97 21:54 GMT
Received: from hermes.ex.ac.uk by goggins.bath.ac.uk with SMTP (PP);
          Tue, 11 Feb 1997 21:54:20 +0000
Received: from noether [144.173.8.10] by hermes via SMTP (VAA03582);
          Tue, 11 Feb 1997 21:49:49 GMT
Received: from hermes.ex.ac.uk by noether.maths.exeter.ac.uk;
          Tue, 11 Feb 97 21:49:43 GMT
Received: from mailbox.swip.net [193.12.122.1] by hermes via ESMTP (VAA03576);
          Tue, 11 Feb 1997 21:49:42 GMT
Received: from rasmus (dialup122-1-5.swipnet.se [130.244.122.5])           
          by mailbox.swip.net (8.7.6swip/8.7.3) with SMTP           
          id WAA29774 for ;
          Tue, 11 Feb 1997 22:49:09 +0100 (MET)
Message-Id: <3300EA7C.5424@hexagon.se>
Date: Tue, 11 Feb 1997 22:54:04 +0100
From: rasmus ekman 
X-Mailer: Mozilla 3.0 (Win95; I)
Mime-Version: 1.0
To: Csound mailing list 
Subject: Re: Manual....
References: <3300c3cc35a3116@mhub1.tc.umn.edu>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-csound-outgoing@maths.ex.ac.uk
Precedence: bulk

Thomas R. Trenka wrote:
> 
> Fellow CSounders--
> 
Mike Berry wrote:
> 
>         I have already done this in the Mac

... and I have most everything, also in RTF format. This includes v 3.45 
and the Robin Whittle opcodes. I've also done it as a Windows help file, 
and planned just to wait for the voscili documentation before putting it 
on a web page. I suggest we mail each other to work things out (like a
common format) - would be good to avoid multiple efforts in the future.

cheers,
	re



Received: from stork2.maths.bath.ac.uk by omphalos.maths.Bath.AC.UK id aa05493;
          11 Feb 97 22:52 GMT
Received: from goggins.bath.ac.uk by stork.maths.Bath.AC.UK id aa27767;
          11 Feb 97 22:52 GMT
Received: from hermes.ex.ac.uk by goggins.bath.ac.uk with SMTP (PP);
          Tue, 11 Feb 1997 22:51:58 +0000
Received: from noether [144.173.8.10] by hermes via SMTP (WAA06175);
          Tue, 11 Feb 1997 22:45:55 GMT
Received: from hermes.ex.ac.uk by noether.maths.exeter.ac.uk;
          Tue, 11 Feb 97 22:45:50 GMT
Received: from stieltjes.smc.univie.ac.at [131.130.31.68] by hermes 
          via ESMTP (WAA06164); Tue, 11 Feb 1997 22:45:44 GMT
Received: from polya.univie.ac.at (plato-slip-155.univie.ac.at [131.130.99.155]) 
          by stieltjes.smc.univie.ac.at (8.7.5/8.6.12) with SMTP id XAA10549 
          for ; Tue, 11 Feb 1997 23:47:53 +0100 (MET)
Date: Tue, 11 Feb 97 23:39:15 W. Europe Standard Time
From: Erich Neuwirth 
Subject: mirror
To: csound@maths.ex.ac.uk
X-Mailer: Chameleon ATX 6.0, Standards Based IntraNet Solutions, NetManage Inc.
X-Face: Ww0y#m#gfCw8pV9jF$;}^l_CqkSs+!2YJ[yJyyb-1aE?tp~5|GtEti,{1f~,Pt?)qcVs2-UjY#WCI6a3t)LZ=qpl>M8b{%j5NTX8l-nhJ&s+^a
X-Priority: 3 (Normal)
Message-Id: 
Mime-Version: 1.0
Content-Type: TEXT/PLAIN; charset=US-ASCII
Sender: owner-csound-outgoing@maths.ex.ac.uk
Precedence: bulk

in case i have not mentioned it on the list

sunsite vienna is mirroring the bath ftp site

http://SunSITE.univie.ac.at/pub/sound/csound/

it also works via ftp

sometimes getting to the british isles from the continent ist
difficult, even electronically!

so here is you second chance.

-- 
Erich Neuwirth 
Computer Supported Didactics Working Group, University of Vienna
PGP-key at http://www.smc.univie.ac.at/PGP-Keys/neuwirth.asc
Visit my Spreadsheet home page at http://sunsite.univie.ac.at/Spreadsite



Received: from stork2.maths.bath.ac.uk by omphalos.maths.Bath.AC.UK id aa08411;
          12 Feb 97 8:49 GMT
Received: from goggins.bath.ac.uk by stork.maths.Bath.AC.UK id aa17444;
          12 Feb 97 8:49 GMT
Received: from hermes.ex.ac.uk by goggins.bath.ac.uk with SMTP (PP);
          Wed, 12 Feb 1997 08:49:37 +0000
Received: from noether [144.173.8.10] by hermes via SMTP (IAA22920);
          Wed, 12 Feb 1997 08:41:27 GMT
Received: from hermes.ex.ac.uk by noether.maths.exeter.ac.uk;
          Wed, 12 Feb 97 08:41:21 GMT
Received: from pp@goggins.bath.ac.uk [138.38.32.13] by hermes 
          via ESMTP (IAA22911); Wed, 12 Feb 1997 08:41:21 GMT
From: jpff@maths.bath.ac.uk
Message-Id: <199702120841.IAA22911@hermes>
Received: from maths.Bath.AC.UK (actually host omphalos.maths.bath.ac.uk)           
          by goggins.bath.ac.uk with SMTP (PP); Wed, 12 Feb 1997 08:41:18 +0000
Date:     Wed, 12 Feb 97 8:40:54 GMT
Subject:  Re: Manual....
To: csound@maths.ex.ac.uk
Sender: owner-csound-outgoing@maths.ex.ac.uk
Precedence: bulk

Message written at 11 Feb 1997 21:44:45 +0000
In-reply-to: <3300c3cc35a3116@mhub1.tc.umn.edu> (tren0009@gold.tc.umn.edu)

>>>>> "Thomas" == Thomas R Trenka  writes:

 Thomas> Fellow CSounders--
 Thomas> Regarding the manual, perhaps it is time to work out a common format,
 Thomas> one in which new ugens and a version update list would be a standard
 Thomas> part.

 Thomas> What I propose is this:  a manual that would add addendums for each
 Thomas> version update, placed on a common FTP site (Bath would be my
 Thomas> suggestion), in PDF and Postscript formats, as well as MS Word.

Do not know what PDF is, and I cannot read postscript or MS Word
without many contortions.  How about a format which is actually
READABLE?  Thought that would be too much to ask.

..... snip ....

 Thomas> What I would also suggest is that a common format be made for the
 Thomas> introduction of new ugens, to follow the format given in the original
 Thomas> CSound manual.  Submissions would include parameters, explanation
 Thomas> and usage, and a short example of implimentation.  Anyone else 
 Thomas> interested?

But there is a format already, surely.



Received: from stork2.maths.bath.ac.uk by omphalos.maths.Bath.AC.UK id aa09050;
          12 Feb 97 11:00 GMT
Received: from goggins.bath.ac.uk by stork.maths.Bath.AC.UK id aa22435;
          12 Feb 97 11:00 GMT
Received: from hermes.ex.ac.uk by goggins.bath.ac.uk with SMTP (PP);
          Wed, 12 Feb 1997 11:00:00 +0000
Received: from noether [144.173.8.10] by hermes via SMTP (KAA05174);
          Wed, 12 Feb 1997 10:51:43 GMT
Received: from hermes.ex.ac.uk by noether.maths.exeter.ac.uk;
          Wed, 12 Feb 97 10:51:36 GMT
Received: from rzaix13.rrz.uni-hamburg.de [134.100.2.13] by hermes 
          via SMTP (KAA05153); Wed, 12 Feb 1997 10:51:34 GMT
Received: from localhost 
          by rzaix13.rrz.uni-hamburg.de (AIX 4.1/UCB 5.64/4.03)          
          id AA13260; Wed, 12 Feb 1997 11:51:33 +0100
Message-Id: <3301A0B5.2F1C@rrz.uni-hamburg.de>
Date: Wed, 12 Feb 1997 11:51:33 +0100
From: Bernd Eggink 
Organization: RRZ Uni Hamburg
X-Mailer: Mozilla 3.01 (X11; I; AIX 1)
Mime-Version: 1.0
To: CSound mailing list 
Subject: Re: Manual....
References: <199702120841.IAA22911@hermes>
Content-Type: text/plain; charset=us-ascii
Content-Transfer-Encoding: 7bit
Sender: owner-csound-outgoing@maths.ex.ac.uk
Precedence: bulk

jpff@maths.bath.ac.uk wrote:
 
> Do not know what PDF is, and I cannot read postscript or MS Word
> without many contortions.  How about a format which is actually
> READABLE?  Thought that would be too much to ask.

What about HTML? Doesn't everybody have a browser anyway? Nice to read,
easy to print, and a separate Windows help file would not be necessary.

Bernd

--

Bernd Eggink
Regionales Rechenzentrum der Uni Hamburg
eggink@rzaix13.rrz.uni-hamburg.de
http://www.uni-hamburg.de/eggink/BEggink.html

Date1997-02-11 20:11
FromMike Berry
SubjectRe: Manual....
	I have already done this in the Mac online manual, which, of
course, is only readable on a Mac.  If you don't have one, I would be
happy to send you what I have done in .rtf format.  I have all but the
3.45 ugens included.  The mac online naturally does not have sections like
how to format the Unix command line.  I would suggest that each of the
machine specific sections be stored as a separate document.
	The online version is a DOCMaker application.  I don't know if
there is something similar available for PC's, but the format works very
well on Macs.

Mike Berry
mikeb@mills.edu