Fix for sorting directives with documentation comments.

pkg/analysis_server/test/services/correction/sort_members_test.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.
 
 library test.services.refactoring.sort_members;
 
 import 'package:analysis_server/plugin/protocol/protocol.dart';
 import 'package:analysis_server/src/services/correction/sort_members.dart';
 import 'package:test_reflective_loader/test_reflective_loader.dart';
 import 'package:unittest/unittest.dart';
@@ skipping 353 matching lines @@
 export 'bbb/bbb.dart';
 
 part 'aaa/aaa.dart';
 part 'bbb/bbb.dart';
 
 main() {
 }
 ''');
   }
 
-  void test_directives_comments() {
+  void test_directives_docComment_hasLibrary_lines() {
     _parseTestUnit(r'''
-// header
-library lib;
+/// Library documentation comment A.
+/// Library documentation comment B.
+library foo.bar;
 
-import 'c.dart';// c
-import 'a.dart';// aa
-import 'b.dart';// bbb
-
-/** doc */
-main() {
-}
+/// bbb1
+/// bbb2
+/// bbb3
+import 'b.dart';
+/// aaa1
+/// aaa2
+import 'a.dart';
 ''');
     // validate change
     _assertSort(r'''
-// header
-library lib;
+/// Library documentation comment A.
+/// Library documentation comment B.
+library foo.bar;
 
+/// aaa1
+/// aaa2
 import 'a.dart';
+/// bbb1
+/// bbb2
+/// bbb3
 import 'b.dart';
-import 'c.dart';
-// c
-// aa
-// bbb
-
-/** doc */
-main() {
-}
 ''');
   }
 
+  void test_directives_docComment_hasLibrary_stars() {
+    _parseTestUnit(r'''
+/**
+ * Library documentation comment A.
+ * Library documentation comment B.
+ */
+library foo.bar;
+
+/**
+ * bbb
+ */
+import 'b.dart';
+/**
+ * aaa
+ * aaa
+ */
+import 'a.dart';
+''');
+    // validate change
+    _assertSort(r'''
+/**
+ * Library documentation comment A.
+ * Library documentation comment B.
+ */
+library foo.bar;
+
+/**
+ * aaa
+ * aaa
+ */
+import 'a.dart';
+/**
+ * bbb
+ */
+import 'b.dart';
+''');
+  }
+
+  void test_directives_docComment_noLibrary_lines() {
+    _parseTestUnit(r'''
+/// Library documentation comment A
+/// Library documentation comment B
+import 'b.dart';
+/// aaa1
+/// aaa2
+import 'a.dart';
+''');
+    // validate change
+    _assertSort(r'''
+/// aaa1
+/// aaa2
+/// Library documentation comment A
+/// Library documentation comment B
+import 'a.dart';
+import 'b.dart';
+''');
+  }
+
+  void test_directives_docComment_noLibrary_stars() {
+    _parseTestUnit(r'''
+/**
+ * Library documentation comment A.
+ * Library documentation comment B.
+ */
+import 'b.dart';
+/**
+ * aaa
+ * aaa
+ */
+import 'a.dart';
+''');
+    // validate change
+    _assertSort(r'''
+/**
+ * aaa
+ * aaa
+ */
+/**
+ * Library documentation comment A.
+ * Library documentation comment B.
+ */
+import 'a.dart';
+import 'b.dart';
+''');
+  }
+
   void test_directives_imports_packageAndPath() {
     _parseTestUnit(r'''
 library lib;
 
 import 'package:product.ui.api.bbb/manager1.dart';
 import 'package:product.ui.api/entity2.dart';
 import 'package:product.ui/entity.dart';
 import 'package:product.ui.api.aaa/manager2.dart';
 import 'package:product.ui.api/entity1.dart';
 import 'package:product2.client/entity.dart';
@@ skipping 299 matching lines @@
     List<SourceEdit> edits = sorter.sort();
     String result = SourceEdit.applySequence(testCode, edits);
     expect(result, expectedCode);
   }
 
   void _parseTestUnit(String code) {
     addTestSource(code);
     testUnit = context.parseCompilationUnit(testSource);
   }
 }