Re: [Csnd-dev] should there be a NEW introduction to CS7 manual?

in general yes, i think.
but changing from docbook to markdown would be a big step and a lot of work.
i just wanted to work on this introduction with a tool which i know and 
which is straightforward.


On 23/10/2024 21:05, tjingboem wrote:
> Is there a way to run examples from this new manual?
> 
> On Wed, Oct 23, 2024 at 9:01 PM tjingboem <[email protected] 
> <mailto:[email protected]>> wrote:
> 
>     i definitely agree and it is a good idea to build this from the
>     ground up.
>     Your approach looks clean.
>     I made some comments in
>     https://github.com/csound/manual/wiki/Manual-Changes-for-Csound-7
>     <https://github.com/csound/manual/wiki/Manual-Changes-for-Csound-7>
>     but i can not keep up with the speed you are working in :-)
> 
> 
> 
> 
> 
> 
>     On Wed, Oct 23, 2024 at 8:46 PM joachim heintz <[email protected]
>     <mailto:[email protected]>> wrote:
> 
>         i feel that it would be good to have a more clear structure in
>         the first
>         section of the csound manual.  this is my suggestion:
> 
>         Introduction
>               What's New in Csound 7
>               Historical Preface
>               History of the Manual
>               Copyright Notice
> 
>         Invoking Csound
>               How Csound Works
>               The `.csd` File Format
>               The `csound` Command
>               Csound Options (flags) Alphabetically
>               Csound Options (flags) by Category
>               Environment Variables
>               Order of Precedence
> 
>         Syntax of the Orchestra
>               Header Statements
>               Global Space
>               Instruments
>               Data Types
>               Variables
>               Macros
>               User Defined Opcodes (UDO)
>               Traditional and Functional Code
> 
>         Syntax of the Score
>               Parameter Fields
>               Preprocessing
>               Statements
>               Macros
>               Included Files
> 
>         a first draft (not at all complete) can be seen at
>         https://joachimheintz.github.io/CS7_Manual/
>         <https://joachimheintz.github.io/CS7_Manual/>
> 
>         is it worth to continue?
>                  joachim
>