comments.html revision 9bff67898d55cddfcec9ce30cc2b1bb6211ec691
278N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
278N/A<!--
278N/A - Copyright (C) 1999, 2000 Internet Software Consortium.
278N/A -
278N/A - Permission to use, copy, modify, and distribute this software for any
278N/A - purpose with or without fee is hereby granted, provided that the above
278N/A - copyright notice and this permission notice appear in all copies.
278N/A -
278N/A - THE SOFTWARE IS PROVIDED "AS IS" AND INTERNET SOFTWARE CONSORTIUM DISCLAIMS
278N/A - ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES
278N/A - OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL INTERNET SOFTWARE
278N/A - CONSORTIUM BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL
278N/A - DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR
278N/A - PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
278N/A - ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
278N/A - SOFTWARE.
278N/A-->
278N/A
278N/A<HTML>
278N/A<HEAD>
278N/A <TITLE>BIND Comment Syntax</TITLE>
278N/A</HEAD>
278N/A
278N/A<BODY>
278N/A<H2>BIND Configuration File Guide--Comment Syntax</H2>
278N/A
618N/A<HR>
278N/A
278N/A<A NAME="Syntax"><H3>Syntax</H3></A>
278N/A
278N/A<PRE>
278N/A/* This is a BIND comment as in C */
278N/A
278N/A// This is a BIND comment as in C++
278N/A
278N/A# This is a BIND comment as in common Unix shells and perl
278N/A</PRE>
278N/A
278N/A<A NAME="Usage"><H3>Definition and Usage</H3></A>
278N/A
278N/A<P>Comments may appear anywhere that whitespace may appear in a BIND
278N/Aconfiguration file.</P>
278N/A
278N/A<P>C-style comments start with the two characters <CODE>/*</CODE>
278N/A(slash, star) and end with <CODE>*/</CODE> (star, slash). Because
278N/Athey are completely delimited with these characters, they can be used
278N/Ato comment only a portion of a line or to span multiple lines.</P>
278N/A
278N/A<P>C-style comments cannot be nested. For example, the following is
278N/Anot valid because the entire comment ends with the first
278N/A<CODE>*/</CODE>:
278N/A
278N/A<PRE>
278N/A/* This is the start of a comment.
278N/A This is still part of the comment.
278N/A/* This is an incorrect attempt at nesting a comment. */
This is no longer in any comment. */
</PRE>
<P>C++-style comments start with the two characters <CODE>//</CODE>
(slash, slash) and continue to the end of the physical line. They
cannot be continued across multiple physical lines; to have one
logical comment span multiple lines, each line must use the
<CODE>//</CODE> pair. For example:
<PRE>
// This is the start of a comment. The next line
// is a new comment, even though it is logically
// part of the previous comment.
</PRE>
<P>Shell-style (or perl-style, if you prefer) comments start with the
character <CODE>#</CODE> (hash or pound or number or octothorpe or
whatever) and continue to the end of the physical line, like C++
comments.</P> For example:
<PRE>
# This is the start of a comment. The next line
# is a new comment, even though it is logically
# part of the previous comment.
</PRE>
<P><STRONG>WARNING:</STRONG> you cannot use the <CODE>;</CODE>
(semicolon) character to start a comment such as you would in a zone
file. The semicolon indicates the end of a configuration statement,
so whatever follows it will be interpreted as the start of the next
statement.</P>
<HR>
<CENTER><P>[ <A HREF="config.html">BIND Config. File</A>
| <A HREF="http://www.vix.com/isc/bind.html">BIND Home</A>
|&nbsp;<A HREF="http://www.isc.org">ISC</A> ]</P></CENTER>
<HR>
<ADDRESS>
Last Updated: $Id: comments.html,v 1.2 2000/06/21 23:50:27 tale Exp $
</ADDRESS>
</BODY>
</HTML>