README of the Matlab High level applications list.

Greg White, 15-Sep-17
Update:  02-Sep-22, site now managed by git and web site updated by
         post-receive hook, so replaced instructions on cvs with git. 
         25-Jul-19, Added making changes to matlab/documents/

This directory contains documentation on SLAC's Matlab GUIs and utilities.
The GUIs are high level matlab software applications and libraries for beam
optimization and control of the SLAC accelerator complex.

SCM: git repo at /afs/slac/g/cd/swe/git/repos/sites/www.slac.stanford.edu/grp/ad/docs/model/matlab.git
URL: https://www.slac.stanford.edu/grp/ad/docs/model/matlab
PUBLICATION: is automatic on git push. A post receive hook updates the URL on each git push to
master. See https://www.slac.stanford.edu/grp/ad/docs/model/swdev/wwwslaccheatsheet.txt

UPDATE A PAGE

To make changes to matlab/documents, and update web site http://www.slac.stanford.edu/grp/ad/docs/matlab/documents/:

0. git clone <youraccount>@rhel6-64.slac.stanford.edu:/afs/slac/g/cd/swe/git/repos/sites/www.slac.stanford.edu/grp/ad/docs/model/matlab.git

1. cd matlab

2. Make your edits
   [greg@rhel6-64i lclscvs]$ emacsx matlab/documents/programmers_guide.html

   Note the docs for bsd are Markdown.

3. git add <files-changed>
   git commit -m "summary of the changes you made"

   repeat 2 and 3 as necessary
   
4. Release to public matlab/documents web page

   git push    


==========
Tue Sep 06 17:51:11 PDT 2022
* To add to sites/matlab
+ matlabprogramers_guide
- launching matlab - 2020a, 12 etc
- matlab dev cycle with git
- primary PVs of SC timing.
- SC BSA and CU BSA
+ Add FACET Matlab programmers guide?
+ Add use fo directory service, oneliners


===================
HLA_software.xlsx is an Excel spreadsheet of the original files. GUIs mostly
by Henrik Loos and data interfaces by Greg White. 

To regenerate the web page:
0. cvs co matlab/documents with CVSROOT set to ...
1. Open HLA_software.xslx in Excel on your Mac or desktop.
2. Saving
   With AFS
   1. Make sure you have AFS mounted
   2. Select File -> Save as Web Page.
      Navigate to the AFS directory of this web page (on mac, shift-command-G) and enter
      /afs/slac/www/grp/ad/hla
      Save with filename HLA_software.htm
  
   With scp
   1. Select File -> Save as Web Page. Save to somewhere on your mac, like 
      simply the cvs co area
   2. scp -r HLA_software.htm HLA_software_files/ 'greg@rhel6-64.slac.stanford.edu:/afs/slac/www/grp/ad/docs/matlab/documents