[GRASS5] [bug #1434] (grass) the *.in.* man pages don't mention the file extensions they deal with

[Request Tracker]

this bug's URL: http://intevation.de/rt/webrt?serial_num=1434
-------------------------------------------------------------------------

The various *.in.* man pages should mention what file extensions they
deal with.

For instance
$ man v.in.arc
does not mention up front that it deals with file.ABC or file.EFG

It says 
The v.in.arc program will convert
       vector  data  in  ARC/INFO's  "Generate" format to GRASS's
       vector file format, and bring it into the  user's  current
       GRASS  mapset.

Hmm, those files maybe are called file.GEN or file.ARC: who knows. The
man page assumes one knows.

$ man v.in.shape|grep -i shp
is another example showing that the author doesn't think it is
necessary to mention the extensions of files the command deals with,
as the user certainly has years of GIS background.

Oh, the shp file apparently has more to do with r.in.shape ... ok,
wish the v.in.shape man page would mention that.

Mainly all *.in.shape man pages should mention all the things you
might want to do with all the different file extensions one might
encounter.

BTW on the man page it says
  NOTE
       r.in.shape   creates   ASCII   file  first  and  then  run
       r.in.poly.

you better say "runs" or else we think we should run it ourselves. 

By the way, the s.in.shape man page says
       Grass files created have the name extracted from the base
       name of the shapefile.

i.e. s.in.shape doesn't accept a out= parameter, whereas r.in.shape
and v.in.shape wont work without one!

also error messages arent informative:
$ s.in.shape /var/tmp/ec5212NW/EC5212NW    
ERROR: Unable to process shapefile - Aborting.
-- 
http://jidanni.org/ Taiwan(04)25854780


--- Headers Follow ---

>From jidanni at dman.ddts.net  Wed Nov 20 09:41:22 2002
Return-Path: <jidanni at dman.ddts.net>
Delivered-To: grass-bugs at lists.intevation.de
Received: from mail.intevation.de (aktaia [212.95.126.10])
	by lists.intevation.de (Postfix) with ESMTP id A09A81394F
	for <grass-bugs at lists.intevation.de>; Wed, 20 Nov 2002 09:41:22 +0100 (CET)
Received: from smtp.u2online.com.tw (NK210-200-180-161.cl.fx.apol.com.tw [210.200.180.161])
	by mail.intevation.de (Postfix) with ESMTP id B7D0A1C258
	for <grass-bugs at intevation.de>; Wed, 20 Nov 2002 09:41:20 +0100 (CET)
Received: from debian (TC218-187-82-144.2-7.pl.apol.com.tw [218.187.82.144])
	by smtp.u2online.com.tw (8.12.2/8.11.6) with ESMTP id gAK8hNDZ069899
	for <grass-bugs at intevation.de>; Wed, 20 Nov 2002 16:43:27 +0800 (CST)
	(envelope-from jidanni at dman.ddts.net)
Received: from jidanni by debian with local (Exim 3.35 #1 (Debian))
	id 18ELWT-0001DJ-00
	for <grass-bugs at intevation.de>; Wed, 20 Nov 2002 11:27:29 +0800
To: grass-bugs at intevation.de
Subject: the *.in.* man pages don't mention the file extensions they deal with 
From: Dan Jacobson <jidanni at dman.ddts.net>
User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.2
Date: Wed, 20 Nov 2002 11:27:29 +0800 01:00:00 +0000 (GMT)
Message-ID: <87k7j8apjy.fsf at jidanni.org>
Lines: 47
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
X-Spam-Status: No, hits=-1.6 required=5.0
	tests=DATE_IN_PAST_03_06,SIGNATURE_SHORT_DENSE,SPAM_PHRASE_00_01,
	      USER_AGENT
	version=2.41
X-Spam-Level: 

-------------------------------------------- Managed by Request Tracker