  
  [1X4 [33X[0;0YInstallation and Auxiliary Functions[133X[101X
  
  
  [1X4.1 [33X[0;0YRequirements[133X[101X
  
  [33X[0;0YThis  version  of [5XResClasses[105X needs at least [5XGAP[105X 4.7.0, [5XPolycyclic[105X 2.6 [EN11]
  and  [5XGAPDoc[105X 1.4 [LN12].  It  can  be  used on all platforms for which [5XGAP[105X is
  available.  [5XResClasses[105X  is  completely  written in the [5XGAP[105X language and does
  neither contain nor require external binaries.[133X
  
  
  [1X4.2 [33X[0;0YInstallation[133X[101X
  
  [33X[0;0YLike  any  other  [5XGAP[105X  package,  [5XResClasses[105X  must  be  installed  in the [11Xpkg[111X
  subdirectory of the [5XGAP[105X distribution. This is accomplished by extracting the
  distribution  file  in this directory. By default, the package [5XResClasses[105X is
  autoloaded.  If  you have switched autoloading of packages off, you can load
  [5XResClasses[105X via [10XLoadPackage( "resclasses" );[110X.[133X
  
  
  [1X4.3 [33X[0;0YThe testing routines[133X[101X
  
  [1X4.3-1 ResClassesTest[101X
  
  [29X[2XResClassesTest[102X(  ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing.[133X
  
  [33X[0;0YPerforms  tests  of  the [5XResClasses[105X package. Errors, i.e. differences to the
  correct  results  of the test computations, are reported. The processed test
  files are in the directory [11Xpkg/resclasses/tst[111X.[133X
  
  [1X4.3-2 ResClassesTestExamples[101X
  
  [29X[2XResClassesTestExamples[102X(  ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing.[133X
  
  [33X[0;0YRuns  all  examples in the manual of the [5XResClasses[105X package, and reports any
  differences between the actual output and the output printed in the manual.[133X
  
  
  [1X4.4 [33X[0;0YUtilities for preparing the package for distribution[133X[101X
  
  [1X4.4-1 ResClassesBuildManual[101X
  
  [29X[2XResClassesBuildManual[102X(  ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing.[133X
  
  [33X[0;0YThis  function  is  a  development  tool  which  builds  the  manual  of the
  [5XResClasses[105X package in the file formats LaTeX, PDF, HTML and ASCII text. This
  is accomplished using the [5XGAPDoc[105X package by Frank Lübeck and Max Neunhöffer.
  Building  the manual is possible only on UNIX systems and requires PDFLaTeX.
  As  all  files  generated  by this function are included in the distribution
  file anyway, users will not need it.[133X
  
  [1X4.4-2 ConvertPackageFilesToUNIXLineBreaks[101X
  
  [29X[2XConvertPackageFilesToUNIXLineBreaks[102X( [3Xpackage[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing.[133X
  
  [33X[0;0YThis function is a development tool which converts the text files of package
  [3Xpackage[103X  from  Windows-  to  UNIX line breaks. Here [3Xpackage[103X is assumed to be
  either [10X"resclasses"[110X or [10X"rcwa"[110X.[133X
  
  [1X4.4-3 RemoveTemporaryPackageFiles[101X
  
  [29X[2XRemoveTemporaryPackageFiles[102X( [3Xpackage[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ynothing.[133X
  
  [33X[0;0YThis  function  is a development tool which cleans up the temporary files of
  package  [3Xpackage[103X.  Here  [3Xpackage[103X  is  assumed  to  be either [10X"resclasses"[110X or
  [10X"rcwa"[110X.[133X
  
  
  [1X4.5 [33X[0;0YDownloadFile, SendEmail and EmailLogFile[133X[101X
  
  [1X4.5-1 DownloadFile[101X
  
  [29X[2XDownloadFile[102X( [3Xurl[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Ythe  contents  of the file with URL [3Xurl[103X in the form of a string if
            that  file  exists  and  the  download  was  successful,  and [10Xfail[110X
            otherwise.[133X
  
  [33X[0;0YThis  function needs the [5XIO[105X package, and as most system-related functions it
  works  only under UNIX. Also the computer must of course be connected to the
  Internet.[133X
  
  [1X4.5-2 SendEmail[101X
  
  [29X[2XSendEmail[102X( [3Xsendto[103X, [3Xcopyto[103X, [3Xsubject[103X, [3Xtext[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Yzero  if  everything  worked  correctly, and a system error number
            otherwise.[133X
  
  [33X[0;0YSends  an  e-mail with subject [3Xsubject[103X and body [3Xtext[103X to the addresses in the
  list  [3Xsendto[103X,  and  copies  it  to  those  in the list [3Xcopyto[103X. The first two
  arguments must be lists of strings, and the latter two must be strings.[133X
  
  [33X[0;0YAs  most system-related functions, [10XSendEmail[110X works only under UNIX. Also the
  computer must of course be connected to the Internet.[133X
  
  [1X4.5-3 EmailLogFile[101X
  
  [29X[2XEmailLogFile[102X( [3Xaddresses[103X ) [32X function
  [6XReturns:[106X  [33X[0;10Yzero  if  everything  worked  correctly, and a system error number
            otherwise.[133X
  
  [33X[0;0YSends the current log file by e-mail to [3Xaddresses[103X, if [5XGAP[105X is in logging mode
  and  one  is  working  under  UNIX, and does nothing otherwise. The argument
  [3Xaddresses[103X  must  be  either  a  list  of e-mail addresses or a single e-mail
  address. Long log files are abbreviated, i.e. if the log file is larger than
  64KB,  then  any  output  is  truncated at 1KB, and if the log file is still
  longer than 64KB afterwards, it is truncated at 64KB.[133X
  
