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

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 <[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/
>
> is it worth to continue?
>         joachim
>