db.login: update manual + module usage description (cosmetics)

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

db/db.login/db.login.html

@@ -1,30 +1,33 @@
 <h2>DESCRIPTION</h2>
 
-<em>db.login</em> sets user/password for driver/database.
+<em>db.login</em> sets user and optionally also password for
+connection to the selected <b>database</b> through DB <b>driver</b>.
 
 <h2>NOTE</h2>
 
-This is only related to SQL database backends (PostgreSQL, MySQL etc).
-The passwords are stored in a hidden file in the user account ('home' 
-directory) called <em>.grasslogin6</em>. Only the file owner
-can access this file.
+This is only related to SQL database backends
+like <a href="grass-pg.html">PostgreSQL</a>, <a href="grass-mysql.html">MySQL</a>
+or <a href="grass-odbc.html">ODBC</a>. The passwords are stored in a
+hidden unencrypted file in the user account ('home' directory)
+called <em>.grass7/dblogin</em>. Only the file owner can access this
+file.
 
 <h2>EXAMPLES</h2>
 
-Example 1: Username specified, password will be invisibly queried interactively:
+Username specified only:
 
 <div class="code"><pre>
 db.login user=bacava
 </pre></div>
 
-<p>Example 2: Username and password specified (note that the command
+<p>Username and password specified (note that the command
 lines history will store the password in this way):
 
 <div class="code"><pre>
 db.login user=bacava pass=secret
 </pre></div>
 
-<p>Example 3: Username and empty password specified (note that the command
+<p>Username and empty password specified (note that the command
 lines history will store the password in this way):
 
 <div class="code"><pre>
@@ -37,8 +40,12 @@ db.login user=bacava pass=""
 <a href="db.test.html">db.test</a>
 </em>
 
+<p>
+<a href="sql.html">SQL support in GRASS GIS</a>
+
 <h2>AUTHOR</h2>
 
 Radim Blazek
 
-<p><i>Last changed: $Date$</i>
+<p>
+<i>Last changed: $Date$</i>

db/db.login/main.c

@@ -6,7 +6,7 @@
  *               Glynn Clements <glynn gclements.plus.com>
  *               Markus Neteler <neteler itc.it>
  * PURPOSE:      Store db login settings
- * COPYRIGHT:    (C) 2004-2009, 2012 by the GRASS Development Team
+ * COPYRIGHT:    (C) 2004-2014 by the GRASS Development Team
  *
  *               This program is free software under the GNU General
  *               Public License (>=v2). Read the file COPYING that
@@ -54,7 +54,7 @@ int main(int argc, char *argv[])
     user->type = TYPE_STRING;
     user->required = NO;
     user->multiple = NO;
-    user->description = _("Username");
+    user->description = _("Username to set for DB connection");
     user->guisection = _("Settings");
     
     password = G_define_option();
@@ -62,7 +62,7 @@ int main(int argc, char *argv[])
     password->type = TYPE_STRING;
     password->required = NO;
     password->multiple = NO;
-    password->description = _("Password");
+    password->description = _("Password to set for DB connection");
     password->guisection = _("Settings");
 
     if (G_parser(argc, argv))