From d06a45a9a48878fa429c13001ef00ce45ac36720 Mon Sep 17 00:00:00 2001
From: Julien Lancelot <julien.lancelot@sonarsource.com>
Date: Thu, 15 May 2014 16:09:11 +0200
Subject: [PATCH] Add some description of the result array for Ws using
 compressed format

---
 .../main/java/org/sonar/server/source/ws/ScmAction.java  | 8 +++++++-
 .../main/java/org/sonar/server/source/ws/ShowAction.java | 7 ++++++-
 .../org/sonar/server/test/ws/CoverageShowAction.java     | 9 ++++++++-
 3 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/sonar-server/src/main/java/org/sonar/server/source/ws/ScmAction.java b/sonar-server/src/main/java/org/sonar/server/source/ws/ScmAction.java
index bfc688bb411..8f67df2342d 100644
--- a/sonar-server/src/main/java/org/sonar/server/source/ws/ScmAction.java
+++ b/sonar-server/src/main/java/org/sonar/server/source/ws/ScmAction.java
@@ -40,7 +40,13 @@ public class ScmAction implements RequestHandler {
 
   void define(WebService.NewController controller) {
     WebService.NewAction action = controller.createAction("scm")
-      .setDescription("Get SCM information of source files. Require Browse permission on file's project")
+      .setDescription("Get SCM information of source files. Require Browse permission on file's project<br/>" +
+        "Each element of the result array is composed of:" +
+        "<ol>" +
+        "<li>Line number</li>" +
+        "<li>Author of the commit</li>" +
+        "<li>Date of the commit</li>" +
+        "</ol>")
       .setSince("4.4")
       .setResponseExample(Resources.getResource(getClass(), "example-scm.json"))
       .setHandler(this);
diff --git a/sonar-server/src/main/java/org/sonar/server/source/ws/ShowAction.java b/sonar-server/src/main/java/org/sonar/server/source/ws/ShowAction.java
index bf90536acd9..b3947c65ef5 100644
--- a/sonar-server/src/main/java/org/sonar/server/source/ws/ShowAction.java
+++ b/sonar-server/src/main/java/org/sonar/server/source/ws/ShowAction.java
@@ -41,7 +41,12 @@ public class ShowAction implements RequestHandler {
 
   void define(WebService.NewController controller) {
     WebService.NewAction action = controller.createAction("show")
-      .setDescription("Get source code. Require Browse permission on file's project")
+      .setDescription("Get source code. Require Browse permission on file's project<br/>" +
+        "Each element of the result array is composed of:" +
+        "<ol>" +
+        "<li>Line number</li>" +
+        "<li>Content of the line</li>" +
+        "</ol>")
       .setSince("4.4")
       .setResponseExample(Resources.getResource(getClass(), "example-show.json"))
       .setHandler(this);
diff --git a/sonar-server/src/main/java/org/sonar/server/test/ws/CoverageShowAction.java b/sonar-server/src/main/java/org/sonar/server/test/ws/CoverageShowAction.java
index e385920a927..41ce23f4b5d 100644
--- a/sonar-server/src/main/java/org/sonar/server/test/ws/CoverageShowAction.java
+++ b/sonar-server/src/main/java/org/sonar/server/test/ws/CoverageShowAction.java
@@ -46,7 +46,14 @@ public class CoverageShowAction implements RequestHandler {
 
   void define(WebService.NewController controller) {
     WebService.NewAction action = controller.createAction("show")
-      .setDescription("Get code coverage. Require Browse permission on file's project")
+      .setDescription("Get code coverage. Require Browse permission on file's project<br/>" +
+        "Each element of the result array is composed of:" +
+        "<ol>" +
+        "<li>Line number</li>" +
+        "<li>Is the line covered?</li>" +
+        "<li>Number of branches</li>" +
+        "<li>Number of branches covered</li>" +
+        "</ol>")
       .setSince("4.4")
       .setResponseExample(Resources.getResource(getClass(), "coverage-example-show.json"))
       .setHandler(this);
-- 
2.39.5