Update documentation of some public API routines

Fix missing return

Fixing a nasty memory corruption bug in non-zero allocation and set zero entries. And other miscellaneous cleanups.

Merge remote-tracking branch 'upstream/master'

Merge branch 'master' into prbrune/snes-fascontinuation

* master: (855 commits)
fix for moab example had wrong blocksize of mapping
docs:remove src/docs/doxygen/manual [per Barry's instructions]

Merge branch 'master' into prbrune/snes-fascontinuation

* master: (855 commits)
fix for moab example had wrong blocksize of mapping
docs:remove src/docs/doxygen/manual [per Barry's instructions]
gfortran: remove 132 char limit from f90 free-form
SNES: Set up matrix-free *after* copying the user Jacobian to snes->pc
DMPlex-Gmsh: Use trueNumCells when building the coordinate section
Sys: Got guard logic reversed
Sys: The #define guard for PetscMalloc*() must match the one for PetscFree*()
PetscFV: I hate fucking complex
removed ltog scatter from DMDA since functionality can be obtained with gtol scatter and less memory
fix test of DMLocalToGlobalBegin/End and add actual test cases
improve object memory logging for DA, ISLocalToGlobal and ISBLOCK
lower high water mark of constructing parallel scatter by allocating only as much room in svalues as needed
owner in VecScatter construction is the rank, therefor can use PetscMPIInt to hold it do not PetscInt
another reuse of allocated array in 2d/3d DMDA create
improved high water mark of DMDASetups by implementing and using PETSC_USE_POINTER for ISCreateBlock()
PetscFV: Another complex fix
DMPlex+TS: Fixing types
ISIdentity() was wrong for block IS! Indices are NOT scaled by bs
PetscFV: Straighten out complex types
TS ex11: Fix casts and remove unused variable
...

show more ...

Merge branch 'master' into barry/saws-options

Merge branch 'jed/dmda-memusage'

Merge branch 'master' into stefano_zampini/pcbddc-multilevel-improvement

Conflicts:
src/docs/website/documentation/changes/dev.html
src/ksp/ksp/examples/tutorials/ex59.c
src/ksp/pc/impls/bddc/bdd

Merge branch 'master' into stefano_zampini/pcbddc-multilevel-improvement

Conflicts:
src/docs/website/documentation/changes/dev.html
src/ksp/ksp/examples/tutorials/ex59.c
src/ksp/pc/impls/bddc/bddcprivate.c

show more ...

removed use of block mapping in moab dxx code and documentation

added bs argument to ISLocalToGlobalMappingCreate(), not yet used for bs > 1

Merge branch 'master' into shri/ts-events

Conflicts:
src/ts/interface/ts.c

Merge branch 'master' into shri/feature-dm-circuit

Conflicts:
src/dm/impls/makefile

Adding the BlockSetFills capability for DMMoab.

Merge branch 'master' into prbrune/snes-fascontinuation

Conflicts:
include/petscsnesfas.h

Add the capability to access the block or material number for each entity.

Updating DMMoab interface to the latest PETSc changes related to PetscNew. Removing occurrences of stringstream and replacing with PetscSNPrintf for manipulating IO options.

Adding DMSetFromOptions_Moab to unify all options database retrieval from command line. Added appropriate storage fields in data-structures and made sure that they are universally used, consistently.

Adding DMSetFromOptions_Moab to unify all options database retrieval from command line. Added appropriate storage fields in data-structures and made sure that they are universally used, consistently. Still need to figure out: how to propagate read options to DM before DMSetFromOptions is called.

show more ...

Fix a bug when user provides a ltog_tag that is invalid and expects a valid one back on call to DMMoabCreateMoab. Other misc cleanups in examples.

Adding more documentation to all main source files and making sure the documentation is generated according to PETSc standards.

Adding documentation to describe DMMOAB type.

Documentation updates for all the DMMoab implementation sources and re-arranging routines to place public API first and static/private routines next.

Making sure that the interface is const correct when dealing with MOAB objects on the getter methods.

Adding a public API method DMMoabGetOffset to get the local offset when dealing with global spaces for Vec/Mat.

Rename nfields->numFields and fields->fieldNames to be consistent with PetscSection. Need to make a move eventually to this structure to handle the internal field and point DOF.

Adding a variable to store ghosted elements. Change the public API to retrieve local and ghosted vertices/element sizes.