Re: [Csnd-dev] Manual for Csound 7

Metadata like the ones in the comments at the top of this file:
https://github.com/joachimheintz/CS7_Manual/blob/main/docs/opcodes/adsyn.md?plain=1#adsyn
?

Le mar. 25 févr. 2025, 20:51, Hlöðver Sigurðsson <[email protected]> a
écrit :

> look good. The only downside off the bat for me, is I use the data
> programmability of xml to create emacs and web-ide editor support. But it
> could be supported separately, in fact perhaps even as opcode metadata
> built in down the road.
>
> On Tue, 25 Feb 2025 at 20:52, Rory Walsh <[email protected]> wrote:
>
>> Great work guys. It looks and functions great. :)
>>
>> On Tue, 25 Feb 2025 at 18:33, Dr. Richard Boulanger <
>> [email protected]> wrote:
>>
>>> Looking great!  But... the historical preface mentions Berry Vercoe.
>>>  ;-).   It is Barry Vercoe
>>> Dr. Richard Boulanger
>>> Professor
>>> Electronic Production and Design
>>> Berklee College of Music
>>>
>>> On Feb 25, 2025, at 1:27 PM, vlz <[email protected]> wrote:
>>>
>>> Yes, absolutely. Thanks a lot for this work. It will simplify
>>> maintenance significantly.
>>> Prof. Victor Lazzarini
>>> Maynooth University
>>> Ireland
>>>
>>> On 25 Feb 2025, at 17:08, Francois PINOT <[email protected]> wrote:
>>>
>>> 
>>> Dear devs,
>>>
>>> Joachim, Menno and I are working on a new platform for the manual for
>>> Csound 7. We're using mkdocs-material which is based on markdown, a
>>> technology simpler and more recent than docbook. It produces
>>> beautiful pages.
>>>
>>> The transformation from xml to markdown is a bit tedious. I tried
>>> different tools available on the web, but the results were not convincing.
>>> I finally wrote a program to transform one notice from xml to markdown: it
>>> works fine on nearly all files: for each file it takes me about 2mn to
>>> transform it, verify the result and eventually do some hand adjustment. I
>>> wrote another program to cleanly replace the tabulations by spaces in the
>>> csd files.
>>>
>>> After three weeks, I've transformed about 65% of the manual. You can see
>>> the result here: https://joachimheintz.github.io/CS7_Manual/
>>>
>>> If everyone agrees, we'd like to move this repository from Joachim's
>>> github to the csound github even if it's not complete so that people can
>>> begin to add notices for Csound 7. We can add it as a new branch to the
>>> actual manual repo, protecting the other branches against writing, so that
>>> this new branch becomes the official develop branch of the manual with its
>>> own CI action. Of course, we'll provide guidelines to help people writing
>>> new notices.
>>>
>>> Comments and advice are welcome.
>>>
>>> Regards
>>>
>>> François
>>>
>>>