Manual Changes for Csound 7

(joachim) I go here through the current items in the Csound 7 Manual

Preface

Preface to the Csound Manual

We still have Barry's historical preface here. Suggestion:

• Write a new preface
• Put Barry's historical preface (if possible with the year - 1996?) in an own item afterwards

History of the Canonical Csound Reference Manual

ok

Copyright Notice

• Remove mentions of CsoundAC
• Add present time (1991-2024 rather than 1991-2008 ...)
• Fix some links (sourceforge ...)

Getting Started with Csound

• Should this be removed?
• Or a very short description? Or a collection of links?
• We have this version on the Csound homepage. Better one place?

What's new in Csound 7

That is definitely very important. Suggestion:

• Write a short text here, kind of overview.
• Link to the (to be written) chapter in the FLOSS Manual about the same topic.

Overview

Introduction

• By the way: here 1984 is said to be the birth of Csound ... =)
• This introduction is outdated in many ways, and mostly repeats historical facts: REMOVE?

The Csound Command

ok

Order of Precedence

small updates (CSOUND7RC etc)

Description of the command syntax

small updates

Csound command line

• I think the title is not consistent. The usage of Csound in terminal was explained in the previous section.
• Title suggestion: Command line flags / Options (alphabetically)

Command-line Flags (by Category)

• Title suggestion: Command line flags / Options (by category)

Csound Environment Variables

In general good; needs some updates.

Unified File Format for Orchestras and Scores

• Remove the HTML paragraph?

Command Line Parameter File (.csound6rc)

• small updates

Score File Preprocessing

• ok?

Using Csound

• in general ok

Csound's Console Output

• this is written in a different tone: not any more as technical description but as tutorial. I would suggest to keep the tone of a reference, so here more dense and short

How Csound works

• very nice and short description about the architecture
• the subchapter "Csound's processing buffers" is not visible in the overview page!

Amplitude Values in Csound

• In general good but again the tone could be more technial and less tutorial
• Table 2 should show more precise values for 0dbfs = 1

Real-Time Audio

• seems good to me, just some updates needed

Optimizing I/O Latency

• I think this is good; perhaps small additions needed

Realtime I/O on Linux / Mac / Windows

I am not very happy with these platform dependent descriptions. Remove? Move to FLOSS Manual? (See https://flossmanual.csound.com/how-to)

Realtime I/O with JACK

More or less the same question

Configuring

This is outdated. Remove?

Syntax of the Orchestra