195f7d040SSatish Balay# Changes: Development 295f7d040SSatish Balay 395f7d040SSatish Balay% STYLE GUIDELINES: 495f7d040SSatish Balay% * Capitalize sentences 595f7d040SSatish Balay% * Use imperative, e.g., Add, Improve, Change, etc. 695f7d040SSatish Balay% * Don't use a period (.) at the end of entries 795f7d040SSatish Balay% * If multiple sentences are needed, use a period or semicolon to divide sentences, but not at the end of the final sentence 895f7d040SSatish Balay 995f7d040SSatish Balay```{rubric} General: 1095f7d040SSatish Balay``` 1195f7d040SSatish Balay 1295f7d040SSatish Balay```{rubric} Configure/Build: 1395f7d040SSatish Balay``` 1495f7d040SSatish Balay 1593d84e17SPierre Jolivet- Make `SYCL` a `devicePackage`, i.e., builds `--with-sycl` now have `PETSC_HAVE_DEVICE` defined 16c95305b8SPierre Jolivet- Add the option `--with-devicelanguage` to compile `PetscDevice` code using either a C or C++ compiler 1793d84e17SPierre Jolivet 1895f7d040SSatish Balay```{rubric} Sys: 1995f7d040SSatish Balay``` 2095f7d040SSatish Balay 2195f7d040SSatish Balay```{rubric} Event Logging: 2295f7d040SSatish Balay``` 2395f7d040SSatish Balay 245268dc8aSHong Zhang- Add two approaches for GPU energy monitoring: `-log_view_gpu_energy` and `-log_view_gpu_energy_meter` 255268dc8aSHong Zhang- Add API `PetscLogGpuEnergy()`, `PetscLogGpuEnergyMeter()`, `PetscLogGpuEnergyMeterBegin()` and `PetscLogGpuEnergyMeterEnd()` for GPU energy monitoring 265268dc8aSHong Zhang 2795f7d040SSatish Balay```{rubric} PetscViewer: 2895f7d040SSatish Balay``` 2995f7d040SSatish Balay 30e6aa7a3bSBarry Smith- Change the final argument of `PetscViewerGLVisSetFields()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 31e6aa7a3bSBarry Smith 3295f7d040SSatish Balay```{rubric} PetscDraw: 3395f7d040SSatish Balay``` 3495f7d040SSatish Balay 3595f7d040SSatish Balay```{rubric} AO: 3695f7d040SSatish Balay``` 3795f7d040SSatish Balay 3895f7d040SSatish Balay```{rubric} IS: 3995f7d040SSatish Balay``` 4095f7d040SSatish Balay 4195f7d040SSatish Balay```{rubric} VecScatter / PetscSF: 4295f7d040SSatish Balay``` 4395f7d040SSatish Balay 4495f7d040SSatish Balay```{rubric} PF: 4595f7d040SSatish Balay``` 4695f7d040SSatish Balay 4795f7d040SSatish Balay```{rubric} Vec: 4895f7d040SSatish Balay``` 4995f7d040SSatish Balay 5095f7d040SSatish Balay```{rubric} PetscSection: 5195f7d040SSatish Balay``` 5295f7d040SSatish Balay 5395f7d040SSatish Balay```{rubric} PetscPartitioner: 5495f7d040SSatish Balay``` 5595f7d040SSatish Balay 5695f7d040SSatish Balay```{rubric} Mat: 5795f7d040SSatish Balay``` 5895f7d040SSatish Balay 59cc1eb50dSBarry Smith- Change the `destroy()` function argument of `MatShellSetMatProductOperation()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 60*421480d9SBarry Smith- Remove `MatMissingDiagonal()`. Developers should use `MatGetDiagonalMarkers_SeqXXX()` when the functionality is needed 61cc1eb50dSBarry Smith 6295f7d040SSatish Balay```{rubric} MatCoarsen: 6395f7d040SSatish Balay``` 6495f7d040SSatish Balay 6595f7d040SSatish Balay```{rubric} PC: 6695f7d040SSatish Balay``` 6795f7d040SSatish Balay 68cf053153SJunchao Zhang- Add multi-precision support for MUMPS. One could use `-pc_precision <single, double>` to set the precision to be used by MUMPS, which can be different from `PetscScalar`'s precision 69cf053153SJunchao Zhang 7095f7d040SSatish Balay```{rubric} KSP: 7195f7d040SSatish Balay``` 7295f7d040SSatish Balay 731f08b62aSPierre Jolivet- Remove `KSPHPDDMPrecision` in favor of `PetscPrecision` 741f08b62aSPierre Jolivet 7595f7d040SSatish Balay```{rubric} SNES: 7695f7d040SSatish Balay``` 7795f7d040SSatish Balay 7812651944SBarry Smith- Change the `destroy()` function argument of `SNESSetConvergenceTest()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 7912651944SBarry Smith 8095f7d040SSatish Balay```{rubric} SNESLineSearch: 8195f7d040SSatish Balay``` 8295f7d040SSatish Balay 8395f7d040SSatish Balay```{rubric} TS: 8495f7d040SSatish Balay``` 8595f7d040SSatish Balay 8698cba041SBarry Smith- Change the `destroy()` function argument of `TSTrajectorySetTransform()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 8798cba041SBarry Smith 8895f7d040SSatish Balay```{rubric} TAO: 8995f7d040SSatish Balay``` 9095f7d040SSatish Balay 9195f7d040SSatish Balay```{rubric} PetscRegressor: 9295f7d040SSatish Balay``` 9395f7d040SSatish Balay 9495f7d040SSatish Balay```{rubric} DM/DA: 9595f7d040SSatish Balay``` 9695f7d040SSatish Balay 97e6aa7a3bSBarry Smith- Change the final argument of `DMShellSetDestroyContext()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it 98e6aa7a3bSBarry Smith 9995f7d040SSatish Balay```{rubric} DMSwarm: 10095f7d040SSatish Balay``` 10195f7d040SSatish Balay 10295f7d040SSatish Balay```{rubric} DMPlex: 10395f7d040SSatish Balay``` 10495f7d040SSatish Balay 10544a422c4SJames Wright- Add `DMPlexVecGetClosureAtDepth()` 10644a422c4SJames Wright 10795f7d040SSatish Balay```{rubric} FE/FV: 10895f7d040SSatish Balay``` 10995f7d040SSatish Balay 11095f7d040SSatish Balay```{rubric} DMNetwork: 11195f7d040SSatish Balay``` 11295f7d040SSatish Balay 11395f7d040SSatish Balay```{rubric} DMStag: 11495f7d040SSatish Balay``` 11595f7d040SSatish Balay 11695f7d040SSatish Balay```{rubric} DT: 11795f7d040SSatish Balay``` 11895f7d040SSatish Balay 11995f7d040SSatish Balay```{rubric} Fortran: 12095f7d040SSatish Balay``` 121