Search icon CANCEL
Subscription
0
Cart icon
Your Cart (0 item)
Close icon
You have no products in your basket yet
Arrow left icon
Explore Products
Best Sellers
New Releases
Books
Videos
Audiobooks
Learning Hub
Free Learning
Arrow right icon
Arrow up icon
GO TO TOP
Learning Dart

You're reading from   Learning Dart Dart is the programming language developed by Google that offers a new level of simple versatility. Learn all the essentials of Dart web development in this brilliant tutorial that takes you from beginner to pro.

Arrow left icon
Product type Paperback
Published in Jan 2014
Publisher
ISBN-13 9781849697422
Length 388 pages
Edition 1st Edition
Languages
Arrow right icon
Toc

Table of Contents (14) Chapters Close

Preface 1. Dart – A Modern Web Programming Language 2. Getting to Work with Dart FREE CHAPTER 3. Structuring Code with Classes and Libraries 4. Modeling Web Applications with Model Concepts and Dartlero 5. Handling the DOM in a New Way 6. Combining HTML5 Forms with Dart 7. Building Games with HTML5 and Dart 8. Developing Business Applications with Polymer Web Components 9. Modeling More Complex Applications with Dartling 10. MVC Web and UI Frameworks in Dart – An Overview 11. Local Data and Client-Server Communication 12. Data-driven Web Applications with MySQL and MongoDB Index

Documenting your programs

Documenting an application is of utmost importance in software engineering and Dart makes this very easy. The single-line (//) and multiline comments (/* */) are useful (for example, to comment out code or mark lines with // TODO), and they have counterparts /// and /** */ called documentation comments. In these comments (to be placed on the previous line), you can include references to all kinds of objects in your code (classes, methods, fields, and so on) and the Dartdoc tool (in Dart Editor go to Tools | Generate Dartdoc) will generate HTML documentation where these references become links. To demonstrate we will add docs to our banking example (refer to banking_v2doc.dart):

/**
 * A bank account has an [owner], is identified by a [number]
 * and has an amount of money called [balance].
 * The balance is changed through methods [deposit] and [withdraw].
 */
class BankAccount {
  String owner, number;
  double balance;
  DateTime dateCreated, dateModified;
...
You have been reading a chapter from
Learning Dart
Published in: Jan 2014
Publisher:
ISBN-13: 9781849697422
Register for a free Packt account to unlock a world of extra content!
A free Packt account unlocks extra newsletters, articles, discounted offers, and much more. Start advancing your knowledge today.
Unlock this book and the full library FREE for 7 days
Get unlimited access to 7000+ expert-authored eBooks and videos courses covering every tech area you can think of
Renews at $19.99/month. Cancel anytime
Banner background image