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