[GRASS-dev] r.cats -> r.category + enhancements

[Hamish]

r.cats updates committed to cvs. test away.

I am not sure that all which is mentioned in the lib/gis/cats.c comments
really work. (copied into description.html)

I know these don't work:
- category ranges;  cat1:cat2:Label  appears as just cat2:Label in
  d.legend
- val1:val2:Labels for FP maps don't appear in d.legend(?)
- ps.map doesn't respect dynamic label names (see RT bug report)
- etc.


There are probably more bugs about but I wanted to get it checked in for
others to help test. The library code is somewhat "dusty". Reading from
stdin is brand new & totally untested.

r.cats is preserved as a symlink.

Anyone have ideas for module keywords? "support"?


enjoy,
Hamish

------------------
G63> r.category --help

Description:
 Manages category values and labels associated with user-specified raster
map layers.

Keywords:
 raster

Usage:
 r.category map=name [cats=range[,range,...]] [vals=value[,value,...]]
   [fs=character|space|tab] [raster=name] [rules=name] [format=string]
   [coefficients=mult1,offset1,mult2,offset2] [--verbose] [--quiet]

Flags:
 --v   Verbose module output
 --q   Quiet module output

Parameters:
           map   Name of input raster map
          cats   Category values
                  Example: 1,3,7-9,13
          vals   Comma separated value list
                  Example: 1.4,3.8,13
            fs   Output field separator
                 default: tab
        raster   Raster map from which to copy category table
         rules   File containing category label rules (or "-" to read
from stdin)
        format   Default label or format string for dynamic labeling
                  Used when no explicit label exists for the category
  coefficients   Dynamic label coefficients
                  Two pairs of category multiplier and offsets, for $1
and $2