![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to tr84-13 CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / contrib / icon / docs|
Return to tr84-13 CVS log | Up to [CSRG BSD Unix] / 43BSD / contrib / icon / docs |
1.1 ! root 1: .so tmac.tr ! 2: .DA "August 24, 1984; Revised October 12, 1984" ! 3: .TR 84-13a ! 4: .Gr ! 5: .TL ! 6: Installation and Maintenance Guide ! 7: .br ! 8: for Version 5.9 of Icon ! 9: .AU ! 10: Ralph E. Griswold ! 11: .AU ! 12: William H. Mitchell ! 13: .AE ! 14: .tr *\(** ! 15: .PP ! 16: This document describes how to install Version 5.9 of the Icon programming ! 17: language [1, 2]. ! 18: The distribution of Version 5.9 contains source code for Icon itself, ! 19: documentation, sample programs and tests, the Icon program library [3], ! 20: the procedures from the Icon book [1], test suites to aid in ! 21: porting Icon [4, 5], and various support material. ! 22: .PP ! 23: The installation procedure for Icon is simple; it requires unloading the ! 24: distribution tape onto the target machine, the setting of ! 25: site-specific constants, and the compilation of the Icon ! 26: system itself. ! 27: Read Sections 1 and 2 of this document and the overview of Version 5.9 [2] ! 28: before beginning the installation process. ! 29: .PP ! 30: If Version 5.9 is being installed at a site that is running Version 5.8, ! 31: read Section 3.2 before beginning the installation process. ! 32: .NH 1 ! 33: System Requirements ! 34: .PP ! 35: This distribution of Version 5 Icon is targeted for VAX-11s ! 36: and PDP-11s (with separate instruction and data spaces) ! 37: running the UNIX\u\s-2*\s0\d operating system. This distribution package has been tested ! 38: .FS ! 39: \u\s-2*\s0\dUNIX is a trademark of AT&T Bell Laboratories ! 40: .FE ! 41: under V7 and 4.2bsd, and no problems should be encountered when installing ! 42: Icon under one of these versions of UNIX. ! 43: .PP ! 44: When the system is unloaded, it requires about 2,700 kilobytes of disk space. ! 45: During compilation, about 3,700 kilobytes are required. ! 46: To install subsidiary components and test the entire system, about 4,800 ! 47: kilobytes are required. ! 48: After the removal of unnecessary files, ! 49: about 3,800 kilobytes are required. ! 50: These figures vary slightly depending upon the logical organization of ! 51: a particular file system. ! 52: .PP ! 53: Additional space can be saved by omitting the Icon program library, ! 54: test programs, and so on. See Sections 6.1, 6.2, and Appendix A ! 55: for more information about ! 56: the directories on the distribution tape. On systems with severely ! 57: limited disk space, source code also can be deleted after Icon is installed. ! 58: .NH 1 ! 59: Installation Procedure ! 60: .NH 2 ! 61: Unloading the Distribution Tape ! 62: .PP ! 63: The system is distributed as a \fItar\fR archive on magnetic tape. ! 64: The \fItar\fR ! 65: hierarchy is rooted at the directory \*Mv5g\fR. ! 66: If you already have a \*Mv5g\fR directory from an earlier version of ! 67: Icon, you may wish to move this old directory to a new location, such ! 68: as \*Mv5g.old\fR. ! 69: .PP ! 70: Mount the distribution tape ! 71: and do a \fIcd\fR to the directory that is to hold ! 72: the system hierarchy. ! 73: .PP ! 74: The precise ! 75: \fItar\fR command to unload the distribution ! 76: tape depends on the local environment. ! 77: On a 4.\fIn\fRbsd VAX with a 1600 bpi distribution tape, the following ! 78: command should extract the contents of the tape: ! 79: .Ds ! 80: tar x ! 81: .De ! 82: On a V7 PDP-11 with a 1600 bpi distribution tape, use: ! 83: .Ds ! 84: tar xfb /dev/rmt0 20 ! 85: .De ! 86: For example, if the system is to reside at \*M/usr/src/local/icon/v5g\fR on a VAX, ! 87: type: ! 88: .Ds ! 89: cd /usr/src/local ! 90: mkdir icon ! 91: cd icon ! 92: tar x ! 93: .De ! 94: .LP ! 95: \fINote\fR: File names used in the following sections usually are relative to ! 96: the root directory for the Icon hierarchy. For example, if ! 97: the Icon system is unloaded as described above, the root directory ! 98: is ! 99: .Ds ! 100: /usr/src/local/icon/v5g ! 101: .De ! 102: and ! 103: the file name \*Mv5g/bin/Makefile\fR refers to ! 104: .Ds ! 105: /usr/src/local/icon/v5g/bin/Makefile ! 106: .De ! 107: .NH 2 ! 108: Configuring the Icon System ! 109: .PP ! 110: The installer must perform a site-specific configuration of the Icon ! 111: system. This configuration is done by the shell script ! 112: \*MIcon\-setup\fR. ! 113: \*MIcon\-setup\fR accepts a number of parameters and modifies ! 114: several source files to produce a ready-to-compile Icon system tailored ! 115: as specified by the parameters. ! 116: .PP ! 117: Before \*MIcon\-setup\fR ! 118: modifies a file, it copies a generic version of the ! 119: file into place and works on it. Thus, \*MIcon\-setup\fR can be run a number ! 120: of times and only the last run has any lasting effect. ! 121: \*MIcon\-setup\fR is like any other UNIX command and thus all of its ! 122: arguments must be specified on one logical command line. ! 123: \*MIcon\-setup\fR has the following synopsis: ! 124: .IP \*MIcon\-setup ! 125: .nf ! 126: {\-vax\fR,\*M\-pdp11\fR,\*M\-port} ! 127: \-host\ \fIstring\fP ! 128: [\-sets] ! 129: [\-xpx] ! 130: [\-hz\ \fIrate\fP] ! 131: [\-nofp] ! 132: [\-interpex] ! 133: [\-vfork] ! 134: [\-usg] ! 135: [\-ibin\ \fIlibrary directory for Icon\fP] ! 136: [\-iconx\ \fIlocation of the Icon interpreter\fP] ! 137: [\-debug\*M] ! 138: .fi ! 139: .LP ! 140: The parameters have the following meanings: ! 141: .IP \*M\-vax\fR,\fP\ \ \-pdp11\fR,\fP\ \ \fRor\fP\ \ \-port\fR ! 142: .br ! 143: These are mutually exclusive options that control the selection of ! 144: machine-dependent portions of code. Select one as appropriate. ! 145: \*M\-port\fR is used to set up Icon for transporting to a computer ! 146: for which it previously has not been implemented. ! 147: .IP \*M\-host\fR\ \ \fIstring\fR ! 148: .br ! 149: The Icon system has a keyword, \*M&host\fR, whose value should be the ! 150: name of the host machine where the system is running. On some systems, ! 151: notably 4.2bsd, System III, and System V, it is possible to ! 152: determine the name of the system at run-time via a system call. ! 153: On other systems, 4.1bsd for example, ! 154: the file \*M/usr/include/whoami.h\fR contains ! 155: the name of the host in a \*M#define\fR statement. ! 156: On 4.2bsd, specify \*Mgethost\fR for \fIstring\fR. ! 157: This causes the \fIgethostname(2)\fR function to be used. ! 158: On System III, System V, or some other system that ! 159: supports the \fIuname\fR(2) system call, specify \*Muname\fR for ! 160: \fIstring\fR. On a system with a \*M/usr/include/whoami.h\fR ! 161: file that has a \*M#define\fR for \*Msysname\fR, then specify ! 162: \*Mwhoami\fR for \fIstring\fR. If none of these ! 163: are available on your machine, or to give \*M&host\fR some ! 164: value besides that of the machine name, specify an arbitrary ! 165: string (quotes around it may be needed) for \fIstring\fR, for ! 166: example: \*M\-host\fR\ \ \*MUNIX\fR. ! 167: .IP \*M\-sets\fR ! 168: .br ! 169: This parameter incorporates code to support the set data type, an extension to standard Version 5 that ! 170: is described in [6]. ! 171: This extension adds about 3 kilobytes to the size of the run-time system. ! 172: .IP \*M\-xpx\fR ! 173: .br ! 174: This parameter incorporates a number of other extensions to standard Version 5 as described in [6]. ! 175: These extensions add about 2 kilobytes to the size of the Icon run-time system. ! 176: .IP \*M\-hz\fR\ \ \fIrate\fR ! 177: .br ! 178: This parameter specifies the cycle rate of the electrical environment. ! 179: The rate defaults to 60 Hz. ! 180: \*M\-hz\fR does not need to be specified in a 60-Hz electrical environment. If the ! 181: rate is incorrect, the value of \*M&time\fR will be wrong. ! 182: .IP \*M\-nofp\fR ! 183: .br ! 184: Specify this on a PDP-11 that does not have ! 185: floating-point hardware. ! 186: .IP \*M\-interpex\fR ! 187: .br ! 188: Specify this option on a 4.\fIn\fRbsd system. This option ! 189: causes the use of a feature of the \fIexec\fR(2) system call to make ! 190: interpretable files directly executable. ! 191: Do \fInot\fR specify this option on other systems. ! 192: .IP \*M\-vfork\fR ! 193: .br ! 194: Specify this option if the operating system supports the \fIvfork(2)\fR ! 195: system call; this should be specified for 4.\fIn\fRbsd systems. ! 196: .IP \*M\-usg\fR ! 197: .br ! 198: Specify this option to adapt for minor incompatibilities between V7 UNIX systems ! 199: and UNIX Software Group UNIX systems. In particular, specify this ! 200: for System III or System V UNIX. ! 201: .IP \*M\-ibin\ \fIdirectory\fR ! 202: .br ! 203: The directory \*Mbin\fR ! 204: contains executable versions of the Icon translator (\*Mitran\fR), the Icon ! 205: linker (\*Milink\fR), ! 206: and the run-time system (\*Miconx\fR). The path name of this directory is built ! 207: into \*Micont\fR, the program that controls the ! 208: translation of Icon programs. By default, the fully qualified name ! 209: of \*Mbin\fR is used for \*M\-ibin\fR. ! 210: Specifying \*M\-ibin\fR ! 211: causes \*Micont\fR to use the specified ! 212: directory as its library directory. If an alternate directory is ! 213: specified, after the Icon system is built, ! 214: copy \*Mv5g/bin/itran\fR, \*Mv5g/bin/ilink\fR, \*Mv5g/bin/iconx\fR, ! 215: and \*Mv5g/bin/iconx.hdr\fR ! 216: into the specified directory. ! 217: .IP \*M\-iconx\ \fIinterpreter-location\fR ! 218: .br ! 219: By default, the \fIinterpreter-location\fR is the fully qualified ! 220: name of \*Mv5g/bin/iconx\fR. If \*M\-ibin\fR is specified, then ! 221: \fIinterpreter-location\fR defaults to \fIibin-directory/\*Miconx\fR. ! 222: See Section 3.2 for considerations in chosing the location of the interpreter. ! 223: If the fully qualified name of \*Miconx\fR is longer than 29 characters ! 224: and \*M\-interpex\fR is specified, \*MIcon\-setup\fR considers the ! 225: name to be erroneous. If this happens, consult Section 3.1. ! 226: If an alternate location is specified for \*Miconx\fR, after ! 227: the Icon system is built, copy \*Mv5g/bin/iconx\fR to the ! 228: specified location. ! 229: .IP \*M\-debug\fR ! 230: .br ! 231: This option enables some debugging code; it normally is not used. ! 232: .LP ! 233: The only required options are \*M\-host\fR and one of \*M\-vax\fR, \*M\-pdp11\fR, ! 234: or \*M\-port\fR. ! 235: For example, on a VAX running 4.2bsd, use ! 236: .Ds ! 237: Icon\-setup \-vax \-interpex \-host gethost \-vfork ! 238: .De ! 239: .PP ! 240: On a PDP-11 without floating-point hardware, running Version 7 UNIX, ! 241: and on which \*M&host\fR is to be \*MUNIX Version 7\fR, use ! 242: .Ds ! 243: Icon\-setup \-pdp11 \-nofp \-host "Unix Version 7" ! 244: .De ! 245: On a VAX running System V in a 50-Hz electrical ! 246: environment, on which the library directory for Icon is to be ! 247: \*M/usr/lib/icon\fR, ! 248: the Icon interpreter is to reside at \*M/usr/bin/iconx\fR, ! 249: and all language extensions are to be included, use ! 250: .Ds ! 251: .in 0 ! 252: Icon\-setup \-vax \-hz 50 \-sets \-xpx \-host uname \-usg \-ibin /usr/lib/icon \-iconx /usr/bin/iconx ! 253: .De ! 254: .NH 2 ! 255: Compiling Icon ! 256: .PP ! 257: The Icon distribution tape contains no executable binary files and no ! 258: object files, so the system must be completely recompiled from the ! 259: source. After running \*MIcon\-setup\fR, ! 260: compile the system by doing a \fImake\fR. ! 261: The complete system construction process is: ! 262: .Ds ! 263: cd v5g ! 264: Icon\-setup \fIappropriate arguments\fP ! 265: make Icon ! 266: .De ! 267: .NH 2 ! 268: Installing Icon for Public Use ! 269: .PP ! 270: A copy of ! 271: \*Mv5g/bin/icont\fR may be placed in a public ! 272: directory such as \*M/usr/bin\fR or \*M/usr/local\fR to provide general user ! 273: access to Icon. ! 274: If \*M\-ibin\fR and/or \*M-iconx\fR are specified in \*MIcon\-setup\fR, ! 275: copy the appropriate files to the specified location. For example, ! 276: if the last \*MIcon-setup\fR specification in Section 2.2 were used, ! 277: the following would be done: ! 278: .Ds ! 279: cd v5g/bin ! 280: cp itran ilink iconx iconx.hdr /usr/lib/icon ! 281: cp iconx /usr/bin/icon ! 282: .De ! 283: .PP ! 284: The manual pages \*Micont.1\fR and \*Micon\-pi.1\fR in \*Mv5g/docs\fR ! 285: may be copied ! 286: into \*M/usr/man/man1\fR. ! 287: .NH 2 ! 288: Testing Icon ! 289: .PP ! 290: At this point, Icon system should be working. ! 291: To test the system, ! 292: .Ds ! 293: cd v5g ! 294: make Stdtest ! 295: .De ! 296: which runs a number of standard test programs in the directory \*Mv5g/samples\fR ! 297: and compares them to results from a VAX-11. ! 298: While these tests are not exhaustive, any major installation problems ! 299: should show up when they are run. ! 300: The output of the sample program \*Mhello.icn\fR is certain to ! 301: be different, since it contains time and site-specific code. ! 302: .PP ! 303: The sets and experimental extensions can be tested by ! 304: .Ds ! 305: cd v5g ! 306: make Settest ! 307: .De ! 308: and ! 309: .Ds ! 310: cd v5g ! 311: make Xpxtest ! 312: .De ! 313: respectively. ! 314: Alternatively, all the tests may be run by ! 315: .Ds ! 316: cd v5g ! 317: make Alltest ! 318: .De ! 319: There is also a battery of tests in the directory \*Mv5g/test\fR. These can ! 320: be run, if desired, by ! 321: .Ds ! 322: cd v5g/test ! 323: make Std ! 324: .De ! 325: There are also entries in the \*MMakefile\fR in the \*Mtest\fR directory for ! 326: \*MSet\fR, \*MXpx\fR, and \*MAll\fR. ! 327: See [5] for information on interpreting the results of these tests. ! 328: .PP ! 329: There are other tests in \*Mv5g/port\fR. See [5] for details. ! 330: .NH 1 ! 331: Special Installation Considerations ! 332: .NH 2 ! 333: Direct Execution of Interpretable Files ! 334: .PP ! 335: When an Icon program is processed by the translator ! 336: and linker using the \fIicont\fR command, the result is a file ! 337: containing opcodes and data in a format that the Icon interpreter ! 338: understands. Rather than having the user ``execute'' this interpretable file ! 339: by running the Icon interpreter with the file as an argument, the ! 340: Icon system uses one of two methods to make the interpretable ! 341: files appear to be directly executable. ! 342: .PP ! 343: In 4.1bsd and 4.2bsd systems, a feature of \fIexec\fR(2) ! 344: system call can be used to enable the interpretable file produced by ! 345: the linker to appear to be directly executable. When \fIexec\fR ! 346: is called with a file to execute, it examines the first two ! 347: characters of the file. If the first two characters are \*M#!\fR, \fIexec\fR ! 348: assumes that the next argument on the line is the name of a ! 349: program for which the file is to serve as input. The program ! 350: then is executed with the named file (the file that is being ``executed'') ! 351: as its argument. Thus, instead of having to run the Icon interpreter with the ! 352: interpretable file as input, the interpretable file can be executed directly. ! 353: .PP ! 354: An alternative method is used on systems whose \fIexec\fR(2) system ! 355: call doesn't have this feature. An executable file is prepended ! 356: to the data used by the interpreter. The executable portion of the ! 357: file merely runs the Icon interpreter with the file ! 358: itself and any supplied arguments as the arguments for the interpreter. ! 359: .PP ! 360: If \*M\-interpex\fR is ! 361: specified for \*MIcon\-setup\fR, the former method is used, ! 362: otherwise, the latter method is used. The first method is ! 363: preferable in that the interpretable files are smaller and they ! 364: start executing more quickly. ! 365: .PP ! 366: There is a potential complication in using the first method. ! 367: The 4.1bsd and 4.2bsd \fIexec\fR(2) system calls ! 368: impose a length limitation of 29 characters on the name of ! 369: the program to be run. If the name exceeds 29 characters, execution ! 370: of the interpretable file fails. ! 371: For example, suppose the Icon ! 372: interpreter (\*Miconx\fR) on a system is located at ! 373: \*M/usr/csc/local/icon/v5g/bin/iconx\fR. This path name is longer ! 374: than 29 characters, and is thus unsuitable for inclusion in interpretable ! 375: files. ! 376: .PP ! 377: The length of the path to \*Miconx\fR is checked by \*MIcon-setup\fR and ! 378: the path above would be rejected. ! 379: .PP ! 380: One way to solve the problem is to link ! 381: \*M/usr/csc/local/icon/v5g/bin/iconx\fR to \*M/usr/local/iconx\fR, ! 382: and have interpretable files reference \*M/usr/local/iconx\fR. ! 383: Two things need to be done to accomplish this. ! 384: First, find a location where a copy of \*Mbin/iconx\fR ! 385: can be referenced with a fully qualified path name that is no more than ! 386: 29 characters long. ! 387: Second, when configuring the system using \*MIcon\-setup\fR, specify ! 388: the new location of \*Miconx\fR using the \*M\-iconx\fR option. ! 389: For example: ! 390: .Ds ! 391: Icon\-setup \fIother arguments\fP\ \-iconx /usr/local/iconx ! 392: .De ! 393: Be sure to place a copy of \*Miconx\fR in the specified location after ! 394: the system is completely built. It is also possible to get around ! 395: this problem by not specifying \*M\-interpex\fR and having Icon ! 396: prepend the executable header on interpretable files. ! 397: .NH 2 ! 398: The Effect of Version Changes on Interpretable Files ! 399: .PP ! 400: An interpretable file produced by \*Micont\fR contains a path to the ! 401: interpreter, \*Miconx\fR. ! 402: Thus \*Miconx\fR cannot be moved without invalidating existing ! 403: interpretable files. ! 404: Furthermore, the interpreter for Version 5.9 is ! 405: incompatible with those for previous versions. If, for example, ! 406: Version 5.8 has been in use at a site and Version 5.9 is ! 407: installed with the new \*Miconx\fR at the same location as that ! 408: for Version 5.8, all previous interpretable files will be invalidated. ! 409: .PP ! 410: To avoid this, it may be desirable to retain \*Miconx\fR for Version ! 411: 5.8 and put \*Miconx\fR for Version 5.9 ! 412: at a new location, ! 413: such as \*M/usr/lib/icon/5.9/iconx\fR. See the \*M\-iconx\fR ! 414: option in Section 2.2. ! 415: .NH ! 416: Installing the Icon Program Library ! 417: .PP ! 418: The Icon program library is rooted in \*Mv5g/src\fR. After Icon has ! 419: been installed, the library can be installed by ! 420: .Ds ! 421: cd v5g ! 422: make Library ! 423: .De ! 424: See [3] for a description of program library hierarchy. ! 425: .PP ! 426: There are test programs for the library, which can be run by ! 427: .Ds ! 428: cd v5g ! 429: make Libtest ! 430: .De ! 431: These tests should be unnecessary if previous testing has been ! 432: successful, but they are included in case unexpected problems ! 433: arise. They also may be useful in resolving questions about ! 434: library programs. ! 435: Some tests of the library require the optional extensions that are ! 436: available in Version 5.9 and will malfunction if these extensions ! 437: are not installed. ! 438: The test of \fIfarb(6)\fR probably will produce output that is different ! 439: from the ``standard'' output, since it is dependent on the time of day. ! 440: .NH ! 441: Personalized Interpreters ! 442: .PP ! 443: Version 5.9 contains a facility for building personalized interpreters ! 444: for Icon that allow individuals to augment or modify the Icon ! 445: run-time system easily and quickly. See [7] for details. ! 446: To make this facility available for general user access, a copy of ! 447: \*Mv5g/icon\-pi\fR may be placed in a public area. ! 448: .PP ! 449: A sample personalized interpreter may be built by ! 450: .Ds ! 451: cd v5g ! 452: make Pidemo ! 453: .De ! 454: The result is a personalized interpreter in \*Mv5g/pidemo\fR. This ! 455: personalized interpreter contains the C functions from the ! 456: Icon program library. It may be tested by ! 457: .Ds ! 458: cd v5g ! 459: make Pitest ! 460: .De ! 461: This test compares the results produced locally by this personalized interpreter ! 462: to standard results. Differences should be expected. In addition, some ! 463: of the functions only are supported on VAXs. Tests of these will terminate ! 464: prematurely on a PDP-11. ! 465: .NH 1 ! 466: Maintenance Information ! 467: .PP ! 468: The following sections contain information that is not needed to ! 469: install Icon, but which may be helpful in understanding the ! 470: organization of the system and in maintaining it. ! 471: .NH 2 ! 472: System Layout ! 473: .PP ! 474: The Icon system has several top-level directories branching off from \*Mv5g\fR. ! 475: Only the directories marked with asterisks are ! 476: needed to build Icon: ! 477: .IP \*Mbin*\fR \w'\*Moperators*\fR'u+2n ! 478: Executable versions of various system components. ! 479: Source code for programs that control Icon translation also resides here. ! 480: .IP \*Mh*\fR ! 481: Header files that are included in other source files. ! 482: .IP \*Mtran*\fR ! 483: Source code for the Icon translator. ! 484: .IP \*Mlink*\fR ! 485: Source code for the Icon linker. ! 486: .IP \*Miconx*\fR ! 487: Source code for the Icon interpreter. ! 488: .IP \*Mfunctions*\fR ! 489: Source code for the Icon built-in functions. ! 490: .IP \*Moperators*\fR ! 491: Source code for the Icon operators. ! 492: .IP \*Mlib*\fR ! 493: Source code for run-time support routines that are directly callable from ! 494: an Icon program. ! 495: .IP \*Mrt*\fR ! 496: Source code for the Icon run-time system. ! 497: .IP \*Mpifuncs*\fR ! 498: Source code for the C functions in the Icon program library. ! 499: .IP \*Mpilib*\fR ! 500: Files used to build personalized interpreters. ! 501: .IP \*Msamples\fR ! 502: Sample programs and associated data. ! 503: .IP \*Mpidemo\fR ! 504: Sample personalized interpreter. ! 505: .IP \*Mdocs\fR ! 506: Documentation and manual pages. ! 507: .IP \*Msrc\fR ! 508: Source code for programs and procedures in the Icon program library [3]. ! 509: .IP \*Mibin\fR ! 510: Application programs and games from the Icon program library. ! 511: .IP \*Milib\fR ! 512: Linkable code for procedures in the Icon program library. ! 513: .IP \*Mman\fR ! 514: Manual pages for the Icon program library. ! 515: .IP \*Mlibtest\fR ! 516: Tests for the Icon program library. ! 517: .IP \*Mbook\fR ! 518: Source code for procedures appearing in the Icon book [1]. ! 519: .IP \*Mtest\fR ! 520: Tests programs that are more comprehensive than those in \*Msamples\fR. ! 521: .IP \*Mport\fR ! 522: Support material for transporting Version 5.9 to other computers [4, 5]. ! 523: .LP ! 524: .NH 2 ! 525: Disk Utilization ! 526: .PP ! 527: As mentioned earlier, not all of the directories on the distribution tape ! 528: are needed in order to install Icon. ! 529: Once Icon is working satisfactorily, ! 530: .Ds ! 531: cd v5g ! 532: make Clean ! 533: .De ! 534: can be used to remove ! 535: non-source files and test results. ! 536: Additional disk space can be saved by ! 537: deleting source code after the Icon system is built. ! 538: .PP ! 539: The following table shows the approximate amount of disk space needed ! 540: for the Icon system with the sets and experimental extensions included. ! 541: Phase 1 refers to building Icon proper. Phase 2 refers to the installation ! 542: of subsidiary components and testing in all directories. ! 543: This data was obtained on a VAX running 4.2bsd. ! 544: All figures are in kilobytes. ! 545: .nf ! 546: .sp 1 ! 547: .ta 1.2i 2.4i 3.6i 4.8i ! 548: as distributed after phase 1 after phase 2 after clean up ! 549: .sp .8 ! 550: .ta 1.8iR 3iR 4.2iR 5.4iR ! 551: \*Mbin*\fR 9 161 161 154 ! 552: \*Mh*\fR 40 40 40 40 ! 553: \*Mtran*\fR 192 295 295 192 ! 554: \*Mlink*\fR 83 147 147 83 ! 555: \*Miconx*\fR 54 172 172 54 ! 556: \*Mfunctions*\fR 112 205 205 112 ! 557: \*Moperators*\fR 88 167 167 88 ! 558: \*Mlib*\fR 96 131 131 96 ! 559: \*Mrt*\fR 157 267 267 157 ! 560: \*Mpifuncs*\fR 14 14 26 14 ! 561: \*Mpilib*\fR 6 261 261 261 ! 562: \*Msamples\fR 48 49 65 49 ! 563: \*Mpidemo\fR 1 1 446 446 ! 564: \*Mdocs\fR 479 479 479 479 ! 565: \*Msrc\fR 125 125 125 125 ! 566: \*Mibin\fR 1 1 85 85 ! 567: \*Milib\fR 1 1 143 143 ! 568: \*Mman\fR 319 319 319 319 ! 569: \*Mlibtest\fR 163 163 232 171 ! 570: \*Mbook\fR 192 192 192 192 ! 571: \*Mtest\fR 246 247 348 247 ! 572: \*Mport\fR 257 260 454 260 ! 573: .sp .8 ! 574: total (including root) 2696 3714 4777 3784 ! 575: .NH 2 ! 576: Machine-Dependent Code ! 577: .PP ! 578: Since the same source is used to produce versions of Icon on both VAXs ! 579: and PDP-11s, as well as for porting to other computers, ! 580: the portions of the code that are machine dependent are ! 581: bracketed with preprocessor control statements to select sections ! 582: appropriate for each machine. ! 583: The setup options \*M\-vax\fR, \*M\-pdp11\fR, and \*M\-port\fR ! 584: define the preprocessor symbols \*MVAX\fR, \*MPDP11\fR, and \*MPORT\fR, ! 585: respectively. ! 586: .PP ! 587: Preprocessor control statements are used primarily to select appropriate ! 588: assembly ! 589: source code, but they also are used in a few cases for C source code. ! 590: In some cases where differences are extensive (as for assembler files), ! 591: the section of code for the VAX appears in its entirety ! 592: and is followed by the code for the PDP-11 in its entirety. ! 593: Preprocessor control statements for \*MPORT\fR bracket dummy ! 594: code sections that are filled in as part of the porting process. ! 595: .NH 2 ! 596: Recompilation of System Components ! 597: .PP ! 598: There is a \*MMakefile\fR in \*Mv5g\fR for carrying out various tasks, ! 599: as described in preceding sections. This \*MMakefile\fR typically ! 600: performs corresponding \fImakes\fR in subdirectories. ! 601: .PP ! 602: The subdirectories \*Mv5g/iconx\fR, \*Mv5g/tran\fR, and \*Mv5g/link\fR ! 603: each contain code for a single component of Icon. ! 604: Doing a \fImake\fR in any of these directories causes ! 605: the particular component to be remade. The resulting component may then ! 606: be copied into the \*Mv5g/bin\fR directory. ! 607: .PP ! 608: The subdirectories \*Mv5g/functions\fR, \*Mv5g/lib\fR, \*Mv5g/operators\fR, and \*Mv5g/rt\fR ! 609: each contain source code for a ! 610: part of the Icon run-time system. The Icon interpreter, ! 611: \*Miconx\fR, is formed by linking all the run-time subroutines together with ! 612: the routines in \*Mv5g/iconx\fR. ! 613: When changes are made to the run-time system, all affected ! 614: libraries must be rebuilt and then \*Miconx\fR must be rebuilt. For example, ! 615: if the files \*Mv5g/operators/bang.c\fR and \*Mv5g/functions/read.c\fR ! 616: have been modified, ! 617: the following sequence of commands rebuilds the system. ! 618: .Ds ! 619: .ta 1.75i ! 620: cd v5g/functions ! 621: make ! 622: cd ../operators ! 623: make ! 624: cd ../iconx ! 625: make ! 626: cp iconx ../bin # copy new version of interpreter to bin ! 627: .De ! 628: Alternatively, ! 629: .Ds ! 630: cd v5g ! 631: make Icon ! 632: .De ! 633: has the same affect. ! 634: .PP ! 635: Note that if an alternate directory has been specified in \*MIcon-setup\fR ! 636: via the \*M\-ibin\fR option, the files in \*Mbin\fR must then be copied to ! 637: the alternate directory after the \fImake\fR. ! 638: .NH 2 ! 639: PDP-11 Yacc Modifications for the Icon Translator ! 640: .PP ! 641: .ft R ! 642: This section is relevant only if modifications are to be made to ! 643: the Icon grammar, ! 644: which is contained in the file \*Mtran/icon.g\fR. ! 645: The version of Yacc distributed with VAX systems is large enough ! 646: to build the Icon parser, but it may be necessary to build a ! 647: version of Yacc with larger parameters on a PDP-11. ! 648: The following defined constants in the file \*Mdextern\fR (in ! 649: the \*Myacc\fR source directory) ! 650: should be given the values listed below. ! 651: Larger values are acceptable for all these constants, but ! 652: are not necessary. ! 653: .Ds ! 654: # ifdef HUGE ! 655: # define ACTSIZE 3000 ! 656: # define MEMSIZE 6000 ! 657: # define NSTATES 300 ! 658: # define NTERMS 127 ! 659: # define NPROD 200 ! 660: # define NNONTERM 100 ! 661: # define TEMPSIZE 1200 ! 662: # define CNAMSZ 4100 ! 663: # define LSETSIZE 200 ! 664: # define WSETSIZE 200 ! 665: # endif ! 666: .De ! 667: The constant ! 668: \*MHUGE\fR should be defined instead of \*MMEDIUM\fR ! 669: at the end of the file \*Myacc/files\fR. ! 670: Then Yacc should be rebuilt. ! 671: .NH 2 ! 672: Obtaining Source Code Listings ! 673: .PP ! 674: Execution of the commands ! 675: .Ds ! 676: cd v5g ! 677: make Listall ! 678: .De ! 679: produces ! 680: listings of all source files for the Icon system proper on standard output. ! 681: Use the command ! 682: .Ds ! 683: cd v5g ! 684: make List ! 685: .De ! 686: to obtain listings of all such files that have been altered since the ! 687: last \*Mmake List\fR or \*Mmake Listall\fR. ! 688: .NH ! 689: Electronic Mail and Problem Reporting ! 690: .PP ! 691: A mailbox has been established to facilitate communication with ! 692: the Icon Project. Use the following ! 693: addresses for electronic mail: ! 694: .Ds ! 695: .ta 2.5i ! 696: \*Micon\-project.arizona@csnet\-relay\fR (CSNET and ARPANET) ! 697: \*Marizona!icon\-project\fR (Usenet and uucpnet) ! 698: .De ! 699: The Icon Project currently ! 700: has uucp connections established through \*Mnoao\fR, \*Mmcnc\fR, ! 701: \*Mihnp4\fR, and \*Mutah\-cs\fR. ! 702: .PP ! 703: If any problems are encountered with the Icon system, ! 704: send electronic mail or telephone the Icon Project at ! 705: 602\-621\-6613. ! 706: If these forms of communication are not convenient, use the Trouble Report Forms supplied with ! 707: the distribution package. ! 708: .SH ! 709: Acknowledgements ! 710: .PP ! 711: Rob McConeghy and Steve Wampler made a number of contributions to ! 712: the procedures for installing and maintaining Icon. ! 713: .SH ! 714: References ! 715: .LP ! 716: 1. Griswold, Ralph E. and Madge T. Griswold. ! 717: \fIThe Icon Programming Language\fR. Prentice-Hall Inc., Englewood ! 718: Cliffs, New Jersey. 1983. ! 719: .LP ! 720: 2. Griswold, Ralph E., Robert K. McConeghy, and William H. Mitchell. ! 721: \fIVersion 5.9 of Icon\fR. Technical report, Department of Computer ! 722: Science, The University of Arizona. August 1984. ! 723: .LP ! 724: 3. Griswold, Ralph E. \fIThe Icon Program Library\fR. Technical Report ! 725: TR 84-12, Department of Computer Science, The University of Arizona. ! 726: August 1984. ! 727: .LP ! 728: 4. Mitchell, William H. \fIPorting the UNIX Implementation of Icon\fR. ! 729: Technical Report TR 83-10d, Department of Computer Science, The University ! 730: of Arizona. August 1984. ! 731: .LP ! 732: 5. Griswold, Ralph E. \fIAn Overview of the Porting Process for Version 5.9 ! 733: of Icon\fR. ! 734: Department of Computer Science, The University of Arizona. October 1984. ! 735: .LP ! 736: 6. Griswold, Ralph E., Robert K. McConeghy, and William H. Mitchell. \fIExtensions ! 737: to Version 5 of the Icon Programming Language\fR. ! 738: Technical Report TR 84-10a, ! 739: Department of ! 740: Computer Science, The University of Arizona. ! 741: August 1984. ! 742: .LP ! 743: 7. Griswold, Ralph E., Robert K. McConeghy, and William H. Mitchell. ! 744: \fIPersonalized Interpreters for Icon\fR. Technical Report TR 84-14, ! 745: Department of Computer Science, The University of Arizona. August 1984. ! 746: .Ap "Appendix A \(em Icon Hierarchy" ! 747: .sp 2 ! 748: .ta .5i +.5i +.5i +.3i +.3i +.3i +.3i +.3i +.3i +.3i +.3i ! 749: .ds l \h'|2.5i'\fR ! 750: .nf ! 751: \*Mv5g\*lroot directory of the distribution ! 752: \*M /bin\*l binaries and command processor ! 753: \*M /h\*l header files ! 754: \*M /tran\*l translator ! 755: \*M /link\*l linker ! 756: \*M /iconx\*l interpreter ! 757: \*M /functions\*l built-in functions ! 758: \*M /operators\*l built-in operators ! 759: \*M /rt\*l run-time support ! 760: \*M /lib\*l execution library ! 761: \*M /pifuncs\*l C functions for personalized interpreters ! 762: \*M /pilib\*l library for personalized interpreters ! 763: \*M /samples\*l sample Icon programs ! 764: \*M /distr\*l standard test results ! 765: \*M /local\*l local test results ! 766: \*M /pidemo\*l sample personalized interpreter ! 767: \*M /docs\*l text for documents ! 768: \*M /src\*l source code for the Icon program library ! 769: \*M /cmd\*l Icon programs ! 770: \*M /lib\*l Icon procedures ! 771: \*M /libtest\*l test programs for the Icon program library ! 772: \*M /distr\*l standard test results ! 773: \*M /local\*l local test results ! 774: \*M /ibin\*l executable code for Icon library programs ! 775: \*M /ilib\*l linkable code for Icon program library procedures ! 776: \*M /man\*l manual pages ! 777: \*M /man0\*l text for front matter ! 778: \*M /man1\*l text for Section 1 ! 779: \*M /man2\*l text for Section 2 ! 780: \*M /man3\*l text for Section 3 ! 781: \*M /man6\*l text for Section 6 ! 782: \*M /man7\*l text for Section 7 ! 783: \*M /man8\*l text for Section 8 ! 784: \*M /cat0\*l formatted pages for front matter ! 785: \*M /cat1\*l formatted pages for Section 1 ! 786: \*M /cat2\*l formatted pages for Section 2 ! 787: \*M /cat3\*l formatted pages for Section 3 ! 788: \*M /cat6\*l formatted pages for Section 6 ! 789: \*M /cat7\*l formatted pages for Section 7 ! 790: \*M /cat8\*l formatted pages for Section 8 ! 791: \*M /test\*l test battery ! 792: \*M /distr\*l standard test results ! 793: \*M /local\*l local test results ! 794: \*M /book\*l procedures from the Icon book ! 795: \*M /01\*l procedures from Chapter 1 ! 796: \*M /02\*l procedures from Chapter 2 ! 797: \*M /03\*l procedures from Chapter 3 ! 798: \*M /04\*l procedures from Chapter 4 ! 799: \*M /05\*l procedures from Chapter 5 ! 800: \*M /06\*l procedures from Chapter 6 ! 801: \*M /07\*l procedures from Chapter 7 ! 802: \*M /08\*l procedures from Chapter 8 ! 803: \*M /09\*l procedures from Chapter 9 ! 804: \*M /10\*l procedures from Chapter 10 ! 805: \*M /11\*l procedures from Chapter 11 ! 806: \*M /12\*l procedures from Chapter 12 ! 807: \*M /13\*l procedures from Chapter 13 ! 808: \*M /14\*l procedures from Chapter 14 ! 809: \*M /15\*l procedures from Chapter 15 ! 810: \*M /16\*l procedures from Chapter 16 ! 811: \*M /17\*l procedures from Chapter 17 ! 812: \*M /18\*l procedures from Chapter 18 ! 813: \*M /19\*l procedures from Chapter 19 ! 814: \*M /20\*l procedures from Chapter 20 ! 815: \*M /f\*l procedures from Appendix F ! 816: \*M /port\*l porting tests ! 817: \*M /distr\*l standard test results ! 818: \*M /local\*l local test results ! 819: .Ap "Appendix B \(em Listing of Distributed Icon Files" ! 820: .de Ta ! 821: .ps 8 ! 822: .vs 10 ! 823: .ta 1.1i 2.2i 3.3i 4.4i 5.5i ! 824: .. ! 825: .sp 1 ! 826: .PP ! 827: Files names followed by a slash are directories. Asterisks identify ! 828: executable files (shell scripts). ! 829: .sp ! 830: .Ds ! 831: Icon-setup* functions/ lib/ pifuncs/ test/ ! 832: Makefile h/ libtest/ pilib/ tran/ ! 833: Pimakefile.gen ibin/ link/ port/ ! 834: bin/ icon-pi.gen* man/ rt/ ! 835: book/ iconx/ operators/ samples/ ! 836: docs/ ilib/ pidemo/ src/ ! 837: .Dd ! 838: bin: ! 839: Makefile Makefile.gen icont.c ixhdr.c ! 840: .Dd ! 841: book: ! 842: 01/ 08/ 13/ 18/ alpha.ls ! 843: 02/ 09/ 14/ 19/ f/ ! 844: 04/ 10/ 15/ 20/ page.ls ! 845: 05/ 11/ 16/ Makefile ! 846: 07/ 12/ 17/ READ.ME ! 847: .Dd ! 848: book/01: ! 849: countm1.icn hello1.icn hello3.icn hello5.icn locate2.icn ! 850: countm2.icn hello2.icn hello4.icn locate1.icn ! 851: .Dd ! 852: book/02: ! 853: break1.icn break2.icn break3.icn next.icn ! 854: .Dd ! 855: book/04: ! 856: balop.icn inset2.icn minmax2.icn vbars.icn wordlist1.icn ! 857: icwrite.icn lmark.icn powers.icn word1.icn words1.icn ! 858: inset1.icn minmax1.icn section.icn word2.icn ! 859: .Dd ! 860: book/05: ! 861: array.icn get.icn tabwords1.icn wordlen.icn wordlist2.icn ! 862: .Dd ! 863: book/07: ! 864: exor1.icn expr2.icn fib2.icn fword2.icn ! 865: expr1.icn fib1.icn fword1.icn nword.icn ! 866: .Dd ! 867: book/08: ! 868: maxel.icn words2.icn ! 869: .Dd ! 870: book/09: ! 871: copy1.icn copy2.icn copy3.icn ! 872: .Dd ! 873: book/10: ! 874: display.icn shuffle1.icn ! 875: .Dd ! 876: book/11: ! 877: fibseq1.icn mark.icn rtl.icn ! 878: genword.icn marker.icn to.icn ! 879: .Dd ! 880: book/12: ! 881: tabwords2.icn words3.icn ! 882: .Dd ! 883: book/13: ! 884: alt.icn equalseq.icn every.icn filter1.icn inter.icn ! 885: .Dd ! 886: book/14: ! 887: 8q.icn cross1.icn limit1.icn limit3.icn stars.icn ! 888: break4.icn cross2.icn limit2.icn posint.icn ! 889: .Dd ! 890: book/15: ! 891: abc.icn arbno.icn parsexp.icn recexp.icn tab.icn ! 892: arb.icn lmatch.icn rarb.icn shades.icn ! 893: .Dd ! 894: book/16: ! 895: eq.icn lgraph.icn stree.icn visit.icn ! 896: ldag.icn ltree.icn teq.icn ! 897: .Dd ! 898: book/17: ! 899: close.icn disp.icn reverse.icn shuffle2.icn swap.icn ! 900: .Dd ! 901: book/18: ! 902: add1.icn add2.icn add3.icn mpy.icn ! 903: .Dd ! 904: book/19: ! 905: drv.icn form1.icn symadd.icn ! 906: fix.icn form2.icn symop.icn ! 907: .Dd ! 908: book/20: ! 909: rsg1.icn ! 910: .Dd ! 911: book/f: ! 912: 8qp.icn both.icn fact.icn infix.icn rotate.icn ! 913: abcd.icn btree.icn filerev.icn large.icn rsg2.icn ! 914: acker1.icn cdigit.icn filter2.icn lastline.icn rsg3.icn ! 915: acker2.icn charimage.icn filter3.icn limit4.icn seqimage.icn ! 916: ackertr.icn complex.icn first.icn locate3.icn space.icn ! 917: allbal1.icn dashes.icn fixfunc.icn nchars.icn symmpy.icn ! 918: allbal2.icn delete1.icn form3.icn oddline.icn symsub.icn ! 919: allbal3.icn delete2.icn gener.icn palseq.icn tabwords3.icn ! 920: aver.icn depth.icn genpos.icn pause.icn tcopy.icn ! 921: bincop.icn enrepl.icn gensubstr.icn qseq.icn uscore.icn ! 922: boldface.icn exor2.icn hexcvt.icn repalt.icn vcount.icn ! 923: .Dd ! 924: docs: ! 925: Makefile icont.1 tr83-10a.roff tr84-11 tr84-14 ! 926: READ.ME porting tr83-10b.roff tr84-11a.roff version5.9 ! 927: cover reportform tr83-10c.roff tr84-11b.roff ! 928: distpack tmac.tr tr83-3 tr84-12 ! 929: icon-pi.1 tr83-10 tr84-10 tr84-13 ! 930: .Dd ! 931: functions: ! 932: Makefile exit.c member.c reads.c tab.c ! 933: abs.c find.c move.c real.c table.c ! 934: any.c get.c numeric.c repl.c trim.c ! 935: bal.c image.c open.c reverse.c type.c ! 936: center.c insert.c pop.c right.c upto.c ! 937: close.c integer.c pos.c seq.c write.c ! 938: collect.c left.c proc.c set.c writes.c ! 939: copy.c list.c pull.c sort.c ! 940: cset.c many.c push.c stop.c ! 941: delete.c map.c put.c string.c ! 942: display.c match.c read.c system.c ! 943: .Dd ! 944: h: ! 945: Makefile ctype.h gc.h pnames.h ! 946: config.h defs.s keyword.h record.h ! 947: config.h.gen err.h pdef.h rt.h ! 948: .Dd ! 949: ibin: ! 950: \&.placeholder ! 951: .Dd ! 952: iconx: ! 953: Makefile init.c main.c pstop.s ! 954: Makefile.gen interp.s pstart.s start.s ! 955: .Dd ! 956: ilib: ! 957: \&.placeholder ! 958: .Dd ! 959: lib: ! 960: Makefile coret.s esusp.s limit.c pfail.s ! 961: bscan.c create.c field.c llist.c pret.s ! 962: coact.s efail.s invoke.s lsusp.s psusp.s ! 963: cofail.s escan.c keywd.c mkrec.c ! 964: .Dd ! 965: libtest: ! 966: Functest* t-collate.dat t-gener.dat t-loadmap t-shuffile.dat ! 967: Makefile t-collate.icn t-gener.icn t-math.icn t-shuffle.dat ! 968: Proctest* t-complex.dat t-getenv.icn t-parens t-shuffle.icn ! 969: Proctest.gen* t-complex.icn t-gpack.dat t-patterns.dat t-size.dat ! 970: Prog1test* t-cppp t-gpack.icn t-patterns.icn t-size.icn ! 971: Prog2test* t-cppp.dat t-gset t-pdae.dat t-snapshot.dat ! 972: READ.ME t-cross.dat t-i-psort.dat t-pdae.icn t-snapshot.icn ! 973: distr/ t-csgen.dat t-i-split t-pdco.dat t-structs.dat ! 974: func.tlist t-deal.dat t-i-split.dat t-pdco.icn t-structs.icn ! 975: local/ t-delam t-i-trfil t-queens.dat t-strutil.dat ! 976: pdef.h t-delam.dat t-i-trfil.dat t-radcon.dat t-strutil.icn ! 977: proc.tlist t-delamc t-i-xref.dat t-radcon.icn t-tablc.dat ! 978: prog1.tlist t-delamc.dat t-image.dat t-roffcmds.dat t-tablw.dat ! 979: prog2.tlist t-edscript.dat t-image.icn t-rsg.dat t-trig.icn ! 980: sizes.c t-escape.dat t-iscope.icn t-seek.icn t-trim.dat ! 981: t-bitops.dat t-escape.icn t-labels.dat t-segment.dat t-ttyctl.icn ! 982: t-bitops.icn t-farb.dat t-lam t-segment.icn t-ttyinit.dat ! 983: t-bold.dat t-fset t-lam.dat t-seqimage.dat t-ttyinit.icn ! 984: t-bold.icn t-gcomp t-ll.dat t-seqimage.icn t-worm ! 985: .Dd ! 986: libtest/distr: ! 987: bitops.out escape.out i-xref.out pdco.out snapshot.out ! 988: bold.out farb.out image.out queens.out structs.out ! 989: collate.out fset.out iscope.out radcon.out strutil.out ! 990: complex.out gcomp.out labels.out roffcmds.out tablc.out ! 991: cppp.out gener.out lam.out rsg.out tablw.out ! 992: cross.out getenv.out ll.out seek.out trig.out ! 993: csgen.out gpack.out loadmap.out segment.out trim.out ! 994: deal.out gset.out math.out seqimage.out ttyctl.out ! 995: delam.out i-psort.out parens.out shuffile.out ttyinit.out ! 996: delamc.out i-split.out patterns.out shuffle.out worm.out ! 997: edscript.out i-trfil.out pdae.out size.out ! 998: .Dd ! 999: libtest/local: ! 1000: \&.placeholder ! 1001: .Dd ! 1002: link: ! 1003: Makefile glob.c lcode.c lsym.c ! 1004: builtin.c ilink.c llex.c opcode.c ! 1005: datatype.h ilink.h lmem.c opcode.h ! 1006: .Dd ! 1007: man: ! 1008: Makefile cat3/ man0/ man6/ tmac.an.new ! 1009: cat0/ cat6/ man1/ man7/ tmac.an6n ! 1010: cat1/ cat7/ man2/ man8/ tmac.an6t ! 1011: cat2/ cat8/ man3/ tmac.an tmac.ilib ! 1012: .Dd ! 1013: man/cat0: ! 1014: ptx toc ! 1015: .Dd ! 1016: man/cat1: ! 1017: cppp.1 fset.1 i-trfil.1 loadmap.1 tablc.1 ! 1018: csgen.1 gcomp.1 i-xref.1 parens.1 tablw.1 ! 1019: delam.1 gset.1 labels.1 roffcmds.1 trim.1 ! 1020: delamc.1 i-psort.1 lam.1 rsg.1 ! 1021: edscript.1 i-split.1 ll.1 shuffile.1 ! 1022: .Dd ! 1023: man/cat2: ! 1024: bitops.2 escape.2 patterns.2 segment.2 snapshot.2 ! 1025: bold.2 gener.2 pdae.2 seqimage.2 structs.2 ! 1026: collate.2 gpack.2 pdco.2 shuffle.2 strutil.2 ! 1027: complex.2 image.2 radcon.2 size.2 ttyinit.2 ! 1028: .Dd ! 1029: man/cat3: ! 1030: getenv.3 math.3 trig.3 ! 1031: iscope.3 seek.3 ttyctl.3 ! 1032: .Dd ! 1033: man/cat6: ! 1034: cross.6 deal.6 farb.6 queens.6 worm.6 ! 1035: .Dd ! 1036: man/cat7: ! 1037: i-hier.7 ! 1038: .Dd ! 1039: man/cat8: ! 1040: lman.8 uman.8 ! 1041: .Dd ! 1042: man/man0: ! 1043: ptx.in toc.in toc2 toc4 toc6 toc8 ! 1044: ptxx toc1 toc3 toc5 toc7 ! 1045: .Dd ! 1046: man/man1: ! 1047: cppp.1 fset.1 i-trfil.1 loadmap.1 tablc.1 ! 1048: csgen.1 gcomp.1 i-xref.1 parens.1 tablw.1 ! 1049: delam.1 gset.1 labels.1 roffcmds.1 trim.1 ! 1050: delamc.1 i-psort.1 lam.1 rsg.1 ! 1051: edscript.1 i-split.1 ll.1 shuffile.1 ! 1052: .Dd ! 1053: man/man2: ! 1054: bitops.2 escape.2 patterns.2 segment.2 snapshot.2 ! 1055: bold.2 gener.2 pdae.2 seqimage.2 structs.2 ! 1056: collate.2 gpack.2 pdco.2 shuffle.2 strutil.2 ! 1057: complex.2 image.2 radcon.2 size.2 ttyinit.2 ! 1058: .Dd ! 1059: man/man3: ! 1060: getenv.3 math.3 trig.3 ! 1061: iscope.3 seek.3 ttyctl.3 ! 1062: .Dd ! 1063: man/man6: ! 1064: cross.6 deal.6 farb.6 queens.6 worm.6 ! 1065: .Dd ! 1066: man/man7: ! 1067: i-hier.7 ! 1068: .Dd ! 1069: man/man8: ! 1070: lman.8 uman.8 ! 1071: .Dd ! 1072: operators: ! 1073: Makefile lconcat.c mult.c numle.c sect.c ! 1074: asgn.c lexeq.c neg.c numlt.c size.c ! 1075: bang.c lexge.c neqv.c numne.c subsc.c ! 1076: cat.c lexgt.c nonnull.c plus.c swap.c ! 1077: compl.c lexle.c null.c power.c tabmat.c ! 1078: diff.c lexlt.c number.c random.c toby.c ! 1079: div.c lexne.c numeq.c rasgn.c unioncs.c ! 1080: eqv.c minus.c numge.c refresh.c value.c ! 1081: inter.c mod.c numgt.c rswap.c ! 1082: .Dd ! 1083: pidemo: ! 1084: \&.placeholder ! 1085: .Dd ! 1086: pifuncs: ! 1087: Makefile iscope.c seek.c ttyctl.c ! 1088: getenv.c math.c trig.c ! 1089: .Dd ! 1090: pilib: ! 1091: Makefile Pilib* ! 1092: .Dd ! 1093: port: ! 1094: Linkchecker* basis4.icn esusp1.icn lsusp1.icn roman.icn ! 1095: Linktest.gen* basis5.icn esusp2.icn meander.icn rsg.icn ! 1096: Makefile basis6.icn fail.tlist prefix.icn seqimage.icn ! 1097: Runtest.gen* basis7.icn fail1.icn pret.tlist set1.tlist ! 1098: Runtestall* basis8.icn fail2.icn pret1.icn suspend.tlist ! 1099: Trantest.gen* btrees.icn gc.tlist pret2.icn suspend1.icn ! 1100: arith.tlist cross.icn gc1.icn pret3.icn suspend2.icn ! 1101: arith1.icn display.tlist gc2.icn proto.icn wordcount.icn ! 1102: basis.tlist display1.icn hello.icn psusp.tlist ! 1103: basis1.icn display2.icn lit.icn psusp1.icn ! 1104: basis2.icn distr/ local/ psusp2.icn ! 1105: basis3.icn esusp.tlist lsusp.tlist recogn.icn ! 1106: .Dd ! 1107: port/distr: ! 1108: arith1.out cross.u2 lit.u1 proto.u1 rsg.ux ! 1109: basis1.out cross.ux lit.u2 proto.u2 seqimage.u1 ! 1110: basis2.out display1.out lit.ux proto.ux seqimage.u2 ! 1111: basis3.out display2.out lsusp1.out psusp1.out seqimage.ux ! 1112: basis4.out esusp1.out meander.u1 psusp2.out suspend1.out ! 1113: basis5.out esusp2.out meander.u2 recogn.u1 suspend2.out ! 1114: basis6.out fail1.out meander.ux recogn.u2 wordcount.u1 ! 1115: basis7.out fail2.out prefix.u1 recogn.ux wordcount.u2 ! 1116: basis8.out gc1.out prefix.u2 roman.u1 wordcount.ux ! 1117: btrees.u1 gc2.out prefix.ux roman.u2 ! 1118: btrees.u2 hello.u1 pret1.out roman.ux ! 1119: btrees.ux hello.u2 pret2.out rsg.u1 ! 1120: cross.u1 hello.ux pret3.out rsg.u2 ! 1121: .Dd ! 1122: port/local: ! 1123: \&.placeholder ! 1124: .Dd ! 1125: rt: ! 1126: Makefile cvpos.c doasgn.c host.c pow.c ! 1127: addmem.c cvreal.c dump.c ldfps.s putstr.c ! 1128: alc.c cvstr.c equiv.c lexcmp.c qtos.c ! 1129: anycmp.c dblocks.c exp.c locate.c setbound.s ! 1130: arith.s defany.c fail.s log.c strprc.c ! 1131: cplist.c defcset.c floor.c memb.c suspend.s ! 1132: csv.s deffile.c gc.c mkint.c sweep.c ! 1133: ctype.c defint.c gcollect.s mkreal.c trace.c ! 1134: cvcset.c defshort.c gcvt.c mksubs.c ! 1135: cvint.c defstr.c getstr.c numcmp.c ! 1136: cvnum.c deref.c hash.c outimage.c ! 1137: .Dd ! 1138: samples: ! 1139: Makefile diffwords.icn parallel.dat recogn.icn sieve.icn ! 1140: Test.gen* distr/ parallel.icn roman.dat std.tlist ! 1141: btrees.dat hello.dat pdco.dat roman.icn wordcount.dat ! 1142: btrees.icn hello.icn pdco.icn seqimage.dat wordcount.icn ! 1143: cross.dat local/ prefix.dat seqimage.icn xpx.tlist ! 1144: cross.icn meander.dat prefix.icn set.tlist ! 1145: diffwords.dat meander.icn recogn.dat sieve.dat ! 1146: .Dd ! 1147: samples/distr: ! 1148: btrees.out hello.out pdco.out roman.out wordcount.out ! 1149: cross.out meander.out prefix.out seqimage.out ! 1150: diffwords.out parallel.out recogn.out sieve.out ! 1151: .Dd ! 1152: samples/local: ! 1153: \&.placeholder ! 1154: .Dd ! 1155: src: ! 1156: Makefile cmd/ lib/ ! 1157: .Dd ! 1158: src/cmd: ! 1159: Makefile delam.icn gset.icn lam.icn rsg.icn ! 1160: Makefile.gen delamc.icn i-psort.icn ll.icn shuffile.icn ! 1161: cppp.icn edscript.icn i-split.icn loadmap.icn tablc.icn ! 1162: cross.icn farb.icn i-trfil.icn parens.icn tablw.icn ! 1163: csgen.icn fset.icn i-xref.icn queens.icn trim.icn ! 1164: deal.icn gcomp.icn labels.icn roffcmds.icn worm.icn ! 1165: .Dd ! 1166: src/lib: ! 1167: Makefile complex.icn patterns.icn seqimage.icn strutil.icn ! 1168: Makefile.gen escape.icn pdae.icn shuffle.icn ttyinit.icn ! 1169: bitops.icn gener.icn pdco.icn size.icn ! 1170: bold.icn gpack.icn radcon.icn snapshot.icn ! 1171: collate.icn image.icn segment.icn structs.icn ! 1172: .Dd ! 1173: test: ! 1174: Makefile std10.icn std30.icn std50.icn std70.icn ! 1175: READ.ME std11.icn std31.icn std51.icn std71.icn ! 1176: Test.gen* std12.icn std32.icn std52.icn std72.icn ! 1177: buildt.icn std13.icn std33.icn std53.icn std73.icn ! 1178: dismem.icn std14.icn std34.icn std54.icn std74.icn ! 1179: distr/ std15.icn std35.icn std55.icn std75.icn ! 1180: local/ std16.icn std36.icn std56.icn std76.icn ! 1181: set.tlist std17.icn std37.icn std57.icn std77.icn ! 1182: set01.icn std18.icn std38.icn std58.icn std78.icn ! 1183: set02.icn std19.icn std39.icn std59.icn std79.icn ! 1184: std.tlist std20.icn std40.icn std60.icn std80.icn ! 1185: std01.icn std21.icn std41.icn std61.icn std81.icn ! 1186: std02.icn std22.icn std42.icn std62.icn std82.icn ! 1187: std03.icn std23.icn std43.icn std63.icn std83.icn ! 1188: std04.icn std24.icn std44.icn std64.icn std84.icn ! 1189: std05.icn std25.icn std45.icn std65.icn std85.icn ! 1190: std06.icn std26.icn std46.icn std66.icn xpx.tlist ! 1191: std07.icn std27.icn std47.icn std67.icn xpx01.icn ! 1192: std08.icn std28.icn std48.icn std68.icn xpx02.icn ! 1193: std09.icn std29.icn std49.icn std69.icn xpx03.icn ! 1194: .Dd ! 1195: test/distr: ! 1196: set01.out std17.out std35.out std53.out std71.out ! 1197: set02.out std18.out std36.out std54.out std72.out ! 1198: std01.out std19.out std37.out std55.out std73.out ! 1199: std02.out std20.out std38.out std56.out std74.out ! 1200: std03.out std21.out std39.out std57.out std75.out ! 1201: std04.out std22.out std40.out std58.out std76.out ! 1202: std05.out std23.out std41.out std59.out std77.out ! 1203: std06.out std24.out std42.out std60.out std78.out ! 1204: std07.out std25.out std43.out std61.out std79.out ! 1205: std08.out std26.out std44.out std62.out std80.out ! 1206: std09.out std27.out std45.out std63.out std81.out ! 1207: std10.out std28.out std46.out std64.out std82.out ! 1208: std11.out std29.out std47.out std65.out std83.out ! 1209: std12.out std30.out std48.out std66.out std84.out ! 1210: std13.out std31.out std49.out std67.out std85.out ! 1211: std14.out std32.out std50.out std68.out xpx01.out ! 1212: std15.out std33.out std51.out std69.out xpx02.out ! 1213: std16.out std34.out std52.out std70.out xpx03.out ! 1214: .Dd ! 1215: test/local: ! 1216: \&.placeholder ! 1217: .Dd ! 1218: tran: ! 1219: Makefile err.c lex.c mktoktab.icn sym.h ! 1220: Makefile.gen icon.g lex.h optab synerr.h ! 1221: char.c itran.c lfile.h optab.c token.h ! 1222: char.h itran.h lnklist.c parse.c tokens ! 1223: code.c keyword.c mem.c pscript toktab.c ! 1224: code.h keywords mkkeytab.icn sym.c tree.h ! 1225: .De
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.