Hi all,
i sat down and took a moment to reflect on how to get a more transparent manual index; what is shown to the user when looking at the Csound Manual.
So, continuing the path of the present beta Csound7 manual https://csound.com/manual/, i came up with re-distributing of some chapters and simplifying the start screen . The tree of the manual has a max depth of 3.

I can not attach anything in this list, so i hope the copy-paste of my .odt is without error.

Feedback appreciated.

==============================


Introduction
                What’s new
                Historical
                                Preface
                                Manual
                                                Nomenclature
                Copyright/ Links               
Csound System
                How Csound Works
                Configuring
                Real-Time Audio
                The ‘csound’ Command
                The ‘csd’ File Format
                Csound Options (flags)
                                Alphabetically
                                By Category
                Guard Point in Tables
                Environment Variables
                Order of Precedence
                UDP Server
                Syntax of the Orchestra
                                Header Statements and Global Space
                                Instruments
                                Data Types and Variables
                                Macros
                                User Defined Opcodes (UDO)
                                Traditional and Functional Code
                Syntax of the Score
                                Parameter Fileds
                                Durations in Instrument Events
                                Amplitude Values
                                Preprocessing
                                List of Statements
                                Macros
                                Included Files
                                Expressions
                                Scripts
                                Csbeats
Opcodes Overview
                Signal Generators
                Signal Input/Output
                Signal Modifiers
                Instrument Control
                Functional Table Control
                Mathematical Operations
                Pitch Converters
                Real-Time MIDI
                Spectral Processing
                Strings
                Vectorial Opcodes
                Zak Patch System
                OSC, Network and non-MIDI deveices
                Signal Flow Graph Opcodes
                Mixer Opcodes
                Miscellaneous Opcodes
GEN Routine Overview
Utility Programs
                About
                Analysis File Generation
                File Queries
                File Conversion
                Other Csound Utilities
Opcodes Index
Opcodes Quick Reference
GEN Routine Index
Appendices
                List of Examples
                Pitch Conversion
                Sound Intensity Values
                Formant Values
                Modal Frequency Ratios
                Window Functions

hi menno -

i am a bit puzzled how this does or does not refer to what we have
currently in https://csound.com/manual/

what i like in your overview is that the main sections are more clear.
i am wondering whether we can also put Opcodes Index, Opcodes Quick
Reference and GEN Routine Index in another big section called "Index and
Quick Reference".  then it would be:

Introduction
Csound System
Opcode Overview
GEN Routine Overview
Utility Programs
Index and Quick Reference
Appendix

ciao -
        joachim


On 16/04/2025 11:01, Menno Knevel wrote:
> Hi all,
> i sat down and took a moment to reflect on how to get a more transparent manual index; what is shown to the user when looking at the Csound Manual.
> So, continuing the path of the present beta Csound7 manual https://csound.com/manual/, i came up with re-distributing of some chapters and simplifying the start screen . The tree of the manual has a max depth of 3.
>
> I can not attach anything in this list, so i hope the copy-paste of my .odt is without error.
>
> Feedback appreciated.
>
> ==============================
>
>
> Introduction
>               What’s new
>               Historical
>                               Preface
>                               Manual
>                                               Nomenclature
>               Copyright/ Links               
> Csound System
>               How Csound Works
>               Configuring
>               Real-Time Audio
>               The ‘csound’ Command
>               The ‘csd’ File Format
>               Csound Options (flags)
>                               Alphabetically
>                               By Category
>               Guard Point in Tables
>               Environment Variables
>               Order of Precedence
>               UDP Server
>               Syntax of the Orchestra
>                               Header Statements and Global Space
>                               Instruments
>                               Data Types and Variables
>                               Macros
>                               User Defined Opcodes (UDO)
>                               Traditional and Functional Code
>               Syntax of the Score
>                               Parameter Fileds
>                               Durations in Instrument Events
>                               Amplitude Values
>                               Preprocessing
>                               List of Statements
>                               Macros
>                               Included Files
>                               Expressions
>                               Scripts
>                               Csbeats
> Opcodes Overview
>               Signal Generators
>               Signal Input/Output
>               Signal Modifiers
>               Instrument Control
>               Functional Table Control
>               Mathematical Operations
>               Pitch Converters
>               Real-Time MIDI
>               Spectral Processing
>               Strings
>               Vectorial Opcodes
>               Zak Patch System
>               OSC, Network and non-MIDI deveices
>               Signal Flow Graph Opcodes
>               Mixer Opcodes
>               Miscellaneous Opcodes
> GEN Routine Overview
> Utility Programs
>               About
>               Analysis File Generation
>               File Queries
>               File Conversion
>               Other Csound Utilities
> Opcodes Index
> Opcodes Quick Reference
> GEN Routine Index
> Appendices
>               List of Examples
>               Pitch Conversion
>               Sound Intensity Values
>               Formant Values
>               Modal Frequency Ratios
>               Window Functions

thanks menno.
then i put my question in another way:
is your outline based on what we have now as develop manual in
csound.com/manual, or do you go back to the old manual as base?

i was not sure about it; this was what i meant by "puzzled".

        joachim

On 17/04/2025 09:42, tjingboem wrote:
> Hi Joachim,
>
> wonderful!
> This means the Main Chapter counter has gone down from *13* to*7*.
> Without losing any information and a better organization of this
> information.
>
> (I am puzzled why you are puzzled....which puzzle do you mean?)
>
> Menno
>
>
> On Wed, Apr 16, 2025 at 11:08 PM joachim heintz <jh@joachimheintz.de
> <mailto:jh@joachimheintz.de>> wrote:
>
>     hi menno -
>
>     i am a bit puzzled how this does or does not refer to what we have
>     currently in https://csound.com/manual/ <https://csound.com/manual/>
>
>     what i like in your overview is that the main sections are more clear.
>     i am wondering whether we can also put Opcodes Index, Opcodes Quick
>     Reference and GEN Routine Index in another big section called "Index
>     and
>     Quick Reference".  then it would be:
>
>     Introduction
>     Csound System
>     Opcode Overview
>     GEN Routine Overview
>     Utility Programs
>     Index and Quick Reference
>     Appendix
>
>     ciao -
>              joachim
>
>
>     On 16/04/2025 11:01, Menno Knevel wrote:
>      > Hi all,
>      > i sat down and took a moment to reflect on how to get a more
>     transparent manual index; what is shown to the user when looking at
>     the Csound Manual.
>      > So, continuing the path of the present beta Csound7 manual
>     https://csound.com/manual/ <https://csound.com/manual/>, i came up
>     with re-distributing of some chapters and simplifying the start
>     screen . The tree of the manual has a max depth of 3.
>      >
>      > I can not attach anything in this list, so i hope the copy-paste
>     of my .odt is without error.
>      >
>      > Feedback appreciated.
>      >
>      > ==============================
>      >
>      >
>      > Introduction
>      >               What’s new
>      >               Historical
>      >                               Preface
>      >                               Manual
>      >                                               Nomenclature
>      >               Copyright/ Links
>      > Csound System
>      >               How Csound Works
>      >               Configuring
>      >               Real-Time Audio
>      >               The ‘csound’ Command
>      >               The ‘csd’ File Format
>      >               Csound Options (flags)
>      >                               Alphabetically
>      >                               By Category
>      >               Guard Point in Tables
>      >               Environment Variables
>      >               Order of Precedence
>      >               UDP Server
>      >               Syntax of the Orchestra
>      >                               Header Statements and Global Space
>      >                               Instruments
>      >                               Data Types and Variables
>      >                               Macros
>      >                               User Defined Opcodes (UDO)
>      >                               Traditional and Functional Code
>      >               Syntax of the Score
>      >                               Parameter Fileds
>      >                               Durations in Instrument Events
>      >                               Amplitude Values
>      >                               Preprocessing
>      >                               List of Statements
>      >                               Macros
>      >                               Included Files
>      >                               Expressions
>      >                               Scripts
>      >                               Csbeats
>      > Opcodes Overview
>      >               Signal Generators
>      >               Signal Input/Output
>      >               Signal Modifiers
>      >               Instrument Control
>      >               Functional Table Control
>      >               Mathematical Operations
>      >               Pitch Converters
>      >               Real-Time MIDI
>      >               Spectral Processing
>      >               Strings
>      >               Vectorial Opcodes
>      >               Zak Patch System
>      >               OSC, Network and non-MIDI deveices
>      >               Signal Flow Graph Opcodes
>      >               Mixer Opcodes
>      >               Miscellaneous Opcodes
>      > GEN Routine Overview
>      > Utility Programs
>      >               About
>      >               Analysis File Generation
>      >               File Queries
>      >               File Conversion
>      >               Other Csound Utilities
>      > Opcodes Index
>      > Opcodes Quick Reference
>      > GEN Routine Index
>      > Appendices
>      >               List of Examples
>      >               Pitch Conversion
>      >               Sound Intensity Values
>      >               Formant Values
>      >               Modal Frequency Ratios
>      >               Window Functions
>

ok good.  let's continue on this path.
and then we should check whether nothing was lost from the old manual
(there was
https://github.com/csound/manual/blob/csound7/overview/server.xml which
was not transferred i think).
        j

On 17/04/2025 21:12, tjingboem wrote:
> ah i see
> no i think the old manual has done its service and i thank it very much
> for that.
> The manual for Csound7 is indeed https://csound.com/manual/ <https://
> csound.com/manual/> but i am looking to improve and continue on that path.
>
> On Thu, Apr 17, 2025 at 8:58 PM joachim heintz <jh@joachimheintz.de
> <mailto:jh@joachimheintz.de>> wrote:
>
>     thanks menno.
>     then i put my question in another way:
>     is your outline based on what we have now as develop manual in
>     csound.com/manual <http://csound.com/manual>, or do you go back to
>     the old manual as base?
>
>     i was not sure about it; this was what i meant by "puzzled".
>
>              joachim
>
>     On 17/04/2025 09:42, tjingboem wrote:
>      > Hi Joachim,
>      >
>      > wonderful!
>      > This means the Main Chapter counter has gone down from *13* to*7*.
>      > Without losing any information and a better organization of this
>      > information.
>      >
>      > (I am puzzled why you are puzzled....which puzzle do you mean?)
>      >
>      > Menno
>      >
>      >
>      > On Wed, Apr 16, 2025 at 11:08 PM joachim heintz
>     <jh@joachimheintz.de <mailto:jh@joachimheintz.de>
>      > <mailto:jh@joachimheintz.de <mailto:jh@joachimheintz.de>>> wrote:
>      >
>      >     hi menno -
>      >
>      >     i am a bit puzzled how this does or does not refer to what we
>     have
>      >     currently in https://csound.com/manual/ <https://csound.com/
>     manual/> <https://csound.com/manual/ <https://csound.com/manual/>>
>      >
>      >     what i like in your overview is that the main sections are
>     more clear.
>      >     i am wondering whether we can also put Opcodes Index, Opcodes
>     Quick
>      >     Reference and GEN Routine Index in another big section called
>     "Index
>      >     and
>      >     Quick Reference".  then it would be:
>      >
>      >     Introduction
>      >     Csound System
>      >     Opcode Overview
>      >     GEN Routine Overview
>      >     Utility Programs
>      >     Index and Quick Reference
>      >     Appendix
>      >
>      >     ciao -
>      >              joachim
>      >
>      >
>      >     On 16/04/2025 11:01, Menno Knevel wrote:
>      >      > Hi all,
>      >      > i sat down and took a moment to reflect on how to get a more
>      >     transparent manual index; what is shown to the user when
>     looking at
>      >     the Csound Manual.
>      >      > So, continuing the path of the present beta Csound7 manual
>      > https://csound.com/manual/ <https://csound.com/manual/> <https://
>     csound.com/manual/ <https://csound.com/manual/>>, i came up
>      >     with re-distributing of some chapters and simplifying the start
>      >     screen . The tree of the manual has a max depth of 3.
>      >      >
>      >      > I can not attach anything in this list, so i hope the
>     copy-paste
>      >     of my .odt is without error.
>      >      >
>      >      > Feedback appreciated.
>      >      >
>      >      > ==============================
>      >      >
>      >      >
>      >      > Introduction
>      >      >               What’s new
>      >      >               Historical
>      >      >                               Preface
>      >      >                               Manual
>      >      >                                               Nomenclature
>      >      >               Copyright/ Links
>      >      > Csound System
>      >      >               How Csound Works
>      >      >               Configuring
>      >      >               Real-Time Audio
>      >      >               The ‘csound’ Command
>      >      >               The ‘csd’ File Format
>      >      >               Csound Options (flags)
>      >      >                               Alphabetically
>      >      >                               By Category
>      >      >               Guard Point in Tables
>      >      >               Environment Variables
>      >      >               Order of Precedence
>      >      >               UDP Server
>      >      >               Syntax of the Orchestra
>      >      >                               Header Statements and Global
>     Space
>      >      >                               Instruments
>      >      >                               Data Types and Variables
>      >      >                               Macros
>      >      >                               User Defined Opcodes (UDO)
>      >      >                               Traditional and Functional Code
>      >      >               Syntax of the Score
>      >      >                               Parameter Fileds
>      >      >                               Durations in Instrument Events
>      >      >                               Amplitude Values
>      >      >                               Preprocessing
>      >      >                               List of Statements
>      >      >                               Macros
>      >      >                               Included Files
>      >      >                               Expressions
>      >      >                               Scripts
>      >      >                               Csbeats
>      >      > Opcodes Overview
>      >      >               Signal Generators
>      >      >               Signal Input/Output
>      >      >               Signal Modifiers
>      >      >               Instrument Control
>      >      >               Functional Table Control
>      >      >               Mathematical Operations
>      >      >               Pitch Converters
>      >      >               Real-Time MIDI
>      >      >               Spectral Processing
>      >      >               Strings
>      >      >               Vectorial Opcodes
>      >      >               Zak Patch System
>      >      >               OSC, Network and non-MIDI deveices
>      >      >               Signal Flow Graph Opcodes
>      >      >               Mixer Opcodes
>      >      >               Miscellaneous Opcodes
>      >      > GEN Routine Overview
>      >      > Utility Programs
>      >      >               About
>      >      >               Analysis File Generation
>      >      >               File Queries
>      >      >               File Conversion
>      >      >               Other Csound Utilities
>      >      > Opcodes Index
>      >      > Opcodes Quick Reference
>      >      > GEN Routine Index
>      >      > Appendices
>      >      >               List of Examples
>      >      >               Pitch Conversion
>      >      >               Sound Intensity Values
>      >      >               Formant Values
>      >      >               Modal Frequency Ratios
>      >      >               Window Functions
>      >
>

https://csound.com/manual/overview/udp-server/

I'm actually working on Menno's proposal. I think I'll commit things today or tomorrow so that we can go on from there.

Regards

François

Le jeu. 17 avr. 2025 à 21:50, joachim heintz <jh@joachimheintz.de> a écrit :

ok good.  let's continue on this path.
and then we should check whether nothing was lost from the old manual
(there was
https://github.com/csound/manual/blob/csound7/overview/server.xml which
was not transferred i think).
        j

On 17/04/2025 21:12, tjingboem wrote:
> ah i see
> no i think the old manual has done its service and i thank it very much
> for that.
> The manual for Csound7 is indeed https://csound.com/manual/ <https://
> csound.com/manual/> but i am looking to improve and continue on that path.
>
> On Thu, Apr 17, 2025 at 8:58 PM joachim heintz <jh@joachimheintz.de
> <mailto:jh@joachimheintz.de>> wrote:
>
>     thanks menno.
>     then i put my question in another way:
>     is your outline based on what we have now as develop manual in
>     csound.com/manual <http://csound.com/manual>, or do you go back to
>     the old manual as base?
>
>     i was not sure about it; this was what i meant by "puzzled".
>
>              joachim
>
>     On 17/04/2025 09:42, tjingboem wrote:
>      > Hi Joachim,
>      >
>      > wonderful!
>      > This means the Main Chapter counter has gone down from *13* to*7*.
>      > Without losing any information and a better organization of this
>      > information.
>      >
>      > (I am puzzled why you are puzzled....which puzzle do you mean?)
>      >
>      > Menno
>      >
>      >
>      > On Wed, Apr 16, 2025 at 11:08 PM joachim heintz
>     <jh@joachimheintz.de <mailto:jh@joachimheintz.de>
>      > <mailto:jh@joachimheintz.de <mailto:jh@joachimheintz.de>>> wrote:
>      >
>      >     hi menno -
>      >
>      >     i am a bit puzzled how this does or does not refer to what we
>     have
>      >     currently in https://csound.com/manual/ <https://csound.com/
>     manual/> <https://csound.com/manual/ <https://csound.com/manual/>>
>      >
>      >     what i like in your overview is that the main sections are
>     more clear.
>      >     i am wondering whether we can also put Opcodes Index, Opcodes
>     Quick
>      >     Reference and GEN Routine Index in another big section called
>     "Index
>      >     and
>      >     Quick Reference".  then it would be:
>      >
>      >     Introduction
>      >     Csound System
>      >     Opcode Overview
>      >     GEN Routine Overview
>      >     Utility Programs
>      >     Index and Quick Reference
>      >     Appendix
>      >
>      >     ciao -
>      >              joachim
>      >
>      >
>      >     On 16/04/2025 11:01, Menno Knevel wrote:
>      >      > Hi all,
>      >      > i sat down and took a moment to reflect on how to get a more
>      >     transparent manual index; what is shown to the user when
>     looking at
>      >     the Csound Manual.
>      >      > So, continuing the path of the present beta Csound7 manual
>      > https://csound.com/manual/ <https://csound.com/manual/> <https://
>     csound.com/manual/ <https://csound.com/manual/>>, i came up
>      >     with re-distributing of some chapters and simplifying the start
>      >     screen . The tree of the manual has a max depth of 3.
>      >      >
>      >      > I can not attach anything in this list, so i hope the
>     copy-paste
>      >     of my .odt is without error.
>      >      >
>      >      > Feedback appreciated.
>      >      >
>      >      > ==============================
>      >      >
>      >      >
>      >      > Introduction
>      >      >               What’s new
>      >      >               Historical
>      >      >                               Preface
>      >      >                               Manual
>      >      >                                               Nomenclature
>      >      >               Copyright/ Links
>      >      > Csound System
>      >      >               How Csound Works
>      >      >               Configuring
>      >      >               Real-Time Audio
>      >      >               The ‘csound’ Command
>      >      >               The ‘csd’ File Format
>      >      >               Csound Options (flags)
>      >      >                               Alphabetically
>      >      >                               By Category
>      >      >               Guard Point in Tables
>      >      >               Environment Variables
>      >      >               Order of Precedence
>      >      >               UDP Server
>      >      >               Syntax of the Orchestra
>      >      >                               Header Statements and Global
>     Space
>      >      >                               Instruments
>      >      >                               Data Types and Variables
>      >      >                               Macros
>      >      >                               User Defined Opcodes (UDO)
>      >      >                               Traditional and Functional Code
>      >      >               Syntax of the Score
>      >      >                               Parameter Fileds
>      >      >                               Durations in Instrument Events
>      >      >                               Amplitude Values
>      >      >                               Preprocessing
>      >      >                               List of Statements
>      >      >                               Macros
>      >      >                               Included Files
>      >      >                               Expressions
>      >      >                               Scripts
>      >      >                               Csbeats
>      >      > Opcodes Overview
>      >      >               Signal Generators
>      >      >               Signal Input/Output
>      >      >               Signal Modifiers
>      >      >               Instrument Control
>      >      >               Functional Table Control
>      >      >               Mathematical Operations
>      >      >               Pitch Converters
>      >      >               Real-Time MIDI
>      >      >               Spectral Processing
>      >      >               Strings
>      >      >               Vectorial Opcodes
>      >      >               Zak Patch System
>      >      >               OSC, Network and non-MIDI deveices
>      >      >               Signal Flow Graph Opcodes
>      >      >               Mixer Opcodes
>      >      >               Miscellaneous Opcodes
>      >      > GEN Routine Overview
>      >      > Utility Programs
>      >      >               About
>      >      >               Analysis File Generation
>      >      >               File Queries
>      >      >               File Conversion
>      >      >               Other Csound Utilities
>      >      > Opcodes Index
>      >      > Opcodes Quick Reference
>      >      > GEN Routine Index
>      >      > Appendices
>      >      >               List of Examples
>      >      >               Pitch Conversion
>      >      >               Sound Intensity Values
>      >      >               Formant Values
>      >      >               Modal Frequency Ratios
>      >      >               Window Functions
>      >
>