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