Main Content

rm

Mark file for deletion from Git repository

Since R2023b

    Description

    example

    rm(repo,files) marks the files files for deletion from the Git™ repository repo. The rm function does not delete the file from the local disk. The function deletes the cached file from the .git folder.

    Examples

    collapse all

    Create a new Git repository and create a repository object.

    repo = gitinit("newrepo");

    Create a new script.

    edit newScript.m;

    Mark the file for addition and commit it to the repository.

    add(repo,"newScript.m");
    commit(repo,message="Add file");

    Remove the new file from the repository.

    rm(repo,"newScript.m");
    commitDetails = commit(repo,message="Remove file")
    commitDetails = 
    
      GitCommit with properties:
    
               Message: "Remove file"
                    ID: "7fdae521aafe591738864a386608f41f9bdfa2ee"
            AuthorName: "username"
           AuthorEmail: "username@mathworks.com"
            AuthorDate: 17-Apr-2023 14:53:56 +0000
         CommitterName: "username"
        CommitterEmail: "username@mathworks.com"
         CommitterDate: 17-Apr-2023 14:53:56 +0000
         ParentCommits: "c205f677db61dc94cc5e48a4467410f45e31db4a"]

    Input Arguments

    collapse all

    Git repository, specified as a matlab.git.GitRepository object.

    Files to remove from to the Git repository, specified as a string array, character vector, or cell array of character vectors.

    Example: "myfile.m"

    Data Types: char | string | cell

    Tips

    When you perform a merge, you can use the add or rm functions to mark the conflict on a file as resolved.

    Version History

    Introduced in R2023b