home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 35 Internet / 35-Internet.zip / cern_os2.zip / README.txt < prev   
Text File  |  1994-06-16  |  10KB  |  223 lines
  1.                                                                         Read Me
  2.                       WORLDWIDEWEB CERN-DISTRIBUTED CODE
  3.                                        
  4.    See the CERN copyright[1] .  This is the README file which you get when you
  5.    unwrap one of our tar files. These files contain information about
  6.    hypertext, hypertext systems, and the WorldWideWeb project. If you have
  7.    taken this with a .tar file, you will have only a subset of the files.
  8.    
  9.    THIS FILE IS A VERY ABRIDGED VERSION OF THE INFORMATION AVAILABLE ON THE
  10.    WEB.   IF IN DOUBT, READ THE WEB DIRECTLY. If you have not got ANY browser
  11.    installed yet, do this by telnet to info.cern.ch (no username or password).
  12.    
  13.    Files from info.cern.ch are also mirrored on ftp.ripe.net.
  14.    
  15. Archive Directory structure
  16.  
  17.    Under /pub/www[2] , besides this README file, you'll find bin[3] , src[4]
  18.    and doc[5] directories.  The main archives are as follows:
  19.    
  20.   bin/xxx/bbbb            Executable binaries of program bbbb for system xxx.
  21.                          Check what's there before you bother compiling. (Note
  22.                          HP700/8800 series is "snake")
  23.                          
  24.   bin/next/WorldWideWeb_v.vv.tar.Z
  25.                          The Hypertext Browser/editor for the NeXT -- binary.
  26.                          
  27.   src/WWWLibrary_v.vv.tar.Z
  28.                           The W3 Library. All source, and Makefiles for
  29.                          selected systems.
  30.                          
  31.   src/WWWLineMode_v.vv.tar.Z
  32.                           The Line mode browser - all source, and Makefiles for
  33.                          selected systems. Requires the Library[6] .
  34.                          
  35.   src/WWWDaemon_v.vv.tar.Z
  36.                           The HTTP daemon, and WWW-WAIS  gateway programs.
  37.                          Source.  Requires the Library.
  38.                          
  39.   src/WWWMailRobot_v.vv.tar.Z
  40.                           The Mail Robot.
  41.                          
  42.   doc/WWWBook.tar.Z       A snapshot of our internal documentation - we prefer
  43.                          you to access this on line -- see warnings below.
  44.                          
  45. Basic WWW software installation from source
  46.  
  47.    This applies to the line mode client and the server.  Below, $prod means
  48.    LineMode or Daemon depending on which you are building.
  49.    
  50.   GENERATED DIRECTORY STRUCTURE
  51.   
  52.    The tar files are all designed to be unwrapped in the same (this) directory.
  53.    They create different parts of a common directory tree under that directory.
  54.    There may be some duplication. They also generate a few files in this
  55.    directory: README.*, Copyright.*, and some installation instructions (.txt).
  56.    
  57.    The directory structure is, for product $prod  and machine $WWW_MACH
  58.    
  59.   WWW/$prod/Implementation
  60.                           Source files for a given product
  61.                          
  62.   WWW/$prod/Implementation/CommonMakefile
  63.                          The machine-independent parts of the Makefile for this
  64.                          product
  65.                          
  66.  
  67.                                                                 Read Me (65/66)
  68.   WWW/$prod/$WWW_MACH/    Area for compiling for a given system
  69.                          
  70.   WWW/All/$WWW_MACH/Makefile.include
  71.                          The machine-dependent parts of the makefile for any
  72.                          product
  73.                          
  74.   WWW/All/Implementation/Makefile.product
  75.                          A makefile which includes both parts above and so can
  76.                          be used from any product, any machine.
  77.                          
  78.   COMPILATION ON ALREADY SUPPORTED PLATFORMS
  79.   
  80.    You must get the WWWLibrary tar file as well as the products you want and
  81.    unwrap them all from the same directory.
  82.    
  83.    You must define the environmant variable WWW_MACH to be the architecure of
  84.    your machine (sun4, decstation, rs6000, sgi, snake, etc)
  85.    
  86.    In directory WWW, type BUILD.
  87.    
  88.   COMPILATION ON NEW PLATFORMS
  89.   
  90.    If your machine is not on the list:
  91.    
  92.       Make up a new subdirectory of that name under WWW/$prod and WWW/All,
  93.       copying the contents of a basically similar architecture's directory.
  94.       
  95.       Check the  WWW/All/$WWW_MACH/Makefile.include for suitable directory and
  96.       flag definitions.
  97.       
  98.       Check the file tcp.h for the system-specific include file coordinates,
  99.       etc.
  100.       
  101.       Send any changes you have to make back to www-request@info.cern.ch for
  102.       inclusion into future releases.
  103.       
  104.       Once you have this set up, type BUILD.
  105.       
  106.   PROBLEMS?
  107.   
  108.    Some versions of make (NeXT, osf1?) resolve relative pathnames in include
  109.    directives relative to the current file rather than the current working
  110.    directory. If this happens, you get a "Cannot open
  111.    ../../All/Implementation/../Implementation/Commonmakefile" error. You have
  112.    to then for each product build directory WWW/$product/$WWW_MACH, cd to it,
  113.    then
  114.    
  115.         cp ../../All/Implementation/Makefile.product  Makefile
  116.         setenv WWW_MACH osf1        (or whatever)
  117.         make.
  118.  
  119.  
  120. NeXTStep Browser/Editor
  121.  
  122.    The browser for the NeXT is those files contained in the application
  123.    directory WWW/Next/Implementation/WorldWideWeb.app and is compiled. When you
  124.    install the app, you may want to configure the default page,
  125.    WorldWideWeb.app/default.html. These must point to some useful information!
  126.    You should keep it up to date with pointers to info on your site and
  127.    elsewhere. If you use the CERN home page note there is a link at the bottom
  128.    to the master copy on our server.   You should set up the address of your
  129.    local news server with
  130.    
  131.                       dwrite WorldWideWeb NewsHost  news
  132.  
  133.                                                                Read Me (66/131)
  134.    replacing the last word with the actual address of your news host. See
  135.    Installation instructions[7] .
  136.    
  137. Line Mode browser
  138.  
  139.    Binaries of this for some systems are available in /pub/www/bin/ . The
  140.    binaries can be picked up, set executable, and run immediately.
  141.    
  142.    If there is no binary, see "Installation from source" above.
  143.    
  144.     (See Installation notes[8] ).  Do the same thing (in the same directory) to
  145.    the WWWLibrary_v.cc.tar.Z file to get the common library.
  146.    
  147.    You will have an ASCII printable manual in the file
  148.    WWW/LineMode/Defaults/line-mode-guide.txt which you can print out at this
  149.    stage. This is a frozen copy of some of the online documentation.
  150.    
  151.    Whe you install the browser, you may configure a default page. This is
  152.    /usr/local/lib/WWW/default.html for the line mode browser. This must point
  153.    to some useful information! You should keep it up to date with pointers to
  154.    info on your site and elsewhere. If you use the CERN home page note there is
  155.    a link at the bottom to the master copy on our server.
  156.    
  157.    Some basic documentation on the browser is delivered with the home page in
  158.    the directory WWW/LineMode/Defaults. A separate tar file of that directory
  159.    (WWWLineModeDefaults.tar.Z) is available if you just want to update that.
  160.    
  161.    The rest of the documentation is in hypertext, and so wil be readable most
  162.    easily with a browser. We suggest that after installing the browser, you
  163.    browse through the basic documentation so that you are aware of the options
  164.    and customisation possibilities for example.
  165.    
  166. Server
  167.  
  168.    The server can be run very simply under the internet  daemon, to export a
  169.    file directory tree as a browsable hypertext tree.  Binaries are avilable
  170.    for some platofrms, otherwise follow instructions above for compiling and
  171.    then go on to " Installing the basic W3 server[9] ".
  172.    
  173. XMosaic
  174.  
  175.    XMosaic is an X11/Motif  W3 browser.
  176.    
  177.    The sources and binaries are distributed separately from
  178.    FTP.NCSA.UIUC.EDU[10] , in  /Web/xmosaic[11] .  Binaries are available for
  179.    some platforms.  If you have to build from source, check the README in the
  180.    distribution.
  181.    
  182.    The binaries can be picked up, uncompressed, set "executable" and run
  183.    immediately.
  184.    
  185. Viola browser for X11
  186.  
  187.    Viola is an X11 application for reading global hypertext.  If a binary is
  188.    available from your machine, in /pub/www/bin/.../viola*, then take that and
  189.    also the Viola "apps" tar file which contains the scripts you will need.
  190.    
  191.    To generate this from source, you will need both the W3 library and the
  192.    Viola source files.  There is an Imakefile with the viola source directory.
  193.    You will need to generate the XPA and XPM libraries and the W3 library
  194.    befere you make viola itself.
  195.    
  196. Documentation
  197.  
  198.  
  199.                                                                Read Me (66/195)
  200.    In the /pub/www/doc[12] directory are a number articles, preprints and
  201.    guides on the web.
  202.    
  203.    See the online WWW bibliography[13] for a list of these and other articles,
  204.    books, etc. and also the list of WWW Manuals[14] available in text and
  205.    postscript form.
  206.    
  207. General
  208.  
  209.    Your comments will of course be most appreciated, on code, or information on
  210.    the web which is out of date or misleading. If you write your own hypertext
  211.    and make it available by anonymous ftp or using a server, tell us and we'll
  212.    put some pointers to it in ours. Thus spreads the web...
  213.    
  214.                                                                 Tim Berners-Lee
  215.                                                                                
  216.                                                            WorldWideWeb project
  217.                                                                                
  218.                                               CERN, 1211 Geneva 23, Switzerland
  219.                                                                                
  220.           Tel: +41 22 767 3755; Fax: +41 22 767 7155; email: timbl@info.cern.ch
  221.                                                                                
  222.    
  223.