diff_services_pb.rb in gitaly-16.5.0.pre.rc42

- old
+ new
@@ -14,18 +14,26 @@
 
       self.marshal_class_method = :encode
       self.unmarshal_class_method = :decode
       self.service_name = 'gitaly.DiffService'
 
-      # CommitDiff returns stream of CommitDiffResponse with patches chunked over messages.
+      # CommitDiff returns a diff between two different commits. The patch data is
+      # chunked across messages and get streamed back to the client.
       rpc :CommitDiff, ::Gitaly::CommitDiffRequest, stream(::Gitaly::CommitDiffResponse)
-      # CommitDelta returns a stream so we can divide the response in chunks of deltas.
+      # CommitDelta returns the deltas between two different commits. A delta
+      # includes everthing that changed about a set of paths except for the actual
+      # diff.
       rpc :CommitDelta, ::Gitaly::CommitDeltaRequest, stream(::Gitaly::CommitDeltaResponse)
-      # RawDiff ...
+      # RawDiff returns a diff between two commits. The output is the unmodified
+      # output from git-diff(1). This is not to be confused with git-diff(1)'s
+      # --raw mode.
       rpc :RawDiff, ::Gitaly::RawDiffRequest, stream(::Gitaly::RawDiffResponse)
-      # RawPatch ...
+      # RawPatch returns a diff between two commits in a formatted patch.The output
+      # is the unmodified output from git-format-patch(1). This is not to be confused with
+      # git-diff(1)'s --raw mode.
       rpc :RawPatch, ::Gitaly::RawPatchRequest, stream(::Gitaly::RawPatchResponse)
-      # DiffStats ...
+      # DiffStats returns the diff stats between two commits such as number of lines
+      # changed, etc.
       rpc :DiffStats, ::Gitaly::DiffStatsRequest, stream(::Gitaly::DiffStatsResponse)
       # FindChangedPaths returns a list of files changed along with the status of each file
       rpc :FindChangedPaths, ::Gitaly::FindChangedPathsRequest, stream(::Gitaly::FindChangedPathsResponse)
       # GetPatchID computes a patch ID for a patch. Patch IDs are a unique ID computed by hashing
       # a patch with some parameters like line numbers ignored. The patch ID can thus be used to compare