Re: [sc-dev] p tags in docs

[jostM <sc3@xxxxxxxx>]

Simply reformatting is not an impossible task.  Writing docs and examples is a lot harder, since it involves analyzing code and then explaining it.

There is a lot of preparation and agreement that would have to be done before hand though. There are a lot of advantages to the xml/html idea. You could output the docs in any format you wanted then, even convert it to Latex and do beautiful printed versions. 

Linking on the whole is much easier now than it would be (even if it is hard to find errors).

Somehow, I think that before 3.3 there are other things to worry about

jost



Andrea Valle wrote:

intuitions are good and I agree, but reformatting all the help files a

huge task.

Well, after your *huge* work, it's a really good point.

Still, IMHO the situation on windows for help files is pretty bad in terms of user experience

Best (and thanks)

-a-

jostM

_______________________________________________

sc-dev mailing list

info (subscription, etc.): http://www.beast.bham.ac.uk/research/sc_mailing_lists.shtml

archive: https://listarc.bham.ac.uk/marchives/sc-dev/

search: https://listarc.bham.ac.uk/lists/sc-dev/search/

--------------------------------------------------

Andrea Valle

--------------------------------------------------

CIRMA - DAMS

Università degli Studi di Torino

--> http://www.cirma.unito.it/andrea/

--> http://www.myspace.com/andreavalle

--> andrea.valle@xxxxxxxx

--------------------------------------------------

"The objectives of SuperCollider have been taken a stage further with the development of SAOL, the fruits of a research project based at MIT, launched in 1998" 

(P. Manning, Electronic and Computer Music, revised and expanded edition, 2004)