home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol081 / implemnt.doc < prev    next >
Encoding:
Text File  |  1985-02-10  |  4.3 KB  |  85 lines
  1.                     IMPLEMENTATION NOTES
  2.  
  3.  
  4. Thσ disδ contain≤ ß .SU┬ filσ fo≥ eacΦ Pasca∞ program«  Notσ tha⌠ ì
  5. al∞á oµá thσ program≤ excep⌠ F╞á requirσá CONSTS.PAS¼á TYPES.PAS¼ ì
  6. GETFILES.PAS¼á anΣ PROCS.PA╙ durinτ compilation¼á anΣ tha⌠ PRINT¼ ì
  7. XREF¼á anΣá T╨ als∩ requirσ assembl∙ languagσá subroutines«á  Thσ ì
  8. followinτ suggestion≤ ma∙ hel≡ t∩ ge⌠ yo⌡ started.
  9.  
  10. Compilσá thσá program≤ b∙ executinτá FF.SUB¼á PRINT.SUB¼á PP.SUB¼ ì
  11. XREF.SUB¼á anΣá TP.SUB«á  Thσ .SU┬ file≤ assumσá tha⌠á everythinτ ì
  12. happen≤ oε thσ curren⌠ systeφ disk¼á whicΦ mus⌠ oµ coursσ contaiε ì
  13. thσ compiler¼ assembler¼ linker¼ MAIN.SRC¼ etc.
  14.  
  15. Usσá PRETTY.SU┬á t∩á obtaiεá ßá pretty-printeΣá listinτá oµá eacΦ ì
  16. program«á  Thi≤á procedurσá require≤ thσ namσ oµ ß Pasca∞á sourcσ ì
  17. filσ a≤ ß parameter«á  Fo≥ example║  SUBMI╘ PRETT┘ F╞ PRETT┘ use≤ ì
  18. PRIN╘á t∩ prin⌠ ß listinτ oµ thσ pretty-printeΣ prograφá anΣá it≤ ì
  19. cross-referencσ table«  B∙ default¼ PRIN╘ assume≤ 11ó pape≥ anΣ ╢ ì
  20. lines/inch╗á i⌠á print≤ 6░ line≤ oµ tex⌠ oε eacΦá page¼á printinτ ì
  21. pagσ heading≤ anΣ usinτ form-feeΣ character≤ fo≥ pagination«á  I⌠ ì
  22. doe≤ no⌠ truncatσ o≥ wra≡ lonτ lines.
  23.  
  24. Tes⌠á T╨ b∙ formattinτ thi≤ filσ witΦ it«á  Thσ commanΣ  T╨á DIS╦ ì
  25. shoulΣá creatσ ß filσ DISK.DO├ identica∞ t∩ thσ filσ DISK.DO├á oε ì
  26. thi≤á disk«á Iµá i⌠á does¼á usσ T╨ t∩á forma⌠á thσá documentatioε ì
  27. containeΣ iε thσ file≤ SYSTEM.TEX¼ SYSUT.TEX¼ anΣ SYSTP.TEX«  Thσ ì
  28. commanΣá  T╨á SYSTE═  doe≤ this¼á creatinτ thσá formatteΣá manua∞ ì
  29. SYSTEM.DOC¼á thσ tablσ oµ content≤ filσ SYSTEM.CON¼á anΣ thσ filσ ì
  30. oµ cross-reference≤ SYSTEM.REF¼á whicΦ i≤ oµ n∩ grea⌠ interes⌠ t∩ ì
  31. thσ user.
  32.  
  33. Computer≤á beinτá wha⌠ the∙ are¼á yo⌡ wil∞ probabl∙ ge⌠ stucδá a⌠ ì
  34. somσ poin⌠ iε thσ proceedings«á  Unfortunately¼á ╔ canno⌠ predic⌠ ì
  35. wha⌠ wil∞ g∩ wrong¼ bu⌠ herσ arσ somσ possibl∙ alarminτ symptoms.
  36.  
  37. Al∞á oµ thσ program≤ worδ witΦ Versioε 4.░ oµ thσ compile≥ anΣá ╔ ì
  38. believσá tha⌠á al∞ excep⌠ P╨ als∩ worδá witΦá Versioεá 3.0«á  Thσ ì
  39. problem≤á witΦá P╨á unde≥ Versioε 3.░á concerεá passinτá one-bytσ ì
  40. integer≤ b∙ reference« 
  41.  
  42. Somσ oµ thσ operation≤ arσ quitσ slow«á  M∙ systeφ require≤ abou⌠ ì
  43. 1╡ minute≤ t∩ compilσ TP«á  Furthermore¼ T╨ wil∞ requirσ a⌠ leas⌠ ì
  44. ╖á minute≤á t∩ proces≤ SYSTE═ -- i⌠ run≤ a⌠ abou⌠ 120░ word≤á pe≥ ì
  45. minutσ unde≥ Cachσ BIO╙ witΦ flopp∙ disks.
  46.  
  47. Largσá intermediatσ file≤ wil∞ bσ created«á  Checδ thσ amoun⌠á oµ ì
  48. freσ disδ spacσ beforσ eacΦ compilation¼á especiall∙ beforσá wheε ì
  49. compilinτ TP«  Thσ submi⌠ procedure≤ deletσ file≤ a≤ sooε a≤ the∙ ì
  50. arσ n∩ longe≥ required.
  51.  
  52. ╔á havσ haΣ n∩ memor∙ problem≤ runninτ Cachσ BIO╙ iε 128K«á  ╔ d∩ ì
  53. no⌠ kno≈ whethe≥ T╨ caε bσ compileΣ oε ß 48╦ machine«á  I⌠ shoulΣ ì
  54. _ruεá oε ß 48╦ machine¼á bu⌠ therσ wil∞ bσ les≤ spacσ fo≥á cross-ì
  55. reference≤á anΣ "keeps"«á  Thσ simples⌠ wa∙ t∩ reducσ thσá memor∙ ìèrequirement≤á oµá T╨ woulΣ bσ t∩ spli⌠ i⌠ iε two║á par⌠á ▒á woulΣ ì
  56. initializσá thσ globa∞ table≤ anΣ chaiε t∩ par⌠ ▓ whicΦ woulΣá d∩ ì
  57. thσ work.
  58.  
  59. Somσá oµ thσ cross-reference≤ iε SYSTEM.DO├ wil∞á bσá unsatisfieΣ ì
  60. (therσá wil∞ bσ statement≤ likσ "seσ Sectioε 0.0.0")«á  Therσ arσ ì
  61. tw∩á reason≤á fo≥ this║á onσ i≤ tha⌠ T╨ require≤á tw∩á passe≤á t∩ ì
  62. satisf∙á forwarΣá references¼á anΣá thσ othe≥ i≤ tha⌠á therσá arσ ì
  63. reference≤ t∩ section≤ oµ thσ manua∞ tha⌠ arσ no⌠ oε thi≤ disk. 
  64.  
  65. T╨ assume≤ 1▓ characters/incΦ b∙ default«á  EacΦ linσ i≤ precedeΣ ì
  66. b∙ ╢ blank≤ (0.5")¼á anΣ contain≤ a⌠ mos⌠ 7╕ character≤ (6.5"⌐ oµ ì
  67. text«á  Thu≤á thσ tex⌠ fit≤ ont∩ 8.5"x11ó pape≥ witΦ 1óá margins«  ì
  68. Iµ you≥ printe≥ print≤ 1░ characters/incΦ anΣ yo⌡ usσ 8.5ó paper¼ ì
  69. thσá line≤á wil∞ bσ to∩ long«á  (The∙ wil∞ als∩ bσá to∩á lonτá t∩ ì
  70. displa∙á oεá aεá 80-columε screen.)α  Yo⌡ caε tel∞á T╨á t∩á prin⌠ ì
  71. shorte≥á line≤ b∙ insertinτ thσ commanΣ \H╠ ╡ 6╡ a⌠ thσ fron⌠á oµ ì
  72. thσ file║ looδ a⌠ DISK.TE╪ t∩ seσ wherσ i⌠ goes.
  73.  
  74. PRIN╘á ha≤á ß "Tó optioε fo≥ printinτ .DO├ file≤ produceΣ b∙á TP«  ì
  75. Yo⌡á caεá say¼á fo≥á example║á  PRIN╘ SYSTEM.DO├á T1,╡á  Thi≤á i≤ ì
  76. supposeΣ t∩ prin⌠ thσ firs⌠ ╡ page≤ oµ SYSTEM.DOC«  Unfortunatel∙ ì
  77. thi≤ optioε doe≤ no⌠ worδ oε m∙ system«á  Wheε thσ "Tó optioεá i≤ ì
  78. selected¼á thσá printe≥á seem≤á t∩ ignorσ thσá ETX/AC╦á protocol«  ì
  79. Pleasσá le⌠á mσá kno≈á iµ yo⌡ managσ t∩á fi°á thσá bug«á  Iεá thσ ì
  80. meantime¼ usσ \bΣ PI╨ LST:=SYSTEM.DO├ \eΣ instead.
  81.  
  82. Good luck!
  83.  
  84.                   
  85.