summaryrefslogtreecommitdiff
path: root/obsolete/dviware/dvi2xx/README.vms
blob: 38b248871dabcd7ee2c4f40b738431136878417d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
From HAAN@IRIMCF.TUDELFT.NL Thu Oct 17 16:56:16 1991
Received: from IRIMCF.TUDELFT.NL (IRIMCF) by TUDRVA.TUDelft.NL (PMDF #12232) id
 <01GBUYPA7S68AKTSPZ@TUDRVA.TUDelft.NL>; Thu, 17 Oct 1991 16:56 +0100
Date: Thu, 17 Oct 91 16:53 MET
From: H.deHaan@IRIVAX.TUDELFT.NL
Subject: VMS-port of dvi2xx
Sender: Henk de Haan <HAAN@IRIMCF.TUDELFT.NL>
To: NEUMANN@DEC4.WU-WIEN.AC.AT
Message-Id: <01GBUYPA7S68AKTSPZ@TUDRVA.TUDelft.NL>
X-Vms-To: NEUMANN@DEC4.WU-WIEN.AC.AT
Comments: Sent using PMDF-822 V3.0, routing is done by TUDRVA
Status: OR

		Dear Gustaf,

  Thanks for writing the DVI print program for the HP-Laserjet family. 
Because our group recently bought a HP Laserjet 3 printer (for our VAX/VMS
system), we needed a LaTeX driver for it. The only drivers I could locate 
(and that would run on VAX/VMS) are the Beebe drivers, but they are rather
slow and they don't support any \special commands. For this reason I've 
ported your program to VAX/VMS. 

  I'm sending you my changes to your programs (in respect to the DVI2XX,
version 0.50 distribution). All my changes are propely included in #ifdef ...
#endif constructions. I'm also including an extra file (called VAXVMS.C), which
is copied from the DVIPS distribution, and which was originally written by
Nelson Beebe. 

  The other changes are:

	config.h   - definition of FONTAREA and signed_char

	findfile.c - path of types.h and stat.h
		   - VMS specific versions for the font search paths  

	dvi2xx.c   - definition of the functions in VAXVMS.C
		   - writing of output file in a binary format with fixed
			record lengths (512 bytes), this implied that:
			- fwrite didn't work anymore, so another version
			  of EMITB had to be made (using putc).
			- the last record had to be padded with zeros
		   - usage of VAX/VMS specific error codes
		   - definition of 12 for MAXOPEN (because MAXOPEN is
			standard defined as 8).
		   - VAX/VMS doesn't allow the "%hd" format specifier to 
			be used in output statements, so this was changed
			to the "%d" format.

  The program is tested on a MicroVAX-II running VMS 5.3-1 and is compiled
using the VAXC compiler (version 2.3). The compile sequence used is:

	$ CC /DEFINE=(LJ2P,DEBUG) DVI2XX
	$ CC FINDFILE
	$ CC VAXVMS
	$ LINK /EXEC=DVILJ2P DVI2XX,FINDFILE,VAXVMS,SYS$INPUT:/OPT
	SYS$SHARE:VAXCRTL.EXE/SHARE
	^Z

The program can be defined with:

	$ DVILJ2P :== $disk:[directory]DVILJ2P

And can be run with:

	$ DVILJ2P [options] dvi-filename

The uppercase options (such as -D) have to be put between quotation marks,
because the VAX/VMS operating systems converts the command string to lower
case (so: $ DVILJ2P "-D1" dvi-filename).

Only the LJ2P version is compiled and tested. I'm printing the output file 
with the command:

	$ PRINT/QUEUE=queue-name /PASSALL file.LJ


  The only suggestion for some improvements to the program, are in respect
to the \special commands. It would be nice if your program could interpret the
\tpic specials. 

	With kind regards, Henk de Haan

     /-------------------------------+---------------------------------\
    / Henk de Haan                   |  Phone:    +31 15 781398         \
   /  Delft University of Technology |  FAX:      +31 15 786422          \
  /   ISO                            |  E-mail:   H.deHaan@IRI.TUDelft.NL \
 /    p/a IRI                        |  Bitnet:   HAAN@HDETUD5             \
<     Mekelweg 15                    |  DECnet:   IRIMCF::HAAN              >
 \    2629 JB Delft                  |  JANET:    HH01@UK.AC.RL.DE         /
  \   The Netherlands                |  HEPnet:   19477::HH01             /
   \_________________________________|___________________________________/
    \ Phrase:  The only way to cold fusion is Muon Catalyzed Fusion (?) /
     \-----------------------------------------------------------------/

From banko%uiphya.dnet@garcon.cso.uiuc.edu Tue Jun  9 22:03:04 1992
Received: from UIPHYA.DECnet MAIL11D_V3 by garcon.cso.uiuc.edu with SMTP id AA06269
  (5.65d+/IDA-1.4.4 for <neumann@dec4.wu-wien.ac.at>); Tue, 9 Jun 1992 14:53:56 -0500
Date: Tue, 9 Jun 1992 14:53:52 -0500
Message-Id: <199206091953.AA06269@garcon.cso.uiuc.edu>
From: banko%uiphya.dnet@garcon.cso.uiuc.edu (Bradley T. Banko)
To: neumann@dec4.wu-wien.ac.at
Cc: h.dehaan@iri.tudelft.nl
Subject: dvi2xx on VMS success...  Thanks.
Status: OR

Dear Gustaf & Henk,

With a little hacking, we have had success getting dvi2xx to work on our
Vaxstation 3100s running VMS 5.5.  I am enclosing 3 small files below which 
describe the changes we had to make.  (readme.vms, compile.com & vaxvms.c)

Getting a copy of vaxvms.c was our first problem, and then finding the 
"SEVENBIT" define in dvi2xx.c was the final major victory.

Thanks for your help!

Brad Banko
b-banko@uiuc.edu

=======================================================================
readme.vms
=======================================================================

6/9/92  Brad Banko, b-banko@uiuc.edu

The key "defines" are in "config.h" (DEBUG, USEPXL, vms & LJ).
The "main" function type was redefined to be "int".  Vax C wouldn't
compile it with "void main".

A compile/link command file is:  "compile.com".

The key changes are:

	1)  define logical name TEXPXL to refer to the tex fonts
		directory (not device) :== tex_disk:[tex.fonts]
		(instead of tex$pkdir: == tex_disk:[tex.fonts.])

	2)  "#define SEVENBIT" for our older HP Laserjet+.

=========================================================================
>From HAAN@IRIMCF.TUDELFT.NL Thu Oct 17 16:56:16 1991
Received: from IRIMCF.TUDELFT.NL (IRIMCF) by TUDRVA.TUDelft.NL (PMDF #12232) id
 <01GBUYPA7S68AKTSPZ@TUDRVA.TUDelft.NL>; Thu, 17 Oct 1991 16:56 +0100
Date: Thu, 17 Oct 91 16:53 MET
From: H.deHaan@IRIVAX.TUDELFT.NL
Subject: VMS-port of dvi2xx
Sender: Henk de Haan <HAAN@IRIMCF.TUDELFT.NL>
To: NEUMANN@DEC4.WU-WIEN.AC.AT
Message-Id: <01GBUYPA7S68AKTSPZ@TUDRVA.TUDelft.NL>
X-Vms-To: NEUMANN@DEC4.WU-WIEN.AC.AT
Comments: Sent using PMDF-822 V3.0, routing is done by TUDRVA
Status: OR

		Dear Gustaf,

  Thanks for writing the DVI print program for the HP-Laserjet family. 
Because our group recently bought a HP Laserjet 3 printer (for our VAX/VMS
system), we needed a LaTeX driver for it. The only drivers I could locate 
(and that would run on VAX/VMS) are the Beebe drivers, but they are rather
slow and they don't support any \special commands. For this reason I've 
ported your program to VAX/VMS. 

  I'm sending you my changes to your programs (in respect to the DVI2XX,
version 0.50 distribution). All my changes are propely included in #ifdef ...
#endif constructions. I'm also including an extra file (called VAXVMS.C), which
is copied from the DVIPS distribution, and which was originally written by
Nelson Beebe. 

  The other changes are:

	config.h   - definition of FONTAREA and signed_char

	findfile.c - path of types.h and stat.h
		   - VMS specific versions for the font search paths  

	dvi2xx.c   - definition of the functions in VAXVMS.C
		   - writing of output file in a binary format with fixed
			record lengths (512 bytes), this implied that:
			- fwrite didn't work anymore, so another version
			  of EMITB had to be made (using putc).
			- the last record had to be padded with zeros
		   - usage of VAX/VMS specific error codes
		   - definition of 12 for MAXOPEN (because MAXOPEN is
			standard defined as 8).
		   - VAX/VMS doesn't allow the "%hd" format specifier to 
			be used in output statements, so this was changed
			to the "%d" format.

  The program is tested on a MicroVAX-II running VMS 5.3-1 and is compiled
using the VAXC compiler (version 2.3). The compile sequence used is:

	$ CC /DEFINE=(LJ2P,DEBUG) DVI2XX
	$ CC FINDFILE
	$ CC VAXVMS
	$ LINK /EXEC=DVILJ2P DVI2XX,FINDFILE,VAXVMS,SYS$INPUT:/OPT
	SYS$SHARE:VAXCRTL.EXE/SHARE
	^Z

The program can be defined with:

	$ DVILJ2P :== $disk:[directory]DVILJ2P

And can be run with:

	$ DVILJ2P [options] dvi-filename

The uppercase options (such as -D) have to be put between quotation marks,
because the VAX/VMS operating systems converts the command string to lower
case (so: $ DVILJ2P "-D1" dvi-filename).

Only the LJ2P version is compiled and tested. I'm printing the output file 
with the command:

	$ PRINT/QUEUE=queue-name /PASSALL file.LJ

  The only suggestion for some improvements to the program, are in respect
to the \special commands. It would be nice if your program could interpret the
\tpic specials. 

	With kind regards, Henk de Haan

     /-------------------------------+---------------------------------\
    / Henk de Haan                   |  Phone:    +31 15 781398         \
   /  Delft University of Technology |  FAX:      +31 15 786422          \
  /   ISO                            |  E-mail:   H.deHaan@IRI.TUDelft.NL \
 /    p/a IRI                        |  Bitnet:   HAAN@HDETUD5             \
<     Mekelweg 15                    |  DECnet:   IRIMCF::HAAN              >
 \    2629 JB Delft                  |  JANET:    HH01@UK.AC.RL.DE         /
  \   The Netherlands                |  HEPnet:   19477::HH01             /
   \_________________________________|___________________________________/
    \ Phrase:  The only way to cold fusion is Muon Catalyzed Fusion (?) /
     \-----------------------------------------------------------------/

============================================================================
compile.com
============================================================================
$!
$!  The program is tested on a MicroVAX-II running VMS 5.3-1 and is compiled
$!  using the VAXC compiler (version 2.3). The compile sequence used is:
$!
$!  original package from Gustaf Neumann's archive at:
$!    ftp.wu-wien.ac.at
$!
$!  modified and run on Vax VMS 5.5 Vaxstation 3100 with Laserjet+
$!  see README.VMS for more info, Brad Banko, 6/9/92
$!  b-banko@uiuc.edu
$!
$ set verify
$ dvilj :== "$ uiphyb$dka300:[banko.dvi2xx]dvilj.exe"
$ define texpxl tex_disk:[tex.fonts]
$ CC /define=sevenbit DVI2XX
$ CC FINDFILE
$ CC VAXVMS
$ LINK /EXEC=DVILJ DVI2XX,FINDFILE,VAXVMS,SYS$INPUT:/OPT
SYS$SHARE:VAXCRTL.EXE/SHARE

===========================================================================
a vaxvms.c  (no changes, from uxc.cso.uiuc.edu, just fyi)
===========================================================================
/***********************************************************************
This file provides alternative functions for several VMS VMS  C  library
routines which either unacceptable, or incorrect, implementations.  They
have  been developed and  tested under VMS Version  4.4, but indications
are  that they apply  to  earlier versions, back to 3.2  at least.  They
should be retested with each new release of VMS C.

Contents:
	EXIT
	FSEEK
	FTELL
	GETCHAR
	GETENV
	READ
	UNGETC
	getlogin
	qsort
	system
	tell
	unlink

The VAX VMS  file system record  structure has  unfortunate consequences
for random access files.

By default, text  files written by most system  utilities, and languages
other than C, have a variable  length record format,  in  which a 16-bit
character count is  aligned on an  even-byte boundary in the  disk block
b(always 512 bytes   in VMS, independent  of  record and  file  formats),
followed by  <count> bytes of data.   Binary files, such  as .EXE, .OBJ,
and  TeX .DVI  and font  files, all use a  512-byte  fixed record format
which  has no explicit  length  field.  No  file  byte count  is stored;
instead, the block count,  and the  offset of the  last data byte in the
last block are recorded in the file header  (do ``DUMP/HEADER filespec''
to see it).  For binary files with fixed-length  records, the last block
is normally  assumed to be  full,  and  consequently, file   transfer of
binary data from other machines  via Kermit, FTP, or DCL  COPY from ANSI
tapes, generally fails because  the input file length is  not a multiple
of 512.

This record organization may  be contrasted with  the STREAM, STREAM_LF,
and STREAM_CR organizations supported from Version 4.0; in  these,  disk
blocks contain a continuous byte stream in which nothing, or  LF, or CR,
is recognized as a record terminator.  These formats are similar to  the
Unix  and TOPS-20 file system  formats  which also use continuous   byte
streams.

For C, this  means that a  program operating on a file  in record format
cannot count input characters and expect that count to be the same value
as the  offset parameter passed  to fseek(),  which  numerous C programs
assume to  be the case.  The draft  ANSI C  standard,  and  Harbison and
Steele's ``C Reference Manual'', emphasize that only  values returned by
ftell() should be used as arguments to fseek(),  allowing the program to
return to  a position previously read or  written.  UNFORTUNATELY, VMS C
ftell()  DOES NOT  RETURN   A CORRECT  OFFSET VALUE FOR   RECORD  FILES.
Instead, for record files, it returns the byte  offset  of the start  of
the current record, no matter where in that  record the current position
may  be.   This  misbehavior  is  completely unnecessary,   since    the
replacements below perform correctly, and are written entirely in C.

Another problem is that ungetc(char c,  FILE*  fp) is unreliable.  VMS C
implements  characters  as  signed 8-bit integers  (so  do many other  C
implementations).  fgetc(FILE*  fp) returns an int,  not  a  char, whose
value is EOF (-1) in the event of end-of-file;  however, this value will
also  be returned for  a   character  0xFF, so  it  is essential  to use
feof(FILE  *fp) to test  for a  true end-of-file condition  when  EOF is
returned.   ungetc() checks the sign of  its argument c,  and  if it  is
negative (which it will be for 128 of the 256 signed  bytes), REFUSES TO
PUT IT BACK IN THE INPUT STREAM, on the assumption that c is really EOF.
This  too can  be fixed;   ungetc()  should only  do   nothing if feof()
indicates  a  true  end-of-file  condition.   The   overhead of  this is
trivial, since feof() is   actually implemented  as a macro   which does
nothing more than a logical AND and compare-with-zero.

getchar()  waits for a <CR> to  be typed when stdin is  a terminal;  the
replacement vms_getchar() remedies this.

Undoubtedly  other  deficiencies  in   VMS  C will   reveal  themselves.

VMS read() returns   only  a  single  disk   block on  each call.    Its
replacment, vms_read(), will  return  the  requested number of bytes, if
possible.

There are also a  few Unix standard  functions which are  unimplemented.
qsort() is not provided.  getlogin()  and unlink() have VMS  equivalents
provided below.  tell() is considered obsolete, since its  functionality
is available from lseek(), but it is still seen in a few programs, so is
provided below.   getenv()  fails if  the  name contains  a  colon;  its
replacement allows the colon.

In the interest  of  minimal source perturbation,  replacements  for VMS
functions   are  given   the same  names,    but prefixed  "vms_".   For
readability,   the original names  are  preserved,  but are converted to
upper-case:

	#define FTELL vms_ftell
	#define FSEEK vms_fseek
	#define GETCHAR vms_getchar
	#define GETENV vms_getenv
	#define UNGETC vms_ungetc

These  are  only defined to work   correctly for fixed  length  512-byte
records, and no check is made that the file has that organization (it is
possible, but   not without  expensive calls to    fstat(), or access to
internal library structures).

[02-Apr-87]  --	Nelson   H.F.  Beebe,  University  of Utah  Center  for
		Scientific Computing
***********************************************************************/

#define EXIT	vms_exit
#define FTELL	vms_ftell
#define FSEEK	vms_fseek
#define GETENV	vms_getenv
#define GETCHAR vms_getchar
#define READ	vms_read
#define UNGETC	vms_ungetc

#include <stdio.h>
#include <types.h>
#include <ctype.h>
#include <stat.h>
#include <descrip.h>
#include <iodef.h>		/* need for vms_getchar() */
#include <ssdef.h>

/**********************************************************************/
/*-->EXIT*/

void
vms_exit(code)
int code;
{
    switch (code)
    {
    case 0:
	exit(1);			/* success */
	break;

    default:
	exit(2);			/* error */
	break;
    }
}

/**********************************************************************/
/*-->FSEEK*/

/* VMS fseek() and ftell() on fixed-length record files work correctly
only at block boundaries.  This replacement code patches in the offset
within	the  block.  Directions	 from	current	  position   and  from
end-of-file are converted to absolute positions, and then the code for
that case is invoked. */

long
FSEEK(fp,n,dir)
FILE *fp;
long n;
long dir;
{
    long k,m,pos,val,oldpos;
    struct stat buffer;

    for (;;)			/* loops only once or twice */
    {
      switch (dir)
      {
      case 0:			/* from BOF */
	  oldpos = FTELL(fp);	/* get current byte offset in file */
	  k = n & 511;		/* offset in 512-byte block */
	  m = n >> 9;		/* relative block number in file */
	  if (((*fp)->_cnt) && ((oldpos >> 9) == m)) /* still in same block */
	  {
	    val = 0;		/* success */
	    (*fp)->_ptr = ((*fp)->_base) + k; /* reset pointers to requested byte */
	    (*fp)->_cnt = 512 - k;
	  }
	  else
	  {
	    val = fseek(fp,m << 9,0); /* move to start of requested 512-byte block */
	    if (val == 0)	/* success */
	    {
	      (*fp)->_cnt = 0;	/* indicate empty buffer */
	      (void)fgetc(fp);	/* force refill of buffer */
	      (*fp)->_ptr = ((*fp)->_base) + k;	/* reset pointers to requested byte */
	      (*fp)->_cnt = 512 - k;
	    }
	  }
	  return(val);

      case 1:			/* from current pos */
	  pos = FTELL(fp);
	  if (pos == EOF)	/* then error */
	    return (EOF);
	  n += pos;
	  dir = 0;
	  break;		/* go do case 0 */

      case 2:			/* from EOF */
	  val = fstat(fileno(fp),&buffer);
	  if (val == EOF)	/* then error */
	    return (EOF);
	  n += buffer.st_size - 1; /* convert filesize to offset and */
				   /* add to requested offset */
	  dir = 0;
	  break;		/* go do case 0 */

      default:			/* illegal direction parameter */
	  return (EOF);
      }
    }
}

/**********************************************************************/
/*-->FTELL*/

/* With fixed-length record files, ftell() returns the offset of the
start of block.	 To get the true position, this must be biased by
the offset within the block. */

long
FTELL(fp)
FILE *fp;
{
    char c;
    long pos;
    long val;
    if ((*fp)->_cnt == 0)	/* buffer empty--force refill */
    {
	c = fgetc(fp);
	val = UNGETC(c,fp);
	if (val != c)
	    return (EOF);	/* should never happen */
    }
    pos = ftell(fp);		/* this returns multiple of 512 (start of block) */
    if (pos >= 0)		/* then success--patch in offset in block */
      pos += ((*fp)->_ptr) - ((*fp)->_base);
    return (pos);
}
  
/**********************************************************************/
/*-->GETCHAR*/

static int tt_channel = -1;	/* terminal channel for image QIO's */

#define FAILED(status) (~(status) & 1) /* failure if LSB is 0 */

int
GETCHAR()
{
    int ret_char;		/* character returned */
    int status;			/* system service status */
    static $DESCRIPTOR(sys_in,"TT:");

    if (tt_channel == -1)	/* then first call--assign channel */
    {
	status = sys$assign(&sys_in,&tt_channel,0,0);
	if (FAILED(status))
	    lib$stop(status);
    }
    ret_char = 0;
    status = sys$qiow(0,tt_channel,IO$_TTYREADALL | IO$M_NOECHO,0,0,0,
	&ret_char,1,0,0,0,0);
    if (FAILED(status))
        lib$stop(status);

    return (ret_char);
}
  
/**********************************************************************/
/*-->READ*/
int
READ(file_desc,buffer,nbytes)
register int file_desc;
register char *buffer;
register int nbytes;
{
    register int ngot;
    register int left;
    
    for ((left = nbytes, ngot = 0); left > 0; /* NOOP */)
    {
	ngot = read(file_desc,buffer,left);
	if (ngot < 0)
	    return (-1);	/* error occurred */
	buffer += ngot;
	left -= ngot;
    }
    return(nbytes-left);
}

/**********************************************************************/
/*-->UNGETC*/
long
UNGETC(c,fp)	/* VMS ungetc() is a no-op if c < 0 (which is half the time!) */
char c;
FILE *fp;
{

    if ((c == EOF) && feof(fp))
	return (EOF);		/* do nothing at true end-of-file */
    else if ((*fp)->_cnt >= 512)/* buffer full--no fgetc() done in this block!*/
	return (EOF);		/* must be user error if this happens */
    else			/* put the character back in the buffer */
    {
      (*fp)->_cnt++;		/* increase count of characters left */
      (*fp)->_ptr--;		/* backup pointer to next available char */
      *((*fp)->_ptr) = c;	/* save the character */
      return (c);		/* and return it */
    }
}

/**********************************************************************/
/*-->getenv*/
char*
GETENV(name)
char* name;
{
    char* p;
    char* result;
    char ucname[256];

    p = ucname;
    while (*name)	/* VMS logical names must be upper-case */
    {
      *p++ = islower(*name) ? toupper(*name) : *name;
      ++name;
    }
    *p = '\0';

    p = strchr(ucname,':');		/* colon in name? */
    if (p == (char *)NULL)		/* no colon in name */
        result = getenv(ucname);
    else				/* try with and without colon */
    {
	result = getenv(ucname);
	if (result == (char *)NULL)
	{
	    *p = '\0';
	    result = getenv(ucname);
	    *p = ':';
	}
    }
    return (result);
}

/**********************************************************************/
/*-->getlogin*/
char*
getlogin()
{
    return ((char *)getenv("USER")); /* use equivalent VMS routine */
}

/**********************************************************************/
/*-->qsort*/

/***********************************************************************
TeXindex uses  the standard  Unix  library function  qsort()  for
record sorting.  Unfortunately, qsort()  is not a stable  sorting
algorithm, so input order is not necessarily preserved for  equal
sort  keys.    This  is   important,  because   the  sorting   is
case-independent, while  the  actual  entries may  not  be.   For
example, the input

\entry{i}{22}{{\CODE{i}}}
\entry{i}{42}{{\CODE{i}}}
\entry{I}{41}{{\CODE{I}}}
\entry{I}{42}{{\CODE{I}}}

produces

\initial {I}
\entry {{\CODE{i}}}{22}
\entry {{\CODE{I}}}{41--42}
\entry {{\CODE{i}}}{42}

instead of the correct

\initial {I}
\entry {{\CODE{i}}}{22, 42}
\entry {{\CODE{I}}}{41--42}

We  therefore  provide  this  stable  shellsort  replacement  for
qsort() based  on the  code  given on  p.  116 of  Kernighan  and
Ritchie, ``The  C Programming  Language'', Prentice-Hall  (1978).
This has  order  N**1.5  average performance,  which  is  usually
slower than qsort().  In the interests of simplicity, we make  no
attempt to handle short sequences by alternative methods.

[07-Nov-86]
***********************************************************************/

#if VMS_QSORT
#define BASE(i) &base[(i)*width]

void
qsort(base, nel, width, compar)
    char base[];	/* start of data in memory */
    int nel;		/* number of elements to be sorted */
    int width;		/* size (in bytes) of each element */
    int (*compar)();	/* comparison function */
{
    int gap;
    int i;
    int j;

    register int k;	/* inner exchange loop parameters */
    register char* p;
    register char* q;
    register char  c;

    for (gap = nel/2; gap > 0; gap /= 2)
    {
	for (i = gap; i < nel; i++)
	{
	    for (j = i-gap; j >= 0; j -= gap)
	    {
	        p = BASE(j);
		q = BASE(j+gap);
		if ((*compar)(p,q) <= 0)
		    break;	/* exit j loop */
		else
		{
		    for (k = 0; k < width; (++p, ++q, ++k))
		    {
			c = *q;
			*q = *p;
			*p = c;
		    }
		}
	    }
	}
    }
}
#endif
/**********************************************************************
*-->system*
int
system(s)
char *s;
{
	struct	dsc$descriptor t;

	t.dsc$w_length = strlen(s);
	t.dsc$a_pointer = s;
	t.dsc$b_class = DSC$K_CLASS_S;
	t.dsc$b_dtype = DSC$K_DTYPE_T;
	return (LIB$SPAWN(&t) == SS$_NORMAL) ? 0 : 127;
}

**********************************************************************/
/*-->tell*/
long
tell(handle)
int handle;
{
    return (lseek(handle,0L,1));
}

/**********************************************************************/
/*-->unlink*/
int
unlink(filename)
char *filename;
{
	return (delete(filename)); /* use equivalent VMS routine */
}