xref: /petsc/doc/changes/dev.md (revision 126519442fb4dd57a5f782a20905ab3872bce6dc)
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```{rubric} TAO:
83```
84
85```{rubric} PetscRegressor:
86```
87
88```{rubric} DM/DA:
89```
90
91-  Change the final argument of `DMShellSetDestroyContext()` to `PetscCtxDestroyFn *`. This means the destroy function must dereference the argument before operating on it
92
93```{rubric} DMSwarm:
94```
95
96```{rubric} DMPlex:
97```
98
99```{rubric} FE/FV:
100```
101
102```{rubric} DMNetwork:
103```
104
105```{rubric} DMStag:
106```
107
108```{rubric} DT:
109```
110
111```{rubric} Fortran:
112```
113