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/

is it worth to continue?
	joachim

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  > 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
>     
>     but i can not keep up with the speed you are working in :-)
> 
> 
> 
> 
> 
> 
>     On Wed, Oct 23, 2024 at 8:46 PM joachim heintz      > 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/
>         
> 
>         is it worth to continue?
>                  joachim
>