Debian Codegraph @

README

raw
1 %% /u/sy/beebe/tex/bibclean/bibclean-2.16/README, Tue Jan 1 08:59:06 2013
2 %% Edit by Nelson H. F. Beebe <[email protected]>
3 %% /u/sy/beebe/tex/bibclean/2-11/README, Mon Oct 2 10:01:31 1995
4 %% Edit by Nelson H. F. Beebe <beebe@sunrise>
5
6 ========================================================================
7
8 ==========
9 Jump start
10 ==========
11
12 As with most GNUware, you can build, test, and install this program on
13 most UNIX systems by these simple steps
14
15 csh et amici:
16 setenv CC ...your favorite C or C++ compiler...
17 ./configure && make all check install
18
19 sh et amici:
20 CC=...your favorite C or C++ compiler...
21 export CC
22 ./configure && make all check install
23
24 If you don't set the CC environment variable, then gcc (or cc, if gcc
25 is not available) will be assumed.
26
27 If you wish to undo a "make install", just do "make uninstall"; this
28 will remove any files in system directories put there by "make
29 install".
30
31 See below for further details, and for instructions for non-UNIX systems.
32
33 This program normally records the username and hostname of the builder;
34 software distributions may wish to suppress that information by
35 undefining HOST and USER at in the make command:
36
37 ./configure && env HOST= USER= make all check install
38
39
40 ============
41 Introduction
42 ============
43
44 This directory contains bibclean, a BibTeX prettyprinter, portability
45 verifier, and syntax checker. It can be used to find errors in .bib
46 files, as well as to standardize their format for readability and
47 editing convenience. It can also be used to convert Scribe-format
48 bibliographies to BibTeX form.
49
50 Binary executables for IBM PC DOS, DEC Alpha OpenVMS, DEC VAX VMS, and
51 Intel x86 Linux may be included in the distribution.
52
53 If you do not require either the IBM PC DOS or LINUX, or the DEC VMS
54 (Alpha and VAX) versions, then you can save about 2.5MB of disk space
55 by deleting the ibmpc and vms subdirectories.
56
57 The default pattern matching in bibclean.c is selected by
58 HAVE_PATTERNS; with it, no regular-expression library support is
59 needed. Should you wish to compile with regular-expression support
60 instead of the HAVE_PATTERNS code, and your system does not have
61 compile()/step (HAVE_REGEXP), or re_comp()/re_exec() (HAVE_RECOMP),
62 you may be able to use the regex-?-??.tar.Z distribution from the Free
63 Software Foundation, available on prep.ai.mit.edu in /pub/gnu.
64
65 In most cases, the HAVE_PATTERNS code is recommended, since it will
66 give identical results across all machines. I was prompted to write
67 it after discovering that there was considerable variety in the
68 regular expression library codes that resulted in different matching
69 on different machines, a most unsatisfactory situation.
70
71 Please report all problems, suggestions, and comments to the author:
72
73 Nelson H. F. Beebe
74 University of Utah
75 Department of Mathematics, 110 LCB
76 155 S 1400 E RM 233
77 Salt Lake City, UT 84112-0090
78 USA
79 Tel: +1 801 581 5254
80 FAX: +1 801 581 4148
81 Email: [email protected], [email protected], [email protected] (Internet)
82 WWW URL: http://www.math.utah.edu/~beebe/
83
84
85 ============
86 Installation
87 ============
88
89 Starting with version 2.10.1, bibclean has been adapted to use the GNU
90 autoconf automatic configuration system for UNIX installations.
91
92 GNU autoconf is run at the author's site to produce the configure
93 script from configure.ac.
94
95 The configure script is run at each installer's UNIX site to produce
96 Makefile from Makefile.in, and config.h from config.hin. The
97 configure script is a large (1800+ lines) Bourne shell program that
98 investigates various aspects of the local C implementation, and
99 records its conclusions in config.h. Interestingly, its probes
100 uncovered a bug in one compiler: lcc 3.4b on Sun Solaris 2.x has an
101 incorrect definition of toupper() in its ctype.h!
102
103 autoconf, at least at the current 2.4 version, is not as C++-aware as
104 it should be. The Makefile must carry out minor edits of the
105 configure script to get it to even work with C++ compilers. The small
106 test programs run by configure to determine the existence of assorted
107 Standard C library functions all lead to incorrect conclusions for
108 config.h, because they intentionally contain function prototypes with
109 different argument types. Since C++ functions are compiled into
110 external names that encode the function and argument types, along with
111 the function name, these prototypes produce references to non-existent
112 functions, causing program linking to fail. Fortunately, I've been
113 able to fix this problem too with additional automatic edits, all
114 carried out by "make configure".
115
116 Should you do a "make maintainer-clean" [NOT recommended, except at the
117 author's site], the configure script will be deleted, and you will
118 need recent versions of both GNU m4 and autoconf correctly installed
119 to reconstruct things, which can be done this way:
120
121 autoconf # Regenerate unedited configure
122 ./configure # Regenerate config.h and Makefile
123 rm configure # delete configure
124 make configure # Regenerate edited configure
125
126 For convenience and safety, the distribution includes a subdirectory
127 named save that contains read-only copies of the files Makefile,
128 config.h, and configure created by autoconf and "make configure".
129 This will allow recovery from a lost or damaged configure file.
130
131 Suitable hand-crafted config.h files are provided for non-UNIX
132 systems, and in the unlikely event of a failure of the configure
133 script on a UNIX system, config.h can be manually produced from a copy
134 of config.hin with a few minutes' editing work. If you do this,
135 remember to save a copy of your config.h under a different name,
136 because running configure will destroy it. If you have GNU autoconf
137 installed (the installation is very simple and source code is
138 available from prep.ai.mit.edu:/pub/gnu/autoconf-x.y.tar.gz), you
139 might try augmenting config.hin instead, then run autoconf and
140 configure.
141
142 Thus, on UNIX, installation normally consists of just two steps
143 (assuming a csh-compatible shell):
144
145 setenv CC ...your favorite C or C++ compiler...
146 ./configure && make all check install
147
148 If you like, add OPT='your favorite optimization flags' to the make
149 command; by default, only -g (debug) is assumed. If your compiler
150 won't accept -g with other optimization levels, then set CFLAGS
151 instead of OPT on the command line; be sure NOT to override any
152 non-optimizing flags in the CFLAGS set in the Makefile.
153
154 The GNU standard installation directories /usr/local/bin for binaries,
155 and /usr/local/man/man1 for manual pages are assumed. The prefix
156 /usr/local can be overridden by providing an alternate definition on
157 the command line:
158
159 make prefix=/some/other/path install
160
161 After installation, you can do
162 make distclean
163 to restore the directories to their distribution state. You should
164 also do this between builds for different architectures from the same
165 source tree; neglecting to do to will almost certainly lead to
166 failure, because the config.cache file created by configure will lead
167 to an incorrect config.h for the next build.
168
169
170 ============
171 UNIX Systems
172 ============
173
174 The code can be compiled with either C (K&R or ISO/ANSI Standard C) or
175 C++ compilers. With some C++ compilers, it may be necessary to supply
176 additional switches for force the compiler to stay in C++ mode, rather
177 than reverting to C mode (e.g. on DEC Alpha OSF/1, you must do
178 setenv CC "cxx -x cxx").
179
180 On UNIX systems, the only changes that you are likely to need in the
181 Makefile are the settings of CC and CFLAGS, and possibly, DEFINES, and
182 if you wish to do "make install", the settings of bindir, MANDIR, and
183 MANEXT.
184
185 If you are installing bibclean on a new system, you should definitely
186 run "make check" before installing it on your system. For the target
187 test-bibtex-2, latex is needed. For test-bibtex-2 and test-scribe-1,
188 bibtex is needed. Sample output of "make check" from a UNIX system
189 is given below.
190
191 The code has been tested under more than 55 different C and C++
192 compilers, and is in regular use to maintain the TeX User Group
193 bibliography collection stored on ftp.math.utah.edu:/pub/tex/bib, as
194 well as several other local bibliographies. These files total more
195 than 1.08M lines and 62K bibliography entries. Some of these
196 bibliographies are mirrored to the Comprehensive TeX Archive Network
197 (CTAN) hosts. Do "finger [email protected]" to find a CTAN site on
198 the Internet near you.
199
200 bibclean is also used for the BibNet Project, which collects
201 bibliographies in numerical analysis. The master collection is
202 available on ftp.math.utah.edu:/pub/bibnet, and is mirrored from there
203 to netlib servers at AT&T and Oak Ridge National Laboratory.
204
205 If you port bibclean to a new system, please select maximal error and
206 warning messages in your compiler, to better uncover problems. If you
207 find massive numbers of errors complaining about function and argument
208 type mismatches, it is likely that this can be remedied by suitable
209 modifications of config.h. As C implementations move towards
210 conformance with the December 1989 ISO/ANSI C Language Standard, the C
211 language is a moving target that must be tracked by config.h, which is
212 why that file is normally automatically generated on UNIX systems by
213 the configure script. With C compilers, you can safely ignore
214 complaints about implicit declaration of library functions; they are
215 caused by deficiencies in the vendor-provided header files.
216
217 If you have a C++ compiler, please try that as well. This code has
218 been successfully compiled under at least 19 C++ compilers, and the
219 stricter type checking has uncovered problems that slipped past other
220 compilers.
221
222 These programs have been successfully built with C and C++ compilers
223 and tested on these systems for the 2.10.1 release:
224
225 DECstation 5000 ULTRIX 4.2 cc, gcc, g++, lcc
226 DEC Alpha OSF/1 3.0, 3.2c cc, c89, cxx, gcc, g++
227 HP 9000/375 BSD 4.3 cc, CC
228 HP 9000/735 HP-UX 9.0 cc, c89, CC, gcc, g++
229 IBM RS/6000 AIX 3.2 cc, c89, xlC, gcc, g++
230 Intel 486 Linux 1.3.15 gcc, g++
231 MIPS RC6280 RISCos 2.1.1AC cc
232 NeXT 68040 Mach 3.0 cc, cc -ObjC, gcc, g++
233 SGI 4D/210 IRIX 4.0.5c cc, gcc, lcc
234 SGI Indigo/2 IRIX 5.3 cc, CC, gcc, g++, lcc
235 SGI Power Challenge IRIX 6.0.1 cc, CC
236 Sun SPARCstation Solaris 2.3,2.4 cc, CC, gcc, g++, lcc
237 Sun SPARCstation SunOS 4.1.3 acc, cc, CC, gcc
238
239 Further details are given below. Where builds have failed, it is
240 usually because of conflicts between system header files.
241
242 The author uses the build-all.sh script for these tests; it tries
243 builds with every known compiler on the development systems. If your
244 UNIX system has other compilers that can be tested, please send their
245 full path names to the author.
246
247
248 ==========
249 IBM PC DOS
250 ==========
251
252 The ibmpc/dos/README file contains details of the builds and tests
253 of bibclean under 8 IBM PC DOS C and C++ compilers, and instructions
254 for building and testing bibclean with other compilers.
255
256 Since bibclean uses no floating-point arithmetic, and PC DOS has no
257 shared libraries, I expect that the executables will run on any
258 version of DOS greater than 4.0. They may also run on earlier
259 versions. At the time of writing, MS-DOS 6.22 is current, and the
260 bibclean executables work fine on it.
261
262
263 =================
264 DEC Alpha OpenVMS
265 =================
266
267 The vms/alpha subdirectory contains these files for DEC Alpha OpenVMS:
268
269 bibclean.exe bibclean executable program
270 config.h hand-coded configuration file
271 recomp.com do @recomp foo to recompile foo.c
272 vmsclean.com do @vmsclean to cleanup after a build
273 vmsmake.com do @vmsmake to build bibclean
274 vmstest.com do @vmstest to test bibclean
275
276 You will have to change one line in vmstest.com to define the disk
277 location of bibclean.exe in the foreign command symbol for bibclean.
278
279 Unlike the UNIX "make check", execution of vmstest.com does not
280 require that latex or bibtex be installed on your system. [I didn't
281 have either on the Alpha OpenVMS system that I built bibclean on.]
282
283
284 ===========
285 DEC VAX VMS
286 ===========
287
288 The vms/vax/README file contains details of the building and testing
289 of bibclean on VAX VMS 6.1
290
291 Unlike the UNIX "make check", execution of vmstest.com does not require
292 that latex or bibtex be installed on your system. [I didn't have
293 either on the VAX VMS system that I built bibclean on.]
294
295 On versions of VMS before 6.1, you may find differences in the vmstest
296 output between testbib1.bok (correct Sun) and testbib1.bib (VAX VMS);
297 characters with octal values 211--215 and 240 disappear from the VAX
298 VMS output. The reason is that on VAX VMS 5.4 (and likely other
299 versions of VAX VMS) isspace() from <ctype.h> classifies those
300 characters as spaces. This problem does NOT exist on DEC Alpha
301 OpenVMS 1.5, or in VMS 6.1. As long as your .bib files do not use
302 those six characters, execution should be correct; for portability,
303 .bib files should restrict themselves to ASCII/ISO-8859 characters in
304 the range 32--127, plus newline and tab.
305
306
307 ===================================
308 Sample "make check" Output for UNIX
309 ===================================
310
311 Here is a log of "make check" on Sun Solaris 2.5 using the native C++
312 compiler, CC:
313
314 CC -c -I. -I. -DHAVE_CONFIG_H -g romtol.c
315 /bin/rm -f match.O
316 if [ -f match.o ] ; then /bin/mv match.o match.O ; fi
317 /bin/rm -f match.o
318 CC -I. -I. -DHAVE_CONFIG_H -g -DTEST -o match \
319 match.c romtol.o
320 /bin/rm -f match.o
321 if [ -f match.O ] ; then /bin/mv match.O match.o ; fi
322
323 ===================== begin match test =======================
324
325 ./match <match.dat >match.lst
326 There should be no differences found:
327 diff match.lok match.lst
328
329 ====================== end match test ========================
330
331 /bin/rm -f romtol.O
332 if [ -f romtol.o ] ; then /bin/mv romtol.o romtol.O ; fi
333 /bin/rm -f romtol.o
334 CC -I. -I. -DHAVE_CONFIG_H -g -DTEST -o romtol romtol.c
335 /bin/rm -f romtol.o
336 if [ -f romtol.O ] ; then /bin/mv romtol.O romtol.o ; fi
337
338 ===================== begin romtol test ======================
339
340 ./romtol <romtol.dat >romtol.lst
341 There should be no differences found:
342 diff romtol.lok romtol.lst
343
344 ====================== end romtol test =======================
345
346 CC -c -I. -I. -DHAVE_CONFIG_H -g bibclean.c
347 CC -c -I. -I. -DHAVE_CONFIG_H -g chek.c
348 CC -c -I. -I. -DHAVE_CONFIG_H -g do.c
349 CC -c -I. -I. -DHAVE_CONFIG_H -g fix.c
350 CC -c -I. -I. -DHAVE_CONFIG_H -g fndfil.c
351 CC -c -I. -I. -DHAVE_CONFIG_H -g isbn.c
352 CC -c -I. -I. -DHAVE_CONFIG_H -g keybrd.c
353 CC -c -I. -I. -DHAVE_CONFIG_H -g match.c
354 CC -I. -I. -g -c -DHOST=\"`hostname`\" -DUSER=\"beebe\" option.c
355 CC -c -I. -I. -DHAVE_CONFIG_H -g strist.c
356 CC -c -I. -I. -DHAVE_CONFIG_H -g strtol.c
357 CC -o bibclean -g bibclean.o chek.o do.o fix.o fndfil.o isbn.o keybrd.o match.o option.o romtol.o strist.o strtol.o
358 ild: (Performing full relink) too many files changed
359
360 ==================== begin BibTeX test 1 =====================
361
362
363 ./bibclean -init-file bibclean.ini testbib1.org >testbib1.bib 2>testbib1.err
364
365 There should be no differences found:
366 diff testbib1.bok testbib1.bib
367
368 There should be no differences found:
369 diff testbib1.eok testbib1.err
370
371 ===================== end BibTeX test 1 ======================
372
373
374 ==================== begin BibTeX test 2 =====================
375
376
377 ./bibclean -init-file bibclean.ini -no-check-values testbib2.org >testbib2.bib 2>testbib2.err
378
379 There should be no differences found:
380 diff testbib2.bok testbib2.bib
381
382 There should be no differences found:
383 diff testbib2.eok testbib2.err
384
385 latex testbib2.ltx >/dev/null
386
387 Expect 6 BibTeX warnings:
388 bibtex testbib2
389 Warning--empty year in Bennett
390 Warning--empty year in Cejchan
391 Warning--there's a number but no volume in Dubowsky:75
392 Warning--empty institution in Diver:88a
393 Warning--empty booktitle in Diver:88
394 Warning--empty year in Diver
395 (There were 6 warnings)
396
397 latex testbib2.ltx >/dev/null
398
399 latex testbib2.ltx
400 This is TeX, Version 3.1415 (C version 6.1)
401 (testbib2.ltx
402 LaTeX Version 2.09 <14 January 1991>
403 (/usr/local/lib/tex/latex/article.sty
404 Document Style `article' <16 Mar 88>.
405 (/usr/local/lib/tex/latex/art10.sty)) (testbib2.aux) (testbib2.bbl [1] [2]
406 [3]
407 Underfull \hbox (badness 1024) in paragraph at lines 261--264
408 [] []\tenrm L. M. Berkovich, V. P. Gerdt, Z. T. Kos-tova, and M. L.
409 [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16]) [17] (testbib2.aux)
410 )
411 (see the transcript file for additional information)
412 Output written on testbib2.dvi (17 pages, 49032 bytes).
413 Transcript written on testbib2.log.
414
415 ===================== end BibTeX test 2 ======================
416
417
418 ==================== begin BibTeX test 3 =====================
419
420
421 ./bibclean -init-file bibclean.ini -fix-font-change testbib3.org >testbib3.bib 2>testbib3.err
422
423 There should be no differences found:
424
425 There should be no differences found:
426 diff testbib3.eok testbib3.err
427
428 ===================== end BibTeX test 3 ======================
429
430
431 ==================== begin BibTeX test 4 =====================
432
433
434 ./bibclean -init-file bibclean.ini -fix-font-change testbib4.org >testbib4.bib 2>testbib4.err
435
436 There should be no differences found:
437
438 There should be no differences found:
439 diff testbib4.eok testbib4.err
440
441 ===================== end BibTeX test 4 ======================
442
443
444 ==================== begin BibTeX test 5 =====================
445
446
447 ./bibclean -init-file bibclean.ini -German-style testbib5.org >testbib5.bib 2>testbib5.err
448
449 There should be no differences found:
450
451 There should be no differences found:
452 diff testbib5.eok testbib5.err
453
454 ===================== end BibTeX test 5 ======================
455
456
457 ==================== begin BibTeX test 6 =====================
458
459 ./bibclean -init-file bibclean.ini testisxn.org >testisxn.bib 2>testisxn.err
460
461 There should be no differences found:
462 diff testisxn.bok testisxn.bib
463
464 There should be no differences found:
465 diff testisxn.eok testisxn.err
466
467 ===================== end BibTeX test 6 ======================
468
469
470 ==================== begin BibTeX test 7 =====================
471
472 ./bibclean -init-file bibclean.ini testcodn.org >testcodn.bib 2>testcodn.err
473
474 There should be no differences found:
475 diff testcodn.bok testcodn.bib
476
477 There should be no differences found:
478 diff testcodn.eok testcodn.err
479
480 ===================== end BibTeX test 7 ======================
481
482
483 ==================== begin Scribe test 1 =====================
484
485
486 ----------------------------------------------------
487
488 ./bibclean -init-file bibclean.ini -scribe -no-check testscr1.org >testscr1.bib
489
490 There should be no differences found:
491 diff testscr1.bok testscr1.bib
492
493 There should be no differences found:
494 diff testscr1.eok testscr1.err
495
496 Expect 5 BibTeX warnings
497 bibtex testscr1
498 Warning--empty publisher in hanson-67
499 Warning--can't use both volume and number fields in kendeigh-52
500 Warning--empty author in singer-portion-chapter
501 Warning--empty author in singer-portion-volume
502 Warning--can't use both author and editor fields in wright-63
503 (There were 5 warnings)
504
505 ----------------------------------------------------
506
507 ./bibclean -init-file bibclean.ini -scribe -no-check testscr2.org >testscr2.bib
508
509 There should be no differences found:
510 diff testscr2.bok testscr2.bib
511
512 There should be no differences found:
513 diff testscr2.eok testscr2.err
514
515 There should be no BibTeX warnings:
516 bibtex testscr2
517 ===================== end Scribe test 1 ======================
518
519
520 ==================== begin Scribe test 2 =====================
521
522 ./bibclean -init-file bibclean.ini -scribe -file -no-check testscr2.org \
523 >testscr2.bib 2>testscr2.err
524
525 There should be no differences found:
526 diff testscr2.bok testscr2.bib
527
528 There should be no differences found:
529 diff testscr2.eok testscr2.err
530
531
532 ./bibclean -init-file bibclean.ini -scribe -file -no-check -no-par testscr2.org \
533 >testscr2.bi2 2>testscr2.er2
534 make: [test-scribe-2] Error 1 (ignored)
535
536 There should be no differences found:
537 diff testscr2.bo2 testscr2.bi2
538
539 There should be no differences found:
540 diff testscr2.eo2 testscr2.er2
541
542 ===================== end Scribe test 2 ======================
543
544
545 ==================== begin Scribe test 3 =====================
546
547 ./bibclean -init-file bibclean.ini -scribe -no-check testscr3.org >testscr3.bib 2>testscr3.err
548
549 There should be no differences found:
550 diff testscr3.bok testscr3.bib
551
552 There should be no differences found:
553 diff testscr3.eok testscr3.err
554
555 ===================== end Scribe test 3 ======================
556
557
558
559 =====================================
560 Details of UNIX installation attempts
561 =====================================
562
563 Clean builds and validations with "setenv CC xxx && ./configure &&
564 make && make check" have been achieved on these systems:
565
566 DEC Alpha OSF/1 3.0
567 /bin/cc
568 /usr/ccs/bin/c89
569 /usr/ccs/bin/cc
570 /usr/local/bin/g++
571 /usr/local/bin/gcc
572 /usr/ucb/cc
573
574 For /bin/cxx, compiler switches to c89 for .c files, and
575 then gets an error which arises because
576 /usr/include/sys/signal.h:468: error: Missing ")".
577 stack_t is not defined by types.h except in Standard C
578 or C++ mode.
579
580 Recent versions of cxx have switch "-x cxx" to force
581 use of C++ compilation for .c files, but older ones do
582 not. On one such old system, I made an experiment
583 with changing extensions from .c to .cxx and updating
584 the Makefile accordingly. The build failed with:
585 ``Fatal: An attempt to allocate memory failed.''
586 during compilation of bibclean.cxx, and with
587 conflicting declarations of swab() from
588 /usr/include/unistd.h and /usr/include/cxx/string.h
589 during compilation of fndfil.cxx. These are both
590 vendor problems that may be fixed in newer releases of
591 the C++ compiler.
592
593 DEC Alpha OSF/1 3.2C (Digital UNIX)
594 /usr/ucb/cxx
595
596 The problems with cxx experienced on OSF/1 3.0 have
597 all disappeared, and I regularly use "cxx -x cxx" as
598 my C/C++ compiler of choice on this system. [The
599 DEC 2100-5/250 on which the compiler is installed has
600 3 CPUs and 2GB of RAM, and each CPU does 250Mflops in
601 benchmarks, so it is a terrific development system!]
602
603 DECstation ULTRIX 4.3
604 /bin/cc
605 /usr/local/bin/g++
606 /usr/local/bin/gcc
607
608 Got many "warning: missing prototype" messages for
609 functions in system header files (because they are
610 still K&R style) with:
611 /usr/local/bin/lcc -A -A
612 but build completed and validated.
613
614 HP 9000/735 HP-UX 9.0.3
615 /bin/cc
616 /bin/c89
617 /usr/bin/CC
618 /usr/local/bin/g++
619 /usr/local/bin/gcc
620
621 For /bin/cc, the compiler warns
622
623 cc: "bibclean.c", line 3723: warning 30: Character
624 constant contains undefined escape sequence.
625 cc: "bibclean.c", line 3730: warning 30: Character
626 constant contains undefined escape sequence.
627
628 but the escape sequence ('\a') IS correctly translated.
629
630 HP 9000/735 HP-UX 10.0.1
631 /bin/cc
632 /bin/c89
633 /usr/bin/CC
634 /usr/local/bin/g++
635 /usr/local/bin/gcc
636
637 The warnings from /bin/cc no longer appear.
638
639 IBM RS/6000 AIX 3.2.5
640 /bin/cc
641 /bin/xlC
642 /usr/bin/c89
643 /usr/local/bin/g++
644 /usr/local/bin/gcc
645
646 IBM RS/6000 AIX 4.1
647 /bin/c89
648 /bin/xlC
649 /usr/bin/c89
650
651 Intel 486 Linux 1.3.15 and 1.3.97 (POSIX)
652 /usr/bin/g++
653 /usr/bin/gcc
654
655 MIPS RC 6280 RISCos 2.1.1AC
656 /bin/cc
657
658 NeXT Turbostation Mach 3.0
659 Compilation with any compiler produces failing links
660 with error: /bin/ld: multiple definitions of symbol _strtol
661 The configure.ac script attempts to deal with this by
662 AC_REPLACE_FUNCS(strtol), but that results in the created
663 Makefile having LIBOBJS=strtol. Building with
664 make LIBOBJS=
665 provides a temporary workaround.
666
667 /usr/local/bin/gcc
668 /bin/cc
669 /usr/local/bin/g++
670
671 Many compilation "warning: missing prototype", plus
672 bibclean.c:2774: undeclared identifier `__ctype'
673 bibclean.c:3158: type error: pointer expected
674 ...
675 for
676 /usr/local/bin/lcc -A -A
677 lcc on this system is an old version (1.9); the
678 current lcc elsewhere is 3.4b, but unfortunately,
679 lcc 3.x dropped support for the Motorola 68xxx
680 code generator. I'm therefore writing off lcc
681 on the NeXT as not viable for software development.
682
683 NeXT Turbostation Mach 3.1
684 /bin/cc
685 /usr/local/bin/g++
686 /usr/local/bin/gcc
687
688 Silicon Graphics Indigo IRIX 4.0.5F
689
690 /usr/bin/cc
691 /usr/local/bin/gcc
692 /usr/local/bin/lcc -A -A
693
694 Compilation fails with
695 /usr/local/bin/g++
696 because of conflicts between system header files and
697 g++ built-in library function declarations.
698
699 Silicon Graphics Indigo-2 IRIX 5.3
700 /bin/cc
701 /usr/local/bin/g++
702 /usr/local/bin/gcc
703 /usr/local/bin/lcc -A -A
704
705 Silicon Graphics Power Challenge IRIX 6.0.1
706 /bin/CC
707 /bin/cc
708
709 For
710 /usr/local/bin/g++
711 and
712 /usr/local/bin/gcc
713 (2.7.0) get assembler errors from generated code.
714
715 Sun SPARC 4/380 Sun SunOS 4.1.3
716 /bin/cc
717 /usr/lang/acc
718 /usr/lang/CC
719 /usr/local/bin/gcc
720 /usr/ucb/cc
721
722 Linking fails with
723 /usr/local/bin/g++
724 because of multiply defined symbols. These arise
725 because g++ generates inline C-style interfaces
726 to library functions like strchr(), but on this
727 system, the library also contains C-style functions
728 with the same name, so linking produces multiple
729 definitions, and failure. Curiously, g++ 2.7.0 on
730 other systems, including Sun Solaris 2.x, does not
731 generate these interface functions, and so does not
732 cause problems there.
733
734 Compilation fails with
735 /usr/local/bin/lcc -A -A
736 because of a conflict in the definition of size_t
737 between /usr/include/sys/stdtypes.h and
738 /usr/local/include/lcc-3.4b/sparc-sun/stdlib.h.
739
740 Sun SPARC 20 Sun Solaris 2.3
741 /opt/SUNWspro/bin/cc
742 /opt/SUNWspro/bin/CC
743 /usr/local/bin/gcc
744 /usr/ucb/cc
745
746 Linking failed for
747 /usr/local/bin/g++
748 with MANY multiply-defined symbols (e.g. memchr in bibclean
749 and fndfil)
750
751 No problem on Solaris 2.4 with g++!
752
753 The reason that configure says
754 checking for strcspn... (cached) no
755 checking for strdup... (cached) no
756 checking for strspn... (cached) no
757 checking for strstr... (cached) no
758 checking for strtod... (cached) no
759 checking for strtol... (cached) no
760 is that it generates a test program with
761 char $ac_func();
762 as the prototype. With C++, that is a separate
763 function that cannot be found in the library. That is
764 also why LIBOBJS is being set incorrectly.
765
766 *** Need to check out g++ and lcc on this system ***
767 Build failed for
768 /usr/local/bin/lcc -A -A
769 with message
770 configure: error: can not run test program while cross compiling
771 This happens because configure uses -g, which blows
772 compilation because of unknown opcode ".stabd" errors
773 in assembler.
774
775 Can be fixed by manually changing configure line
776 test "${CFLAGS+set}" = set || CFLAGS="-g"
777 to
778 test "${CFLAGS+set}" = set || CFLAGS=""
779
780 There is another problem: STDC_HEADERS is not defined,
781 because a test program created by configure detects an
782 error in toupper(). This was traced to a bug in lcc's
783 ctype.h, and has been reported to the lcc-bugs list.
784 A manual patch to config.h solves the problem.
785
786 ===============================[The End]===============================