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

joachim heintz <[email protected]>
Newsgroups gmane.comp.audio.csound.devel
Message-ID <[email protected]>
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
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.