Improve some manual pages in KSP/SNES

Merge branch 'jonas-heinzmann/sneslinesearch-addbisection' into 'main'

SNESLineSearch: add bisection line search

See merge request petsc/petsc!8028

SNESLineSearch: add bisection line search

Add new bisection line search for SNES, which proves to be useful for highly non-linear problems. The line search assumes that F(X) = grad G(X) and seeks to

SNESLineSearch: add bisection line search

Add new bisection line search for SNES, which proves to be useful for highly non-linear problems. The line search assumes that F(X) = grad G(X) and seeks to find the root in the directional derivative through bisection.
(tested in snes/tutorials/ex99)

show more ...

Merge branch 'stefanozampini/useless-cast' into 'main'

Remove useless cast

See merge request petsc/petsc!7894

Brain dead fixes for useless casts

Merge branch 'barry/2024-09-29/fix-function-typedef-style' into 'main'

Unify handling of context destructors

See merge request petsc/petsc!7900

Unifies all context destructors to have a form of PetscCtxDestroyFn == PetscErrorCode (*)(void **)

Changes the previous subset of destructor APIs that used PetscErrorCode (*)(void *) (mostly those t

Unifies all context destructors to have a form of PetscCtxDestroyFn == PetscErrorCode (*)(void **)

Changes the previous subset of destructor APIs that used PetscErrorCode (*)(void *) (mostly those that
used PetscContainer

- Now allows any context to be a PetscObject
- Will provide a cleaner mapping to bindings in other languages
- Simplifies the maintenance of PETSc source code; improves clarity

Not backward compatible, compiler warnings will tell users what functions need to be updated

show more ...

Merge branch 'jolivet/clang-format-19' into 'main'

clang-format-19

See merge request petsc/petsc!7644

CI: update checkclangformat to use clang-format-19.1.0

Merge remote-tracking branch 'origin/release'

Merge branch 'jolivet/fix-docs' into 'release'

Docs fixes

See merge request petsc/petsc!7682

Docs: fix nonexisting functions and variables

Merge branch 'barry/2024-07-01/fix-petscoptionsgetviewer' into 'main'

The use case of PetscOptionsGetViewer() has evolved to no longer be the get/restore model

See merge request petsc/petsc!7667

The use case of PetscOptionsGetViewer() has evolved to no longer be the get/restore model

Hence the code needs to be refactored

Introduce PetscCallNull() and PetscCallMPINull() to simplify PETSC_VI

The use case of PetscOptionsGetViewer() has evolved to no longer be the get/restore model

Hence the code needs to be refactored

Introduce PetscCallNull() and PetscCallMPINull() to simplify PETSC_VIEWER_XXXX_() routines

Reported-by: James Wright
Thanks-to: Jeremy L Thompson

show more ...

Merge branch 'barry/2024-05-29/minor-fortran-stub-cleanup' into 'main'

More improvements to Fortran stubs and interfaces

See merge request petsc/petsc!7598

This requires some changes to user FORTRAN code

Pass PETSC_NULL_XXX_ARRAY when passing a NULL as an argument that is expecting an array
Pass PETSC_NULL_ENUM when argument returns an enum instead of

This requires some changes to user FORTRAN code

Pass PETSC_NULL_XXX_ARRAY when passing a NULL as an argument that is expecting an array
Pass PETSC_NULL_ENUM when argument returns an enum instead of PETSC_NULL_INTEGER
Pass arrays (and not scalar values) when the argument is expecting an array; this means replace, for example, the argument v with [v]
Use PetscObjectIsNull(obj) to check if the object is NULL, instead of obj == PETSC_NULL_XXX

The compiler will now automatically prevent you from using the wrong argument type for the first three bullets above
This will also require an update sowing with the new sowing branch this MR is using.

show more ...

All constructors should do PetscAssertPointer on output object

Reported-by: Blaise Bourdin

Constructors should not initialize the output to NULL upon entry, serves no purpose

Fix some formatting i

All constructors should do PetscAssertPointer on output object

Reported-by: Blaise Bourdin

Constructors should not initialize the output to NULL upon entry, serves no purpose

Fix some formatting in constructors

show more ...

Merge branch 'barry/2024-04-13/fix-sowing-strings' into 'main'

Update PETSc to use sowing bfort that handles string arguments and PETSC_NULL_INT

See merge request petsc/petsc!7480

Update source code removing all unneeded /*@C and associated manual stubs and interfaces

Merge branch 'jolivet/clang-format-18' into 'main'

clang-format version 18

See merge request petsc/petsc!6902

Remove multiple parentheses and extra semicolon

git grep -l -E "\(\([a-zA-Z0-9_]+\)\(\*[a-zA-Z0-9_]+\)[, )]" | xargs sed -r -i'' 's#\(\(([a-zA-Z0-9_]+)\)\(\*([a-zA-Z0-9_]+)\)([, )])#\(\(\1\)\*\2\3#g

Remove multiple parentheses and extra semicolon

git grep -l -E "\(\([a-zA-Z0-9_]+\)\(\*[a-zA-Z0-9_]+\)[, )]" | xargs sed -r -i'' 's#\(\(([a-zA-Z0-9_]+)\)\(\*([a-zA-Z0-9_]+)\)([, )])#\(\(\1\)\*\2\3#g'
git grep -l -E "Petsc(.)*\(\(\*[a-zA-Z0-9_]*\)," | xargs sed -r -i'' 's#Petsc([a-zA-Z0-9_]*)\(\(\*([a-zA-Z0-9_]*)\), #Petsc\1(*\2, #g'
git grep -l -E "([\!\&\~\*\(]|\)\)|\([^,\*\(]+\**\))\(([a-zA-Z0-9_]+((\.|->)[a-zA-Z0-9_]+|\[[a-zA-Z0-9_ \%\+\*\-]+\])+)\)" | xargs sed -r -i'' 's#([\!\&\~\*\(]|\)\)|\([^,\*\(]+\**\))\(([a-zA-Z0-9_]+((\.|->)[a-zA-Z0-9_]+|\[[a-zA-Z0-9_ \%\+\*\-]+\])+)\)#\1\2#g'

show more ...

Merge branch 'barry/2024-01-19/typedef-snes-functions' into 'main'

add typedef for functions passed to SNESSetFunction() etc to match approach in TS

See merge request petsc/petsc!7206

Change the use of the _Fn suffix to indicate a typedef of a function to just Fn

As determined on a vote on GitLab

add typedef for functions passed to SNESSetFunction() etc to match approach in TS

I never liked Jed's use of typedef for function prototypes for a couple of reasons

1) you don't see immediately tha

add typedef for functions passed to SNESSetFunction() etc to match approach in TS

I never liked Jed's use of typedef for function prototypes for a couple of reasons

1) you don't see immediately that the argument to the function is a function pointer instead of standard variable when looking at source
2) you don't see at the exact location in the code the prototype of the function being passed in

but there is something to say for using these typedefs so

I've prototyped the change for SNES but slightly differently than what Jed did for TS

1) I append the typedef with _Ftn to mark that it is a function (helping to relieve the problem 1 above)
2) I made the typedef to be for a function, not a function pointer so it can also be used directly for things like

PETSC_EXTERN SNESJacobian_Ftn SNESComputeJacobianDefault;

I think the TS usage could be switched to this style without user code breakage, and deprecate the current TS typedef

Thoughts?

Just do SNES the same way as TS and live with less clarity?

show more ...

Merge branch 'jolivet/petsctrytypemethod' into 'main'

Use Petsc[Use|Try]TypeMethod when possible

See merge request petsc/petsc!7213