@DATABASE DICE_Manual
@AUTHOR "Matthew.J.Fletcher // Matthew.Fletcher@student.shu.ac.uk"
@$VER: DICE.guide 0.4 (10/05/1999),.. Its good that someone has checked the version string, hey thats why its here, i just wonder what you were expecting to find, some kind of secret documenation or something else, more sinister, well no its very hard (well impossible) to do in AmigaGuide, ough well you may as well have my e-mail address, so this is not a complete waste of time, here goes... Matthew.Fletcher@student.shu.ac.uk, err, what else can i put in here, ough yes... BEEFCAKE-BEEFCAKE, bye MJF"
@(c) "Copyright İ 1998/1999 Matthew Fletcher... and all the many contributors, if DICE goes commerical again at some point, and you want to use this guide I want ££££, this was not done over-night you know"
@WORDWRAP 76 ;<--- You can change this....
@NODE MAIN
@TITLE "DICE 3.xx Distribution Manual: Contents"

 **************************************************************************
 *                                                                        *
 *                      @{b}--- The DICE Manual (v0.4) ---@{ub}                    *
 *                                                                        *
 *            @{b}--- Covering The Full DICE 3.xx Distribution ---@{ub}            *
 *                                                                        *
 *             @{b}--- (C) 1998/99 The DICE Development Group. ---@{ub}            *
 *                                                                        *
 *                                                                        *
 *                --- Constructed by Matthew J Fletcher ---               *
 *                                                                        *
 *                           --- 1998 - 1999 ---                          *
 *                                                                        *
 **************************************************************************

                             @{b} Table Of Contents@{ub}
                             ŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻŻ
                                  

 @{b}Introductory Documents@{ub}
   
  @{" Release Notes..          " Link newstuff  }   DICE lives again, read this now..., go on.
  @{" Guide Notes..            " Link quicknote }   Read This Now (for my sake)...
  @{" Guide History..          " Link history   }   Where has this guide been (MCP style)...

  @{" Introduction..           " link _Beginner_Readme/MAIN }   Welcome to the DICE System.
  @{" About DICE..             " link _About_Dice/MAIN      }   About the DICE 3.xx Release.
  @{" DICE Development Group.. " link _Copyright/MAIN       }   DICE Copyright Information.
  @{" DICE Source Readme..     " link _Matt_readme/MAIN     }   Source Release Information.
  @{" Future DICE Projects..   " link _future_projects/MAIN }   Upcoming projects for DICE.


  Contents:  @{i}DICE Development Tools@{ui}
             @{" DICE Project Manager Documentation " link pm.guide/MAIN}   *Very Beta !!
             @{" DICE Core Program Documentation    " link Core_docs}
             @{" DICE Program Documentation         " link Sub_Progs}

             @{i}DICE Programming Materials@{ui}
             @{" DICE Support Program Documentation " link other_progs}
             @{" DICE Supplementary Documentation   " link Ref_Docs}

             @{i}ANSI C Programming Materials@{ui}
             @{" DICE/Amiga C-Library Documentation " link Clib}
             @{" Tutorials and Source Code          " link Tutor}


  @{" DICE/DOC/ dir listing " link _dice.doc.dir.list/MAIN} Check you have got all the stuff.
  @{" DICE  Directory Tree " link _dice.dir.tree/MAIN}   Check all the stuff is in the right place.
  
@ENDNODE

@NODE quicknote "Please note..."
@prev main
@next newstuff



- This guide was written with v39/40 amigaguide lib and datatype in mind,
it will probably work with v37, but I have no way of testing it, any
reports of problems, (although I have tried to be careful) would be
helpful thanks.

- Its all messy! The text does not even fit into the window properly? err
this is your fault, it does on my computer. I used polarsmall.font, I cant
possibly get it to fit with all font sizes on all screen resolutions (the
RTF version is for this). Anyway, why are you using a screen font that does
not allow you to fit a standard width 75 columns line onto your screen at 
once? wordwrap is set to 76. This seemed the best option. If you have small
problems change this, if you have big problems use the RTF version...!!


@ENDNODE


@NODE newstuff "Look this is new for this release..."
@next history
@prev quicknote

Introduction to @{b}DICE 3.16@{ub}

- 1) DICE is back in development by @{b}Richard Drummond@{ub}, of CU Amiga
     Fame (well almost) as well as anybody else who wants to contribute.
     It was only posted on 02/10/98 so don't expect a IDE yet.
     Mail him at....
     
     @{B}dice@drummond.u-net.com@{UB} and the DICE mailing list at
     @{B}onelist.com/archives.cgi/dice@{UB} free subscription .....!!
     
- 2) Yes it was compiled from the Free DICE 3.15 source, (yes I tried it
     as well, takes ages however) get if from aminet, dev/c/dice-3.15.lha
     and spend hours fiddling to try and get it to work.
     
- 3) Matt Dillion @{b}Fully@{ub} supports new DICE versions and is in the 
     process off setting up a CVS deposit for any new source code. (cool)

- 4) Yes, those are the fd files and No, its OK, they were (apparently)
     released just before they lost it last time.

- 5) What's this AmigaGuide? err, its going to be part of the new
     documentation set. I also plan a RTF version (this will come before
     any major new amigaguide versions). I will test it on ww6, Word6/97
     (PC/MAC), (sorry but lets face it - where are people going to print all
     this stuff out? yep at college, university or at work, so unless you
     are very lucky is go to work with Word) also it is much easier to use
     as a reference in paper form, well I think so...., some more help is
     needed however..

- 6) Who the hell are you!!, err sorry Matthew Fletcher, mjf or mfletche on
     chat areas. I am doing software engineering but prefer to play around
     all day with masses of text files. Mail me at...
     
     @{B}Matthew.Fletcher@student.shu.ac.uk@{UB} or over the summer 
     @{B}amimjf@Hotmail.com@{UB} just don't expect quick replies.....!!


@ENDNODE

@NODE history "Where has this guide been? (MCP.Guide homage, kind of thing)"
@prev newstuff
@next main

- @{i}18/10/1998@{ui}
When this guide was begun. At the moment, it is just a quick tester. only an
Amigaguide front end to the mass of out of date and messy text documents
that reside in the docs drawer. This was 0.1 (I wonder what would happen if
you were to check the version from the shell ???) and was mailed of to
Richard for abuse and maybe some comments.

- @{i}22/10/1998@{ui}
In hindsight, the layout for the the previous version was a bit crap, anyway
it was totally re-done and with much pain and effort was re-designed and
made in a more professional manner, (i.e. it has working prev / next and an
index buttons) now. It is at times like this that I wish that the "search"
code that exists within v40 datatype library worked, as the index is going
to be massive and will take an age to load / scroll on anything other than a
060. I also noticed a nasty problem, the backslash does not appear in my
guides. I have tried lots of fonts but I think it could be an Amigaguide
problem?

- @{i}08/01/1999@{ui}
The guide has just about been converted now all that needs doing is to
update the contents (shock horror) for any new releases.. Also i have
had a few people point out rarther embrasing errors on my part but its
all for a good cause.

- @{i}12/05/1999@{ui}
Still fiddling, infact it could be considered a major re-design of the
whole interface, but anyway,.. cut out loads of duplication.


@ENDNODE


@NODE Core_Docs "The Core DICE Distribution Documents"
@prev main
@next Sub_progs


 @{b}Core DICE Documents@{ub}
   
   @{i}DICE Tools Suite@{ui}
   @{" DICE Compiler..  " Link dice_compiler/MAIN   }   An introduction + Comments on DICE.
   @{" DICE Extensions.." Link dice_extensions/MAIN }   DICE Spesific Compiler Extensions.
   @{" DICE RegArgs..   " Link dice_regargs/MAIN    }   DICE Register Argument Documents.
   @{" DICE Utilities.. " Link dice_utilities/MAIN  }   DICE Tools Suite Guide.
   @{" DICE _Main()..   " Link dice_main/MAIN       }   DICE _main() Entry Point Handling.

   @{i}Extra DICE Documents@{ui}
   @{" Commands..       " Link dice_commands/MAIN   }   DICE Tools Commands.  @{i}(big file)@{ui}
   @{" Error Messages.. " Link dice_errors/MAIN     }   DICE Error Messages.  @{i}(large file)@{ui}
   @{" Arexx..          " Link dice_rexx/MAIN       }   DICE Arexx Programming Guide.
  
   @{i}Total Supported Fuctions@{ui}
   @{" Libraries..      " Link dice_libraries/MAIN  }   DICE ANSI/Amiga Libraries Functions.

@ENDNODE


@NODE Sub_progs "DICE Program Documention"
@prev Core_Docs
@next Other_Progs

    
 @{b}DICE Program Documentation@{ub}
   
   @{i}Main Compiler Tools@{ui}
   @{" DAS..      " Link "prog_das/MAIN"           }   DICE 68k Assembler.
   @{" DC1..      " Link "prog_dc1/MAIN"           }   DICE Main Compiler Pass.
   @{" DCPP..     " Link "prog_dcpp/MAIN"          }   DICE Pre_Processor.
   @{" DCC..      " Link "prog_dcc/MAIN"           }   DICE Central Interface/Control.
     @{" ROMable. " Link "prog_romable/MAIN"       }   DCC ROM Generation Controls.
   @{" Dlink..    " Link "prog_dlink/MAIN"         }   DICE Linker.

   @{i}Secondary Tools@{ui}
   @{" DDBug..    " Link "prog_ddbug/MAIN"         }   DICE De-Bugger @{i}(formally DD)@{ui}.
   @{" Dmake..    " Link "prog_dmake/MAIN"         }   DICE Make Utility.
   @{" DME..      " Link "prog_dme/MAIN"           }   DICE Editor.
   @{" DProf..    " Link "prog_dprof/MAIN"         }   DICE Profiler.

   @{i}Other Tools@{ui}
   @{" Dicehelp.. " Link "prog_dicehelp/MAIN"      }   DICE Online Help Tool.
   @{" Dobj..     " Link "prog_dobj/MAIN"          }   DICE Dis-assembler.
   @{" Dsearch..  " Link "prog_dsearch/MAIN"       }   DICE Source Searcher.
   @{" Du..       " Link "prog_du/MAIN"            }   DICE Disk Usage Calculator.
   @{" Dupdate..  " Link "prog_dupdate/MAIN"       }   DICE Team Working/Source Handling Tool.
   @{" Dynamic..  " Link "prog_dynamic/MAIN"       }   DICE Dynamic Library Support.

@ENDNODE

     
@NODE other_progs "Other Included Program Documentation"
@prev Sub_Progs
@next Ref_Docs

    
 @{b}Other Included Programs Documents@{ub}
   
   @{" Bin-To-Hex..   " Link "prog2_bintohex/MAIN"        }    Binary to Hex conversion.
   @{" Expand..       " Link "prog2_expand/MAIN"          }    File List generation.
   @{" FD-to-Inline.. " Link "prog2_fdtoinline/MAIN"      }    FD file conversion, to in-line header generation.
   @{" FD-to-Library.." Link "prog2_fdtolib/MAIN"         }    Generation of Amiga libraries from FD files.
   @{" Flush..        " Link "prog2_flush/MAIN"           }    Lib / font, unused file flusher.
   @{" Head..         " Link "prog2_head/MAIN"            }    Prints out files to the CON.
   @{" ISTRIP..       " Link "prog2_istrip/MAIN"          }    White space remover.
   @{" LBMAKE..       " Link "prog2_lbmake/MAIN"          }    Better link library management.
   @{" LHEX..         " Link "prog2_lhex/MAIN"            }    Lha/Lzh archive extractor.
   @{" LibMake..      " Link "prog2_libmake/MAIN"         }    Can generate massive link libraries.
   @{" Libtos..       " Link "prog2_libtos/MAIN"          }    Converts old amiga.lib to a small data model.
   @{" LoadABS..      " Link "prog2_loadabs/MAIN"         }    Generates ROM / Firmware files (cool).
   @{" Loadfile..     " Link "prog2_loadfile/MAIN"        }    Loads ROM binaries for debugging.
   @{" MakeProto..    " Link "prog2_makeproto/MAIN"       }    Makes prototypes.
   @{" Memoration..   " Link "prog2_memoration/MAIN"      }    Limits program memory demands, by William S Hawes.
   @{" Owner..        " Link "prog2_owner/MAIN"           }    Hows is this memory? This will show you.
   @{" Quickref..     " Link "prog2_quickref/MAIN"        }    Used by DME to get useful docs.
   @{" Wedge..        " Link "prog2_wedge/MAIN"           }    DICE lib monitor, task/status/calls etc.

@ENDNODE


@NODE Ref_Docs "Supplementary (Reference) DICE Documentation"
@prev Other_Progs
@next Clib


 @{b}Supplementary (Reference) DICE Documents@{ub}
   
   @{" Alib..          " Link "ref_alib/MAIN"            }    The alib docs.
   @{" Autorefs..      " Link "ref_autorefs/MAIN"        }    Quick auto reference docs.
   @{" Extras ASCII & Presidence.. " Link "ref_extras/MAIN"}    Operational Stuff.
   @{" Known Bugs..    " Link "ref_knownbugs/MAIN"       }    Don't look here !! The known bugs list.
   @{" C Methodology.. " Link "ref_methodology/MAIN"     }    Matts talks about C programming methods.
             

@ENDNODE

@NODE Clib "Standanardised C-Library (Clib) Documentaion"
@prev Ref_Docs
@next Tutor

 
 @{b}DICE CLib Documentation@{ub} @{i}AMIGA C Library Implementation - read this twice..@{ui}

   @{" Clib/amiga..   " Link "clib_amiga/MAIN"    }    Amiga platform specific stuff.
   @{" Clib/extra..   " Link "clib_extra/MAIN"    }    Extra Amiga/DICE Stuff.
   @{" Clib/assert..  " Link "clib_assert/MAIN"   }    Assert command reference.
   @{" Clib/compat..  " Link "clib_compat/MAIN"   }    Old Stuff to boostrap DICE.
   @{" Clib/ctype..   " Link "clib_ctype/MAIN"    }    Char Type Operations.
   @{" Clib/fd..      " Link "clib_fd/MAIN"       }    File Descriptor.
   @{" Clib/float..   " Link "clib_float/MAIN"    }    Floating Point Maths/Operations.
   @{" Clib/memory..  " Link "clib_memory/MAIN"   }    Memory Operations.
   @{" Clib/setjmp..  " Link "clib_setjmp/MAIN"   }    Setjump command reference.
   @{" Clib/signal..  " Link "clib_signal/MAIN"   }    Signaling documentation.
   @{" Clib/stdio..   " Link "clib_stdio/MAIN"    }    The standard Input/Output docs.
   @{" Clib/stdlib..  " Link "clib_stdlib/MAIN"   }    The Standard Library.
   @{" Clib/string..  " Link "clib_string/MAIN"   }    String operations docs.
   @{" Clib/time..    " Link "clib_time/MAIN"     }    Standard time reference.
   @{" Clib/unix..    " Link "clib_unix/MAIN"     }    Unix routines.

@ENDNODE

@NODE Tutor "Tutorial and Source Code Documentation"
@prev Clib
@next main

 
 @{b}Tutorial Documentation@{ub}
 
   @{" Basic Tutorials     " Link "_beginner_readme/MAIN" }  Remember These ?

 @{b}Extra C Tutorials@{ub}
   @{" C Coding Tutorials  " Link "ref_c_tutorial/MAIN"       }  Simple Source Code.
   
 @{b}DICE Specific Tutorials@{ub}
   @{" DICE made easy      " Link "dice_tutor/MAIN"       }  DICE made easy (ish).



This was one of the areas that we thought should be beefed up, due to the
lack of real programming tutorials, books etc. The beginners will have real
problems, so these are what we came up with. Yes I know there are two simple
tutorials in the introduction section but this is the main section for all
that kind of stuff and it also contains the sources so that you don't have
to type them all in.

@ENDNODE