docs drafted

git-svn-id: https://svn.osgeo.org/grass/grass/trunk@32938 15284696-431f-4ddb-bdfa-cd5b030d7da7

raster/r.external/r.external.html

@@ -1 +1,33 @@
-<!-- this needs to be written -->
+<h2>DESCRIPTION</h2>
+
+<em>r.external</em> allows a user to link a GDAL supported raster file to a binary
+raster map layer, from any GDAL supported raster map format, with an optional 
+title. The file is not imported but just registered as GRASS raster map.
+
+<h2>EXAMPLES</h2>
+
+<h3>RGB Orthophoto from GeoTIFF</h3>
+
+<div class="code"><pre>
+r.external  /home/user/data/maps/059100.tif out=ortho.1 band=1
+r.external  /home/user/data/maps/059100.tif out=ortho.2 band=2
+r.external  /home/user/data/maps/059100.tif out=ortho.3 band=3
+g.region rast=ortho.3 -p
+d.rgb r=ortho.1 g=ortho.2 b=ortho.3
+r.composite r=ortho.1 g=ortho.2 b=ortho.3 output=ortho.rgb
+</pre></div>
+
+<h2>SEE ALSO</h2>
+<em>
+<a href="r.in.gdal.html">r.in.gdal</a>
+</em>
+
+<h2>REFERENCES</h2>
+
+GDAL Pages: <a href="http://www.gdal.org">http://www.gdal.org/</a><br>
+
+<h2>AUTHOR</h2>
+
+Glynn Clements
+
+<p><i>Last changed: $Date: 2008-08-15 08:16:42 +0200 (Fri, 15 Aug 2008) $</i>