Reduce API changes, add documentation to the added method

Author: krassowski

src/commandsAndMenu.tsx

@@ -852,7 +852,7 @@ export function addFileBrowserContextMenu(
       const items = getSelectedBrowserItems();
       const statuses = new Set<Git.Status>(
         items
-          .map(item => model.getFileStatus(item.path))
+          .map(item => model.getFile(item.path)?.status)
           .filter(status => typeof status !== 'undefined')
       );
 

src/model.ts

@@ -242,10 +242,13 @@ export class GitExtension implements IGitExtension {
     await this.refreshStatus();
   }
 
-  getFileStatus(path: string): Git.Status {
-    return this.getFile(path)?.status;
-  }
-
+  /**
+   * Match files status information based on a provided file path.
+   *
+   * If the file is tracked and has no changes, undefined will be returned
+   *
+   * @param path the file path relative to the server root
+   */
   getFile(path: string): Git.IStatusFile {
     const matchingFiles = this._status.files.filter(status => {
       return this.getRelativeFilePath(status.to) === path;

src/tokens.ts

@@ -249,16 +249,13 @@ export interface IGitExtension extends IDisposable {
   ensureGitignore(): Promise<void>;
 
   /**
+   * Match files status information based on a provided file path.
    *
-   * @param path
-   */
-  getFile(path: string): Git.IStatusFile;
-
-  /**
+   * If the file is tracked and has no changes, undefined will be returned
    *
-   * @param path
+   * @param path the file path relative to the server root
    */
-  getFileStatus(path: string): Git.Status;
+  getFile(path: string): Git.IStatusFile;
 
   /**
    * Get current mark of file named fname
@@ -637,7 +634,7 @@ export namespace Git {
 
   /** Interface for changed_files request result
    * lists the names of files that have differences between two commits
-   * or beween two branches, or that were changed by a single commit
+   * or between two branches, or that were changed by a single commit
    */
   export interface IChangedFilesResult {
     code: number;