# 5.6. COMMENT

5.6. `COMMENT`
Prev | Chapter 5. Configuring the Makefile | Next

## 5.6. `COMMENT`

This is a one-line description of the port. Please respect the following rules:

1. Try to keep the COMMENT value at no longer than 70 characters, as this line will be used by the pkg_info(1) utility to display a one-line summary of the port;

2. Do not include the package name (or version number of the software);

3. The comment should begin with a capital and end without a period;

4. Do not start with an indefinite article (i.e., A or An);

5. Names are capitalized (for example, Apache, JavaScript, Perl);

6. For lists of words, use the Oxford comma (e.g., green, red, and blue);

7. Spell check the text.

Here is an example:

COMMENT= Cat chasing a mouse all over the screen

The COMMENT variable should immediately follow the MAINTAINER variable in the `Makefile`.

Prev | Up | Next
5.5. `MAINTAINER` | Home | 5.7. `PORTSCOUT`

This, and other documents, can be downloaded from http://ftp.FreeBSD.org/pub/FreeBSD/doc/

For questions about FreeBSD, read the documentation before contacting <questions@FreeBSD.org>.
For questions about this documentation, e-mail <doc@FreeBSD.org>.