diff --git a/source/docs/software/advanced-gradlerio/compiler-args.rst b/source/docs/software/advanced-gradlerio/compiler-args.rst index 2979016a53..e1dfd7e4d9 100644 --- a/source/docs/software/advanced-gradlerio/compiler-args.rst +++ b/source/docs/software/advanced-gradlerio/compiler-args.rst @@ -41,3 +41,17 @@ frcJava(getArtifactClass('FRCJavaArtifact')) { } ``` +## Deleting Unused Deploy Files + +By default the `src/main/deploy` directory in your project is transferred to the roboRIO when code is deployed. It is initiated by this section of the `build.gradle` file. + +```c +frcStaticFileDeploy(getArtifactTypeClass('FileTreeArtifact')) { + files = project.fileTree('src/main/deploy') + directory = '/home/lvuser/deploy' + deleteOldFiles = false // Change to true to delete files on roboRIO that no + // longer exist in deploy directory on roboRIO +} +``` + +This will overwrite any duplicate files found in the `/home/lvuser/deploy` directory on the RIO and copy over any additional not present there. If `deleteOldFiles` is false it will not remove any files no longer present in the project deploy directory. Changing it to `true` helps prevent programs like [Choreo](https://sleipnirgroup.github.io/Choreo/) and [PathPlanner](https://github.com/mjansen4857/pathplanner) from getting confused by files that were deleted locally but still exist on the roboRIO. diff --git a/source/docs/yearly-overview/yearly-changelog.rst b/source/docs/yearly-overview/yearly-changelog.rst index ba717734d0..194ba32fb1 100644 --- a/source/docs/yearly-overview/yearly-changelog.rst +++ b/source/docs/yearly-overview/yearly-changelog.rst @@ -165,7 +165,7 @@ Supported Operating Systems and Architectures: - Use Gradle 8.10.2 - Use shell scripts for launching tools on Linux / macOS, since macOS doesn't ship Python any more -- Add method to delete files on roboRIO that have been deleted in the deploy directory. Set deleteOldFiles to true in the frcStaticFileDeploy block +- Add method to delete files on roboRIO that have been deleted in the deploy directory. :ref:`Set deleteOldFiles to true ` in the frcStaticFileDeploy block ## WPILib All in One Installer