Hi Peiman, Brian mentioned the shift-F1 option, but a way to open example CSD's for an opcode does sound interesting though and shouldn't take long to implement. I think I'll try adding something to blue that will do that. Thanks for mentioning that! steven On Dec 4, 2007 4:06 AM, Peiman Khosravi wrote: > Ah wow, this has been a secrete to me for all these years!!! thanks so much > :-) > > Peiman > > > > On 4 Dec 2007, at 11:58, Brian Wong wrote: > Peiman, > > blue already has that, just put the cursor on the opcode and press Shift-F1 > and it pulls up the page as a new browser tab from your hard drive version > of the Csound manual. :) > > bw > ________________________________ > > > Date: Tue, 4 Dec 2007 11:42:55 +0000 > > To: csound@lists.bath.ac.uk > > From: peimankhosravi@gmail.com > > Subject: [Csnd] Re: Re: Re: Re: A funny/sad manual tale > > > > Hi Steven, > > > > Relating to the max manual I just wanted to mention that there are > > two separate manuals: one for max and one for msp (473 pages). > > > > Max does have one amazing feature and that is each object comes with > > a help patch that you can open by selecting the object and hiting alt > > I think. It would be great if the csound example csds were also > > arranged in such a way that one could open them from within an editor > > (say blue!) by right clicking on the selected opcodes (of course it > > would also be great to have the ability to open selected opcode's > > manual page in blue). But I guess I am diverting a little bit here :-) > > > > Peiman > > > > On 4 Dec 2007, at 06:19, Steven Yi wrote: > > > > > Hi All, > > > > > > Well, the one thing I would say is that a bulk of the manual is > > > reference, while the other part act like a user's manual. I don't > > > think anyone is expected to read the entire reference section, but > > > rather lookup an opcode here and there when one needs it. One might > > > read most of the user's manual section in the beginning (sections I, > > > II, and II) to get an idea of how Csound works and families of opcodes > > > to get the big picture, then pick out opcodes here and there as one > > > needs it. > > > > > > Just to note, I have 1257 opcodes listed when I do csound -z. This is > > > with my local compiled version of Csound and does not include all of > > > the opcodes which are being built for release. I think some formatting > > > changes could certainly be done for the PDF version to bring down the > > > size, but we also have to face that there is a lot of information to > > > cover. > > > > > > I just went to cycling74.com and downloaded the manuals for Max 4.6. > > > To note, the reference manual there is 724 pages and has quite a bit > > > of white space, opting to have each entry at the top of a page which I > > > think helps make it quicker to find IMO. This manual has nice fonts > > > and layout which might be good to model the Csound manual on. I think > > > if Max 4.6 came with as many object/opcodes as Csound, it may very > > > well have a similar number of pages for a manual if we include the > > > pages from the other PDF's there besides the reference (the > > > documentation there is split among a number of PDF's). > > > > > > steven > > > > > > > > > On Dec 3, 2007 5:54 PM, Charles Gran wrote: > > >> On 3 Dec 2007 at 16:36, Brent Boylan wrote: > > >> > > >>> > > >>> The manual is quite out of hand. > > >> . . . > > >> > > >> Yeah, but I'm not complaining really--considering how great Csound > > >> is, and that it's free. But one has to admit that a 2,000 page > > >> manual (produced as a PDF no less, which would imply that it is is to > > >> be printed) is the kind of document only science people must be used > > >> to seeing. Though I suppose there are some 2,000+ page documents > > >> people read . . . the Bible? Is this manual bigger than the Bible? > > >> Nope, just checked. The Bible is bigger. Thank God! > > >> > > >> But a manual that musicians use? I can't even get my students to > > >> read their harmony textbook, and that thing is about as long as an > > >> issue of X-MEN. Big books that musicians read? I don't know. > > >> There's that Taruskin book on Stavinsky. I'm reading Alex Ross's THE > > >> REST IS NOISE, and he quotes Taruskin all over the place so I assume > > >> he read it. But he's a musicologist and they LIKE to read. > > >> > > >> It would be nice to have a manual that one could get *in hand.* That > > >> being said, it's probably better to have the programmers occupied > > >> with the program itself. That's always the rub isn't it? One has to > > >> know the thing to write about it. > > >> > > >> Grabbing a fistful of pages out of the box from reprographics, it > > >> does seem as though white space could be reclaimed and headings could > > >> use smaller fonts. Also, there are these lists, like SIGNAL > > >> GENERATORS on p116 and following, that could definitely be typeset in > > >> a more contained manner. > > >> > > >> > > >> > > >> > > >> Send bugs reports to this list. > > >> To unsubscribe, send email sympa@lists.bath.ac.uk with body > > >> "unsubscribe csound" > > >> > > > > > > > > > Send bugs reports to this list. > > > To unsubscribe, send email sympa@lists.bath.ac.uk with body > > > "unsubscribe csound" > > > > > > > > Send bugs reports to this list. > > To unsubscribe, send email sympa@lists.bath.ac.uk with body "unsubscribe > csound" > > > ________________________________ > Books, DVD's, gadgets, music and more. Shop online with Sympatico / MSN > Shopping today! >