g.mapset manual: example added (contributed by Jerry Huang and Google Code-in); examples restructured

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

general/g.mapset/g.mapset.html

@@ -20,6 +20,41 @@ history -r /"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
 HISTFILE=/"$GISDBASE/$LOCATION/$MAPSET"/.bash_history
 </pre></div>
 
+<h2>EXAMPLES</h2>
+
+<h3>Print the name of the current mapset</h3>
+
+To print the name of the current mapset, use the <b>-p</b> command as
+shown below:
+<div class="code"><pre>
+g.mapset -p
+</pre></div>
+
+
+<h3>List available mapsets</h3>
+To list available mapsets, use the <b>-l</b> command as shown below:
+<div class="code"><pre>
+g.mapset -l
+</pre></div>
+
+This should list all the mapsets, such as: "landsat new PERMANENT user1."
+
+<h3>Change the current mapset</h3>
+To change the current mapset to "user1" use the following command:
+
+<div class="code"><pre>
+g.mapset mapset=user1 location=nc_spm_08_grass7
+</pre></div>
+
+You should receive the following message: "Mapset switched. Your shell
+continues to use the history for the old mapset." 
+
+<h3>Create a new mapset</h3>
+
+To create a new mapset, use the <b>-c</b> tag as shown below:
+<div class="code"><pre>
+g.mapset -c mapset=new location=nc_spm_08_grass7
+</pre></div>
 
 <h2>SEE ALSO</h2>