Re: [Csnd-dev] [EXTERNAL] Re: [Csnd-dev] Manual for Csound 7

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 <[email protected] 
> <mailto:[email protected]>> 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
>