8.2 Comments

Cows allows to insert comments within your scripts in order to make them more readable and easy to maintain. These comments - unlike HTML ones - will never reach users' browsers. So, you may also find valuable to define a Cows script consisting of nothing but comments in order to replace HTML ones.

8.2.1 Line comments

8.2.1.1 Synopsis

// comment

8.2.1.2 Description

Everything following the double slashes until the first End Of Line will be discarded from output.

8.2.1.3 Example

// The time will come when men such as I will look upon the
// murder of animals as they now look on the murder of men.
// -- Leonardo da Vinci

8.2.2 Block comments

8.2.2.1 Synopsis

/*
Comment - first line
Comment - second line
...
*/

8.2.2.2 Description

Everything between /* and */ will be discarded from output. Please note that block comments don't nest but you can still place a line comment inside a block one.

8.2.2.3 Example

/* ****************************************** *
   Human beings are the only animals of which
   I am thoroughly and cravenly afraid.
   -- George Bernard Shaw
 * ****************************************** */

This manual can be downloaded from http://www.g-cows.org/.