Annotation of researchv9/cmd/emacs/kbase, revision 1.1.1.1

1.1       root        1: Infer Fails from { start }
                      2: Hypothesis Findenv: {
                      3:        Ask: "Which of the following describes your situation"
                      4:        Replies: {
                      5:                onsystem: "I am on the same system as is having the problem"
                      6:                indirectory: "My current working directory is the emacs source directory"
                      7:        }
                      8: }
                      9: Hypothesis Fails: {
                     10:        Ask: "Which of the following describes the problem"
                     11:        Replies: {
                     12:                Nocompile: "makefile doesn't finish"
                     13:                Earlyfail: "dumps or otherwise fails without displaying anything sensible"
                     14:                Error43: "displays can't open error file for error number 43"
                     15:                Badio: "comes up but does not respond or does not respond normally to input"
                     16:                Command_bug:  "comes up but some commands or macros don't behave as expected"
                     17:                Termbug: "works normally on some terimals but fails on others"
                     18:        }
                     19: }
                     20: Hypothesis Nocompile: {
                     21:        Ask: "Where does the makefile fail"
                     22:        Replies: {
                     23:                Loaderror: "The ld command reports errors"
                     24:                Ccerror: "One of the compiles fails"
                     25:                makerror: "The make command complains about the makefile"
                     26:                othermake: "Some other command in the makefile complains"
                     27:        }
                     28: }
                     29: Hypothesis Badio: {
                     30:        Ask: "What kind of behavior do you see"
                     31:        Replies: {
                     32:                stopinput: "It displays, but stops doesn't respond
                     33:                to typed characters, or stops responding after a few
                     34:                characters"
                     35:                slowecho: "Sometimes a character doesn't echo until
                     36:                after a second character is typed"
                     37:                junkscreen: "The screen contains unrecognizeable garbage"
                     38:        }
                     39: }
                     40: 
                     41: Infer Bad_3b2 from { slowecho 3b }
                     42: Infer Getmachine from junkscreen
                     43: Infer Termbug certainty 20 from junkscreen
                     44: 
                     45: Infer Getmachine certainty 50 from { nocompile }
                     46: Hypothesis Loaderror: {
                     47:        Ask: "What is the nature of the ld errors"
                     48:        Replies: {
                     49:                lundef: "Undefined symbols"
                     50:                lmuldef: "Multiply defined symbols"
                     51:                Missingobj: "Missing objects or libraries"
                     52:        }
                     53: }
                     54: Hypothesis Missingobj: {
                     55:        Explain: "If you are missing libraries, make sure you have
                     56:        the proper libraries set in the compile of xemacs.  If you
                     57:        are missing emacs objects, make sure you have all of the C
                     58:        sources.  Otherwise, make on your system may not be
                     59:        compatible with the makefile, run the procedures indicated manually"
                     60: }
                     61: Hypothesis Ccerror: {
                     62:        Ask: "Which file(s) fail to compile"
                     63:        Replies: {
                     64:                emacs_main:     "emacs_main.c"
                     65:                emacs_disp: "emacs_disp.c"
                     66:                emacs_cmds: "emacs_cmds.c"
                     67:                emacs_io: "emacs_io.c"
                     68:                emacs_buf: "emacs_buf.c"
                     69:                emacs_re: "emacs_re.c"
                     70:                ecomp: "ecomp.c"
                     71:        }
                     72:        Explain: "If you can, check the code for syntactic correctness
                     73:        You may have a damaged copy of the file that won't compile"
                     74: }
                     75: 
                     76: Infer Ccerror certainty 2 from { emacs_main }
                     77: Infer Ccerror certainty 2 from { emacs_cmds }
                     78: Infer Ccerror certainty 2 from { emacs_buf }
                     79: Infer Ccerror certainty 2 from { emacs_io }
                     80: Infer Ccerror certainty 2 from { emacs_re }
                     81: Infer Ccerror certainty 2 from { emacs_disp }
                     82: 
                     83: Hypothesis Getversion: {
                     84:        Ask: "Which of the following unix versions are you compiling for?"
                     85:        Replies: {
                     86:                bsdunix: "Any berkeley version"
                     87:                attunix: "System V, system III, or any other AT&T unix version"
                     88:                pwbunix: "PWB unix, unix 1.2, 2.0, or version 6 unix"
                     89:                msdos: "PC-DOS or MS-DOS"
                     90:        }
                     91: }
                     92: Hypothesis Getmachine: {
                     93:        Ask: "Which of the following machines are you compiling for?"
                     94: 
                     95:        Replies: {
                     96:                uts:    "Amdahl UTS"
                     97:                pdp11: "DEC 11/70 or equivalent"
                     98:                vax:    "Dec vax (all models)"
                     99:                3b:     "AT&T 3B family"
                    100:                8086:   "Intel 8086 or 8088 based system"
                    101:                u370:   "Unix/370"
                    102:        }
                    103: }
                    104: 
                    105: Conclude attunix from u370
                    106: Conclude attunix from uts
                    107: Conclude attunix from 3b
                    108: Infer Getversion from { !uts !u370 !3b }
                    109: Conclude feps from uts
                    110: Conclude feps from u370
                    111: Infer Get_terminal_support certainty 30 from { junkscreen } 
                    112: Infer Get_terminal_support certainty 30 from { loaderror } 
                    113: Infer Get_terminal_support certainty 30 from { ccerror }
                    114: Infer Amdahl_bug certainty 70 from { uts command_bug }
                    115: Infer Get_terminal_support certainty 20 from { earlyfail }
                    116: Infer Portext_bug certainty 50 from { dinternal junkscreen }
                    117: Infer Portext_bug certainty 0 from uts
                    118: Infer Portext_bug certainty 0 from u370
                    119: Infer Getmachine certainty 15 from { command_bug }
                    120: Infer Getmachine certainty 25 from { earlyfail }
                    121: Infer Getmachine certainty 25 from { badio }
                    122: 
                    123: Hypothesis Get_terminal_support: {
                    124:        Ask: "What terminal support are you using"
                    125:        Replies: {
                    126:                dinternal: "Emacs internal (no special defines)"
                    127:                dtermcap: "Termcap (-DTERMCAP in the makefile)"
                    128:                dterminfo: "Terminfo/curses (-DTERMINFO in the makefile)"
                    129:        }
                    130: }
                    131: Infer Missing_libraries certainty 40 from { dtermcap lundef }
                    132: Infer Missing_libraries certainty 40 from { dterminfo lundef }
                    133: Infer Old_termcap certainty 50 from { lmuldef dtermcap }
                    134: Infer Bad_terminfo certainty 40 from { emacs_disp dterminfo }
                    135: Infer Bad_terminfo certainty 30 from { lundef dterminfo lcurses }
                    136: Hypothesis Bad_terminfo: {
                    137:        Ask: "Do you have either of these problems"
                    138:        Replies: {
                    139:                curtermdef: "cur_term undefined in emacs_disp, or illegal references to it" 
                    140:                curtermobj: "cur_term undefined at load time"
                    141:        }
                    142:        Explain: "You seem to have an inconsistency between the
                    143:        curses.h include file and the curses library.  If you get
                    144:        the message at load time, make sure your curses.h includes
                    145:        #define SINGLE.  If you get it at compile time, remove the
                    146:        offending code from emacs."
                    147: }
                    148: Infer Bad_terminfo certainty 0 from { !curtermdef !curtermobj }
                    149: 
                    150: Hypothesis Old_termcap: {
                    151:        Ask: "Are some or all of these symbols multiply defined"
                    152:        Replies: {
                    153:                pcundef: "PC, BC, or DO"
                    154:        }
                    155:        Explain: "You seem to have an old termcap system.  To use
                    156:        it, you must define all of these must be declared as
                    157:        \"extern\" inside of emacs."
                    158: }
                    159: Infer Old_termcap certainty 0 from { !pcundef }
                    160: 
                    161: Hypothesis Missing_libraries: {
                    162:        Ask: "Did you include either of the following on in the
                    163:        arguments to the final compile"
                    164:        Replies: {
                    165:                lcurses: "-lcurses (or whatever your curses library is)"
                    166:                ltermcap: "-ltermcap (or whatever your termcap library is)"
                    167:        }
                    168:        Explain: "If you compile for terminfo/curses (-DTERMINFO) you
                    169:        must include -lcurses in the compile.  If you compile for
                    170:        termcap (-DTERMCAP) you must include -ltermcap in the final compile"
                    171: }
                    172: Infer Missing_libraries certainty 0 from { lcurses dterminfo }
                    173: Infer Missing_libraries certainty 0 from { ltermcap dtermcap }
                    174: 
                    175: Hypothesis Amdahl_bug: {
                    176:        Ask: "Did you include any of the following compilation flags"
                    177:        Replies: {
                    178:                gflag: "-g (get symbol table)"
                    179:        }
                    180:        Explain: "On some or all Amdahl systems, the -g flag causes
                    181:        external symbols not to be properly resolved.  Please
                    182:        recompile without it"
                    183: }
                    184: Infer Amdahl_bug certainty 0 from { !gflag }
                    185: 
                    186: Hypothesis Portext_bug: {
                    187:        Ask: "Did you include any of the following in VFLAGS"
                    188:        Replies: {
                    189:                dportext: "-DPORTEXT (more portable externals)"
                    190:        }
                    191:        Explain: "Include -DPORTEXT in the setting of VFLAGS, remove
                    192:        emacs_disp.c, and try again.  This flag is needed for some
                    193:        system V release 2 systems that do not allocate external
                    194:        symbols contiguously"
                    195: }
                    196: Infer Portext_bug certainty 0 from { dportext }
                    197: Infer Bad_vflags certainty 20 from { !attunix }
                    198: Infer Bad_vflags certainty 30 from { emacs_io }
                    199: 
                    200: Hypothesis Bad_vflags: {
                    201:        Ask: "Which of the following did you set in VFLAGS"
                    202:        Replies: {
                    203:                dbsd: "-Dbsd"
                    204:                dux3: "-Dux3"
                    205:                dpc: "-DPC"
                    206:        }
                    207: }
                    208: Infer Missing_ux3 from { attunix !dux3 }
                    209: Infer Missing_ux3 from { uts !dux3 }
                    210: Infer Missing_bsd from { bsdunix !dbsd }
                    211: Infer Bad_ux3 from { dux3 !attunix !uts }
                    212: Infer Bad_bsd from { dbsd !bsdunix }
                    213: Infer Bad_pc from { dpc !msdos }
                    214: Infer Missing_pc from { msdos !dpc }
                    215: 
                    216: Hypothesis Missing_pc: {
                    217:        Explain: "The -DPC flag must be set when compiling the PC
                    218:        version of emacs."
                    219: }
                    220: Hypothesis Bad_pc: {
                    221:        Explain: "The -DPC flag should only be set when compiling
                    222:        the PC version of emacs."
                    223: }
                    224: Hypothesis Missing_ux3: {
                    225:        Explain: "The flag -Dux3 should be set for any recent AT&T
                    226:        version or any other unix version compatible with system III
                    227:        or system V unix"
                    228: }
                    229: Hypothesis Missing_bsd: {
                    230:        Explain: "The flag -Dbsd should be set for any berkeley unix
                    231:        version"
                    232: }
                    233: Hypothesis Bad_ux3: {
                    234:        Explain: "the flag -Dux3 should be set only for recent AT&T
                    235:        unix systems"
                    236: }
                    237: Hypothesis Bad_bsd: {
                    238:        Explain: "the flag -Dbsd should be set only for Berkeley
                    239:        unix systems"
                    240: }
                    241: Infer Bad_bsd_select certainty 20 from { dbsd }
                    242: Infer Bad_bsd_select certainty 30 from { bsd41 bsdother }
                    243: Infer Bad_bsd_select certainty 20 from { bsdunix emacs_io }
                    244: 
                    245: Hypothesis Bad_bsd_select: {
                    246:        Ask: "Which berkeley version are you compiling for"
                    247:        Replies: {
                    248:                bsd42: "4.2bsd"
                    249:                bsd41: "4.1bsd"
                    250:                bsdother: "Other berkeley versions"
                    251:        }
                    252:        Explain: "The berkeley version assumes 4.2bsd by default. 
                    253:        If you wish to compile for another, make the following changes:
                    254:        
                    255:                Change sys/time.h to time.h in the include files in
                    256:                emacs_io.c
                    257:                
                    258:                Remove the definitions of SELECT and CBREAK in
                    259:                emacs_io.c unless your system supports these in a
                    260:                way compatible with 4.2bsd."
                    261: }
                    262: Infer Bad_bsd_select certainty 0 from { bsd42 }
                    263: Hypothesis Error43: {
                    264:        Ask: "How was the emacs object produced?"
                    265:        Replies: {
                    266:                justcompiled: "Just compiled, nothing moved or
                    267:                deleted since"
                    268:                oldcompiled: "Compiled some time ago, source or
                    269:                object may have been moved"
                    270:                installed: "Compiled using \"make install\""
                    271:        }
                    272: }
                    273: Infer Source_moved certainty 50 from { oldcompiled error43 }
                    274: Infer Bad_library certainty 50 from { installed error43 }
                    275: Infer Amdahl_bug certainty 20 from { justcompiled error43 }
                    276: Infer Protection_bug certainty 30 from { justcompiled error43 }
                    277:        
                    278: Hypothesis Bad_library: {
                    279:        Explain: "You probably did not get the \"LIBDIR\" variable
                    280:        set properly in the makefile. First make sure you can make
                    281:        and run xemacs.  Then remove the terminals.x file,
                    282:        check the LIBDIR entry, and try again to make install"
                    283: }
                    284: Hypothesis Source_moved: {
                    285:        Explain: "Emacs depends on being able to access the
                    286:        \"terminals\" directory, helpfile, errfile, and all of the
                    287:        files in the terminals directory.  If any of these have been
                    288:        moved since compilation, or if they are not currently
                    289:        readable by all, you must recompile and make sure all files
                    290:        under the source directory are publicly readable."
                    291: }
                    292: Hypothesis Protection_bug: {
                    293:        Ask: "Does the problem occur"
                    294:        Replies: {
                    295:                forothers: "When run by other unprivileged users"
                    296:                forowner: "When run by the user who owns the source"
                    297:        }
                    298: }
                    299: Infer Source_moved from { forothers !forowner }
                    300: Hypothesis Termbug: {
                    301:        Ask: "Does the terminal problem appear to be associated with"
                    302:        Replies: {
                    303:                tusers: "only with certain users"
                    304:                tterms: "only on certain kinds of terminals"
                    305:                tlan: "only when emacs is accessed over a local area network"
                    306:        }
                    307: }
                    308: Infer Protection_bug certainty 80 from { termbug tusers }
                    309: Infer Describe_terminal_bug certainty 50 from { termbug }
                    310: Infer Get_terminal_support certainty 40 from { termbug }
                    311: Hypothesis Describe_terminal_bug: {
                    312:        Ask: "Which of the following applies to your problem"
                    313:        Replies: {
                    314:                badisp: "The display is always wrong, or wrong after
                    315:                certain commands"
                    316:                sqbotch: "Emacs sometimes goes into search mode all by itself"
                    317:                markbreak: "Emacs says 'BREAK' when I try to set the mark"
                    318:                flowbotch: "An small or empty buffer displays fine,
                    319:                but the display is garbled when displaying a full screen"
                    320:                stopout: "Output is garbled when you type during output"
                    321:                Screensize: "Emacs says that the screen is too large"
                    322:                noterm: "Emacs doesn't recognize the terminal type"
                    323:        }
                    324: }
                    325: Infer Command_bug certainty 15 from badisp
                    326: Infer Get_termtype certainty 50 from { tterms }
                    327:        
                    328: Hypothesis Get_termtype: {
                    329:        Ask: "What type of terminal is failing"
                    330:        Replies: {
                    331:                
                    332:                termpc: "A personal computer used as a terminal"
                    333:                termvt100: "Dec vt100 or compatible terminal"
                    334:                termhpbomb: "hp 2621B"
                    335:                termblit: "Blit or tty 5620"
                    336:                termfast: "A terminal running at 9600 baud"
                    337:                other: "Other"
                    338:        }
                    339: }
                    340: Infer Badpc from { termpc noterm }
                    341: Infer Badpc certainty 20 from { tterms termpc }
                    342: Infer Flowlim certainty 30 from { flowbotch tlan }
                    343: Infer Flowlim certainty 30 from { sqbotch }
                    344: Infer Slowterm certainty 20 from { sqbotch }
                    345: Infer Slowterm certainty 1 from { !termhpbomb !termvt100 }
                    346: Infer Slowterm certainty 50 from { termfast }
                    347: Infer Slowterm certainty 20 from { flowbotch }
                    348: Infer Termbug certainty 70 from { eatsq }
                    349: Infer Eatflow from {eatsq tlan}
                    350: Infer Eatflow certainty 70 from { eatsq termblit }
                    351: Infer Eatflow certainty 50 from { eatsq termvt100 }
                    352: Infer Flowlim certainty 70 from { stopout }
                    353: Infer Badsize certainty 20 from { termpc badisp }
                    354: Infer Missing_term certainty 20 from { noterm }
                    355: 
                    356: Hypothesis Flowlim: {
                    357:        Ask: "Is the following mode set to something other than 0"
                    358:        Replies: {
                    359:                flowlim: "flow_lim"
                    360:        }
                    361:        Explain: "With flow_lim mode set, type-ahead of ^S or ^Q will
                    362:        confuse the display.  Avoid typing these characters while
                    363:        emacs is displaying output.  You may wish to set flow_lim
                    364:        mode to zero and try again, but this may cause other
                    365:        problems if you have a slow terminal or are hooked to a
                    366:        local area network"
                    367: }
                    368: Infer Flowlim certainty 0 from { !flowlim }
                    369: Infer Badlan certainty 40 from { !flowlim tlan badisp }
                    370: Infer Badlan certainty 40 from { !flowlim tlan sqbotch }
                    371: Hypothesis Badpc: {
                    372:        Explain: "If you are using a personal computer, make sure
                    373:        you tell emacs the name of the terminal that it emulates,
                    374:        not the name of the personal computer."
                    375: }
                    376: Hypothesis Badlan:  {
                    377:        Explain: "It is likely that your local area network is using
                    378:        ^S and ^Q for flow control.  Try running with \"flow_lim\"
                    379:        mode set to about 50"
                    380: }
                    381: Hypothesis Slowterm: {
                    382:        Explain: "Your terminal probably won't run fast enough
                    383:        without flow control.  If you are not connect through a
                    384:        local area network, then set flow_lim mode to about 50.  If
                    385:        you are connected through a local area network, you will
                    386:        probably need to lower your terimal speed."
                    387: }
                    388: Hypothesis Eatflow: {
                    389:        Explain: "Your terminal or local area network is interfering
                    390:        with the ^S and ^Q characters from the keyboard.  Make sure
                    391:        that your LAN is not interpreting these characters from the
                    392:        terminal as flow control.  Some vt100 compatible terminals
                    393:        and Blit's or TTY 5620 terminals also do this.  On a Blit or
                    394:        5620, the only solution is to load a terminal emulator that
                    395:        will pass ^S and ^Q (like netty) into the terminal."
                    396: }
                    397: Hypothesis Missing_term: {
                    398:        Explain: "Your system does not recognize your terminal type.
                    399:        It is very likely that your terminal is similar enough to
                    400:        one of the standard types (like hp, vt100, adm, etc.) that
                    401:        one will work.  Sorry."
                    402: }
                    403: Hypothesis Badsize: {
                    404:        Explain: "Some PC based terminal emulators provide a larger
                    405:        than normal screen, which confuses emacs and other screen
                    406:        based programs.  There are some special terminal types (like
                    407:        hp2621i) to describe standard terminals with non-standard
                    408:        screen sizes."
                    409: }
                    410: 
                    411: Hypothesis Command_bug: {
                    412:        Ask: "Which of the following describes the failure"
                    413:        Replies: {
                    414:                Othercmd: "Other commands don't work"
                    415:                eatsq: "Commands containing ^S or ^Q (like search) wont work"
                    416:                Initfail: "Initialization files don't work"
                    417:                macrobug: "Some or all macros fail"
                    418:        }
                    419: }
                    420: Hypothesis Othercmd: {
                    421:        Ask: "What kinds of commands don't work"
                    422:        Replies: {
                    423:                unixescape: "M-!, M-$, or mail sending"
                    424:                Fileio: "File reading/writing"
                    425:                markbreak: "setting the mark"
                    426:                Searches: "Search commands"
                    427:                cmother: "commands that modify the buffer"
                    428:                cmother: "commands that move the cursor"
                    429:        }
                    430: }
                    431: Hypothesis Fileio: {
                    432:        Ask: "What is the nature of your file reading/writing problem"
                    433:        Replies: {
                    434:                Bad_environment: "Emacs can't find some files I try
                    435:                to read"
                    436:                garbled_files: "The file read or written gets garbled"
                    437:        }
                    438: }
                    439: Infer Pcfiles from { garbled_files msdos }
                    440: Hypothesis Pcfiles: {
                    441:        Explain: "You may have binary mode set wrong for the file
                    442:        you are trying to read or write.  Binary mode should be off
                    443:        if you are reading or writing text files.  Binary mode
                    444:        should be on for reading and writing emacs macros."
                    445: }
                    446: Hypothesis Screensize: {
                    447:        Explain: "Emacs has compile time limits on the size of
                    448:        screen it can handle in emacs_disp.h.  If you would like to
                    449:        change these, edit this file to increase the screen size. 
                    450:        It will work fine without changing the limit and just ignore
                    451:        the extra part of the screen"
                    452: }
                    453: 
                    454: Hypothesis Searches: {
                    455:        Ask: "What kind of searches fail?"
                    456:        Replies: {
                    457:                sqbotch: "Emacs doesn't respond at all to ^S"
                    458:                Regular: "Regular search and replace don't work"
                    459:                Search_return: "It displays ^J after what I am
                    460:                searching for and only finds the first one"
                    461:        }
                    462: }
                    463: Hypothesis Search_return: {
                    464:        Explain: "You are probably typing <return> after the string
                    465:        to search for.  Don't do this with incremental search (^S).
                    466:        Just type what you want to find without the return"
                    467: }
                    468: Hypothesis Regular: {
                    469:        Explain: "Be sure you have looked at the description of
                    470:        regular expressions carefully, and understand it.  Emacs's
                    471:        regular expressions are not quite the same as those used in
                    472:        other unix tools"
                    473: }
                    474: Infer Repeatibility from cmother
                    475: Hypothesis Repeatibility: {
                    476:        Ask: "Which of the following applies"
                    477:        Replies: {
                    478:                badisp: "The display looks wrong after I do
                    479:                something, but typing ^L clears it up"
                    480:                solidfail: "The problem occurs every time I use a
                    481:                certain command"
                    482:                interm: "The problem occurs only in some situations"
                    483:        }
                    484: }
                    485: 
                    486: Infer Get_terminal_support certainty 40 from badisp
                    487: 
                    488: Hypothesis Initfail: {
                    489:        Ask: "Which of the following is true"
                    490:        Replies: {
                    491:                cmdfile: "running a command file with ^X^I fails"
                    492:                userinit: "Emacs ignores $HOME/.emacs_init"
                    493:                sysinit: "Emacs ignores the system .emacs_init"
                    494:                Bad_user_init: "text in my .emacs_init winds up in my buffer"
                    495:        }
                    496: }
                    497: Infer Protection_bug from { !userinit sysinit}
                    498: Infer Bad_environment from { userinit }
                    499: Hypothesis Bad_user_init: {
                    500:        Explain: ".emacs_init files are supposed to contain commands
                    501:        as typed from the terminal, like ^X^Msave, not embedded
                    502:        modes like EMACS_MODES: save.  Make sure that the file
                    503:        contains exactly what you would type from the keyboard to do
                    504:        what you want."
                    505: }
                    506: Hypothesis Bad_environment: {
                    507:        Ask: "Which of the following failures occur"
                    508:        Replies: {
                    509:                Badenv: "Doing ^X^R$HOME/.profile doesn't read your profile"
                    510:                Badtilde: "Reading ~user/file doesn't access a file
                    511:                in the users directory"
                    512:                Badshell: "Reading \"*\" does not find a file in a
                    513:                directory in which there are several files"
                    514:                bademacs: "Reading ~EMACS/emacs_defs doesn't get you
                    515:                a file"
                    516:        }
                    517: }
                    518: Infer Protection_bug certainty 20 from { bademacs }
                    519: Hypothesis Badenv: {
                    520:        Explain: "Shell environment variables are not working, or
                    521:        HOME is not exported in your installation"
                    522: }
                    523: Hypothesis Badshell: {
                    524:        Explain: "The environment variable \"SHELL\" may not name a
                    525:        suitable shell for running commands"
                    526: }
                    527: Hypothesis Badtilde: {
                    528:        Explain: "Emacs is having difficulty reading and
                    529:        understanding the password file.  Emacs includes the passwd
                    530:        file reading code (the standard code wants to use stdio),
                    531:        and must be modified if you have a non-standard
                    532:        installation."
                    533: }
                    534: Infer Debug_terminal certainty 30 from { badisp dinternal }
                    535: Hypothesis Debug_terminal: {
                    536:        Ask: "The emacs terminal descriptor is probably bad for this
                    537:        terminal.  Which of the following can you do to debug it?"
                    538:        Replies: {
                    539:                Ttest: "I can run the ttest program on it"
                    540:                taccess: "I can run emacs on it"
                    541:        }
                    542: }
                    543: Hypothesis Ttest: {
                    544:        Ask: "Run ttest and indicate everything that seemed to fail"
                    545:        Replies: {
                    546:                Bad_curpos: "the absolute cursor positioning test
                    547:                did not fill in numbers across and down the screen"
                    548:                bad_relpos: "a relative motion did not work"
                    549:                Bad_cr: "return did not appear at the left margin on
                    550:                the same line as carriage"
                    551:                Bad_clear: "The screen didn't clear when indicated"
                    552:                Bad_wraps: "It printed \"wraps          cursor\" and
                    553:                lots of gibberish in the right hand column"
                    554:                Bad_size: "wraps did not line up under wraps"
                    555:                Badscroll: "The screen did not scroll after each word
                    556:                in the scroll ttest"
                    557:                Bad_lclear: "It didn't clear the line after clear"
                    558:        }
                    559: }
                    560: Hypothesis Ttest1: {
                    561:        Ask: "Enter additional failures from ttest"
                    562:        Replies: {
                    563:                Bad_insert_character: "The insert/delete character
                    564:                tests did not behave as advertised"
                    565:                Bad_insert_line: "The test to scroll lines 2-23 up
                    566:                and down failed"
                    567:                Badunderline: "The underlining test failed"
                    568:        }
                    569: }
                    570: Infer Ttest1 certainty 99 from { ttest }
                    571: Infer Bad_curpos from { bad_relpos }
                    572: Hypothesis Bad_insert_character: {
                    573:        Explain: "Insert/delete character doesn't seem to run as
                    574:        advertised.  Try running without it, or with \"in\" set differently"
                    575: }
                    576: Hypothesis Bad_curpos: {
                    577:        Explain: "Cursor positioning doesn't work properly.  If a
                    578:        relative movement fails, delete or change it.  If absolute
                    579:        positioning fails, you may be able to avoid it, but emacs
                    580:        won't run efficiently without it"
                    581: }
                    582: Hypothesis Badunderline: {
                    583:        Explain: "The terminal doesn't underline as advertised.  If
                    584:        you get extra underlines, try turning off 'eo'.  If you
                    585:        don't get underlines where you should, check 'ul' or 'us'"
                    586: }
                    587: Hypothesis Bad_cr: {
                    588:        Explain: "Carriage return does not work on your terminal. 
                    589:        Alternatively, something (like a local area network) may be
                    590:        turning carriage return into carriage return-linefeed"
                    591: }
                    592: Infer Badsize certainty 20 from { bad_size termpc }
                    593: Infer Bad_size certainty 15 from { badscroll }
                    594: Infer Bad_size certainty 15 from { bad_curpos }
                    595: Hypothesis Bad_size: {
                    596:        Explain: "Your screen size may be wrong, make sure it's
                    597:        correct"
                    598: }
                    599: Hypothesis Bad_clear: {
                    600:        Explain: "Clear screen doesn't work.  Without this, you
                    601:        nothing else will work well.  If the terminal really won't
                    602:        clear but will scroll, substitute gobs of newlines for clear!"
                    603: }
                    604: Hypothesis Bad_wraps: {
                    605:        Explain: "Your terminal does not automatically wrap to the
                    606:        next line on overly long lines.  You may be able to change
                    607:        this in setup modes or switch settings on the terminals. 
                    608:        Otherwise, take out the 'am' capability"
                    609: }
                    610: Hypothesis Badscroll: {
                    611:        Explain: "Scrolling may not work on your terminal, get rid
                    612:        of 'sf'"
                    613: }
                    614: Hypothesis Memcurad: {
                    615:        Explain: "The cursor addressing on your terminal may be
                    616:        memory based and not screen based.  Try removing the 'sf'
                    617:        Parameter or changing th 'cm' parameter to a screen based
                    618:        cursor addressing scheme"
                    619: }
                    620: 
                    621: Hypothesis Bad_lclear: {
                    622:        Explain: "Clear line (ce) doesn't seem to work,
                    623:        alternatively, your terminal may not be set to allow
                    624:        characters to be overwritten by blanks"
                    625: }
                    626: Hypothesis Bad_insert_line: {
                    627:        Explain: "Line insertion and deletion or settable scrolling
                    628:        region doesn't work."
                    629: }
                    630: Infer Emtest certainty 20 from { taccess }
                    631: Infer Emtest certainty 20 from { tterms !dinternal }
                    632: 
                    633: Hypothesis Emtest: {
                    634:        Ask: "To debug emacs, run emacs on the following terminal
                    635:        and report what fails"
                    636:        Replies: {
                    637:                bad_clear: "Screen doesn't clear when you run emacs"
                    638:                bad_curpos: "The emacs mode line is messed up even in
                    639:                an empty buffer"
                    640:                bad_size: "The screen scrolls or the mode line is in
                    641:                the wrong place when emacs is run on file with no
                    642:                long lines"
                    643:                badunderline: "Underlines appear mysteriously in the text"
                    644:                bad_lclear: "When paging through a file, junk from the
                    645:                previous page is left on the screen"
                    646:                wrapfail: "Long lines don't wrap properly"
                    647:                afterscrol: "The screen is fouled up after
                    648:                inserting/deleting lines or scrolling"
                    649:        }
                    650: }
                    651: Hypothesis Test_ins_del: {
                    652:        Ask: "Does your problem with inserting/deleting lines happen"
                    653:        
                    654:        Replies: {
                    655:                aftern: "After doing ^N at the bottom of the screen"
                    656:                afterp: "After doing ^P at the top of the screen"
                    657:                afterdel: "After doing ^O in the middle of the screen"
                    658:        }
                    659: }
                    660: Infer Test_ins_del from { afterscrol }
                    661: Infer Memcurad from { aftern !badscroll }
                    662: Infer Memcurad from { aftern !afterp }
                    663: Infer Bad_insert_line from { afterdel !aftern }
                    664: Infer Bad_insert_line certainty 20 from { afterscrol }
                    665: Infer Memcurad certainty 20 from { afterscrol }
                    666: Infer Bad_wraps certainty 30 from { wrapfail }
                    667: Infer Bad_size certainty 30 from { wrapfail }
                    668: Infer Bad_control_at from { dbsd markbreak }
                    669: Hypothesis Bad_control_at: {
                    670:        Explain: "The set mark command should be entered with
                    671:        escape-space (M- ) and not control-atsign (^@) or
                    672:        control-space.  ^@ will not work on berkeley unix systems
                    673:        and causes a break instead."
                    674: }
                    675: Hypothesis Bad_3b2: {
                    676:        Ask: "Which processor do you have the problem with"
                    677:        Replies: {
                    678:                3b2: "3b2"
                    679:                3b5: "3b5"
                    680:                3b20: "3b20"
                    681:        }
                    682:        Explain: "The I/O interface on some 3B2 systems sometimes
                    683:                buffers one character, causing emacs to respond one
                    684:                character behind your typing.  There is no fix for
                    685:                this at the moment"
                    686: }
                    687: Infer Bad_fep from { feps stopinput }
                    688: Infer Bad_fep certainty 20 from { fep badio }
                    689: 
                    690: 
                    691: Hypothesis Bad_fep: {
                    692:        Explain: "The front end processors on some unix/370 or amdahl
                    693:        systems do not handle raw I/O properly.  To get around this,
                    694:        change the values asigned to VMIN and VTIME in emacs_io.c to
                    695:        1 and 0, and recompile"
                    696: }
                    697: Infer Bad_3b2 certainty 0 from { !3b2}
                    698: 
                    699: Hypothesis Bad_termcap: {
                    700:        Explain: "The termcap or terminfo description for your
                    701:        terminal may be incorrect, or there may be a bug in the
                    702:        emacs implementation.  Try recompiling with internal
                    703:        terminal support."
                    704: }
                    705: 
                    706: Infer Bad_termcap certainty 30 from { badisp !dinternal }
                    707: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.