% -*- texinfo -*-
% @deftypefn {Function File} {[@var{mesh}]} = MSH3Mgmsh(@var{geometry},@var{option},@var{value},...)
%
% Construct an unstructured 3D mesh making use of the free software gmsh. Give as output the PDE-tool like mesh structure.
%
% Input:
% @itemize @minus
% @item @var{geometry}: name of the '.geo' file describing the 2D geometry. Required by gmsh to start the meshing operation.
% @item @var{option}: option to be used by gmsh
% @item @var{value}: value of the option
% @end itemize
% For more information refer to gmsh manual, or gmsh site:
%
% http://www.geuz.org/gmsh/
%
% Output: mesh basic structure, composed of the following fields
% @itemize @minus
% @item @var{p}: matrix with size 3 times number of mesh point.
% @itemize @bullet
% @item 1st row: x-coordinates of the points.
% @item 2nd row: y-coordinates of the points.
% @item 3rd row: z-coordinates of the points.
% @end itemize
% @item @var{e}: matrix with size 10 times number of mesh border edges.
% @itemize @bullet
% @item 1st row: p-matrix column number of the first edge-vertex.
% @item 2nd row: p-matrix column number of the second edge-vertex.
% @item 3rd row: p-matrix column number of the third edge-vertex.
% @item 4th row: not initialized, only for compatibility with standard PDE-tool like mesh.
% @item 5th row: not initialized, only for compatibility with standard PDE-tool like mesh.
% @item 6th row: not initialized, only for compatibility with standard PDE-tool like mesh.
% @item 7th row: not initialized, only for compatibility with standard PDE-tool like mesh.
% @item 8th row: number of the region to the right of the referred mesh edge.
% @item 9th row: number of the region to the left of the referred mesh edge.
% @item 10th row: number of the geometrical border upon which the referred mesh edge is lying on.
% @end itemize
% @item @var{t}:
% @itemize @bullet
% @item 1st row: p-matrix column number of the first tetrahedra vertex.
% @item 2nd row: p-matrix column number of the second tetrahedra vertex.
% @item 3rd row: p-matrix column number of the third tetrahedra vertex.
% @item 4th row: p-matrix column number of the fourth tetrahedra vertex.
% @item 5th row: number of the region upon which the referred trg is lying on.
% @end itemize
% @end itemize
%
% @seealso{MSH2Mgmsh,MSH2Mjoinstructm,MSH2Msubmesh}
% @end deftypefn