Use hanging indentation when code generating Javadoc @params.

pkg/analysis_server/tool/spec/to_html.dart

 // Copyright (c) 2014, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 /**
  * Code for displaying the API as HTML.  This is used both for generating a
  * full description of the API as a web page, and for generating doc comments
  * in generated code.
  */
 library to.html;
@@ skipping 20 matching lines @@
 }
 div.box {
   border: 1px solid rgb(0, 0, 0);
   background-color: rgb(207, 226, 243);
   padding: 0.5em;
 }
 dt {
   margin-top: 1em;
   margin-bottom: 1em;
 }
+div.hangingIndent {
+  padding-left: 3em;
+  text-indent: -3em;
+}
 '''.trim();
 
 /**
  * Helper methods for creating HTML elements.
  */
 abstract class HtmlMixin {
   void element(String name, Map<dynamic, String> attributes, [void callback()]);
 
   void anchor(String id, void callback()) {
     element('a', {
@@ skipping 18 matching lines @@
   void dt(String cls, void callback()) => element('dt', {
     'class': cls
   }, callback);
   void gray(void callback()) => element('span', {
     'style': 'color:#999999'
   }, callback);
   void h1(void callback()) => element('h1', {}, callback);
   void h2(void callback()) => element('h2', {}, callback);
   void h3(void callback()) => element('h3', {}, callback);
   void h4(void callback()) => element('h4', {}, callback);
+  void hangingIndent(void callback()) => element('div', {
+    'class': 'hangingIndent'
+  }, callback);
   void head(void callback()) => element('head', {}, callback);
   void html(void callback()) => element('html', {}, callback);
   void i(void callback()) => element('i', {}, callback);
   void p(void callback()) => element('p', {}, callback);
   void pre(void callback()) => element('pre', {}, callback);
   void title(void callback()) => element('title', {}, callback);
   void tt(void callback()) => element('tt', {}, callback);
 }
 
 /**
@@ skipping 306 matching lines @@
         });
       } else {
         visitTypeDecl(subType);
       }
     }
   }
 
   void javadocParams(TypeObject typeObject) {
     if (typeObject != null) {
       for (TypeObjectField field in typeObject.fields) {
-        write('@param ${field.name} ');
-        translateHtml(field.html, squashParagraphs: true);
-        br();
+        hangingIndent(() {
+          write('@param ${field.name} ');
+          translateHtml(field.html, squashParagraphs: true);
+        });
       }
     }
   }
 
   @override
   void visitRequest(Request request) {
     dt('request', () {
       write(request.longMethod);
     });
     dd(() {
@@ skipping 108 matching lines @@
  */
 main() {
   ToHtmlVisitor visitor = new ToHtmlVisitor(readApi());
   dom.Document document = new dom.Document();
   for (dom.Node node in visitor.collectHtml(visitor.visitApi)) {
     document.append(node);
   }
   File outputFile = new File('../../doc/api.html');
   outputFile.writeAsStringSync(document.outerHtml);
 }