[GRASS5] [bug #1565] (grass) man pages are ugly if terminal window is small

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

Subject: man pages are ugly if terminal window is small

Platform: GNU/Linux/i386
grass obtained from: Mirror of Trento site
grass binary for platform: Compiled from Sources
GRASS Version: 5.0.0

The man pages are ugly if the terminal window is smaller than 87 columns wide.

It doesn't wrap cleanly; normal system man pages usually display "Reformatting foo(1), please wait..." and then look good in a smaller window. The grass pages display "Reformatting r.transect(1), please wait..." and then mess up the indentation/word wrap on the next line.

e.g.:
DESCRIPTION
       This progream outputs, in ASCII, the values in a raster
map which lie
       along one or more user-defined transect lines. The
transects are
       described by their starting coordinates, azimuth, and
distance. The
       transects may be single-cell wide lines, or multiple-cell
wide lines.
       The output, for each transect, may be the values at each
of the cells,
       or a single aggregate value (e.g., average or median val-
ue).

g.html2man CR/LF vs <P> issue ?

This is on 5.0.0, multiple linux platforms. I don't know if it is fixed in 5.0.1 or CVS.

Hamish

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

Request Tracker wrote:

Subject: man pages are ugly if terminal window is small

Platform: GNU/Linux/i386
grass obtained from: Mirror of Trento site
grass binary for platform: Compiled from Sources
GRASS Version: 5.0.0

The man pages are ugly if the terminal window is smaller than 87
columns wide.

87? That suggests a problem with your "man" program, or at least with
the way in which it is being invoked. Are you running the "make"
command in a wider than normal terminal?

It doesn't wrap cleanly; normal system man pages usually display
"Reformatting foo(1), please wait..." and then look good in a
smaller window. The grass pages display "Reformatting r.transect(1),
please wait..." and then mess up the indentation/word wrap on the
next line.

g.html2man CR/LF vs <P> issue ?

This is on 5.0.0, multiple linux platforms. I don't know if it is
fixed in 5.0.1 or CVS.

GRASS installs pre-formatted man pages by default. I suggest changing
the default target in html/Gmakefile from:

  all: htmlpages g.help-manpages
to:
  all: htmlpages manpages

This should install the nroff source, which will be formatted
dynamically.

--
Glynn Clements <glynn.clements@virgin.net>

On Mon, 3 Feb 2003 04:50:31 +0000
"Glynn Clements" <glynn.clements@virgin.net> wrote:

Request Tracker wrote:

> Subject: man pages are ugly if terminal window is small
>
> Platform: GNU/Linux/i386
> grass obtained from: Mirror of Trento site
> grass binary for platform: Compiled from Sources
> GRASS Version: 5.0.0
>
> The man pages are ugly if the terminal window is smaller than 87
> columns wide.

87? That suggests a problem with your "man" program, or at least with
the way in which it is being invoked.

87. This happens to me on both RedHat 7.3 & Debian/Sarge, BUT...

Are you running the "make" command in a wider than normal terminal?

Most probably yes.

I just tried it on the laptop (RH8.0), it doesn't wrap nicely either, but on that machine the magic number is <66 columns wide, which doesn't happen much.. I can guess that the terminal window was smaller on compile due to the smaller screen, but couldn't remember. I'll have a go at putting 5.0.1 on that and see what happens.

GRASS installs pre-formatted man pages by default. I suggest changing
the default target in html/Gmakefile from:

  all: htmlpages g.help-manpages
to:
  all: htmlpages manpages

This should install the nroff source, which will be formatted
dynamically.

I'll give it a shot as well.

Hamish