CalGPS Application

Description

The CalGPS application prints GPS calendars either to the command line or to a graphics file.

The UNIX cal utility served as the initial inspiration for this tool.

Command Summary

calgps [options]

where [options] can be

`-h, --help`	Display argument list.
`-3, --three-months`	Display last, this and next months.
`-y, --year`	Display all months for the current year
-Y, --specific-year=NUM	Display all months for a given year
-p, --postscript=ARG	Generate a postscript file
-s, --svg=ARG	Generate an SVG file
-e, --eps=ARG	Generate an encapsulated postscript file
`-v, --view`	Try to launch an appropriate viewer for the file.

Usage examples

Example 1. Printing text calendar to standard output.

user@host:~$ calgps

                       Dec 2007
1455                                             1-335 
1456   2-336  3-337  4-338  5-339  6-340  7-341  8-342 
1457   9-343 10-344 11-345 12-346 13-347 14-348 15-349 
1458  16-350 17-351 18-352 19-353 20-354 21-355 22-356 
1459  23-357 24-358 25-359 26-360 27-361 28-362 29-363 
1460  30-364 31-365

Example 2. Printing a 2002 calendar to standard output.

calgps -Y 2002

                       Jan 2002
1147                 1-001  2-002  3-003  4-004  5-005 
1148   6-006  7-007  8-008  9-009 10-010 11-011 12-012 
1149  13-013 14-014 15-015 16-016 17-017 18-018 19-019 
1150  20-020 21-021 22-022 23-023 24-024 25-025 26-026 
1151  27-027 28-028 29-029 30-030 31-031               

                       Feb 2002
1151                                      1-032  2-033 
1152   3-034  4-035  5-036  6-037  7-038  8-039  9-040 
1153  10-041 11-042 12-043 13-044 14-045 15-046 16-047 
1154  17-048 18-049 19-050 20-051 21-052 22-053 23-054 
1155  24-055 25-056 26-057 27-058 28-059               

                       Mar 2002
1155                                      1-060  2-061 
1156   3-062  4-063  5-064  6-065  7-066  8-067  9-068 
1157  10-069 11-070 12-071 13-072 14-073 15-074 16-075 
1158  17-076 18-077 19-078 20-079 21-080 22-081 23-082 
1159  24-083 25-084 26-085 27-086 28-087 29-088 30-089 
1160  31-090                                           
...

Example 3. Generating a graphical calender in SVG, launching a postscript viewer when done.

e$ ./calgps -s test.svg -v

Going to launch rsvg-view -b white
sh: rsvg-view: not found
... couldn't execute: rsvg-view -b white test.svg
Going to launch ksvg
sh: ksvg: not found
... couldn't execute: ksvg test.svg
Going to launch inkscape

A picture like the attached is generated: cal.svg

Platforms Supported

This application has been successfully used in Linux, Solaris and Windows. This application successfully build under these environments: linux-x86, linux-x86_64, solaris-ppc, Windows/.net2005, MacOS/X-Code.