![[BACK]](/cvsweb/icons/back.gif){kind=icon}
Return to read_me.nr CVS log ![[TXT]](/cvsweb/icons/text.gif){kind=icon}
![[DIR]](/cvsweb/icons/dir.gif){kind=icon}
Up to [CSRG BSD Unix] / 43BSD / games / trek / DOC|
Return to read_me.nr CVS log | Up to [CSRG BSD Unix] / 43BSD / games / trek / DOC |
1.1 ! root 1: .de @h ! 2: 'sp 4 ! 3: 'tl 'TREK SETUP INSTRUCTIONS''%' ! 4: 'sp 2 ! 5: .ns ! 6: .. ! 7: .de @f ! 8: 'bp ! 9: .. ! 10: .wh 0 @h ! 11: .wh -6 @f ! 12: .de pp ! 13: .sp ! 14: .ne 2 ! 15: .ti +5 ! 16: .. ! 17: .de s1 ! 18: .sp 2 ! 19: .nr S1 +1 ! 20: .nr S2 0 ! 21: .ne 5 ! 22: .in 4 ! 23: .ti 0 ! 24: \\n(S1.\ \ \c ! 25: .. ! 26: .de s2 ! 27: .sp 1 ! 28: .nr S2 +1 ! 29: .ne 3 ! 30: .in 8 ! 31: .ti 4 ! 32: \\n(S2.\ \ \c ! 33: .. ! 34: .br ! 35: .ce ! 36: TREK SETUP INSTRUCTIONS ! 37: .sp 2 ! 38: .pp ! 39: This document describes all sorts of nifty things ! 40: you should know ! 41: before you start to muck around ! 42: with the trek source code. ! 43: Please read them carefully. ! 44: .s1 ! 45: MAINTENANCE ! 46: .s2 ! 47: There are a number of shell files ! 48: which you may use to maintain the system. ! 49: "Prtrek" produces a copy of the source code. ! 50: It pipes its output to lpr ! 51: and runs in background. ! 52: "Comp" compiles up to nine source modules ! 53: and leaves them in .o files. ! 54: "Compile" is the same as "comp" ! 55: except that it loads after compiling. ! 56: If stated without any arguments, ! 57: it loads from .o files. ! 58: "Compall" compiles all the .c files ! 59: into .o files, ! 60: but does not load. ! 61: It redirects its output to the file "output". ! 62: To recompile the entire system, ! 63: type ! 64: .ti +8 ! 65: compall ! 66: .ti +8 ! 67: compile ! 68: .br ! 69: .s2 ! 70: Main.c contains a variable called "Mother". ! 71: This is initialized to the result of the ! 72: "getuid()" call for the maintainer of trek ! 73: at your installation. ! 74: Only Mother is allowed to set trace flags ! 75: and run the game at other than the default priority. ! 76: .s2 ! 77: Speaking of priorities, ! 78: trek eats up a lot of system resources. ! 79: Hence, it normally runs at a very low priority. ! 80: This makes it almost impossible to play ! 81: if the system is loaded. ! 82: However, ! 83: the -pN flag sets the priority to N, ! 84: which makes it possible to debug ! 85: when the system is loaded. ! 86: The default priority is set by a #define of ! 87: PRIO, ! 88: which is set to 10 in the default system. ! 89: .s2 ! 90: Trace information is provided ! 91: which may be useful in debugging things in the system. ! 92: If you are in a bad way for space, ! 93: comment out the #define xTRACE ! 94: which appears in trek.h. ! 95: This will cause the trace stuff to not occur ! 96: in the object. ! 97: .s2 ! 98: The version of trek released to you ! 99: is compiled with the -f flag (for no floating point) ! 100: and should work without problems on your machine. ! 101: You can edit out the -f flag ! 102: in "compile" if you have floating point hardware ! 103: on your machine ! 104: so that it will take less space. ! 105: .s1 ! 106: THE PORTABLE C LIBRARY ! 107: .pp ! 108: The portable C library was used ! 109: to do I/O in trek. ! 110: Unfortunately, ! 111: the version which we had at Berkeley ! 112: had a number of small bugs ! 113: which caused trek to do bad things at times. ! 114: For some unknown reason ! 115: (temporary insanity perhaps) ! 116: I rewrote the portable C library. ! 117: This version is much smaller than the old version ! 118: and has cleaner code. ! 119: It also works right ! 120: (???). ! 121: However, there are a few minor differences ! 122: which you should be aware of. ! 123: .s2 ! 124: Scanf no longer ignores the noise characters "\\n", ! 125: "\\t", and space in the format string; ! 126: i.e., ! 127: these characters now require a match ! 128: in the input stream. ! 129: .s2 ! 130: A variable ! 131: f_log ! 132: has been added ! 133: which is the file descriptor ! 134: of a "log" file. ! 135: If f_log is greater than zero ! 136: a copy of everything read from ! 137: the standard input ! 138: and written to ! 139: the standard output ! 140: is written in the file f_log. ! 141: .s1 ! 142: DISCLAIMERS ! 143: .s2 ! 144: Frankly, ! 145: I am getting pretty sick of playing this game. ! 146: Hence, ! 147: the version which you get may have several bugs ! 148: in it; ! 149: I freely admit ! 150: that it is probably buggier ! 151: than some previous versions. ! 152: Sorry about that. ! 153: .s2 ! 154: Along with being buggy, ! 155: the game never had quite everything implemented ! 156: that was originally intended. ! 157: If you see things that look weird, ! 158: that may be why. ! 159: There are even some features which I have taken out ! 160: (like ghost starsystems) ! 161: upon deciding that I didn't have the energy ! 162: to implement them correctly. ! 163: .s1 ! 164: REQUESTS ! 165: .pp ! 166: There are several things that I would like to ask of anyone ! 167: who does work on the source code. ! 168: .s2 ! 169: Please let me know of any bugs which you find ! 170: in the code, ! 171: and any fixes which you may have. ! 172: Other copies will probably be going out to other people later, ! 173: and it would be nice if those copies where less buggy. ! 174: Also, ! 175: I would be interested in hearing about any ! 176: enhancements of the game which you might install. ! 177: .s2 ! 178: Please note that I have a distinct coding style. ! 179: I feel that it is cleaner ! 180: and easier to read than a more ! 181: casual style. ! 182: If possible, ! 183: please stick to it, ! 184: especially if you end up sending tapes back to me. ! 185: This goes along with my whole belief in clean code: ! 186: I ask you to please avoid obscure code ! 187: whenever possible. ! 188: If you throw some in, ! 189: please don't let me see it. ! 190: It just depresses me. ! 191: .s2 ! 192: Unfortunately, ! 193: the game is huge. ! 194: There are many neat things ! 195: which could go in, ! 196: if there were only enough space. ! 197: However, ! 198: I have specifically not gone to seperated I/D ! 199: space. ! 200: The main reason is that I would like future versions ! 201: of the game ! 202: to be 11/40 compatible. ! 203: .s1 ! 204: SUGGESTIONS FOR THE FUTURE ! 205: .pp ! 206: If you happen to have more energy than I do, ! 207: you may want to examine the following areas. ! 208: These are things that I may get to, ! 209: but don't hold your breath. ! 210: .s2 ! 211: Frankly, ! 212: making the portable C library work ! 213: (even without bugs) ! 214: was a bitch. ! 215: I should have done the I/O in a more ! 216: ad hoc manner. ! 217: It is my intent to rewrite the I/O ! 218: routines to bypass the portable C library entirely. ! 219: .s2 ! 220: The routine "capture" is quite unclean. ! 221: First, it should have a manner of selecting Klingons ! 222: other than random, ! 223: either selecting the most likely ! 224: or asking the captain (probably best). ! 225: It should either be fully implemented, ! 226: which includes adding a "board" routine ! 227: (half written, ! 228: on some tapes as board.x) ! 229: which sends a boarding party to forcefully ! 230: take over the Klingon, ! 231: or it should go out completely, ! 232: which is probably what I will end up doing. ! 233: When this happens, ! 234: the transporter will go completely. ! 235: It seems that the space may be better used ! 236: for something which more directly enhances the game. ! 237: .sp 3 ! 238: .in 0 ! 239: Well, that's about it. ! 240: To get hold of me, ! 241: write to: ! 242: .nf ! 243: .sp ! 244: Eric P Allman ! 245: Electronics Research Laboratory ! 246: University of California ! 247: Berkeley, California 94720 ! 248: .fi ! 249: ! 250: Happy trekking!! ! 251: .pp
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.