[Sc-devel] autoHelp?

Andrea Valle valle at di.unito.it
Sun Nov 4 15:07:45 PST 2007


Hmm, I'll take the second way and then back to the list...

Best

-a-

On 4 Nov 2007, at 13:57, Scott Wilson wrote:

> This idea has been mentioned, and it's a good one.
>
> The problem is that the template uses rulers (which I think is  
> desirable) so I think you would need to either add that  
> functionality to Document (probably not too hard), or generate the  
> html directly.
>
> S.
>
> On 4 Nov 2007, at 11:56, Andrea Valle wrote:
>
>> Hi to all,
>>
>> I was writing some docs for a project trying to follow the guide  
>> lines. I appreciate a lot their presence, no problem with UGen and  
>> Topic, but I find extremely boring to write all the stuff
>> related to Class help files, respecting the required format.
>> I see there's been a lot of work in automatic documentation (I  
>> mean: Help.gui, Class.browse).
>> Is there anyone working on a Class method generating the html help  
>> file (e.g. Collection.makeHelp)? So that you have all methods and  
>> args listed in the opportune layout following the guide line, and  
>> you have to to complete/clean the resulting document (e.g.  
>> removing the private or not relevant methods, replacing dummy  
>> lines with real content etc).
>>
>> I think it could greatly help the consistency of new documentation.
>> I was starting working at it, but maybe there's something already  
>> done. More, I know nothing about help file  creation from rtf etc.
>>
>> Best
>>
>> -a-
>>
>>
>> --------------------------------------------------
>> Andrea Valle
>> --------------------------------------------------
>> CIRMA - DAMS
>> Università degli Studi di Torino
>> --> http://www.cirma.unito.it/andrea/
>> --> andrea.valle at unito.it
>> --------------------------------------------------
>>
>>
>> I did this interview where I just mentioned that I read Foucault.  
>> Who doesn't in university, right? I was in this strip club giving  
>> this guy a lap dance and all he wanted to do was to discuss  
>> Foucault with me. Well, I can stand naked and do my little dance,  
>> or I can discuss Foucault, but not at the same time; too much  
>> information.
>> (Annabel Chong)
>>
>>
>>
>>
>> _______________________________________________
>> Sc-devel mailing list
>> Sc-devel at create.ucsb.edu
>> http://www.create.ucsb.edu/mailman/listinfo/sc-devel
>
> _______________________________________________
> Sc-devel mailing list
> Sc-devel at create.ucsb.edu
> http://www.create.ucsb.edu/mailman/listinfo/sc-devel

--------------------------------------------------
Andrea Valle
--------------------------------------------------
CIRMA - DAMS
Università degli Studi di Torino
--> http://www.cirma.unito.it/andrea/
--> andrea.valle at unito.it
--------------------------------------------------


I did this interview where I just mentioned that I read Foucault. Who  
doesn't in university, right? I was in this strip club giving this  
guy a lap dance and all he wanted to do was to discuss Foucault with  
me. Well, I can stand naked and do my little dance, or I can discuss  
Foucault, but not at the same time; too much information.
(Annabel Chong)




-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://www.create.ucsb.edu/pipermail/sc-devel/attachments/20071104/fc4acd9f/attachment.htm


More information about the Sc-devel mailing list