# /************************************************************
# 
# Copyright (C) 1998, Lucent Technologies
# All rights reserved
# 
# ************************************************************/
# 
MATERIALS

Manuals are included in two forms.
	PostScript:
		map.ps
	input for troff -man:
		map.1, map.3, map.5, route.1

The source directory has two subdirectories: 
	libmap		source for all the projection subroutines
	mapdata		World Data Bank I, etc.

The source is written in ANSI C.  Check CFLAGS and CC in the
Makefile and make them reflect your system's conventions.

QUICK TEST

For a quick test, to see whether you can compile and compute, try this
test, which makes "map" and checks its output for a bit of Africa:

	make quicktest

PLOTTING FILTERS

Map produces output for a plotting filter (not included).
Unfortunately there is no Unix standard for plotting.
Here are ways to compile for various filters.

	make		For PostScript output.  Maps are drawn
			6.5-inch square centered 1 inch from the 
			top of an 8.5x11 page.  To change edit the
			PostScript or polotPS.c
	make PLOT=plotV	Output for Sys V or SunOS plotting filters
			described under plot(1) or tplot(1).

	make PLOT=plot0	For v10 research system plot(1), not
			compatible with System V.

	make ps		PostScript.  Maps are drawn in a 6.5-inch
			square centered 1 inch from the top of an
			8.5x11 page.  To change, edit the
			PostScript or plotPS.c.

	As map uses only simple plotting features, it is usually
	easy to interface to other plotting packages. See
	iplot.h for details.

When you have a plotting filter, you can test map in the current
directory as follows.  For sample arguments, see EXAMPLES on the
map(1) man page.

	MAPDIR=./mapdata MAPPROG=./map  map.sh arguments | filter

INSTALLATION

For real installation, examine the recipe for

	make install

It puts the map shell script in /usr/bin and everything else
in /usr/lib/map.  If you want to put things elsewhere, adjust
variables MAPDIR and MAPPROG in map.sh and alter Makefile
accordingly.  map.sh will become the command "map".  After 
installation it will be run thus:

	map arguments | filter

POSSIBLE PROBLEMS

Lost output
	If you lose the last bit of a map, read BUGS in map(1).

Option problems
	Option -f needs World Data Bank II, which is not in
	this distribution, but can be fetched separately from
	the same place.

Library problems
	At least one version of tplot has been seen to garble
	the output.  In this case the trouble went away by
	compiling map with -l4014 instead of -lplot; see plot(3).

	Collisions with a nonstandard library function sincos()
	have been observed.  sincos will have to be renamed 
	in map.h and all .c files.

Man pages
	The man pages were produced with a slightly nonstandard
	-man package.  If you change font L to B throughout
	you can probably get a passable result.

REFERENCES

Most standard texts on cartography discuss the major 
projections and their uses.  A short introduction, with
24 sample maps drawn by the "map" program itself and the
commands to draw them, is

	Projections: Mapmakers' Answers to the Riddle of
	Presenting a Round Earth on Flat Paper
	by M. Douglas McIlroy
	Computing Science Technical Report 140, (1987)
	available from

	Computing Science Reports, Room 2C447
	Bell Labs
	600 Mountain Avenue
	Murray Hill, NJ 07974

	[In this report, option -s is used in an obsolete way.
	It should always be replaced by -s2, with -s1 added
	to the previous command.]

Doug McIlroy
doug@research.bell-labs.com
