xref: /petsc/doc/changes/dev.md (revision 6e21546b67dc9c60beb879e53c80e138a9893ac6)
1# Changes: Development
2
3% STYLE GUIDELINES:
4% * Capitalize sentences
5% * Use imperative, e.g., Add, Improve, Change, etc.
6% * Don't use a period (.) at the end of entries
7% * If multiple sentences are needed, use a period or semicolon to divide sentences, but not at the end of the final sentence
8
9```{rubric} General:
10```
11
12```{rubric} Configure/Build:
13```
14
15- Make `SYCL` a `devicePackage`, i.e., builds `--with-sycl` now have `PETSC_HAVE_DEVICE` defined
16- Add the option `--with-devicelanguage` to compile `PetscDevice` code using either a C or C++ compiler
17
18```{rubric} Sys:
19```
20
21```{rubric} Event Logging:
22```
23
24```{rubric} PetscViewer:
25```
26
27-  Change the final argument of `PetscViewerGLVisSetFields()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
28
29```{rubric} PetscDraw:
30```
31
32```{rubric} AO:
33```
34
35```{rubric} IS:
36```
37
38```{rubric} VecScatter / PetscSF:
39```
40
41```{rubric} PF:
42```
43
44```{rubric} Vec:
45```
46
47```{rubric} PetscSection:
48```
49
50```{rubric} PetscPartitioner:
51```
52
53```{rubric} Mat:
54```
55
56-  Change the `destroy()` function argument of `MatShellSetMatProductOperation()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
57
58```{rubric} MatCoarsen:
59```
60
61```{rubric} PC:
62```
63
64- 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
65
66```{rubric} KSP:
67```
68
69- Remove `KSPHPDDMPrecision` in favor of `PetscPrecision`
70
71```{rubric} SNES:
72```
73
74-  Change the `destroy()` function argument of `SNESSetConvergenceTest()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
75
76```{rubric} SNESLineSearch:
77```
78
79```{rubric} TS:
80```
81
82-  Change the `destroy()` function argument of `TSTrajectorySetTransform()` to type `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
83
84```{rubric} TAO:
85```
86
87```{rubric} PetscRegressor:
88```
89
90```{rubric} DM/DA:
91```
92
93-  Change the final argument of `DMShellSetDestroyContext()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
94
95```{rubric} DMSwarm:
96```
97
98```{rubric} DMPlex:
99```
100
101```{rubric} FE/FV:
102```
103
104```{rubric} DMNetwork:
105```
106
107```{rubric} DMStag:
108```
109
110```{rubric} DT:
111```
112
113```{rubric} Fortran:
114```
115