home *** CD-ROM | disk | FTP | other *** search
/ Amiga MA Magazine 1998 #6 / amigamamagazinepolishissue1998.iso / www / cucug / amiga / amiinfo / reviews / amigadosmanual.txt < prev    next >
Internet Message Format  |  1997-11-07  |  5KB
  1. From: comp.sys.amiga.reviews Moderator <amiga-reviews@math.uh.edu>
  2. Organization: The Amiga Online Review Column - ed. Jason L. Tibbitts III
  3. Subject: REVIEW: The AmigaDOS Manual, 3rd Edition
  4. Keywords: manual, documentation, AmigaDOS, 2.0, commercial
  5. Path: karazm.math.uh.edu!amiga-reviews
  6. Distribution: world
  7. Newsgroups: comp.sys.amiga.reviews
  8. Followup-To: comp.sys.amiga.misc
  9. --text follows this line--
  10. The newest AmigaDOS Manual from Bantam and Commodore-Amiga, Inc. is an
  11. updated version of the earlier books.  Editions number one and two covered
  12. AmigaDOS v1.1 and V1.2 respectively, while the third edition is written
  13. for AmigaDOS v2.04 specifically.
  14.  
  15. [This was sent to me by Charles Hill of AMReport fame.  The last working
  16. address I have for him is: Charles Hill/InfoTrak
  17. <76370.3045@compuserve.com>. -JLT3]
  18.  
  19.                       The AmigaDOS Manual, 3rd Edition
  20.                       --------------------------------
  21.  
  22. The first editions were bound in a silly plastic spiral, which I found
  23. to be *real* annoying at times.  The new version is a standard paperback
  24. binding, as the manual IS a large paperback.  The cover and format hasn't
  25. changed much -- the cover is still white with some blue and the layout is
  26. still broken into three sections:  User, Developer & Technical Reference.
  27.  
  28. The user manual starts out real simple, explaining on what a shell,
  29. directories and files are and how they are arranged.  Logical devices,
  30. file redirection, formatting & installing a disk as well as some of the
  31. more primitive operations of DOS are covered early.  The manual here has
  32. really only been updated to reflect the details of v2.04 as opposed to
  33. earlier versions.  The descriptions and diagrams of directories and tree
  34. structures are the same as in the 1st Edition.
  35.  
  36. The next chapter steps through each AmigaDOS command and tells you the
  37. command format and what it does.  The explanations are simple and a good
  38. way to see the differences in v1.3 and v2.04 of AmigaDOS for those who
  39. don't have access to both operating systems.
  40.  
  41. Chapter three details AmigaDOS Error messages giving the error number,
  42. name, meaning (in English) and possible solutions.
  43.  
  44. Chapter four is a glossary of terms, and that is the end of the User
  45. portion on the manual.
  46.  
  47.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  48.  
  49. The Developer's portion of the manual is complete, and as far as I can
  50. tell, accurate.  Bantam claims that Commodore went over the book with a
  51. fine-toothed comb so as to make it as accurate as possible.  Publishing
  52. date is July 1991, so I guess that means CBM had 2.04 finished as early
  53. as May (just squashing bugs thereafter).
  54.  
  55. While the User's manual was written on a very simple level, the Developer's
  56. manual assumes that you know a bit about programming and programming
  57. techniques.  It jumps in with both feet.  Short explanations on file I/O,
  58. Workbench rules, programming environments, file handlers and command line
  59. parsing get you started.
  60.  
  61. Chapter six does the same thing as Chapter two but uses the AmigaDOS
  62. resident library functions instead of the C: commands.  A sample AmigaDOS
  63. function description as found in Chapter 6 follows.
  64.  
  65.     DELAY
  66.  
  67.     _name_
  68.       Delay: delays a process for a specified time.
  69.  
  70.     _synopsis_
  71.       Delay(ticks)
  72.              D1
  73.       Void Delay(ULONG)
  74.  
  75.     _function_
  76.       The argument 'ticks' specifies how many ticks (50 per second) to
  77.       wait before returning control.
  78.  
  79.     _inputs_
  80.       ticks: Integer
  81.  
  82.     _bugs_
  83.       Due to a bug in the timer.device in V1.2/V1.3, specifying a timeout
  84.       of zero for Delay() can cause unreliable timer and floppy disk
  85.       operations.  This defect has been fixed in V36 and later versions.
  86.  
  87. Chapter seven details the CBM supplied linker:  ALINK.  Details include
  88. overlay trees, command line syntax, etc.
  89.  
  90. Chapter eight covers device I/O and covers all the named devices (PAR:,
  91. SER:, PRT:, RAW:, etc.)  The Developer's section ends here.
  92.  
  93.  
  94.                          ~~~~~~~~~~~~~~~~~~~~~~~~~~~
  95.  
  96. Part three, the Technical Reference Manual goes into detail on the
  97. nitty-gritty parts of AmigaDOS.  The filing structure is first, and the
  98. book details the different block types and their formats in both OFS and
  99. FFS.
  100.  
  101. Binary file structure is next, detailing the HUNK structures and their
  102. details.  AmigaDOS Data structures are next, then finally some tidbits
  103. on strange stuff.
  104.  
  105. Chapter 12 covers "Additional Information for the Advanced Developer",
  106. which includes overlay hunks, linking in new disk and non-disk devices,
  107. ad using AmigaDOS without Intuition.  This chapter is short, and a bit
  108. beyond my reach, so I really can't comment on its effectiveness.
  109.  
  110. An index rounds everything out and ends on page 447.
  111.  
  112. The books is good, though I find it a bit TOO simple in the User manual,
  113. and a bit obtuse in points in the Developer's section.  The Technical
  114. Reference Manual was complete, and gives everything in a straight-forward
  115. manner.  The book will make a good hold-over until the RKMs arrive, and
  116. then it should complement them nicely.
  117.