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