
                        UUDEVIEW FOR UNIX INSTALLATION
                                       
   To install the files in Unix, there are three steps to do:
    1. Configuration.
    2. Compilation.
    3. Installation.
       
Configuration

   You must edit the Makefile to reflect your local configuration.
   Especially the mailing and posting features of the encoder need to be
   properly configured, or they won't work. They will most certainly need
   manual adjustment. So fire up your favourite text editor and open the
   Makefile.
   
     A line in the Makefile is considered a comment if it has a '#' sign
     as first character on the line. Commenting the line out means to put
     a '#' in front of the line so that it doesn't take effect.
     Uncommenting means to remove the '#' signs from the beginning of
     the line so that it does take effect.
     
  CONFIGURATION OPTIONS
  
   Each option is of the kind <name>=<value>. Changing an option means
   either to comment it out, to uncomment it, or to change the value.
   Never edit the name of the option.
   
    General Options
    
   BINDIR
          The final location for the programs, usually a directory
          accessible to everyone. A good choice is /usr/local/bin. If you
          aren't the system administrator, and can't write to public
          directories, use $(HOME)/bin.
          
   MANDIR
          The final location for the manual pages, which will be stored
          in the man1/ subdirectory of the given directory. A good choice
          is /usr/local/man. If you aren't the system administrator, you
          will probably choose not to install the manual pages at all; in
          that case, this setting doesn't matter.
          You can then read the manual pages using the commands
            nroff -man uudeview.1 | more
            nroff -man uuenview.1 | more
          
   CC
          The C compiler. If you have the GNU C compiler installed, set
          it to gcc, otherwise to cc.
          
   FLAGS
          Compiler flags. Use -O to get optimized code. If your compiler
          needs a switch to be forced into ANSI mode, add this switch
          here. Most native HP compilers (other than gcc) need -Aa
          -D_INCLUDE_POSIX_SOURCE.
          
   LIBS
          Additional libraries to link. SunOS 4.x and Solaris 1.x might
          need -ldl here.
          
    UUEnview Options
    
   In this section, you must tell the encoder what programs it shall use
   to mail and post files, and how to operate them. You will need some
   experience with Unix to answer the questions asked here. You can also
   choose to comment out all configuration options, but then you won't be
   able to mail and post (encoding into a file will work).
   
   MAIL
          The program used to mail a file, usually /bin/mail or
          /usr/bin/mail. If it is not in your PATH, give the full path
          name. The program must read its input from standard input.
          
   MPSUBJECT
          Set the value to 1 if the above program accepts the -s command
          line option to set the mail's subject. If it doesn't, set the
          value to 0. The encoder will then try another means of setting
          the subject, but if that isn't accepted, too, we can't help it.
          
   INEWS
          The program used to post an article to the usenet. All it's got
          to do is to read headers and the article from standard input
          and then submit it to your news server. inews will work, but
          only if the news server runs locally. I have no experience with
          cnews and other related utilities. The default is to use
          minews, a mini inews.
          
   MINEWS
          A mini version of inews that can be used by the encoder to post
          an article is included in the distribution. Uncomment this line
          (this is the default) to build it along with the other
          programs. In this case, you will also have to configure minews
          with the options below. If you don't need it, or if it fails to
          compile or work, comment out this line, and don't use minews in
          the above definition.
          On some systems, you must add -lnsl to the LIBS option above,
          or compilation of minews will fail.
          
    Configuration of minews
    
   You only need to adjust these settings if you chose to compile minews.
   If you have commented out the MINEWS option above, you can skip this
   section.
   
   NNTPSERVER
          Specifies the news-serving host on your local network, which
          will be contacted to post an article. The value given here can
          always be overridden at runtime with the NNTPSERVER environment
          variable.
          
   DOMAIN
          The internet domain your machine is in. This is the fully
          qualified hostname minus the hostname itself. For example, one
          of our machines here is zeus.rbi.informatik.uni-frankfurt.de,
          meaning that the hostname is zeus and the domain is
          rbi.informatik.uni-frankfurt.de. This value is used to
          compose the sender's (your) email address for the posting. Be
          advised that you cannot make yourself anonymous by specifying a
          wrong domain name. There are still other means of tracing the
          article back to you.
          
   HIDDENNET
          If you set this value to 1, the local hostname will be stripped
          from your email address. It will appear to come from
          user@DOMAIN instead of user@hostname.DOMAIN. Use only if your
          subnet is configured correctly.
          
   If you think you've sorted out the above settings, but it doesn't
   work, play around with them. It will also help to try the mail and
   inews program manually to figure out how they're working. If you
   cannot get them to work by any means, disable both features by
   commenting out the MAIL and INEWS settings. The encoder will then
   refuse to mail and post.
   
Compilation

   After working through the configuration, you're about finished. If all
   settings, especially the compiler setting, is correct, then this and
   the final installation steps are a piece of cake. Don't forget to save
   the edited Makefile and exit from your editor. Then, issue the
   following command:

        make

   This will hopefully compile everything. Two binaries should appear in
   the current directory, the decoder uudeview and the encoder uuenview.
   If you chose to compile minews, then it should be built in the inews
   subdirectory. If you encounter compiler errors, have a close look at
   them. Make sure you really have an ANSI compiler. If all source file
   compile, but they fail to link because of missing functions, try to
   find out what library they belong to and add it to the LIBS
   definition.
   
     On some systems, make may fail because it uses the wrong shell. If
     you get errors with multi-line commands, try invoking sh -c 'make'.
     
Installation

   Installation is split up into two steps, installation of the programs
   and installation of the manual pages. Both steps are absurdly simple.
   But if you want to install the programs and manuals publicly, this is
   the time to login as root.

        make install

   To install uudeview, uuenview, and, if you chose to use it, minews.

        make install.man

   Installs the manual pages, if you want them.
   
   You can now test the installation by invoking uudeview and uuenview
   without any arguments; they should print a short description. Then,
   try reading the manual pages, man uudeview and man uuenview. If it
   doesn't work, make sure the BINDIR and MANDIR settings in the Makefile
   match your PATH and MANPATH environment variables, respectively.
   
   On the other hand, if it works, congratulations, you have successfully
   installed the uudeview package. You can now go on and test whether
   mailing and posting from uuenview works, preferredly by emailing a
   file to yourself and posting to local test newsgroups.
   
     Optionally, you may also try to use the compatibility features of
     both tools by symlinking uuencode to uuenview and uudecode to
     uudeview. Called like that, both tools will try to mimic their
     predecessors' behaviour.
     
   
   
   
     _________________________________________________________________
   
   
    Frank Pilhofer <fp@informatik.uni-frankfurt.de> Back to the Homepage
    
   Last modified: Wed Oct 18 15:54:04 1995
