Editing Tutorial (section)

==Getting started==
Before you can get started writing reproducible documents, you need to ensure that your system is properly setup.  This section of the tutorial will walk you through the setup process, which can be somewhat difficult and laborious depending on which operating system you are on, as you will need a full installation of L<sup>A</sup>TEX and additional L<sup>A</sup>TEX class files that Madagascar makes available to you. The good news is that this configuration only happens once.
===Downloading L<sup>A</sup>TEX===
To begin, you need to download a full installation of L<sup>A</sup>TEX for your operating system.  To do so, you may need to contact your system administrator.  If you have administrative rights, then you can download a full install for your platform from the following locations:
  
*Linux - use your package management software to install a full texlive (you may need additional packages depending on your distribution). 
*Mac - install MacTex http://www.tug.org/mactex/2011/. 
*Windows - install MikTex http://miktex.org/. 
The respective downloads typically are quite large and take a substantial amount of time to complete, so start the download and come back later.  Once your download is done, test your installation by executing '''pdflatex'''  at the command line.  If everything works fine then continue onwards. For Mac users, you may need "sudo port install texlive-latex-extra".

===Downloading SEGTeX===
The next step is to download the SEG\TeX class files, which tells L<sup>A</sup>TEX how to build certain documents that we commonly use.  To download SEG\TeX first '''cd'''  to a directory where L<sup>A</sup>TEX can find additional class files.  This directory is typically operating system dependent, and may be distribution dependent for Linux.  Typically, you can place these files in '''&#36;HOME/texmf''' .  Otherwise, you will need to place them in the root installation for Latex which can be found by searching for the basic class files, such as article.cls.  On a Mac the typical place to put these files is '''&#36;HOME/Library/texmf''' .  In any case, once you are in the proper location, then use the following command to download the class files (using subversion):
<pre>
svn co https://segtex.svn.sourceforge.net/svnroot/segtex/trunk texmf 
</pre>
or download a stable release from http://sourceforge.net/projects/segtex/files/ and unpack it into the <tt>texmf</tt> directory.
===Updating your L<sup>A</sup>TEX install===
Once the class files are successfully downloaded, you will need to run '''texhash'''  or '''texconfig rehash'''  to update L<sup>A</sup>TEX about the new class files.  For reference, a successful run of '''texhash'''  produces the following output:
<pre>
jgodwin&#36; texhash
texhash: Updating /usr/local/texlive/2010/../texmf-local/ls-R... 
texhash: Updating /usr/local/texlive/2010/texmf/ls-R... 
texhash: Updating /usr/local/texlive/2010/texmf-config/ls-R... 
texhash: Updating /usr/local/texlive/2010/texmf-dist/ls-R... 
texhash: Updating /usr/local/texlive/2010/texmf-var/ls-R... 
texhash: Done.
</pre>
To determine if these files are found successfully, go into &#36;RSFROOT/book/rsf/manual and run '''scons manual.read''' .  If L<sup>A</sup>TEX complains about being unable to find the class files then you should re-run texhash, or make sure that your class files are in the proper location.  If you are still having difficulties, then contact the [[SEGTeX|SEGTeX webpage]] or the user mailing list for further information.