Updated docs for 0.7 release (still in progress)

git-svn-id: http://svn.osgeo.org/qgis/trunk@3427 c8812cc2-4d05-0410-92ff-de0c093fc19c

doc/source/user_guide/getting_started.tex

@@ -1,22 +1,32 @@
+% vim: set textwidth=78 autoindent:
 \chapter{Getting Started}
 
 This chapter gives you a quick overview of running QGIS and examining data available on the QGIS web page.
 
 
 \section{Installation}
 \index{installation}
-Installation of QGIS is documented in Appendix \ref{install_guide}. The Installation Guide is distributed with the QGIS source code and is also available at \url{http://qgis.org}. Under Windows and Mac OSX, QGIS is available as a standard installer package for these platforms.
+Installation of QGIS is documented in Appendix \ref{install_guide}. The
+Installation Guide is distributed with the QGIS source code and is also
+available at \url{http://qgis.org}. Under Windows and Mac OSX, QGIS is
+available as a standard installer package for these platforms. Packages for
+many flavors of Linux are also available. 
 
 
 \section{Sample Data}
-\index{data!sample}
-If you do not have any GIS data handy, you can obtain a dataset for Alaska from the QGIS web site at \url{http://qgis.org}. The Alaska data set will be used as the basis for many of the examples and screenshots provided in this document.
+\index{data!sample} If you do not have any GIS data handy, you can obtain a
+dataset for Alaska from the QGIS web site at \url{http://qgis.org}. The Alaska
+data set will be used as the basis for many of the examples and screenshots
+provided in this document.
 
 
 \section{Starting QGIS}
 
-Assuming that QGIS is installed in the PATH, you can start QGIS by
-typing: \textbf{qgis}  at a command prompt or by double clicking on the QGIS application link (or shortcut) on the desktop. Under MS Windows, start QGIS using the Start menu shortcut, and under Mac OSX, double click the icon in your applications folder.
+Assuming that QGIS is installed in the PATH, you can start QGIS by typing:
+\textbf{qgis}  at a command prompt or by double clicking on the QGIS
+application link (or shortcut) on the desktop. Under MS Windows, start QGIS
+using the Start menu shortcut, and under Mac OSX, double click the icon in
+your Applications folder.
 %\begin{figure}
 %\caption{QGIS Main Window}
 %\end{figure} 
@@ -26,7 +36,7 @@ \subsection{Command Line Options}\index{command line options}
 statement for QGIS is:
 \small
 \begin{verbatim}
-Usage: /home/gsherman/qgis06_rc/bin/qgis [options] [FILES]
+Usage: /home/gsherman/qgis07_rc/bin/qgis [options] [FILES]
   options:
         [--snapshot filename]   emit snapshot of loaded datasets to given file
         [--lang language]       use language for interface text
@@ -54,17 +64,19 @@ \subsection{Command Line Options}\index{command line options}
 \end{Tip}
 
 \section{The QGIS Main Window}\index{main window}
-When QGIS starts, you are presented with the main window as shown below.
+When QGIS starts, you are presented with the main window as shown below (the
+numbers 1 through 6 in blue ovals refer to the six major areas of the
+interface as discussed below):
 
 \begin{figure}[h]
    \begin{center}
    \caption{Main window}\label{fig:startup}
-   \includegraphics[scale=.5]{qgis_user_guide_images/startup}
+   \includegraphics[scale=.7]{qgis_user_guide_images/startup}
 \end{center}  
 
 \end{figure}
 \textsc{Note - Your window decorations (title bar, etc.) may appear different depending on your operating system and window manager}
-The QGIS main window is divided into five areas:
+The QGIS main window is divided into six areas:
 \begin{compactenum}
 \item The menu bar
 \item The tool bar
@@ -77,13 +89,13 @@ \section{The QGIS Main Window}\index{main window}
 These six components of the QGIS interface are described in more detail in the following sections
 \subsection{The QGIS menu bar}
 \index{menus}
-The menu bar provides access to various QGIS features using a standard windows
+The menu bar provides access to various QGIS features using a standard 
 heirachical menu. The top-level menus and a summary of some of the functions provided are:
 \begin{compactitem}
 \item File (project open, save, export image, properties)
-\item Layer (add, show, hide layers)
 \item View (zoom, refresh)
-\item Tools (plugin manager, preferences)
+\item Layer (add, show, hide layers)
+\item Settings (plugin manager, preferences)
 \item Plugins (menus added by plugins as they are loaded)
 \item Help (documentation and web links)
 \end{compactitem}
@@ -94,7 +106,11 @@ \subsection{Toolbars}
 The toolbars provide access to most of the same functions as the menus, plus
 additional tools for interacting with the map. Each toolbar item has popup
 help available. Hold your mouse over the item and a short description of the
-tool's purpose will be displayed. %See Appendix \ref{app_toolbar} for complete
+tool's purpose will be displayed. You can also use the \textit{Whats This?}
+tool (the arrow with a question mark next to it) to get more information about
+the tools and other components of the QGIS interface. To use it, click on the
+\textit{Whats This?} button and then click on the item of interest to display
+the information. %See Appendix \ref{app_toolbar} for complete
 %descriptions and illustrations of the various toolbars.  
 
 \subsection{The QGIS map legend}
@@ -111,34 +127,58 @@ \subsection{The QGIS map legend}
 
 Each legend entry can show the following mini icons:
 
-\includegraphics[scale=1]{qgis_user_guide_images/pyramid} This is a raster layer that has pyramids built for it to improve rendering efficiency (see Section \ref{raster_pyramids}).\\
-\includegraphics[scale=1]{qgis_user_guide_images/no_pyramid} This is a raster that has no pyramid layers (see Section \ref{raster_pyramids}).\\
-\includegraphics[scale=1]{qgis_user_guide_images/inoverview} This layer is shown in the overview map area as well as in the main map window.\\
-\includegraphics[scale=1]{qgis_user_guide_images/editable} This is a vector layer that is currently enabled for editing.\\
+\includegraphics[scale=1]{qgis_user_guide_images/pyramid} This is a raster
+layer that has pyramids built for it to improve rendering efficiency (see
+Section \ref{raster_pyramids}).\\
+\includegraphics[scale=1]{qgis_user_guide_images/no_pyramid} This is a raster
+that has no pyramid layers (see Section \ref{raster_pyramids}).\\
+\includegraphics[scale=1]{qgis_user_guide_images/inoverview} This layer is
+shown in the overview map area as well as in the main map window.\\
+\includegraphics[scale=1]{qgis_user_guide_images/editable} This is a vector
+layer that is currently enabled for editing.\\
+
 \subsection{The QGIS map view}
 \index{map!view}
 This is the 'business end' of QGIS - maps are displayed in this area! The map
 displayed in this window will depend on the vector and raster layers you have
-chosen to load (see sections that follow for more info on this). The map view
-can be panned (shifting to focus of the map display to another region), zoomed
-in and out, and supports various other actions as described in the toolbar
-description above.  The map view and the legend are tightly bound to each
-other - the maps in view reflect changes you make in the legend area.  
+chosen to load (see sections that follow for more info on how to load layers).
+The map view can be panned (shifting the focus of the map display to another
+region) and zoomed in and out. Various other operations can be performed on
+the map as described in the toolbar description above.  The map view and the
+legend are tightly bound to each other - the maps in view reflect changes you
+make in the legend area.  
 \begin{Tip}\caption{\textsc{Zooming the Map with the Mouse
 Wheel}}\index{zoom!mouse wheel}
 \qgistip{You can use the mouse wheel to zoom in and out on the map. Place the mouse cursor inside the map area and roll it forward (away from you) to zoom in and backwards (towards you) to zoom out.
 }
 \end{Tip}
 \subsection{The QGIS map overview}
 \index{map!overview}
-The map overview area provides a full extent view of layers added to it. Within the view is a rectangle showing the current map extent. This allows you to quickly determine which area of the map you are currently viewing. Note that labels are not rendered to the map overview even if the layers in the map overview have been set up for labelling.
+The map overview area provides a full extent view of layers added to it.
+Within the view is a rectangle showing the current map extent. This allows you
+to quickly determine which area of the map you are currently viewing. Note
+that labels are not rendered to the map overview even if the layers in the map
+overview have been set up for labelling. You can add a single layer to the
+overview by right-clicking on it in the legend and choosing \textit{Toggle in
+Overview}. You can also add or remove all layers to the overview using the
+\textit{Add to Overview tool} on the toolbar.
 
 \subsection{The QGIS map status bar} 
-The status bar shows you your current position in map coordinate (e.g. meters
-or decimal degress) as the mouse pointer is moved accross the map view. The status bar also shows the view extents of the map view as you pand and zoom in and out. A progress bar in the status bar shows progress of rendering as each layer is drawn to the map view. In some cases such as the gathering of statistics in raster layers, the progress bar will be used to show the status of lengthy operations. At the end of the status bar is a small checkbox which can be used to temporarily prevent layers being rendered to the map view )see Section \ref{subsec:redraw_events} below.
+The status bar shows you your current position in map coordinates (e.g. meters
+or decimal degress) as the mouse pointer is moved accross the map view. The
+status bar also shows the view extents of the map view as you pan and zoom in
+and out. A progress bar in the status bar shows progress of rendering as each
+layer is drawn to the map view. In some cases, such as the gathering of
+statistics in raster layers, the progress bar will be used to show the status
+of lengthy operations. On the right side of the status bar is a small checkbox which
+can be used to temporarily prevent layers being rendered to the map view )see
+Section \ref{subsec:redraw_events} below. At the far right of the status bar
+is a projector icon. Clicking on this opens the projection properies for the
+current project.
 
 \section{Rendering}\label{subsec:redraw_events}\index{rendering}
-By default, QGIS renders all visible layers whenever the map canvas must be refreshed. The events that trigger a refresh of the map canvas include:
+By default, QGIS renders all visible layers whenever the map canvas must be
+refreshed. The events that trigger a refresh of the map canvas include:
 \begin{compactitem}
 \item Adding a layer
 \item Panning or zooming
@@ -155,7 +195,7 @@ \subsection{Scale Dependent Rendering}\index{rendering!scale dependent}
 the \textit{Use scale dependent rendering} checkbox.
 
 You can determine the scale values by first zooming to the level you want to use
-an noting the scale value in the QGIS status bar.\index{scale}
+and noting the scale value in the QGIS status bar.\index{scale}
 \subsection{Controlling Map Rendering}
 Map rendering can be controlled in the following ways:
 \begin{compactenum}
@@ -194,10 +234,10 @@ \subsection{Updating the Map Display During Rendering}\index{rendering!update
 You can set an option to update the map display as features are drawn. By
 default, QGIS does not display any features for a layer until the entire layer
 has been rendered. To update the display as features are read from the
-datastore, choose \textit{Preferences} from the
-\textit{Settings} menu and click on the \textit{Rendering} tab. Set the feature
-count to an appropriate value to update the display during rendering. Setting a
-value of 0 disables update during drawing (this is the default). Setting a value
-too low will result in poor performance as the map canvas is continually updated
-during the reading of the features. A suggested value to start with is 500. 
+datastore, choose \textit{Preferences} from the \textit{Settings} menu and
+click on the \textit{Rendering} tab. Set the feature count to an appropriate
+value to update the display during rendering. Setting a value of 0 disables
+update during drawing (this is the default). Setting a value too low will
+result in poor performance as the map canvas is continually updated during the
+reading of the features. A suggested value to start with is 500. 
 

doc/source/user_guide/introduction.tex

@@ -1,8 +1,28 @@
+
 \chapter{Introduction}
 
-Welcome to the wonderful world of Geographical Information Systems (GIS)! Quantum GIS (QGIS) is an Open Source Geographic Information System. The project was born in May of 2002 and was established as a project on SourceForge in June of the same year. We've worked hard to make GIS software (which is traditionaly expensive commerical software) a viable prospect for anyone with basic access to a Personal Computer. QGIS currently runs on most Unix platforms, Window, and OS X. QGIS is developed using the Qt toolkit (\url{http://www.trolltech.com}) and C++. This means that QGIS feels snappy to use and has a pleasing, easy to use graphical user interface. 
+Welcome to the wonderful world of Geographical Information Systems (GIS)!
+Quantum GIS (QGIS) is an Open Source Geographic Information System. The project
+was born in May of 2002 and was established as a project on SourceForge in June
+of the same year. We've worked hard to make GIS software (which is traditionaly
+expensive commerical software) a viable prospect for anyone with basic access
+to a Personal Computer. QGIS currently runs on most Unix platforms, Window, and
+OS X. QGIS is developed using the Qt toolkit (\url{http://www.trolltech.com})
+and C++. This means that QGIS feels snappy to use and has a pleasing, easy to
+use graphical user interface. 
 
-QGIS aims to be an easy to use GIS, providing common functions and features. The initial goal was to provide a GIS data viewer. QGIS has reached that point in its evolution and is being used by many for their daily GIS data viewing needs. QGIS supports a number of raster and vector data formats, with new support easily added using the plugin architecture (see Appendix \ref{appdx_data_formats} for a full list of currenly supported data formats). QGIS is released under the GNU Public License (GPL). Devloping QGIS under this license means that you can (if you want to) inspect and modify the source code and guarantees that you, our happy user will always have access to a GIS program that is free of cost and can be freely modified. You should have received a full copy of the license with your copy of QGIS, and is also available as Appendix \ref{gpl_appendix}.  
+QGIS aims to be an easy to use GIS, providing common functions and features.
+The initial goal was to provide a GIS data viewer. QGIS has reached that point
+in its evolution and is being used by many for their daily GIS data viewing
+needs. QGIS supports a number of raster and vector data formats, with new
+support easily added using the plugin architecture (see Appendix
+\ref{appdx_data_formats} for a full list of currenly supported data formats).
+QGIS is released under the GNU Public License (GPL). Devloping QGIS under this
+license means that you can (if you want to) inspect and modify the source code
+and guarantees that you, our happy user will always have access to a GIS
+program that is free of cost and can be freely modified. You should have
+received a full copy of the license with your copy of QGIS, and is also
+available as Appendix \ref{gpl_appendix}.  
 \begin{quote}
 \begin{center}
 \textbf{Note:} The latest version of this document can always be found at \newline
@@ -19,6 +39,9 @@ \section{Major Features}
 \item Support for spatially enabled PostgreSQL tables using PostGIS 
 \item Support for ESRI shapefiles and other vector formats support by the
 OGR library, including MapInfo files 
+\item GRASS integration, including view, edit, and analysis
+\item On the fly projection of vector layers
+\item Map composer
 \item Identify features 
 \item Display attribute table 
 \item Select features 
@@ -32,37 +55,33 @@ \section{Major Features}
 or landsat imagery 
 \item Change raster symbology (grayscale, pseudocolor and multiband RGB) 
 \item Export to Mapserver map file 
-\item Preliminary digitizing support
+\item Digitizing support
 \item Map overview
 \item Plugins 
 \end{compactenum}
 
 
-\section{Whats New in 0.6}
-QGIS is still under development. In this release many new features have become available including:
+\section{Whats New in 0.7}
+Version 0.7 brings several important features, including projection support, a map composer, and better integration with GRASS. The major new features in this release include:
 \begin{compactenum}
-\item GEOS support in the OGR provider to refine selection of features via identify. This improves over the previous method of feature selection which used a simple MBR intersection check.
-\item PostGIS editing support in provider
-\item Vector dialog redesign to improve usability
-\item Improvement in project handling (loading and saving)
-\item Scale dependent rendering
-\item User option to load layers with out drawing them, thus allowing you to set scale dependency, etc without waiting for the initial draw to complete
-\item Interrupt drawing of features by hitting ESC
-\item Attribute actions - the ability to run an external program based on the contents of an attribute field in a layer
-\item Create new vector layer (shapefile) for editing
-\item Windows installer
- Mac OSX binary
-\item New options in the graticule builder plugin
-\item Enhancements to the GPS plugin
-\item Man page
-\item Save delimited text as shapefile
-\item Improved Delimited Text plugin, including preview of text file
-\item Improved SPIT handling of PostgreSQL reserved words and shapefiles with multiple geometry types
-\item Display SQL query used to create a PostGIS layer
-\item PostgreSQL query builder
-\item Ability to redefine the query used for PostgreSQL layers from the layer properties dialog
-\item North arrow, scalebar, and copyright plugins save their state in the project file
-\item Datasets with UTF8, Kanjii and CJK filenames now load properly
-
+  \item On the fly projection for reprojecting layers in different coordinate systems
+  \item Map Composer for creating print layouts
+  \item Toolbox for running GRASS tools from QGIS
+  \item Raster graphing tool to produce a histogram for a raster layer.
+  \item Raster query using the identify tool to get the pixel
+  values from a raster 
+  \item New customizable settings for the digitizing line width, color, and selection color  
+  \item New symbols for use with point layers are available from the layer properties dialog 
+  \item Spatial bookmarks allow you to create and manage bookmarks for an area on the map
+  \item Measure tool to measure distances on the map with both
+  segment length and total length displayed as you click
+  \item GPX loading times and memory consumption for large GPX (GPS) files
+  has been drastically reduced.  
+  \item Digitizing enhancements, including the ability to capture data straight
+  into PostgreSQL/PostGIS, and improvements to the definition of attribute tables
+  for newly created layers.
+  \item Raster Georeferencing plugin can be used
+  to generate a world file for a raster by defining known
+  control points in the raster coordinate system.
 \end{compactenum}
 

doc/source/user_guide/qgis_user_guide.tex

@@ -39,7 +39,7 @@
 \title{
 \includegraphics[scale=0.4]{qgis_user_guide_images/qgis_icon_new_verylarge}\\
 Quantum GIS User Guide\\
-\large Version 0.6 \textsl{'Simon'}}
+\large Version 0.7 \textsl{'Seamus'}}
 \author{Gary E. Sherman \\Tim Sutton \\Radim Blazek (GRASS) \\ Lars Luthman (GPS Plugin)\\
 \date{\mydate\today}
 }
@@ -63,7 +63,7 @@
 %\fancyfoot[C]{\thepage}
 \pagestyle{fancy}
 \fancyhead[L]{QGIS User Guide}
-\fancyhead[R]{\textsl{Version 0.6}}
+\fancyhead[R]{\textsl{Version 0.7}}
 
 \pagenumbering{arabic}
 \begin{onehalfspace}