# [QGIS Commit] r8982 - docs/trunk/english_us/user_guide

svn_qgis at osgeo.org svn_qgis at osgeo.org
Sat Aug 2 08:09:23 EDT 2008

Author: macho
Date: 2008-08-02 08:09:23 -0400 (Sat, 02 Aug 2008)
New Revision: 8982

Modified:
docs/trunk/english_us/user_guide/plugins_decorations.tex
docs/trunk/english_us/user_guide/plugins_delimited_text.tex
docs/trunk/english_us/user_guide/plugins_gps.tex
Log:
update to new conventions

Modified: docs/trunk/english_us/user_guide/plugins_decorations.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_decorations.tex	2008-08-02 12:08:36 UTC (rev 8981)
+++ docs/trunk/english_us/user_guide/plugins_decorations.tex	2008-08-02 12:09:23 UTC (rev 8982)
@@ -14,7 +14,7 @@

%\begin{figure}[ht]
%   \begin{center}
%\end{center}
%\end{figure}
@@ -23,11 +23,11 @@

\begin{enumerate}
\item Make sure the plugin is loaded
-\item Click on the \textsl{Copyright Label} tool on the Plugins toolbar
\item Enter the text you want to place on the map. You can use HTML as
shown in the example
-\item Choose the placement of the label from the drop-down box
-\item Make sure the Enable Copyright Label'' checkbox is checked
+\item Choose the placement of the label from the \selectstring{Placement}{Bottom Right} drop-down box
+\item Make sure the \checkbox{Enable Copyright Label} checkbox is checked
\item Click \textsl{OK}
\end{enumerate}

@@ -65,15 +65,14 @@

\begin{enumerate}
-\item Open the plugin dialog by clicking on the \textsl{Scale Bar} tool
-  on the Plugins toolbar
-\item Choose the placement from the drop-down list
-\item Choose the style
-\item Select the color for the bar, or use the default black color
-\item Set the size of the bar and its label
-\item Make sure the Enable scale bar'' checkbox is checked
+\item Click on \mainmenuopt{Plugins} > \dropmenuopt{Decorations} > \dropmenuopttwo{scale_bar}{Scale Bar} or use the \toolbtntwo{scale_bar}{Scale Bar} button from the Toolbar.
+\item Choose the placement from the \selectstring{Placement}{Bottom Left} drop-down list
+\item Choose the style from the \selectstring{Scale bar style}{Tick Down} list
+\item Select the color for the bar \selectcolor{Color of bar}{black} or use the default black color
+\item Set the size of the bar and its label \selectnumber{Size of bar}{30 degrees}
+\item Make sure the \checkbox{Enable scale bar} checkbox is checked
\item Optionally choose to automatically snap to a round number when the
-  canvas is resized
+  canvas is resized \checkbox{Automatically snap to round number on resize}
\item Click \textsl{OK}
\end{enumerate}

@@ -82,5 +81,4 @@
%   \caption{Scale Bar Plugin}\label{fig:scale_bar}\smallskip
%   \includegraphics[clip=true, width=8cm]{scale_bar}
%\end{center}
-%\end{figure}
-
+%\end{figure}
\ No newline at end of file

Modified: docs/trunk/english_us/user_guide/plugins_delimited_text.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_delimited_text.tex	2008-08-02 12:08:36 UTC (rev 8981)
+++ docs/trunk/english_us/user_guide/plugins_delimited_text.tex	2008-08-02 12:09:23 UTC (rev 8982)
@@ -1,21 +1,15 @@
-% vim: set textwidth=78 autoindent:
-
\subsection{Using the Delimited Text Plugin}\label{label_dltext}

-The Delimited Text plugin allows you to load a delimited text file as a layer
-in QGIS.
+The Delimited Text plugin allows you to load a delimited text file as a layer in QGIS.

\subsubsection{Requirements}

To view a delimited text file as layer, the text file must contain:

\begin{enumerate}
-\item A delimited header row of field names. This must be the first line in
-the text file.
-\item The header row must contain an X and Y field. These fields can have any
-name.
-\item The x and y coordinates must be specified as a number. The coordinate
-system is not important.
+\item A delimited header row of field names. This must be the first line in the text file.
+\item The header row must contain an X and Y field. These fields can have any name.
+\item The x and y coordinates must be specified as a number. The coordinate system is not important.
\end{enumerate}

An example of a valid text file might look like this:
@@ -37,30 +31,26 @@
Some items of note about the text file are:

\begin{enumerate}
-\item  The example text file uses \mbox{$|$} as delimiter. Any character can
-be used to delimit the fields.
-\item The first row is the header row. It contains the fields name, latdec,
-longdec and cell.
+\item  The example text file uses \mbox{$|$} as delimiter. Any character can be used to delimit the fields.
+\item The first row is the header row. It contains the fields name, latdec, longdec and cell.
\item No quotes ({\tt{}"{}}) are used to delimit text fields.
\item The x coordinates are contained in the {\em longdec} field.
\item The y coordinates are contained in the {\em latdec} field.
\end{enumerate}

\subsubsection{Using the Plugin}
-To use the plugin you must have QGIS running and use the Plugin Manager to
+To use the plugin you must have QGIS running and use the Plugin Manager to load the plugin:

-Start QGIS, then open the Plugin Manager by choosing the {\em
-Plugins\mbox{$|$}Plugin Manager} menu. The Plugin Manager displays a list of
-available plugins. Those that are already loaded have a check mark to the
-left of their name. Click on the checkbox to the left of the {\em Add
-Delimited Text Layer} plugin and click Ok to load it as described in Section
-\ref{sec:managing_plugins}.
+Start QGIS, then open the Plugin Manager by choosing \mainmenuopt{Plugins} > \dropmenuopttwo{mActionShowPluginManager}{Plugin Manager...}
+\index{plugins!manager}
+The Plugin Manager displays a list of available plugins.
+Those that are already loaded have a check mark to the left of their name.
+Click on the checkbox to the left of the \checkbox{Add Delimited Text Layer} plugin and click Ok to load it as described in Section \ref{sec:managing_plugins}.

A new toolbar icon is now present:
-%FIXME \includegraphics[width=0.7cm]{toolbar_icon}
-Click on the icon to open the Delimited Text dialog as shown in Figure
+\includegraphics[width=0.7cm]{delimited_text}
+Click on the icon \toolbtntwo{delimited_text}{Add Delimited Text Layer} to open the Delimited Text dialog as shown in Figure
\ref{fig:delim_text_plugin_dialog}.

%\begin{figure}[ht]
@@ -71,11 +61,9 @@
%   \end{center}
%\end{figure}

-First select the file to import by clicking on the \textit{Browse...} button.
+First select the file to import by clicking on the \browsebutton .
Select the desired text file from the file dialog.
-Once the file is selected, the plugin attempts to parse the file using the
-last used delimiter, in this case \mbox{$|$} (see Figure
-\ref{fig:delim_text_file_selected}).
+Once the file is selected, the plugin attempts to parse the file using the last used delimiter, in this case \mbox{$|$} (see Figure \ref{fig:delim_text_file_selected}).

%\begin{figure}[ht]
%   \begin{center}
@@ -84,9 +72,9 @@
%   \end{center}
%\end{figure}

-In this case the delimiter \mbox{$|$} is not correct for the file. The file is
-actually tab delimited. Note that the X and Y field drop down boxes do not
-contain valid field names.
+In this case the delimiter \mbox{$|$} is not correct for the file.
+The file is actually tab delimited.
+Note that the X and Y field drop down boxes do not contain valid field names.

%\begin{figure}[ht]
%   \begin{center}
@@ -96,9 +84,8 @@
%   \end{center}
%\end{figure}

-To properly parse the file, change the delimiter to
-tab using \mbox{$\backslash$}t (this is a regular expression for the tab
-character). After changing the delimiter, click {\em Parse}.
+To properly parse the file, change the delimiter to tab using \mbox{$\backslash$}t (this is a regular expression for the tab character).
+After changing the delimiter, click \button{Parse}.
The drop down boxes now contain the fields properly parsed as shown in Figure
\ref{fig:delim_text_file_selected2}.

@@ -110,10 +97,5 @@
%   \end{center}
%\end{figure}

-Choose the X and Y fields from the drop
-down boxes and enter a Layer name as shown in Figure
-\ref{fig:delim_text_file_selected3}. To add the layer to the
-map, click {\em Add Layer}. The delimited text file now behaves as any other
-map layer in QGIS.
-
-% html: End of file: index.html'
+Choose the X and Y fields from the drop down boxes and enter a Layer name as shown in Figure \ref{fig:delim_text_file_selected3}.
+To add the layer to the map, click {\em Add Layer}. The delimited text file now behaves as any other map layer in QGIS.
\ No newline at end of file

Modified: docs/trunk/english_us/user_guide/plugins_gps.tex
===================================================================
--- docs/trunk/english_us/user_guide/plugins_gps.tex	2008-08-02 12:08:36 UTC (rev 8981)
+++ docs/trunk/english_us/user_guide/plugins_gps.tex	2008-08-02 12:09:23 UTC (rev 8982)
@@ -2,31 +2,21 @@

\subsubsection{What is GPS?}\label{whatsgps}

-GPS, the Global Positioning System, is a satellite-based system that
-allows anyone with a GPS receiver to find their exact position anywhere
-in the world. It is used as an aid in navigation, for example in airplanes,
-in boats and by hikers. The GPS receiver uses the signals from the
-satellites to calculate its latitude, longitude and (sometimes) elevation.
-Most receivers also have the capability to store locations (known
-as \emph{waypoints}), sequences of locations that make up a planned
-\emph{route} and a tracklog or \emph{track} of the receivers movement
-over time. Waypoints, routes and tracks are the three basic feature
-types in GPS data. QGIS displays waypoints in point layers while routes
-and tracks are displayed in linestring layers.
+GPS, the Global Positioning System, is a satellite-based system that allows anyone with a GPS receiver to find their exact position anywhere in the world.
+It is used as an aid in navigation, for example in airplanes, in boats and by hikers.
+The GPS receiver uses the signals from the satellites to calculate its latitude, longitude and (sometimes) elevation.
+Most receivers also have the capability to store locations (known as \emph{waypoints}), sequences of locations that make up a planned \emph{route} and a tracklog or \emph{track} of the receivers movement over time.
+Waypoints, routes and tracks are the three basic feature types in GPS data.
+QGIS displays waypoints in point layers while routes and tracks are displayed in linestring layers.

-There are dozens of different file formats for storing GPS data. The
-format that QGIS uses is called GPX (GPS eXchange format), which is
-a standard interchange format that can contain any number of waypoints,
-routes and tracks in the same file.
+There are dozens of different file formats for storing GPS data.
+The format that QGIS uses is called GPX (GPS eXchange format), which is a standard interchange format that can contain any number of waypoints, routes and tracks in the same file.

-\includegraphics[width=0.7cm]{gps_importer} To load a GPX file you need to use the
-\emph{GPS
-Tools} plugin. When this plugin is loaded a button with a small handheld GPS
-device will show up in the toolbar (the device looks a bit like a mobile
-phone). Clicking on this button will open the \emph{GPS Tools} dialog (see
`