官术网_书友最值得收藏!

Commenting code

It is best practice to always document your JavaScript code through the use of comments. At a minimum, this should include the author of the code, date of last revision, and the general purpose of the code. In addition, at various points throughout your code you should include comment sections that define the purpose of specific sections of the application. The purpose of this documentation is to make it easier for you or another programmer to quickly get up to speed in the event that the code needs to be updated in some way.

Any comments that you include in your code are not executed. They are simply ignored by the JavaScript interpreter. JavaScript can be commented in a couple of ways including single line and multi-line comments. Single line comments start with // and any additional characters you add to the line. The following code example shows how single line comments are created:

//this is a single line comment.  This line will not be executed

Multi-line comments in JavaScript start with /* and end with */. Any lines in between are treated as comments and are not executed. The following code example shows an example of multi-line comments (also called block comments):

/* 
Copyright 2012 Google Inc. Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. 
*/ 
主站蜘蛛池模板: 大关县| 河北省| 离岛区| 岚皋县| 察隅县| 兴海县| 都兰县| 临颍县| 文安县| 鄯善县| 平凉市| 新安县| 阳泉市| 淮北市| 墨江| 辉县市| 普格县| 新安县| 织金县| 应城市| 元朗区| 无极县| 根河市| 竹溪县| 泸西县| 潞城市| 阳曲县| 怀安县| 常山县| 平阳县| 宝鸡市| 博客| 镶黄旗| 涞源县| 岑巩县| 通海县| 清水县| 盐亭县| 林州市| 静海县| 偃师市|