home *** CD-ROM | disk | FTP | other *** search
/ CBM Funet Archive / cbm-funet-archive-2003.iso / cbm / README.html < prev    next >
Encoding:
Extensible Markup Language  |  2002-09-18  |  8.6 KB  |  195 lines
  1. <?XML VERSION="1.0"?><!-- -*- XML -*- -->
  2. <!doctype HTML public "-//w3c//dtd xhtml 1.0 sTRICT//en"
  3.  "HTTP://WWW.W3.ORG/tr/XHTML1/dtd/XHTML1-STRICT.DTD">
  4. <HTML
  5.  XMLNS="HTTP://WWW.W3.ORG/1999/XHTML"
  6.  LANG="EN" XML:LANG="EN" DIR="LTR">
  7.  
  8. <HEAD>
  9. <TITLE>iNSTRUCTIONS FOR ACCESSING
  10. HTTP://WWW.FUNET.FI/PUB/CBM/</TITLE>
  11. <LINK REV="MADE" HREF="MAILTO:MSMAKELA@NIC.FUNET.FI" />
  12. <LINK REL="STYLESHEET" HREF=".DOC.CSS" />
  13. <LINK REL="ICON" HREF=".ICON.PNG" />
  14. <META HTTP-EQUIV="cONTENT-tYPE" CONTENT="TEXT/HTML; CHARSET=ISO-8859-1" />
  15. </HEAD>
  16.  
  17. <BODY>
  18.  
  19. <H1>iNSTRUCTIONS FOR ACCESSING <A CLASS="LINK"
  20. HREF="HTTP://WWW.FUNET.FI/PUB/CBM/INDEX.HTML">HTTP://WWW.FUNET.FI/PUB/CBM/</A></H1>
  21.  
  22. <P>tHIS ARCHIVE IS THE MAIN eUROPEAN SUPPORTER OF DOCUMENTATION AND SOFTWARE
  23. FOR cOMMODORE bUSINESS mACHINES' 8-BIT COMPUTERS.  iF YOU ARE LOCATED FAR
  24. AWAY FROM eSPOO, fINLAND, eUROPE, PLEASE TRY A <A HREF="mirrors.HTML">MIRROR
  25. SITE</A> CLOSER TO YOU.</P>
  26.  
  27. <H2>0. gENERAL INFORMATION</H2>
  28.  
  29. <P>wE TRY TO KEEP OUR FILES DOCUMENTED, SO THAT YOU DON'T HAVE TO
  30. DOWNLOAD ANYTHING TO FIND OUT IF IT WAS WORTH DOWNLOADING.  iN EACH
  31. DIRECTORY IN THE /PUB/CBM TREE, THERE IS A FILE CALLED <A
  32. HREF="00index" TYPE="TEXT/PLAIN">00index</A> THAT CONTAINS A BRIEF
  33. DESCRIPTION OF THE FILES IN THAT DIRECTORY.  tHIS IS THE SOURCE OF
  34. INFORMATION FOR THE <ACRONYM
  35. TITLE="hYPERtEXT mARKUP lANGUAGE">html</ACRONYM> DIRECTORY LISTINGS IN
  36. THE <A HREF="INDEX.HTML">INDEX.HTML</A> FILES.</P>
  37.  
  38. <H2>1. gETTING STARTED</H2>
  39.  
  40. <P>iT MIGHT BE WISEST TO FIRST DOWNLOAD THE <A HREF="00index"
  41. TITLE="TEXTUAL FILE DESCRIPTIONS">00index</A> OR <A HREF="INDEX.HTML"
  42. TITLE="HYPERTEXT DIRECTORY INDEX">INDEX.HTML</A> FILES FROM THE
  43. DIRECTORIES YOU ARE INTERESTED IN.</P>
  44.  
  45. <P>aT THE TOP LEVEL AND IN ITS EACH MAJOR SUBDIRECTORY (<A
  46. HREF="VIC20/INDEX.HTML" TITLE="cOMMODORE vic-20">VIC20</A>, <A
  47. HREF="C64/INDEX.HTML" TITLE="cOMMODORE 64">C64</A>, <A
  48. HREF="C128/INDEX.HTML" TITLE="cOMMODORE 128">C128</A> AND OTHERS),
  49. THERE ARE INDEXES THAT COVER THE WHOLE DIRECTORY TREE:</P>
  50.  
  51. <DL>
  52.  <DT><A HREF="alldirs" TYPE="TEXT/PLAIN"
  53.  TITLE="TEXTUAL LISTING">alldirs</A>, <A HREF="alldirs.HTML"
  54.  TYPE="TEXT/PLAIN" TITLE="HYPERTEXT LISTING">alldirs.HTML</A></DT>
  55.  <DD>aLL DIRECTORY NAMES WITH DESCRIPTIONS.  mODIFICATION
  56.  TIME STAMPS ARE NOT INCLUDED.</DD>
  57.  <DT><A HREF="allfiles" TYPE="TEXT/PLAIN"
  58.  TITLE="TEXTUAL LISTING">allfiles</A>, <A HREF="allfiles.HTML"
  59.  TYPE="TEXT/PLAIN" TITLE="HYPERTEXT LISTING">allfiles.HTML</A></DT>
  60.  <DD>aLL DIRECTORY AND FILE NAMES WITH DESCRIPTIONS.  mODIFICATION
  61.  TIME STAMPS ARE NOT INCLUDED.</DD>
  62. </DL>
  63.  
  64. <H2>2. sYMBOLIC LINKS AND HYPERLINKS</H2>
  65.  
  66. <P>sOMETIMES, THERE ARE SEVERAL NAMES TO THE SAME DIRECTORY.  fOR
  67. INSTANCE, THE SCHEMATIC DIAGRAMS OF THE cOMMODORE 128 COMPUTER CAN BE
  68. ACCESSED BOTH VIA THE <CODE>C128</CODE> SUBDIRECTORY OF <CODE><A
  69. HREF="SCHEMATICS/COMPUTERS/INDEX.HTML">SCHEMATICS/COMPUTERS/</A></CODE>
  70. AND VIA THE <CODE>SCHEMATICS</CODE> SUBDIRECTORY OF <CODE><A
  71. HREF="C128/INDEX.HTML">C128/</A></CODE>.  iN THE <ACRONYM
  72. TITLE="hYPERtEXT mARKUP lANGUAGE">html</ACRONYM> NAVIGATION INTERFACE
  73. TO THE ARCHIVE, HYPERLINKS TO SYMBOLIC LINKS ARE REPLACED WITH DIRECT
  74. HYPERLINKS TO THE SYMBOLIC LINK TARGETS.  iN OTHER WORDS, THE
  75. HYPERLINK <CODE>SCHEMATICS</CODE> IN <CODE><A
  76. HREF="C128/INDEX.HTML">C128/</A></CODE> JUMPS DIRECTLY TO <CODE><A
  77. HREF="SCHEMATICS/COMPUTERS/C128/INDEX.HTML">SCHEMATICS/COMPUTERS/C128/</A></CODE>.</P>
  78.  
  79. <P>iN ONE CASE, SYMBOLIC LINKS MAY CAUSE PROBLEMS.  dIRECTORY LISTINGS
  80. CAN BE ACCESSED ALSO WITH NON-CANONICAL <ACRONYM
  81. TITLE="uNIFORM rESOURCE iDENTIFIER">uri</ACRONYM>S WHERE SOME
  82. DIRECTORY COMPONENTS ARE SYMBOLIC LINKS.  tHE PROBLEMS BEGIN WHEN A
  83. DIRECTORY NAVIGATION LINK IS SELECTED THE LISTING: THE <ACRONYM
  84. TITLE="hYPERtEXT mARKUP lANGUAGE">html</ACRONYM> BROWSER AND THE FILE
  85. SERVER WILL BECOME <Q>OUT OF SYNCHRONISATION</Q>, AND EITHER THE
  86. TARGET LINKS CANNOT BE FOUND OR THEY POINT TO UNEXPECTED PLACES.  wE
  87. COULD SOLVE THIS PROBLEM BY USING THE <ACRONYM
  88. TITLE="hYPERtEXT mARKUP lANGUAGE">html</ACRONYM> <CODE><A
  89. HREF="HTTP://WWW.W3.ORG/tr/HTML4/STRUCT/LINKS.HTML#H-12.4">BASE</A></CODE>
  90. ELEMENT, BUT THAT ELEMENT WOULD HAVE TO BE ADAPTED FOR EACH <A
  91. HREF="mirrors.HTML">MIRROR</A> AND <A HREF="cd-r.HTML"><ACRONYM
  92. TITLE="cOMPACT dISK&MDASH;rECORDABLE">cd-r</ACRONYM> SNAPSHOT</A>
  93. SEPARATELY.</P>
  94.  
  95. <H2>3. dOWNLOADING</H2>
  96.  
  97. <P>wHEN DOWNLOADING FILES, YOU HAVE TO TAKE SOME PRECAUTIONS.  iF YOU
  98. ARE UNFAMILIAR WITH SOME FILE TYPES YOU ENCOUNTER ON OUR SITE, PLEASE
  99. SEE OUR <A HREF="filetypes.HTML">LIST OF FILE TYPES</A>.</P>
  100.  
  101. <H3>3.1 <ACRONYM
  102. TITLE="hYPERtEXT tRANSFER pROTOCOL">http</ACRONYM> INTERFACE</H3>
  103.  
  104. <P>tO DOWNLOAD A FILE, YOU HAVE TO USE THE <Q>sAVE LINK TARGET</Q>
  105. FUNCTION OF YOUR <ACRONYM
  106. TITLE="hYPERtEXT mARKUP lANGUAGE">html</ACRONYM> BROWSER.  oTHERWISE
  107. THE CONTENTS OF THE FILE MAY BE DISPLAYED ON THE SCREEN AS BINARY
  108. GARBAGE.</P>
  109.  
  110. <P>iN <A CLASS="LINK" HREF="HTTP://LYNX.BROWSER.ORG/">lYNX</A>, USE THE
  111. <KBD>D</KBD> KEY TO SAVE A LINK TARGET.  yOU WILL BE PROMPTED FOR
  112. ALTERNATIVES.  cHOOSE <Q>sAVE TO DISK</Q> AND CONFIRM THE FILENAME.</P>
  113.  
  114. <P>iN GRAPHICAL BROWSERS, YOU CAN USUALLY INVOKE A CONTEXT-SENSITIVE
  115. MENU BY CLICKING THE RIGHT MOUSE BUTTON WHILE THE POINTER IS PLACED
  116. ABOVE A HYPERLINK.  sELECT THE <Q>dOWNLOAD LINK</Q> OR <Q>sAVE LINK
  117. TARGET</Q> OR EQUIVALENT COMMAND.  iF YOUR OPERATING SYSTEM HAS SOME
  118. FILENAME LIMITATIONS, YOU MAY ALSO NEED TO RENAME THE FILE.</P>
  119.  
  120. <P>pLEASE NOTE THAT ON mICROSOFT
  121. wINDOWS, SOME VERSIONS OF nETSCAPE MAY SOMETIMES TRANSFORM THE <ACRONYM
  122. TITLE="cARRIAGE rETURN">cr</ACRONYM> AND <ACRONYM
  123. TITLE="lINE fEED">lf</ACRONYM> CHARACTERS IN THE FILES IT DOWNLOADS.
  124. aLSO, iNTERNET eXPLORER MAY SILENTLY DECOMPRESS <A CLASS="LINK"
  125. HREF="HTTP://WWW.GNU.ORG/DIRECTORY/GZIP.HTML">GZIP</A>PED FILES YOU
  126. DOWNLOAD, WITHOUT REMOVING THE <CODE>.GZ</CODE> FILE NAME SUFFIX.</P>
  127.  
  128. <P>iN CASE YOU HAVE PROBLEMS WITH <ACRONYM
  129. TITLE="hYPERtEXT tRANSFER pROTOCOL">http</ACRONYM>, TRY A BETTER
  130. CLIENT, SUCH AS <A CLASS="LINK"
  131. HREF="HTTP://WWW.GNU.ORG/DIRECTORY/WGET.HTML">WGET</A>, OR USE THE
  132. <ACRONYM TITLE="fILE tRANSFER pROTOCOL">ftp</ACRONYM> INTERFACE.</P>
  133.  
  134. <H3>3.2 <ACRONYM
  135. TITLE="fILE tRANSFER pROTOCOL">ftp</ACRONYM> INTERFACE</H3>
  136.  
  137. <P>uSE <EM>BINARY</EM> MODE WHEN TRANSFERRING THE PROGRAMS.  nOTE THAT
  138. THE <ACRONYM
  139. TITLE="tRANSMISSION cONTROL pROTOCOL/iNTERNET pROTOCOL">tcp/ip</ACRONYM>
  140. FIREWALL OF YOUR <ACRONYM TITLE="iNTERNET sERVICE pROVIDER">isp</ACRONYM>
  141. MAY REQUIRE YOU TO ENTER <EM>PASSIVE</EM> MODE BEFORE DOWNLOADING
  142. ANYTHING, EVEN DIRECTORY LISTINGS.</P>
  143.  
  144. <P><ACRONYM TITLE="fILE tRANSFER pROTOCOL">ftp</ACRONYM> CLIENTS WITH
  145. PRETTY GRAPHICAL USER INTERFACES CAN CAUSE LOTS OF PROBLEMS.  tHEY
  146. WILL NOT LET YOU ISSUE ALL COMMANDS THAT ARE AVAILABLE IN A TEXTUAL
  147. CLIENT, AND THEY MAY NOT SHOW THE RETURN CODES OF THE ftp SERVER.
  148. aLSO, YOU MAY BE UNSURE WHETHER TRANSFERS TAKE PLACE IN BINARY OR IN
  149. TEXT MODE.</P>
  150.  
  151. <H3>3.3 mASS DOWNLOADING AND MIRRORING</H3>
  152.  
  153. <P>pROBABLY THE MOST EFFICIENT WAY TO MAINTAIN A MIRROR OF OUR ARCHIVE
  154. IS TO USE <A CLASS="LINK" HREF="HTTP://RSYNC.SAMBA.ORG/">RSYNC</A> AND
  155. A <ACRONYM TITLE="uNIFORM rESOURCE iDENTIFIER">uri</ACRONYM> STARTING
  156. WITH <CODE>RSYNC://NIC.FUNET.FI/FTP/PUB/CBM/</CODE>.  dO NOT FORGET
  157. THE TRAILING SLASH CHARACTER <Q><CODE>/</CODE></Q>!</P>
  158.  
  159. <H2>4. uPLOADING</H2>
  160.  
  161. <P>iF YOU HAVE SOME SOFTWARE OR DOCUMENTS THAT YOU WOULD WANT TO
  162. UPLOAD HERE, FOLLOW THE INSTRUCTIONS IN <A CLASS="LINK"
  163. HREF="HTTP://WWW.FUNET.FI/PUB/CBM/INCOMING/readme.uploader"
  164. TYPE="TEXT/PLAIN">/PUB/CBM/INCOMING/readme.uploader</A>.  iT IS A GOOD
  165. IDEA TO NOTIFY <A CLASS="LINK" HREF="MAILTO:CBM-ADM@LISTS.FUNET.FI">US</A>
  166. ABOUT THE UPLOADS, SO THAT THEY WILL BE PROCESSED FASTER.  aLSO, THE UPLOADS
  167. SHOULD ALWAYS BE DESCRIBED (WHAT THE PROGRAM DOES, WHICH PLATFORMS IT
  168. RUNS ON, AND SO ON).</P>
  169.  
  170. <H2>5. pROBLEMS AND FEEDBACK</H2>
  171.  
  172. <P>iF YOU HAVE ANY PROBLEMS ACCESSING OUR ARCHIVE, OR IF YOU WOULD
  173. LIKE TO GIVE US ANY FEEDBACK, YOU CAN REACH US VIA E-MAIL AT <A
  174. CLASS="LINK"
  175. HREF="MAILTO:CBM-ADM@LISTS.FUNET.FI">CBM-ADM@LISTS.FUNET.FI</A>.</P>
  176.  
  177. <P>iF YOU ARE LOOKING FOR HELP, PLEASE BE AS SPECIFIC AS POSSIBLE.
  178. mENTION THE FULL PATHNAMES, SUCH AS <CODE>/PUB/CBM/readme.HTML</CODE>
  179. OR <CODE>HTTP://WWW.FUNET.FI/PUB/CBM/readme.HTML</CODE>, AND TELL US
  180. WHAT SYSTEM YOU ARE USING, IF THE PROBLEM COULD BE SYSTEM-DEPENDENT.</P>
  181.  
  182. <HR />
  183. <ADDRESS><A CLASS="LINK" HREF="MAILTO:MSMAKELA@NIC.FUNET.FI">mARKO
  184. m&AUML;KEL&AUML;</A></ADDRESS>
  185.  
  186. <P><A
  187.  CLASS="LINK" HREF="HTTP://VALIDATOR.W3.ORG/CHECK/REFERER"><IMG
  188.  SRC="HTTP://WWW.W3.ORG/iCONS/VALID-XHTML10"
  189.  ALT="[vALID xhtml 1.0!]" HEIGHT="31" WIDTH="88" /></A><A
  190.  CLASS="LINK" HREF="HTTP://JIGSAW.W3.ORG/CSS-VALIDATOR/"><IMG
  191.  SRC="HTTP://JIGSAW.W3.ORG/CSS-VALIDATOR/IMAGES/VCSS"
  192.  ALT="[vALID css!]" HEIGHT="31" WIDTH="88" /></A></P>
  193.  
  194. </BODY></HTML>
  195.