Return to README CVS log

Up to [Research Unix] / researchv10no / cmd / map / export

Annotation of researchv10no/cmd/map/export/README, revision 1.1

1.1     ! root        1: MATERIALS
        !             2: 
        !             3: Manuals are included in two forms.
        !             4:        formatted ASCII file:
        !             5:                map.man
        !             6:        input for troff -man:
        !             7:                map.5, map.7, proj.3, proj.5, route.1
        !             8: 
        !             9: The source directory has two subdirectories: 
        !            10:        libmap          source for all the projection subroutines
        !            11:        mapdata         World Data Bank I, etc.
        !            12: 
        !            13: The source is written in ANSI C.  Check CFLAGS and CC in the
        !            14: Makefile and make them reflect your system's conventions.
        !            15: 
        !            16: QUICK TEST
        !            17: 
        !            18: For a quick test, to see whether you can compile and compute, try this
        !            19: test, which makes "map" and checks its output for a bit of Africa:
        !            20: 
        !            21:        make quicktest
        !            22: 
        !            23: PLOTTING FILTERS
        !            24: 
        !            25: Map produces output for a plotting filter (not included).
        !            26: Unfortunately there is no Unix standard for plotting.
        !            27: Here are ways to compile for various filters.
        !            28: 
        !            29:        make            For System V and SunOS filters plot(1)
        !            30:                        or tplot(1).
        !            31: 
        !            32:        make v10        For v10 research system plot(1), not
        !            33:                        compatible with System V.
        !            34: 
        !            35:        make ps         PostScript.  Maps are drawn in a 6.5-inch
        !            36:                        square centered 1 inch from the top of an
        !            37:                        8.5x11 page.  To change, edit the
        !            38:                        PostScript or plotPS.c.
        !            39: 
        !            40:        As map uses only simple plotting features, it is usually
        !            41:        easy to interface to other plotting packages. See
        !            42:        iplot.h (used with "make v10") for details.
        !            43: 
        !            44: When you have a plotting filter, you can test map in the current
        !            45: directory as follows.  For sample arguments, see EXAMPLES on the
        !            46: map(7) man page.
        !            47: 
        !            48:        MAPDIR=./mapdata MAPPROG=./map  map.sh arguments | filter
        !            49: 
        !            50: INSTALLATION
        !            51: 
        !            52: For real installation, examine the recipe for
        !            53: 
        !            54:        make install
        !            55: 
        !            56: It puts the map shell script in /usr/bin and everything else
        !            57: in /usr/lib/map.  If you want to put things elsewhere, adjust
        !            58: variables MAPDIR and MAPPROG in map.sh.  map.sh will become
        !            59: the command "map".  After installation it will be run thus:
        !            60: 
        !            61:        map arguments | filter
        !            62: 
        !            63: POSSIBLE PROBLEMS
        !            64: 
        !            65: Options 
        !            66:        Option -f oes not work because World Data Bank II is
        !            67:        not in this distribution on account of its size (13Mb).
        !            68: 
        !            69:        -y files are like v10, not Sys V, plot files.
        !            70:        The plot(5) man page from v10 is included for reference,
        !            71:        although most of it is irrelevant for this application.
        !            72: 
        !            73: Library 
        !            74:        At least one version of tplot(1) has been seen to garble
        !            75:        the output.  In this case the trouble went away by
        !            76:        compiling map with -l4014 instead of -lplot; see plot(3).
        !            77: 
        !            78:        Collisions with a nonstandard library function sincos()
        !            79:        have been observed.  sincos will have to be renamed 
        !            80:        in map.h and all .c files.
        !            81: 
        !            82: Man pages
        !            83:        The man pages were produced with a -man macros slightly
        !            84:        different from Sys V.  If you change font L to B throughout
        !            85:        you will probably get a passable result.
        !            86: 
        !            87: REFERENCES
        !            88: 
        !            89: Most standard texts on cartography discuss the major projections
        !            90: and their uses.  Some thorough works:
        !            91:   
        !            92:   J. P. Snyder, An Album of Map Projections, US Geological Survey
        !            93:   Professional Paper 1453, USGPO Washington (1989)
        !            94:   
        !            95:   J. P. Snyder, Map Projections - A Working Manual, US Geological
        !            96:   Survey Professional Paper 1395, USGPO Washington (1987)
        !            97:   
        !            98:   D. H. Maling, Coordinate Systems and Map Projections, George
        !            99:   Philip and Son, London (1973)
        !           100:   
        !           101:   J. A. Steers, An Introduction to the Study of Map Projections,
        !           102:   Univ. London Press (1970)
        !           103: 
        !           104: A short introduction, with 24 sample maps drawn by the "map"
        !           105: program itself and the commands to draw them:
        !           106: 
        !           107:   M. D.        McIlroy, Projections: Mapmakers' Answers to the Riddle of
        !           108:   Presenting a Round Earth on Flat Paper, AT&T Bell Labs Computing
        !           109:   Science Tech. Report 140 (1987), order from Computing Science
        !           110:   Reports, Room 2C579, AT&T Bell Labs Murray Hill, NJ 07974
        !           111: 
        !           112:   [In this report, option -s is used in an obsolete way.  It
        !           113:   should always be replaced by -s2, with -s1 added to the
        !           114:   preceding command.]
        !           115: 
        !           116: Doug McIlroy
        !           117: 201-582-6050
        !           118: research!doug
        !           119: [email protected]

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.