home *** CD-ROM | disk | FTP | other *** search
/ Source Code 1992 March / Source_Code_CD-ROM_Walnut_Creek_March_1992.iso / usenet / altsrcs / 3 / 3861 < prev    next >
Encoding:
Internet Message Format  |  1991-08-22  |  42.0 KB
  1. Path: wupost!zaphod.mps.ohio-state.edu!cis.ohio-state.edu!pacific.mps.ohio-state.edu!linac!att!cbnews!jbr0
  2. From: jbr0@cbnews.cb.att.com (joseph.a.brownlee)
  3. Newsgroups: alt.sources
  4. Subject: Pcal v4.1, part 1 of 6
  5. Keywords: pcal calendar postscript
  6. Message-ID: <1991Aug19.121007.212@cbnews.cb.att.com>
  7. Date: 19 Aug 91 12:10:07 GMT
  8. Organization: AT&T Bell Laboratories
  9. Lines: 1129
  10.  
  11. "Pcal" Version 4.1
  12.  
  13. This is an intermediate release of "Pcal", the PostScript calendar making
  14. program.  For those not familiar with this pcakage, "pcal" generates calendars
  15. in various formats and generates Postscript.  You can keep "events" in a file
  16. and "pcal" will place them in the appropriate day in the calendar.
  17.  
  18. Major changes since v4.0:
  19.  
  20.     1) Of interest to Pcal hackers and installers:
  21.  
  22.     .    The Un*x flavor of Pcal is now considerably smarter about finding
  23.     the date file, using the PATH environment variable to identify
  24.     the directory where the executable lives.  (This is so system-
  25.     dependent that it exists only for Un*x; in fact, it may require
  26.     some tweaking for your particular system.  See the comments in
  27.     pcalutil.c regarding X_OK.)
  28.  
  29.  
  30.     2) New command-line options:
  31.  
  32.     .    The "-v" option has been added to print version information without
  33.     the entire usage message.
  34.  
  35.     .    The "-G" option has been added to print "gray" dates as filled
  36.     outlines (thanks to Richard Dyson for the idea).
  37.  
  38.  
  39.     3) New date file functionality:
  40.  
  41.     .    Pcal now supports format specifiers (derived mostly from strftime())
  42.     which allow the user to substitute the current month, day, weekday,
  43.     year, etc. into a text or foot string.  For further information,
  44.     refer to the manual page and/or the comments in "pcal.c".
  45.  
  46.  
  47.     4) Other new functionality:
  48.  
  49.     .    The default moon phase algorithm has been replaced with an
  50.     astronomer-quality version; moon file ".moonXX" will continue
  51.     to be supported for now.
  52.  
  53.     5) Portability:
  54.  
  55.     .   Some VMS-specific files have been updated.  Also, a TeX style sheet
  56.     is now included in the distribution.
  57.  
  58.  
  59. Credit where credit is due:
  60.  
  61. The following people contributed to Pcal v4.1:
  62.  
  63.     Overall coordinator, troff manual page:        Joe Brownlee
  64.     VMS/TeX support, moon phase algorithm:        Richard Dyson
  65.     Other C and PostScript code:            Andrew Rogers
  66.  
  67. Although they probably wouldn't recognize the current version, countless
  68. others worked on Pcal long before any of us ever heard of it; see the
  69. Orig.ReadMe file and topline comments in pcal.c.
  70.  
  71.    ^      _   Joe Brownlee, Analysts International Corporation @ AT&T Bell Labs
  72.   /_\  @ / `  471 E Broad St, Suite 2001, Columbus, Ohio 43215   (614) 860-7461
  73.  /   \ | \_,  E-mail: jbr@cblph.att.com     Who pays attention to what _I_ say?
  74.  "Scotty, we need warp speed in 3 minutes or we're all dead!" --- James T. Kirk
  75.  
  76. ------------------------------- 8<  cut here  >8 -------------------------------
  77. #!/bin/sh
  78. # This is a shell archive (produced by shar 3.49)
  79. # To extract the files from this archive, save it to a file, remove
  80. # everything above the "!/bin/sh" line above, and type "sh file_name".
  81. #
  82. # existing files will NOT be overwritten unless -c is specified
  83. #
  84. # This shar contains:
  85. # length  mode       name
  86. # ------ ---------- ------------------------------------------
  87. #   1849 -rw-r--r-- ReadMe
  88. #   2923 -rw-r--r-- Make_Pcal.com
  89. #   1159 -rw-r--r-- Makefile
  90. #   1010 -rw-r--r-- Makefile.Amiga
  91. #   1023 -rw-r--r-- Makefile.DOS
  92. #   2505 -rw-r--r-- Makefile.VMS
  93. #    984 -rw-r--r-- Orig.ReadMe
  94. #  23366 -rw-r--r-- Pcal.TeX
  95. #  24613 -rw-r--r-- Pcal.hlp
  96. #    670 -rw-r--r-- SetUp.com
  97. #     31 -rw-r--r-- VaxCrtl.opt
  98. #   9144 -rw-rw-rw- calendar
  99. #   8311 -rw-rw-rw- exprpars.c
  100. #   2504 -rw-rw-rw- moon91
  101. #  14863 -rw-rw-rw- moonphas.c
  102. #   2051 -rw-rw-rw- noprotos.h
  103. #  36344 -rw-rw-rw- pcal.c
  104. #  20376 -rw-r--r-- pcal.man
  105. #  14846 -rw-rw-rw- pcaldefs.h
  106. #   3549 -rw-rw-rw- pcalglob.h
  107. #   3975 -rw-r--r-- pcalinit.c
  108. #  13642 -rw-rw-rw- pcalinit.ps
  109. #  27444 -rw-rw-rw- pcallang.h
  110. #  16402 -rw-r--r-- pcalutil.c
  111. #   3511 -rw-rw-rw- protos.h
  112. #  27599 -rw-r--r-- readfile.c
  113. #   3609 -rw-r--r-- troffman.sty
  114. #  13864 -rw-r--r-- writefil.c
  115. #
  116. # ============= ReadMe ==============
  117. if test -f 'ReadMe' -a X"$1" != X"-c"; then
  118.     echo 'x - skipping ReadMe (File already exists)'
  119. else
  120. echo 'x - extracting ReadMe (Text)'
  121. sed 's/^X//' << 'SHAR_EOF' > 'ReadMe' &&
  122. "Pcal" Version 4.1
  123. X
  124. This is an intermediate release of "Pcal", the PostScript calendar making
  125. program.
  126. X
  127. Major changes:
  128. X
  129. X    1) Of interest to Pcal hackers and installers:
  130. X
  131. X    .    The Un*x flavor of Pcal is now considerably smarter about finding
  132. X    the date file, using the PATH environment variable to identify
  133. X    the directory where the executable lives.  (This is so system-
  134. X    dependent that it exists only for Un*x; in fact, it may require
  135. X    some tweaking for your particular system.  See the comments in
  136. X    pcalutil.c regarding X_OK.)
  137. X
  138. X
  139. X    2) New command-line options:
  140. X
  141. X    .    The "-v" option has been added to print version information without
  142. X    the entire usage message.
  143. X
  144. X    .    The "-G" option has been added to print "gray" dates as filled
  145. X    outlines (thanks to Richard Dyson for the idea).
  146. X
  147. X
  148. X    3) New date file functionality:
  149. X
  150. X    .    Pcal now supports format specifiers (derived mostly from strftime())
  151. X    which allow the user to substitute the current month, day, weekday,
  152. X    year, etc. into a text or foot string.  For further information,
  153. X    refer to the manual page and/or the comments in "pcal.c".
  154. X
  155. X
  156. X    4) Other new functionality:
  157. X
  158. X    .    The default moon phase algorithm has been replaced with an
  159. X    astronomer-quality version; moon file ".moonXX" will continue
  160. X    to be supported for now.
  161. X
  162. X    5) Portability:
  163. X
  164. X    .   Some VMS-specific files have been updated.  Also, a TeX style sheet
  165. X    is now included in the distribution.
  166. X
  167. X
  168. Credit where credit is due:
  169. X
  170. The following people contributed to Pcal v4.1:
  171. X
  172. X    Overall coordinator, troff manual page:        Joe Brownlee
  173. X    VMS/TeX support, moon phase algorithm:        Richard Dyson
  174. X    Other C and PostScript code:            Andrew Rogers
  175. X 
  176. Although they probably wouldn't recognize the current version, countless
  177. others worked on Pcal long before any of us ever heard of it; see the
  178. Orig.ReadMe file and topline comments in pcal.c.
  179. SHAR_EOF
  180. chmod 0644 ReadMe ||
  181. echo 'restore of ReadMe failed'
  182. Wc_c="`wc -c < 'ReadMe'`"
  183. test 1849 -eq "$Wc_c" ||
  184.     echo 'ReadMe: original size 1849, current size' "$Wc_c"
  185. fi
  186. # ============= Make_Pcal.com ==============
  187. if test -f 'Make_Pcal.com' -a X"$1" != X"-c"; then
  188.     echo 'x - skipping Make_Pcal.com (File already exists)'
  189. else
  190. echo 'x - extracting Make_Pcal.com (Text)'
  191. sed 's/^X//' << 'SHAR_EOF' > 'Make_Pcal.com' &&
  192. $ If F$Mode () .eqs. "INTERACTIVE"
  193. $   Then
  194. $       VERIFY = F$Verify (0)
  195. $   Else
  196. $       VERIFY = F$Verify (1)
  197. $ EndIf
  198. $!========================================================================
  199. $!
  200. $!  Name      : MAKE_PCAL.COM
  201. $!
  202. $!  Purpose   : Compile and Link pcal under VMS
  203. $!
  204. $!  Arguments : P1/P2 = DATE_DEBUG: compile with DEBUG info
  205. $!              P1/P2 = LINK : link only
  206. $!
  207. $!  Created: 13-SEP-1990 Rick Dyson
  208. $!  Updated: 20-SEP-1990 pcal v2.3
  209. $!  Updated:  2-OCT-1990 pcal v2.4
  210. $!  Updated:  8-OCT-1990 pcal v2.5
  211. $!  Updated:  2-JAN-1991 pcal v3.0
  212. $!  Updated: 15-FEB-1991 pcal v3.1
  213. $!  Updated:  1-MAR-1991 pcal v4.0
  214. $!  Updated: 15-AUG-1991 pcal v4.1
  215. $!
  216. $!========================================================================
  217. $   THIS_PATH = F$Element (0, "]", F$Environment ("PROCEDURE")) + "]"
  218. $   Set Default 'THIS_PATH'
  219. $   On Error     Then GoTo FINISH
  220. $   On Control_Y Then GoTo FINISH
  221. $   If P1 .eqs. "DATE_DEBUG" .or. P2 .eqs. "DATE_DEBUG"
  222. $       Then
  223. $           DEFINE = "/Define = (""VMS"", ""DATE_DEBUG"")"
  224. $       Else
  225. $           DEFINE = "/Define = (""VMS"")"
  226. $   EndIf
  227. $   If P1 .eqs. "LINK" .or. P2 .eqs. "LINK" Then GoTo LINK
  228. $   Write Sys$Output "Making pcalinit..."
  229. $   Cc /NoList 'DEFINE' PCALINIT
  230. $   Link /NoMap PCALINIT,VAXCRTL.OPT /Option
  231. $   PCALINIT := $ 'THIS_PATH'PCALINIT.EXE
  232. $   Write Sys$Output "Executing pcalinit..."
  233. $   PCALINIT PCALINIT.PS PCALINIT.H
  234. $   Write Sys$Output "Compiling pcal programs..."
  235. $   Cc /NoList 'DEFINE' PCAL.C
  236. $   Cc /NoList 'DEFINE' EXPRPARS.C
  237. $   Cc /NoList 'DEFINE' MOONPHAS.C
  238. $   Cc /NoList 'DEFINE' PCALUTIL.C
  239. $   Cc /NoList 'DEFINE' READFILE.C
  240. $   Cc /NoList 'DEFINE' WRITEFIL.C
  241. $LINK:
  242. $   Write Sys$Output "Linking pcal..."
  243. $   Link /NoMap PCAL,EXPRPARS,MOONPHAS,PCALUTIL,READFILE,WRITEFIL,VAXCRTL/Option
  244. $EXIT:
  245. $   If .not. $Status Then GoTo FINISH
  246. $   Set NoOn
  247. $   Set Protection = Owner:RWED *.OBJ;*,*.EXE;-1
  248. $   Purge /Log /NoConfirm *.OBJ,*.EXE
  249. $   If F$Search ("PCAL.HLB") .eqs. ""
  250. $       Then
  251. $           Write Sys$Output "Creating a help library for Pcal..."
  252. $           Library /Log /Help /Create PCAL PCAL
  253. $       Else
  254. $           Write Sys$Output "Updating help library for Pcal..."
  255. $           Library /Log /Help PCAL PCAL
  256. $   EndIf
  257. $   If F$Mode () .nes. "INTERACTIVE" Then GoTo FINISH
  258. $   Set File /Truncate PCAL.HLB
  259. $   LIB = "Hlp$Library"
  260. $   X = F$Trnlnm (LIB, "Lnm$Process")
  261. $   If X .eqs. "" Then GoTo INSERT
  262. $   If X .eqs. "''THIS_PATH'PCAL.HLB" Then GoTo FINISH
  263. $   BASE = LIB + "_"
  264. $   N = 1
  265. $NEXTLIB:
  266. $   LIB := 'BASE''N'
  267. $   X = F$Trnlnm (LIB, "Lnm$Process")
  268. $   If X .eqs. "" Then GoTo INSERT
  269. $   If X .eqs. "''THIS_PATH'PCAL.HLB" Then GoTo FINISH
  270. $   N = N + 1
  271. $   GoTo NEXTLIB
  272. $INSERT:
  273. $   Define 'LIB' 'THIS_PATH'PCAL.HLB
  274. $FINISH:
  275. $   Set Protection = (System:RWE, Owner:RWED, Group:RE, World:RE) *.*;*
  276. $   Purge /Log /NoConfirm *.*
  277. $   Set Protection = Owner:RWE *.*
  278. $   VERIFY = F$Verify (VERIFY)
  279. $   Exit
  280. SHAR_EOF
  281. chmod 0644 Make_Pcal.com ||
  282. echo 'restore of Make_Pcal.com failed'
  283. Wc_c="`wc -c < 'Make_Pcal.com'`"
  284. test 2923 -eq "$Wc_c" ||
  285.     echo 'Make_Pcal.com: original size 2923, current size' "$Wc_c"
  286. fi
  287. # ============= Makefile ==============
  288. if test -f 'Makefile' -a X"$1" != X"-c"; then
  289.     echo 'x - skipping Makefile (File already exists)'
  290. else
  291. echo 'x - extracting Makefile (Text)'
  292. sed 's/^X//' << 'SHAR_EOF' > 'Makefile' &&
  293. #
  294. # Makefile for Pcal v4.0 under UNIX
  295. #
  296. X
  297. # Set the configuration variables below to taste.
  298. X
  299. CC    = /bin/cc
  300. MANDIR    = /usr/man
  301. COPTS    =
  302. OBJECTS = pcal.o exprpars.o moonphas.o pcalutil.o readfile.o writefil.o
  303. X
  304. pcal:    $(OBJECTS)
  305. X    $(CC) $(LDFLAGS) -o pcal $(OBJECTS) -lm
  306. X    @ echo "Build of pcal complete"
  307. X
  308. exprpars.o:    exprpars.c pcaldefs.h
  309. X    $(CC) $(CFLAGS) $(COPTS) -c exprpars.c
  310. X
  311. moonphas.o:    moonphas.c pcaldefs.h pcalglob.h
  312. X    $(CC) $(CFLAGS) $(COPTS) -c moonphas.c
  313. X
  314. pcal.o:        pcal.c pcaldefs.h pcalglob.h pcallang.h
  315. X    $(CC) $(CFLAGS) $(COPTS) -c pcal.c
  316. X
  317. pcalutil.o:    pcalutil.c pcaldefs.h pcalglob.h pcallang.h
  318. X    $(CC) $(CFLAGS) $(COPTS) -c pcalutil.c
  319. X
  320. readfile.o:    readfile.c pcaldefs.h pcalglob.h pcallang.h
  321. X    $(CC) $(CFLAGS) $(COPTS) -c readfile.c
  322. X
  323. writefil.o:    writefil.c pcaldefs.h pcalglob.h pcallang.h pcalinit.h
  324. X    $(CC) $(CFLAGS) $(COPTS) -c writefil.c
  325. X
  326. pcalinit: pcalinit.c
  327. X    $(CC) $(CFLAGS) $(LDFLAGS) $(COPTS) -o pcalinit pcalinit.c
  328. X
  329. pcalinit.h: pcalinit pcalinit.ps
  330. X    pcalinit pcalinit.ps pcalinit.h
  331. X
  332. pcalglob.h: protos.h noprotos.h
  333. X
  334. clean:
  335. X    rm -f $(OBJECTS) pcal pcalinit pcalinit.h
  336. X
  337. man:    pcal.man
  338. X    nroff -man pcal.man > pcal.1
  339. X    pack pcal.1
  340. #    mv pcal.1.z $(MANDIR)
  341. SHAR_EOF
  342. chmod 0644 Makefile ||
  343. echo 'restore of Makefile failed'
  344. Wc_c="`wc -c < 'Makefile'`"
  345. test 1159 -eq "$Wc_c" ||
  346.     echo 'Makefile: original size 1159, current size' "$Wc_c"
  347. fi
  348. # ============= Makefile.Amiga ==============
  349. if test -f 'Makefile.Amiga' -a X"$1" != X"-c"; then
  350.     echo 'x - skipping Makefile.Amiga (File already exists)'
  351. else
  352. echo 'x - extracting Makefile.Amiga (Text)'
  353. sed 's/^X//' << 'SHAR_EOF' > 'Makefile.Amiga' &&
  354. #   Makefile for the Amiga.
  355. #
  356. #   Set the configuration variables below to taste.
  357. X
  358. CC    = lc:lc
  359. LDFLAGS = -cufirst -v -d0 -m3s -O
  360. OBJECTS = pcal.o exprpars.o moonphas.o pcalutil.o readfile.o writefil.o
  361. X
  362. pcal:    $(OBJECTS)
  363. X    blink from lib:c.o $(OBJECTS) to pcal lib lib:lcm.lib lib:lc.lib SC SD VERBOSE ND
  364. X    @ echo "+ Build of pcal complete!"
  365. X
  366. exprpars.o:    exprpars.c pcaldefs.h
  367. X    $(CC) $(LDFLAGS) >bugs-$> exprpars.c
  368. X
  369. moonphas.o:    moonphas.c pcaldefs.h pcalglob.h
  370. X    $(CC) $(LDFLAGS) >bugs-$> moonphas.c
  371. X
  372. pcal.o:        pcal.c pcaldefs.h pcalglob.h pcallang.h
  373. X    $(CC) $(LDFLAGS) >bugs-$> pcal.c
  374. X
  375. pcalutil.o:    pcalutil.c pcaldefs.h pcalglob.h pcallang.h
  376. X    $(CC) $(LDFLAGS) >bugs-$> pcalutil.c
  377. X
  378. readfile.o:    readfile.c pcaldefs.h pcalglob.h pcallang.h
  379. X    $(CC) $(LDFLAGS) >bugs-$> readfile.c
  380. X
  381. writefil.o:    writefil.c pcaldefs.h pcalglob.h pcallang.h 
  382. X    $(CC) $(LDFLAGS) >bugs-$> writefil.c
  383. X
  384. pcalinit: pcalinit.c
  385. X    $(CC) $(LDFLAGS) >bugs-$> -Lscsdndver pcalinit pcalinit.c
  386. X
  387. pcalinit.h: pcalinit pcalinit.ps
  388. X    DH0:pcal/pcalinit pcalinit.ps
  389. SHAR_EOF
  390. chmod 0644 Makefile.Amiga ||
  391. echo 'restore of Makefile.Amiga failed'
  392. Wc_c="`wc -c < 'Makefile.Amiga'`"
  393. test 1010 -eq "$Wc_c" ||
  394.     echo 'Makefile.Amiga: original size 1010, current size' "$Wc_c"
  395. fi
  396. # ============= Makefile.DOS ==============
  397. if test -f 'Makefile.DOS' -a X"$1" != X"-c"; then
  398.     echo 'x - skipping Makefile.DOS (File already exists)'
  399. else
  400. echo 'x - extracting Makefile.DOS (Text)'
  401. sed 's/^X//' << 'SHAR_EOF' > 'Makefile.DOS' &&
  402. # PCAL v4.0 MAKEFILE for MS-DOS.
  403. # Uses TurboC command line compiler.
  404. X
  405. CC    = tcc
  406. CFLAGS    = -DDOS
  407. OBJECTS = pcal.obj exprpars.obj moonphas.obj pcalutil.obj readfile.obj writefil.obj
  408. X
  409. pcal.exe:    $(OBJECTS)
  410. X    $(CC) $(LDFLAGS) $(OBJECTS)
  411. X    @ echo + Build of pcal complete!
  412. X
  413. exprpars.obj:    exprpars.c pcaldefs.h
  414. X    $(CC) $(CFLAGS) $(COPTS) -c exprpars.c
  415. X
  416. moonphas.obj:    moonphas.c pcaldefs.h pcalglob.h
  417. X    $(CC) $(CFLAGS) $(COPTS) -c moonphas.c
  418. X
  419. pcal.obj:        pcal.c pcaldefs.h pcalglob.h pcallang.h
  420. X    $(CC) $(CFLAGS) $(COPTS) -c pcal.c
  421. X
  422. pcalutil.obj:    pcalutil.c pcaldefs.h pcalglob.h pcallang.h
  423. X    $(CC) $(CFLAGS) $(COPTS) -c pcalutil.c
  424. X
  425. readfile.obj:    readfile.c pcaldefs.h pcalglob.h pcallang.h
  426. X    $(CC) $(CFLAGS) $(COPTS) -c readfile.c
  427. X
  428. writefil.obj:    writefil.c pcaldefs.h pcalglob.h pcallang.h pcalinit.h
  429. X    $(CC) $(CFLAGS) $(COPTS) -c writefil.c
  430. X
  431. pcalinit.exe: pcalinit.c
  432. X    $(CC) $(CFLAGS) $(LDFLAGS) $(COPTS) pcalinit.c
  433. X
  434. pcalinit.h: pcalinit.exe pcalinit.ps
  435. X    pcalinit pcalinit.ps pcalinit.h
  436. X
  437. clean:
  438. X    del *.obj
  439. X    del pcalinit.exe
  440. X    del pcalinit.h
  441. SHAR_EOF
  442. chmod 0644 Makefile.DOS ||
  443. echo 'restore of Makefile.DOS failed'
  444. Wc_c="`wc -c < 'Makefile.DOS'`"
  445. test 1023 -eq "$Wc_c" ||
  446.     echo 'Makefile.DOS: original size 1023, current size' "$Wc_c"
  447. fi
  448. # ============= Makefile.VMS ==============
  449. if test -f 'Makefile.VMS' -a X"$1" != X"-c"; then
  450.     echo 'x - skipping Makefile.VMS (File already exists)'
  451. else
  452. echo 'x - extracting Makefile.VMS (Text)'
  453. sed 's/^X//' << 'SHAR_EOF' > 'Makefile.VMS' &&
  454. #   This is a makfile for the public domain VMS version of MAKE by Nelson
  455. #   H.F. Beebe dated 20-Feb-88.  Below you will find a paragraph cut out
  456. #   of the MAKE.DOC file.  If you have this program and want to use it
  457. #   instead of the MAKE_PCAL.COM, rename this file from MAKEFILE.VMS to
  458. #   MAKEFILE.  and type
  459. #       MAKE pcal               ! for the program
  460. #       MAKE help               ! for the help library
  461. #       MAKE clean              ! to clean up the directory
  462. #
  463. #   The original version of MAKE  was done by Stuart Feldman  in
  464. #   1978.  This  multi-operating-system version  is based  on  a
  465. #   public-domain posting  of 3-Dec-86  to the  Usenet  bulletin
  466. #   board  mod.sources,  its  author  known  only  by  an  EMAIL
  467. #   address: Caret@FAIRLIGHT.OZ.  It contained support for Unix,
  468. #   OS9, and  EON  operating  systems.  The  TOPS-20,  VMS,  and
  469. #   MS-DOS   support   was   added   by   Nelson   H.F.    Beebe
  470. #   (BEEBE@UTAH-SCIENCE).
  471. #
  472. X
  473. # Set the configuration variables below to taste.
  474. X
  475. CFLAGS    = /NoList
  476. COPTS    = VAXCRTL.OPT /Option
  477. OBJECTS = exprpars.obj moonphas.obj pcalutil.obj readfile.obj writefil.obj
  478. OBJLIST = exprpars,moonphas,pcalutil,readfile,writefil
  479. X
  480. pcal:    pcal.exe
  481. X
  482. pcal.exe:    pcal.obj $(OBJECTS)
  483. X    $(CC) $(CFLAGS) pcal
  484. X    Link pcal,$(OBJLIST),$(COPTS)
  485. X    Set Protection = (System:RWE, Owner:RWE, Group:RE, World:RE) *.*
  486. X
  487. exprpars.obj:    exprpars.c pcaldefs.h
  488. X    $(CC) $(CFLAGS) exprpars.c
  489. X
  490. moonphas.obj:    moonphas.c pcaldefs.h pcalglob.h
  491. X    $(CC) $(CFLAGS) moonphas.c
  492. X
  493. pcal.obj:    pcal.c pcaldefs.h pcalglob.h pcallang.h
  494. X    $(CC) $(CFLAGS) pcal.c
  495. X
  496. pcalutil.obj:    pcalutil.c pcaldefs.h pcalglob.h pcallang.h
  497. X    $(CC) $(CFLAGS) pcalutil.c
  498. X
  499. readfile.obj:    readfile.c pcaldefs.h pcalglob.h pcallang.h
  500. X    $(CC) $(CFLAGS) readfile.c
  501. X
  502. writefil.obj:    writefil.c pcaldefs.h pcalglob.h pcallang.h pcalinit.h
  503. X    $(CC) $(CFLAGS) writefil.c
  504. X
  505. pcalinit:    pcalinit.exe
  506. X
  507. pcalinit.exe:    pcalinit.c
  508. X    $(CC) $(CFLAGS) pcalinit.c
  509. X    Link $(LDFLAGS) pcalinit,$(COPTS)
  510. X
  511. pcalinit.h:    pcalinit.exe pcalinit.ps
  512. X    MCR Sys$$Disk:[]pcalinit pcalinit.ps pcalinit.h
  513. X
  514. help:    pcal.hlb
  515. X
  516. pcal.hlb:    pcal.hlp
  517. X    Library /Log /Create /Help PCAL.HLB PCAL.HLP
  518. X    Set Protection = (System:RWE, Owner:RWE, Group:RE, World:RE) PCAL.HLB
  519. X    Set File /Truncate PCAL.HLB
  520. X
  521. clean:
  522. X    Set Protection = Owner:RWED *.*;-1
  523. X    Purge /Log /NoConfirm pcal.exe,pcalinit.exe
  524. X    Set Protection = Owner:RWED *.obj
  525. X    Delete /Log /NoConfirm *.obj;*
  526. X    Set Protection = Owner:RWED pcalinit.h
  527. X    Delete /Log /NoConfirm pcalinit.h;
  528. X    Set Protection = (System:RWE, Owner:RWE) *.*
  529. SHAR_EOF
  530. chmod 0644 Makefile.VMS ||
  531. echo 'restore of Makefile.VMS failed'
  532. Wc_c="`wc -c < 'Makefile.VMS'`"
  533. test 2505 -eq "$Wc_c" ||
  534.     echo 'Makefile.VMS: original size 2505, current size' "$Wc_c"
  535. fi
  536. # ============= Orig.ReadMe ==============
  537. if test -f 'Orig.ReadMe' -a X"$1" != X"-c"; then
  538.     echo 'x - skipping Orig.ReadMe (File already exists)'
  539. else
  540. echo 'x - extracting Orig.ReadMe (Text)'
  541. sed 's/^X//' << 'SHAR_EOF' > 'Orig.ReadMe' &&
  542. "Pcal" is a program to print PostScript calendars for any month and year.
  543. By default, it looks for a file in the home directory named "calendar"
  544. for entries with leading dates matching dates on the calendar, and prints
  545. any following text under the appropriate day.
  546. X
  547. The program may be a little System V flavored (getopt, time routines)
  548. but should be easily portable to other vintages of UNIX.
  549. X
  550. Pcal is the combined effort of several people, most notably Patrick Wood
  551. of Pipeline Associates, Inc. for the original PostScript code and Bill
  552. Vogel of AT&T for the calendar file mechanism.  My part was simple
  553. translation to a "C" program, the addition of a couple options and a more
  554. generalized date searching routine (oh yes, and a manual page :-).
  555. X
  556. The original calendar PostScript was Copyright (c) 1987 by Patrick Wood
  557. and Pipeline Associates, Inc. with permission to modify and redistribute.
  558. Please retain this README file with the package.
  559. X
  560. X
  561. Ken Keirnan
  562. Pacific Bell
  563. San Ramon, CA.
  564. SHAR_EOF
  565. chmod 0644 Orig.ReadMe ||
  566. echo 'restore of Orig.ReadMe failed'
  567. Wc_c="`wc -c < 'Orig.ReadMe'`"
  568. test 984 -eq "$Wc_c" ||
  569.     echo 'Orig.ReadMe: original size 984, current size' "$Wc_c"
  570. fi
  571. # ============= Pcal.TeX ==============
  572. if test -f 'Pcal.TeX' -a X"$1" != X"-c"; then
  573.     echo 'x - skipping Pcal.TeX (File already exists)'
  574. else
  575. echo 'x - extracting Pcal.TeX (Text)'
  576. sed 's/^X//' << 'SHAR_EOF' > 'Pcal.TeX' &&
  577. % -*-LaTeX-*-
  578. % Converted automatically from troff to LaTeX
  579. % by tr2latex (version 1.04, July 15, 1991)
  580. % on Thu Aug 15 10:28:35 1991
  581. % tr2latex was written by Kamal Al-Yahya at Stanford University
  582. % (Kamal%Hanauma@SU-SCORE.ARPA)
  583. X
  584. \documentstyle[troffman]{article}
  585. \begin{document}
  586. %
  587. % input file: [-]pcal.man
  588. %
  589. \phead{PCAL}{4.1}{}{}{}
  590. X
  591. \shead{NAME}
  592. pcal -- generate PostScript calendars
  593. X
  594. \shead{SYNOPSIS}
  595. {\bf pcal} [{\bf --e} $|$\ {\bf --f} {\it cal\/}] [{\bf --o}
  596. {\it \ file\/}] [{\bf --j} $|$ {\bf --J}] [{\bf --l}
  597. $|$ {\bf --p}] [{\bf --m} $|$ {\bf --M}] [{\bf --b}{\it \ day\/}
  598. $|$ all ][{\bf --g}{\it \ day\/}$|$ all \/]\hfil\break
  599. [{\bf --O}] [{\bf --G}] [{\bf --F}{\it \ day\/}] [{\bf --A} $|$ {\bf --E}]
  600. [{\bf --t}{\it \ title\_font\/}] [{\bf --d}{\it \ day\_font\/}]
  601. [{\bf --n}{\it \ text\_font\/}] [{\bf --L}{\it \ footer\_string\/}]\hfil\break
  602. [{\bf --C}{\it \ footer\_string\/}] [{\bf --R}{\it \ footer\_string\/}]
  603. [{\bf --D}{\it \ symbol\/}] [{\bf --U}{\it \ symbol\/}] [{\bf --x}{\it \
  604. xscale\/}] [{\bf --y}{\it \ yscale\/}]\hfil\break
  605. [{\bf --X}{\it \ xtrans\/}] [{\bf --Y}{\it \ ytrans\/}][{\bf --I}] [{\bf --B}]
  606. [{\bf --w}] [{\bf --h}{\rm \ $|$\ }{\bf --v}]\hfil\break
  607. [{\bf month}] [{\bf year}] [{\bf nmonths}]
  608. X
  609. \shead{DESCRIPTION}
  610. {\it Pcal} generates PostScript to produce landscape or portrait
  611. calendars for any month and year.  The arguments {\bf month}, {\bf year},
  612. and {\bf nmonths}, if provided, should be numeric.  The {\bf month} value
  613. should be in the range 1 -- 12, and the {\bf year} value should be
  614. specified as 1 or 2 digits or as the full 4 digit year.  If no numeric
  615. arguments are provided, the calendar for the current month and year will
  616. be generated.
  617. X
  618. If one numeric argument is provided, it is interpreted as the {\bf year}
  619. value, and calendars for the entire year will be generated.  Otherwise,
  620. {\bf nmonth} months, starting with {\bf month} and {\bf year}, will be
  621. generated.
  622. X
  623. For whole-year calendars ({\it i.e.}, the {\bf --w} option is given), the
  624. command line arguments are interpreted somewhat differently.  By default,
  625. all months in the current year are printed, starting with January.  If
  626. the {\bf month} argument alone is given, it is expected to be the desired
  627. {\bf year} to print, and prints all of the months in the given year.  If
  628. both {\bf month} and {\bf year} are given, then 12 consecutive months are
  629. printed starting at the given month and year.  If the {\bf month}, {\bf
  630. year}, and {\bf nmonths} arguments are all present, printing begins with
  631. the given month and year and {\bf nmonths} months are printed, rounded up
  632. to the nearest multiple of 12.
  633. X
  634. {\bf The Date File}
  635. X
  636. By default, {\it pcal} simply prints an empty calendar.  Its real power
  637. is in its ability to place ``events'' in appropriate days on the
  638. calendar, thus allowing the user to create personalized calendars.  This
  639. is achieved through the use of the ``date file''.
  640. X
  641. The date file is named {\it calendar} ({\it pcal.dat} under MS-DOS), or
  642. {\it calendar} for compatibility with older versions.  {\it Pcal} will
  643. look in several places for such a file.  First, if a file called {\it
  644. calendar} exists in the caller's home directory, it is used.  Next, if
  645. such a file exists in the directory indicated by environment variable
  646. {\bf PCAL\_DIR} (or the current directory if no such variable is
  647. defined), it is used.  Finally, the directory where the {\it pcal}
  648. executable resides will be checked.  If no date file is found, an empty
  649. calendar is printed.
  650. X
  651. If a date file is found, it will be searched for lines with leading dates
  652. matching the requested month and year.  Any text following the dates
  653. found will be printed on the calendar under the appropriate day of the
  654. month.  Dates in the {\it calendar} file may be expressed in any of
  655. several formats:
  656. X
  657. %.ft CW
  658. {\tt\nofill
  659. X      $<$ordinal$>$ $<$day\_spec$>$ in $<$month\_spec$>$\{$\ast$\} \{$<$text$>$\}
  660. X      $<$day\_spec$>$ $<$prep$>$ $<$date\_spec$>$\{$\ast$\} \{$<$text$>$\}
  661. X      $<$date\_spec$>$\{$\ast$\} \{$<$text$>$\}
  662. \fill}
  663. %.ft
  664. X
  665. Where:
  666. X
  667. {\tt\nofill
  668. X      $<$month\_name$>$        := first 3+ characters of name of month, or ``all''
  669. X      $<$month\_spec$>$        := $<$month\_name$>$, or ``year''
  670. X      $<$day\_spec$>$          := first 3+ characters of name of weekday, ``day'',
  671. X                              ``weekday'', ``workday'', ``holiday'', ``nonweekday'',
  672. X                              ``nonworkday'', or ``nonholiday''
  673. X      $<$ordinal$>$           := any ordinal number (``1st'', ``2nd'', {\it etc.}),
  674. X                              ``first'' $\ldots$ ``fifth'', ``last'', ``odd'', ``even'',
  675. X                              or ``all''
  676. X      $<$prep$>$              := ``before'', ``preceding'', ``after'', ``following'',
  677. X                              ``on\_or\_before'' (``oob''), or ``on\_or\_after'' (``ooa'')
  678. X      $<$sep$>$               := one or more non-numeric, non-space, non-`$\ast$' characters
  679. X      $<$month$>$             := a numeric month (1-12)
  680. X      $<$day$>$               := day of month (1-31)
  681. X      $<$year$>$              := a numeric year
  682. \fill}
  683. %.ft
  684. X
  685. If the {\bf --A} option (American date formats, the default) is given:
  686. X
  687. {\tt\nofill
  688. X   $<$date\_spec$>$    := [$<$month\_name$>$ $<$day$>$ $|$ $<$month$>$$<$sep$>$$<$day$>$\{$<$sep$>$$<$year$>$\}]
  689. \fill}
  690. X
  691. If the {\bf --E} option (European date formats) is given:
  692. X
  693. {\tt\nofill
  694. X   $<$date\_spec$>$    := [$<$day$>$ $<$month\_name$>$ $|$ $<$day$>$$<$sep$>$$<$month$>$\{$<$sep$>$$<$year$>$\}]
  695. \fill}
  696. X
  697. {\it Pcal} also allows format specifiers in both the text and foot
  698. strings (see the {\bf --L}, {\bf --C}, and {\bf --R} options below); each
  699. will be replaced by a corresponding string as outlined in the table
  700. below.  Most of these are derived from the
  701. %.ft CW
  702. {\it strftime()}
  703. %.ft
  704. function; the {\bf \%l} and {\bf \%[o0+--]} format specifiers are
  705. specific to {\it pcal}:
  706. X
  707. {\tt\nofill
  708. X      \%a     abbreviated weekday
  709. X      \%A     full weekday
  710. X      \%b     abbreviated month name
  711. X      \%B     full month name
  712. X      \%d     day of month (1-31)
  713. X      \%j     day of year (1-366)
  714. X      \%l     days left in year (0-365)
  715. X      \%m     month (1-12)
  716. X      \%U     week number (0-53)
  717. X      \%W     week number (0-53)
  718. X      \%y     year w/o century (00-99)
  719. X      \%Y     year w/century
  720. X      \%\%     ``\%'' character
  721. X
  722. X      \%o     print number as ordinal
  723. X      \%0     print number with leading zeroes
  724. X      \%+     use following month or year
  725. X      \%--    use previous month or year
  726. \fill}
  727. X
  728. The {\bf \%U} format specifier considers the first logical Sunday (the
  729. first day of the week as printed; see the {\bf --F} option below) of the
  730. year as the first day of week number 1; the {\bf \%W} specifier uses the
  731. first logical Monday instead.  This is an extension of the behavior of
  732. the
  733. %.ft CW
  734. {\it strftime()}
  735. %.ft
  736. function.
  737. X
  738. The {\bf \%o} format specifier prints a number as an ordinal, with the
  739. appropriate suffix (``st'', ``nd'', ``rd'', or ``th'' in English)
  740. appended; for example, {\bf \%od} prints the day of the month as ``1st'',
  741. ``2nd'', ``3rd'', {\it etc.}
  742. X
  743. Unlike
  744. %.ft CW
  745. {\it strftime(),}
  746. %.ft
  747. {\it pcal}'s default is to print numbers (except {\bf \%y}{\rm )} without
  748. leading zeroes.  If leading zeroes are desired, the ``0'' prefix may be
  749. used; for example, {\bf \%0j} prints the day of year as 001-365.
  750. X
  751. The {\bf \%+} and {\bf \%--} format specifiers direct {\it pcal} to
  752. substitute the following or previous month or year for the following {\bf
  753. [bBmyY]} specifier; for example, {\bf \%+B} prints the name of the
  754. following month.
  755. X
  756. Examples:
  757. X
  758. %.ft CW
  759. {\tt\nofill
  760. X      last Monday in May$\ast$         Memorial Day Holiday
  761. \par\vspace{1.0\baselineskip}
  762. X      all Fridays in Oct          Status Meeting, 11 AM
  763. X      first workday in all        \%-B progress report due
  764. X      all Fri in all              Time card due, 3 PM
  765. X      all Monday in all           Fiscal week \%0W
  766. X      -2nd workday in all         Schedule for \%+B due
  767. X      Fri on\_or\_before all 15      Pay Day
  768. X      even Fridays in year        Pay Day
  769. X      183rd day of year           mid-year (\%l days left)
  770. \par\vspace{1.0\baselineskip}
  771. X      Tue after first Mon in Nov  Election Day (USA)
  772. \par\vspace{1.0\baselineskip}
  773. X      4th Thu in Nov$\ast$             Thanksgiving
  774. X      Fri after 4th Thu in Nov$\ast$   Day after Thanksgiving
  775. \par\vspace{1.0\baselineskip}
  776. X      12/25/90$\ast$                   Christmas     \# American
  777. X      25.12.90$\ast$                   Christmas     \# European
  778. \par\vspace{1.0\baselineskip}
  779. X      Dec 25$\ast$                     Christmas     \# American
  780. X      25 Dec$\ast$                     Christmas     \# European
  781. \fill}
  782. %.ft
  783. X
  784. Any non-numeric character may separate numeric dates.  Holidays may be
  785. flagged by following the date immediately with ``$\ast$'' as in the examples
  786. above; this will cause the date to be printed in gray.  ``Each'' and
  787. ``every'' are accepted as synonyms for ``all'', and any word may be used
  788. in place of ``in''.  The abbreviations ``oob'' and ``ooa'' may be used in
  789. place of the keywords ``on\_or\_before'' and ``on\_or\_after'',
  790. respectively.
  791. X
  792. Wildcard day names are also provided.  The keyword ``weekday'' applies to
  793. any days which are normally printed in black on the calendar.  The
  794. keyword ``workday'' is the same, but does not include any holidays.  The
  795. keyword ``holiday'' includes only those days flagged as holidays.  The
  796. keywords ``nonweekday'', ``nonworkday'', and ``nonholiday'' are also
  797. recognized as negations of the above.  See the {\bf CAVEATS} below for
  798. important notes on using these keywords.
  799. X
  800. Ordinal day numbers may be used to specify dates, either relative to the
  801. month or to the year.  Either words or numeric abbreviations may be used
  802. for ``first'' through ``fifth''; higher numbers must be given using the
  803. numeric equivalent ({\it e.g.}, 100th).  Negative ordinal numbers may
  804. even be used.  For example, ``--2nd'' means ``next to last''.
  805. X
  806. ``Odd'' and ``even'' do not refer to the actual date; instead, ``odd''
  807. means ``alternate, starting with the first'', and ``even'' means
  808. ``alternate, starting with the second''.  Thus, ``odd Fridays in March''
  809. refers to the first, third, and (if present) fifth Fridays in March - not
  810. to those Fridays falling on odd dates.
  811. X
  812. ``All'' refers to each individual month; ``year'' refers to the year as
  813. an entity.  Thus ``odd Fridays in all'' refers to the first, third, and
  814. fifth Friday of each month, while ``odd Fridays in year'' refers to the
  815. first Friday of January and every other Friday thereafter.
  816. X
  817. Text in the date file may use C-like escape sequences ({\it i.e.}, a
  818. ``\bs '' followed by a character, 1 -- 3 octal digits, or ``x'' followed
  819. by 1 -- 2 hexadecimal digits).  Escaped whitespace (including {\bf
  820. newline} ) and the standard ANSI character escapes (``\bs a'', ``\bs b'',
  821. ``\bs f'', ``\bs n'', ``\bs r'', ``\bs t'', ``\bs v'') are all replaced
  822. by a single blank.
  823. X
  824. Lines in the {\it calendar} file consisting of {\bf year \#\#\#\#} (where
  825. {\bf \#\#\#\#} is a numeric year) can be used to set the year for
  826. following entries.  This assumes that the following entries do not
  827. contain a year; any date entries containing year information will set the
  828. remembered year to that year.
  829. X
  830. Lines in the {\it calendar} file consisting of {\bf opt $<$options$>$}
  831. can be used to override the defaults for any command-line options except
  832. {\bf --e}, {\bf --f}, {\bf --h}, {\bf --v}, {\bf --D}, and {\bf --U}.
  833. Any options specified in this manner are, in turn, overridden by those
  834. specified explicitly on the command line.
  835. X
  836. Lines in the {\it calendar} file consisting of {\bf note $<$month$>$} can
  837. be used to place notes regarding the entire month is one of the unused
  838. blocks of the calendar.  The {\bf $<$month$>$} indicator may be either a
  839. number 1 through 12 or an alphabetic month name as described above;
  840. ``note all'' will place the associated text in the notes block for each
  841. month in the current year.
  842. X
  843. Comments are supported in the {\it calendar} file.  Any characters
  844. following a ``\#'' character through the end of the line are ignored.
  845. X
  846. {\it Pcal} supports rudimentary {\it cpp}-like functionality in the date
  847. file, allowing the following constructs:  {\bf define\ $|$\ undef}, {\bf
  848. if\{n\}def $\ldots$ else $\ldots$ endif}, and {\bf include}.  Note that
  849. these are not preceded by ``\#'' as they are in C.  Symbol names defined
  850. using these keywords (or via the {\bf -D} option) are case-insensitive.
  851. It is not an error to {\bf undef} an undefined symbol, nor to {\bf
  852. define} a previously-defined one.  An {\bf ifdef} alone is always {\bf
  853. false}; an {\bf ifndef} alone is always {\bf true}.
  854. X
  855. The name of the file in the {\bf include} directive may optionally be
  856. surrounded by either `` '' or $<$$>$, both of which are ignored.  If the
  857. name is not an absolute path, it is taken to be relative to the directory
  858. where the file containing the directive is located.  {\it Pcal} is smart
  859. enough to translate {\bf \~{}/} to the user's home directory.
  860. X
  861. In addition to pre-processing keywords, {\it pcal} also accepts boolean
  862. expressions in {\bf if\{n\}def} directives.  These expressions consist of
  863. symbol names joined by the boolean operators {\bf !}, {\bf \&}, {\bf
  864. \^{}}, and {\bf $|$}, in order of precedence, high to low.  Parentheses
  865. may be used to alter the precedence.  The synonyms {\bf \&\&} and {\bf
  866. $|$$|$} are accepted for {\bf \&} and {\bf $|$}.  A symbol name evaluates
  867. to {\bf true} if currently defined, {\bf false} if not; thus:
  868. X
  869. %.ft CW
  870. {\tt\nofill
  871. X      ifdef A $|$ B $|$ C
  872. \fill}
  873. %.ft
  874. X
  875. $\ldots$ is {\bf true} if any of the symbols A, B, and C is defined, and:
  876. X
  877. %.ft CW
  878. {\tt\nofill
  879. X      ifdef A \& B \& C
  880. \fill}
  881. %.ft
  882. X
  883. $\ldots$ is {\bf true} if they all are.  Note that {\bf ifndef $<$expr$>$}
  884. is equivalent to {\bf ifdef !( $<$expr$>$ ).}
  885. X
  886. {\bf The Moon File}
  887. X
  888. If a file of the name {\it .moon\#\#} ({\it moon\#\#.dat}under MS-DOS),
  889. where {\bf \#\#} is the last two digits of the calendar year, exists in
  890. the same directory as the date file, {\it pcal} uses the information
  891. contained within to calculate the phase of the moon.  If no such file
  892. exists, {\it pcal} uses an approximate algorithm.
  893. X
  894. Entries in the moon file must conform to the following syntax:
  895. X
  896. If the {\bf --A} option (American date formats, the default) is given:
  897. X
  898. %.ft CW
  899. {\tt\nofill
  900. X      $<$quarter$>$ $<$month$>$$<$sep$>$$<$day$>$ \{$<$hour$>$$<$sep$>$$<$min$>$\}
  901. \fill}
  902. %.ft
  903. X
  904. If the {\bf --E} option (European date formats) is given:
  905. X
  906. %.ft CW
  907. {\tt\nofill
  908. X      $<$quarter$>$ $<$day$>$$<$sep$>$$<$month$>$ \{$<$hour$>$$<$sep$>$$<$min$>$\}
  909. \fill}
  910. %.ft
  911. X
  912. Where:
  913. X
  914. {\tt\nofill
  915. X      $<$quarter$>$           := ``nm'', ``fq'' or ``1q'', ``fm'', ``3q'' or ``lq''
  916. X                              (new moon, first quarter, full moon, last quarter)
  917. X      $<$hour$>$              := number 0-23 (24-hour clock)
  918. X      $<$min$>$               := number 0-59
  919. \fill}
  920. X
  921. This file must contain entries for all quarter moons in the year, in
  922. chronological order; if any errors are encountered, {\it pcal} will
  923. revert to using its default algorithm.
  924. X
  925. As in the date file, comments start with `\#' and run through the end of
  926. the given line.
  927. X
  928. {\bf Options}
  929. X
  930. {\it Pcal} has many options:
  931. \begin{TPlist}{{\bf --e}}
  932. \item[{{\bf --e}}]
  933. Prints an empty calendar.  Do not print entries from a {\it calendar}
  934. file.
  935. \item[{{\bf --f}{\it \ cal}}]
  936. Directs {\it pcal} to use the file name {\it cal} as the input file in
  937. place of the default {\it calendar} file in the user's home directory (or
  938. the directory pointed to by {\bf PCAL\_DIR}.
  939. \item[{{\bf --o}{\it \ file}}]
  940. Directs {\it pcal} to write the output to {\it file} instead of to
  941. stdout.
  942. \item[{{\bf --l}}]
  943. Causes the output to be in landscape mode (default).  This also resets
  944. the x- and y-axis scaling and translation factors to the defaults for
  945. landscape mode.
  946. \item[{{\bf --p}}]
  947. Causes the output to be in portrait mode.  This also resets the x- and
  948. y-axis scaling and translation factors to the defaults for portrait mode.
  949. \item[{{\bf --j}}]
  950. Causes the Julian date (day of year) to be printed in each calendar box.
  951. \item[{{\bf --J}}]
  952. Causes the Julian date and the number of days remaining in the year to be
  953. printed in each calendar box.
  954. \item[{{\bf --m}}]
  955. Causes moon icons to be printed on dates corresponding to new, half, and
  956. full moons (the default is that no moons are printed).
  957. \item[{{\bf --M}}]
  958. Causes moon icons to be printed on all dates (the default is that no
  959. moons are printed).
  960. \item[{{\bf --b}{\it \ day}{\bf \ $|$\ all}}]
  961. Causes all dates falling on weekday {\it day} to be printed in black;
  962. {\bf --b all} causes all weekdays to be printed in black.
  963. \item[{{\bf --g}{\it \ day}{\bf \ $|$\ all}}]
  964. Causes all dates falling on weekday {\it day} to be printed in gray;
  965. {\bf --g all} causes all weekdays to be printed in gray.
  966. \begin{IPlist}
  967. \IPitem{{}}
  968. The default for the {\bf --b}{\rm \ and\ }{\bf --g} options is to print
  969. Saturdays and Sundays in gray and other days, unless flagged as holidays,
  970. in black.
  971. \end{IPlist}%
  972. \item[{{\bf --O}}]
  973. Causes pcal to print ``gray'' dates as outlined characters.
  974. \item[{{\bf --G}}]
  975. Causes pcal to print ``gray'' dates as outlined characters filled with
  976. gray.
  977. \item[{{\bf --F}{\it \ day}}]
  978. Selects weekday {\it day} as the first day of the week.  The given day
  979. will appear in the left-most column of the calendar.
  980. \item[{{\bf --A}}]
  981. Directs {\it pcal} to use American date conventions {\bf mm/dd\{/yy\}}
  982. and {\bf month dd} ) when parsing the date file (default).
  983. \item[{{\bf --E}}]
  984. Directs {\it pcal} to use European date conventions {\bf dd/mm\{/yy\}}
  985. and {\bf dd month} ) when parsing the date file.
  986. \item[{{\bf --X}{\it \ xtrans}}]
  987. Specifies the x-axis translation value for positioning the output on the
  988. page.
  989. \item[{{\bf --Y}{\it \ ytrans}}]
  990. Specifies the y-axis translation value for positioning the output on the
  991. page.
  992. \item[{{\bf --x}{\it \ xscale}}]
  993. Specifies the x-axis scaling factor for the calendar size.
  994. \item[{{\bf --y}{\it \ yscale}}]
  995. Specifies the y-axis scaling factor for the calendar size.
  996. \item[{{\bf --t}{\it \ title\_font}}]
  997. Specifies the name of a font to use to print the month name and year at
  998. the top of the calendar.  For example, {\bf pcal\ --t\ Times-Roman}.
  999. \item[{{\bf --d}{\it \ day\_font}}]
  1000. Similar to the {\bf --t} option, but selects the font used to print the
  1001. day numbers.
  1002. \item[{{\bf --n}{\it \ text\_font}}]
  1003. Similar to the {\bf --t} option, but selects the font used to print the
  1004. text inside each day and in the notes block.
  1005. \item[{{\bf --D}{\it \ symbol}}]
  1006. Defines the named symbol prior to reading the date file.
  1007. \item[{{\bf --U}{\it \ symbol}}]
  1008. Un-defines the named symbol prior to reading the date file.
  1009. \item[{{\bf --L}{\it \ string}}]
  1010. Causes the accompanying string to be printed as a left-justified footer.
  1011. Format specifiers denoting the month and/or year may appear in the
  1012. string;  the appropriate values will be substituted upon printing.
  1013. \item[{{\bf --C}{\it \ string}}]
  1014. Causes the accompanying string to be printed as a centered footer.
  1015. Format specifiers denoting the month and/or year may appear in the
  1016. string;  the appropriate values will be substituted upon printing.
  1017. \item[{{\bf --R}{\it \ string}}]
  1018. Causes the accompanying string to be printed as a right-justified footer.
  1019. Format specifiers denoting the month and/or year may appear in the
  1020. string;  the appropriate values will be substituted upon printing.
  1021. \item[{{\bf --B}}]
  1022. Causes {\it pcal} to leave unused calendar boxes blank (default is gray).
  1023. \item[{{\bf --w}}]
  1024. Causes {\it pcal} to print a calendar for 12 consecutive months: 3 rows /
  1025. 4 columns in landscape mode, 4 rows / 3 columns in portrait mode.  See
  1026. the {\bf CAVEATS} section for details on the use of this option with
  1027. other options.
  1028. \item[{{\bf --I}}]
  1029. Resets all parameters to the program defaults.
  1030. \item[{{\bf --h}}]
  1031. Causes {\it pcal} to write version information, usage message, and full
  1032. explanation of options and file formats (to {\it stdout}) and terminate.
  1033. \item[{{\bf --v}}]
  1034. Causes {\it pcal} to write version information only (to {\it stdout}) and
  1035. terminate.
  1036. \end{TPlist}
  1037. X
  1038. Any option which normally takes an argument may be specified without the
  1039. argument in order to reset the value to the program default.  Note that
  1040. while the {\bf --D} option alone clears all the defined symbols, the {\bf
  1041. --U} option alone has no effect.  The {\bf --} (or {\bf --\,--} as per
  1042. System V) argument may be used to disambiguate command lines such as:
  1043. X
  1044. \begin{IPlist}
  1045. \IPitem{{}}
  1046. {\bf pcal --t 9 90}
  1047. \end{IPlist}
  1048. X
  1049. This could be written instead as one of the following:
  1050. \begin{IPlist}
  1051. \IPitem{{}}
  1052. {\bf pcal --t -- 9 90}
  1053. \nwl
  1054. {\bf pcal --t --\,-- 9 90}
  1055. \end{IPlist}
  1056. X
  1057. If the environment variable {\bf PCAL\_OPTS} is defined, its contents are
  1058. parsed as a command line.  Flags set via {\bf PCAL\_OPTS} override the
  1059. program defaults, but are overridden by options set via {\bf opt} lines
  1060. in the {\it calendar} file or explicitly on the command line.
  1061. X
  1062. \shead{CAVEATS}
  1063. The ``workday'' and ``holiday'' keywords are aware of only those holidays
  1064. which have already been flagged at the point where they appear.  For
  1065. example, consider January 1990:
  1066. X
  1067. %.ft CW
  1068. {\tt\nofill
  1069. %.ne 7
  1070. X                                January 1990
  1071. X                             S  M Tu  W Th  F  S
  1072. X                                1  2  3  4  5  6
  1073. X                             7  8  9 10 11 12 13
  1074. X                            14 15 16 17 18 19 20
  1075. X                            21 22 23 24 25 26 27
  1076. X                            28 29 30 31
  1077. \fill}
  1078. %.ft
  1079. X
  1080. If the {\it calendar} file looked like this:
  1081. X
  1082. %.ft CW
  1083. {\tt\nofill
  1084. X      workday on\_or\_before all 15   payday
  1085. X      3rd Mon in Jan$\ast$               MLK day
  1086. \fill}
  1087. %.ft
  1088. X
  1089. then {\it pcal} would mark the 15th as ``payday'' since at that point in
  1090. the {\it calendar} file it has no way of knowing that January 15th will
  1091. later be flagged as a holiday.  If the two lines were reversed, such that
  1092. the holiday preceded the ``workday'' wildcard, then {\it pcal} would work
  1093. as intended, marking instead the 12th as ``payday''.  Also, beware of
  1094. year boundaries which affect the handling of all of the day wildcard
  1095. keywords.  In general, it is best to place monthly wildcards such as the
  1096. example above at the end of each year to achieve the desired effect.
  1097. X
  1098. When the {\bf --w} and {\bf --p} options are used together, {\it pcal}
  1099. revises the y-scale factor in order to use the entire portrait page;
  1100. therefore, the user should avoid using use the {\bf --y} option when
  1101. using both the {\bf --w} and {\bf --p} options.  Use of the {\bf --w}
  1102. option in any case effectively disables the {\bf --m}, {\bf --M}, {\bf
  1103. --j} , and {\bf --J} options.
  1104. X
  1105. \shead{SEE ALSO}
  1106. cal(1)
  1107. X
  1108. \shead{VERSION}
  1109. This documentation corresponds to v4.1 dated 15-AUG-1991.
  1110. X
  1111. \shead{AUTHORS}
  1112. The original PostScript code to generate the calendars was written by
  1113. Patrick Wood (Copyright (c) 1987 by Patrick Wood of Pipeline Associates,
  1114. Inc.), and authorized for modification and redistribution.  The calendar
  1115. file inclusion code was originally written in {\it bs}(1) by Bill Vogel
  1116. of AT\&T.  Patrick's original PostScript was modified and enhanced
  1117. several times by others whose names have regrettably been lost.  Ken
  1118. Keirnan of Pacific Bell assembled the original ``C'' version upon which
  1119. this is based; additional modifications and enhancements are the work of
  1120. Joseph P. Larson, Ed Hand, Andrew W. Rogers, Mark Kantrowitz, Joe
  1121. Brownlee, Jamie Zawinski, Richard L. Dyson, Bill Hogsett, and Floyd
  1122. Miller.
  1123. X
  1124. \end{document}
  1125. SHAR_EOF
  1126. chmod 0644 Pcal.TeX ||
  1127. echo 'restore of Pcal.TeX failed'
  1128. Wc_c="`wc -c < 'Pcal.TeX'`"
  1129. test 23366 -eq "$Wc_c" ||
  1130.     echo 'Pcal.TeX: original size 23366, current size' "$Wc_c"
  1131. fi
  1132. true || echo 'restore of Pcal.hlp failed'
  1133. echo End of part 1, continue with part 2
  1134. exit 0
  1135. -- 
  1136.    ^      _   Joe Brownlee, Analysts International Corporation @ AT&T Bell Labs
  1137.   /_\  @ / `  471 E Broad St, Suite 2001, Columbus, Ohio 43215   (614) 860-7461
  1138.  /   \ | \_,  E-mail: jbr@cblph.att.com     Who pays attention to what _I_ say?
  1139.  "Scotty, we need warp speed in 3 minutes or we're all dead!" --- James T. Kirk
  1140.