bringONSASmFilesToONSASdocs.m

%md function used to conver .m files in the ONSAS repo to .md files in this repo
%md this function is executed from the makeAndPreview.sh file or can also be
%md executed from the bash terminal: `octave --eval "bringONSASmFilesToONSAS_docs('$ONSAS_PATH')"`
%md where \$ONSAS_PATH is the environment variable with the directory of ONSAS.m

function bringONSASmFilesToONSASdocs( dirONSASm );

  dirONSAS_docs = '../docs/src/' ;

  addpath( genpath( '../src/' ));

  ONSASmFiles = {   'src/ONSAS_solve.m' ...
                  ; 'examples/staticVonMisesTruss/onsasExample_staticVonMisesTruss.m' ...
                  ; 'examples/uniformCurvatureCantilever/onsasExample_uniformCurvatureCantilever.m' ...
                  ; 'examples/uniaxialExtension/onsasExample_uniaxialExtension.m' ...
                } ;

  MDFiles    = {   'ONSAS_solve.md' ...
                 ; 'staticVonMisesTruss.md' ...
                 ; 'cantileverBeam.md' ...
                 ; 'uniaxialExtension.md' ...
                } ;

  iniLines = {  19 ...
               ; 1 ...
               ; 1 ...
               ; 1 ...
             };

  fprintf( 'converting:\n' )
  for i=1:length( ONSASmFiles )
    fprintf([ '  - ' ONSASmFiles{i} '\n' ])
    m2md( [ dirONSASm ONSASmFiles{i} ] , [ dirONSAS_docs MDFiles{i} ] , 1, iniLines{i} ) ;
  end