Main Content

rm

Mark file for deletion from Git repository

Since R2023b

collapse all in page

    Syntax

    rm(repo,files)

    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"]

    Open the Times Table App project repository and create a repository object.

    openExample("matlab/TimesTableProjectExample")
repo = gitrepo;

    Delete a file from disk.

    file = fullfile(pwd,"requirements","TimesTableRequirements.mlx");
delete(file);

    Deleting a file from disk does not remove it from source control. The status function reports the file as Missing.

    repoStatus = status(repo)

    repoStatus =

  1×1 table

                                                                                                        Status        
                                                                                                   _____________________

    C:\Workspace\TimesTableProjectExample\TimesTableApp\requirements\TimesTableRequirements.mlx         Missing

    Remove the missing file from source control.

    rm(repo,file);

    Commit the deletion to the repository.

    commit(repo,Message="Remove unused file");

    For instructions on how to restore a missing file, see discardChanges.

    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

    See Also

    | | | |

    Topics