Installing Epydoc

1. Downloading Epydoc
2. Installing from the RPM File
3. Installing from the Windows Installer
4. Installing from the Source Distribution
5. Installing from the Source Distribution (without make)
6. Installing on Debian

Downloading Epydoc

Epydoc can be downloaded from the SourceForge download page. Epydoc is available in five formats:

• RPM (.noarch.rpm)
• Windows installer (.win32.exe)
• Source install (.tar.gz)
• Source install (.zip)
• Source RPM (.src.rpm)

If you are installing on RedHat, I recommend that you use the RPM file. If you are installing on Windows, I recommended that you use the windows installer. Otherwise, you should use one of the source install files.

Installing from the RPM File

1. Download the RPM file to a directory of your choice.
2. Use rpm to install the new package.

   [/tmp]$ su
   Password:
   [/tmp]# rpm -i epydoc-2.0.noarch.rpm
   

3. Once epydoc is installed, you can delete the RPM file.

   [/tmp]# rm epydoc-2.0.rpm
   

Installing from the Windows Installer

1. Download and run epydoc-2.0.win32.exe.
2. Follow the on-screen instructions. Epydoc will be installed in the epydoc subdirectory of your Python installation directory (typically C:\Python22\).
3. The windows installer creates two scripts in the Scripts subdirectory of your Python installation directory: epydoc.pyw opens the graphical user interface, and epydoc.py calls the command line interface. If you'd like, you can create shortcuts from these scripts to more convenient locations (such as your desktop or start menu).
4. Once epydoc is installed, you can delete epydoc-2.0.win32.exe.

Installing from the Source Distribution (using make)

1. Download an epydoc source distribution to a directory of your choice, and uncompress it.

   [/tmp]$ wget -q http://prdownloads.sourceforge.net/epydoc/epydoc-2.0.tar.gz
   [/tmp]$ gunzip epydoc-2.0.tar.gz
   [/tmp]$ tar -xvf epydoc-2.0.tar
   

2. Use "make install" in the eydoc-2.0/ directory to install epydoc.

   [/tmp]$ cd epydoc-2.0/
   [/tmp/epydoc-2.0]$ su
   Password:
   [/tmp/epydoc-2.0]# make install
   running install
   running build
   [...]
   copying build/scripts/epydoc -> /usr/bin
   changing mode of /usr/bin/epydoc to 100775
   

3. If you'd like to keep a local copy of the documentation, then use "make installdocs". By default, this will install the documentation to /usr/share/doc/ and the man pages to /usr/share/man/. If you would prefer to install documentation to different directories (such as /usr/lib/doc), then edit the MAN and DOC variables at the top of Makefile before running "make installdocs".

   [/tmp/epydoc-2.0]# make installdocs
   

4. Once epydoc is installed, you can delete the installation directory and the source distribution file.

   [/tmp/epydoc-2.0]# cd ..
   [/tmp]# rm -r epydoc-2.0
   [/tmp]# rm epydoc-2.0.tar
   

Installing from the Source Distribution (without make)

1. Download an epydoc source distribution to a directory of your choice, and uncompress it.

   [/tmp]$ wget -q http://prdownloads.sourceforge.net/epydoc/epydoc-2.0.tar.gz
   [/tmp]$ gunzip epydoc-2.0.tar.gz
   [/tmp]$ tar -xvf epydoc-2.0.tar
   

2. Use the setup.py script in the eydoc-2.0/ directory to install epydoc.

   [/tmp]$ cd epydoc-2.0/
   [/tmp/epydoc-2.0]$ su
   Password:
   [/tmp/epydoc-2.0]# python setup.py install
   running install
   running build
   [...]
   copying build/scripts/epydoc -> /usr/bin
   changing mode of /usr/bin/epydoc to 100775
   [/tmp/epydoc-2.0]# cd ..
   [/tmp]#
   

3. If you'd like to keep a local copy of the documentation, then copy it to a permanant location, such as /usr/share/doc/. You may also want to copy the man pages to a permanat location, such as /usr/share/man/.

   [/tmp]# cp -r epydoc-2.0/doc/ /usr/share/doc/epydoc/
   [/tmp]# cp epydoc-2.0/man/* /usr/share/man/
   

4. Once epydoc is installed, you can delete the installation directory and the source distribution file.

   [/tmp]# rm -r epydoc-2.0
   [/tmp]# rm epydoc-2.0.tar
   

Installing on Debian

Epydoc 1.1 is available as an unstable debian package. Epydoc 2.0 has not yet been packaged for debian; please use one of the other install methods.

[Epydoc]

[Using]

[Epytext]

[Author]