blob: bfd7acf086992c505f4a36338562d3faea5d6f96 [file] [log] [blame]
<?php require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/app.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/nav.class.php"); require_once($_SERVER['DOCUMENT_ROOT'] . "/eclipse.org-common/system/menu.class.php"); $App = new App(); $Nav = new Nav(); $Menu = new Menu(); include($App->getProjectCommon()); # All on the same line to unclutter the user's desktop'
$pageTitle = "Documentation for Photran";
$pageKeywords = "photran, contributors, developers";
$pageAuthor = "Jeffrey Overbey";
# Paste your HTML content between the EOHTML markers!
$html = <<<EOHTML
<div id="maincontent">
<div id="midcolumn">
<h1>$pageTitle</h1>
<div class="homeitem3col">
<h3>Documentation?</h3>
<p>Unfortunately,
there is no real documentation for
Photran at this
time.&nbsp; Documentation is an excellent way to contribute to
Photran;
if you are interested in this, please contact us.<br>
<br>
That said, Photran is highly based on the CDT, and therefore, the <a
href="http://dev.eclipse.org/viewcvs/index.cgi/%7Echeckout%7E/cdt-home/user/C_C++_Development_Toolkit_User_Guide.pdf?cvsroot=Tools_Project">CDT
User's Guide</a> translates almost directly into documentation for
Photran (although there are a few features the CDT has that Photran
does not).&nbsp; If you are not sure how a part of Photran works, try
looking there; if you're still not sure, join the <a
href="mailinglists.php">Photran mailing list</a> and
post your question there.</p>
<h4>On this page...</h4>
<ol>
<li><a href="#mm">Getting Started with Managed Make</a></li>
<li><a href="#sm">Getting Started with Standard Make</a></li>
</ol>
<h4>Elsewhere on the Photran site...</h4>
<ol>
<li><a href="refactoring.php">Overview of Refactoring Support</a></li>
</ol>
<h4>Elsewhere on the Web...</h4>
<ol>
<li><a href="http://g95.sourceforge.net/howto.html#photran">How to use Photran with g95</a>
(<a href="http://vinyl2.sentex.ca/~tcc/g95/How_to_use_Photran_with_g95.html">alternate link</a>)</li>
<!--li><a href="http://vinyl2.sentex.ca/~tcc/g95/How_to_use_mkmf_with_g95.html">How to use mkmf with g95</a></li-->
<li><a href="ftp://ftp.swcp.com/pub/walt/F/photran.pdf">Photran Tutorial</a> from the <a href="http://www.fortran.com">F Tools</a> suite (slightly outdated)</li>
</ol>
</div>
<div class="homeitem3col">
<a name="mm"></a><h3>Getting Started with Managed Make</h3>
<p>If your system has the GNU gfortran compiler installed, try this.</p>
<ol>
<li>File | New | Fortran Project </li>
<li>Call it whatever</li>
<li>Choose the Executable (Gnu Fortran) from the project type list</li>
<li>Choose GCC Toolchain from the toolchain list (you may need to uncheck
the &quot;Show project types...&quot; check box at the bottom of the
window)
<li>Click Next</li>
<li>Click on Advanced Settings</li>
<li>Expand C/C++ Build in the list on the left, and click on Settings</li>
<li>Click on the Binary Parsers tab.&nbsp; Check the appropriate
parsers for your platform. If you are using Windows, check
PE Windows Parser and/or Cygwin PE Parser; if you are using Linux,
check Elf Parser; if you are using Mac, check Mach-O parser.</li>
<li>Click on the Error Parsers tab. Check the error parser(s) for the
Fortran compiler(s) you will use.</li>
<li>Click OK</li>
<li>Click Finish</li>
<li>Click File | New | Source File </li>
<li>Call it hello.f90; click Finish</li>
<li>Type the standard "Hello, World" program, and click
File | Save.<br>
<br>
<samp>program hello<br>
&nbsp;&nbsp;&nbsp; print *, "Hello World"<br>
&nbsp;&nbsp;&nbsp; stop<br>
end program hello<br>
</samp><br>
</li>
<li>Open the Console view, and make sure "make" ran OK
and compiled your program </li>
<li>In the Fortran Projects view, expand the Binaries
entry, and click on your
executable (e.g., "whatever - [x86le]") </li>
<li>Run | Run As | Run Local C/C++ Application (yeah, I
know, it should say "Fortran Application", but it doesn't) </li>
<li>Choose GDB Debugger (Cygwin GDB Debugger if you're
under Windows) </li>
<li>Check the Console view, and make sure Hello World appeared.</li>
</ol>
</div>
<div class="homeitem3col">
<a name="sm"></a><h3>Getting Started with Standard Make</h3>
<p>To get started, try this.&nbsp; If you're under Windows, you need
to be running Cygwin, c:\cygwin\bin and c:\cygwin\usr\bin should be in
your system path, and the g95 libraries need to be copied into /usr/lib
(to make things easier for yourself, at least).</p>
<ol>
<li>File | New | Fortran Project </li>
<li>Call it whatever</li>
<li>Expand &quot;Makefile project&quot; in the project type list (it has a folder icon),
and choose Empty Project</li>
<li>Make sure &quot;-- Other Toolchain --&quot; is selected in the
toolchain list in the right-hand column, and
click Next</li>
<li>Click on Advanced Settings</li>
<li>Expand C/C++ Build in the list on the left, and click on Settings</li>
<li>Click on the Binary Parsers tab.&nbsp; Check the appropriate
parsers for your platform. If you are using Windows, check
PE Windows Parser and/or Cygwin PE Parser; if you are using Linux,
check Elf Parser; if you are using Mac, check Mach-O parser.</li>
<li>Click on the Error Parsers tab. Check the error parser(s) for the
Fortran compiler(s) you will use.</li>
<li>Click OK</li-->
<li>Click Finish</li>
<li>File | New | File </li>
<li>Call it Makefile </li>
<li>Click Finish </li>
<li>We assume you're familiar with how to format a
Makefile.&nbsp; Something like this will work for now.&nbsp;
Remember
to start the g95 line with a tab, not spaces. &nbsp;The -g switch
instructs g95 to include debugging symbols in the generated executable
so that it can be debugged later.<br>
<br>
<samp>all:<br>
&nbsp;&nbsp;&nbsp; g95 -g hello.f90<br>
<br>
clean:<br>
<br>
</samp><br>
</li>
<li>File | New | Source File </li>
<li>Call it hello.f90 </li>
<li>Click Finish </li>
<li>Type the standard "Hello, World" program.<br>
<br>
<samp>program hello<br>
&nbsp;&nbsp;&nbsp; print *, "Hello World"<br>
&nbsp;&nbsp;&nbsp; stop<br>
end program hello<br>
</samp><br>
</li>
<li>Project | Clean; then click OK </li>
<li>Open the Console view, and make sure "make" ran OK
and compiled your program </li>
<li>In the Fortran Projects view, expand the Binaries
entry, and click on your
executable (e.g., "whatever - [x86le]") </li>
<li>Run | Run As | Run Local C/C++ Application (yeah, I
know, it should say "Fortran Application", but it doesn't) </li>
<li>Choose GDB Debugger (Cygwin GDB Debugger if you're
under Windows) </li>
<li>Check the Console view, and make sure Hello World appeared.</li>
</ol>
</div>
</div>
</div>
EOHTML;
# Generate the web page
$App->generatePage($theme, $Menu, $Nav, $pageAuthor, $pageKeywords, $pageTitle, $html);
?>