\title{The Comprehensive \TeX\ Archive Network}
\author[Sebastian Rahtz]{Sebastian Rahtz\\ArchaeoInformatica, York}
\begin{article}

\section{Introduction}
This article briefly describes the UK \TeX\ Archive
(Internet `Daughter' archive) on {\tt ftp.tex.ac.uk} for the benefit of
\ukt\ members. This archive is part of a collaborating network
of archives known as CTAN (Comprehensive \TeX\ Archive Network). This
is the creation of a \TeX\ Users Group working party on archives
chaired by George Greenwade which discussed the issue by electronic
mail during 1992. Following an initial implementation on {\tt
ftp.tex.ac.uk} in July 1992, the three main archives now follow the
same structure and have identical files ({\tt ftp.tex.ac.uk}, {\tt
ftp.shsu.edu} and {\tt ftp.uni-stuttgart.de}).

The preferred access method to the UK \TeX\ Archive is using the {\em
gopher} program which has a set of useful indexes to help you locate
what you are looking for, but Internet {\em ftp} access is also very
common.  JANET users may only access the machine using the {\tt
ftp-relay} site, as it has no X25 connection. The `Father' archive
on {\tt uk.ac.tex} remains open for JANET X25 access, and is regularly
updated from the `Daughter'.\footnote{Access the machine (DTE
000020120091) with username {\em public\/} and password {\em public.}}

\section{FTP access}
The CTAN archives all run an enhanced {\em ftp} server, which may
possibly confuse your client. If your {\em ftp} client crashes or
hangs shortly after login please try using a dash (-) as the first
character of your password.  This {\em ftp} server supports dynamic
compression, uncompression, and archive creation options. Fetch the
top-level file {\tt README.archive-features} for information.  The
server also supports site-defined commands to assist you.  Please read
{\tt README.site-commands} for a brief overview.
                                                                        
On Aston and SHSU servers, you can go to the top of the
archive tree using the alias {\tt CTAN:} --- type {\tt cd CTAN:} ({\em
with} the colon).

Please report any problems via e-mail to {\tt ctan-mgr@shsu.edu}.           

\section{Submitting material to the CTAN archives}
To submit a file to CTAN using {\em ftp}
to {\tt ftp.tex.ac.uk} or {\tt ftp.shsu.edu} as your point of entry,
please go to the {\tt /incoming} directory at the root level where you
entered this host.  {\tt cd /incoming} from any {\em ftp} prompt should get
you there.

Once in the {\tt /incoming} directory, please do one of the following:
\begin{enumerate}
\item if you are submitting a single file, simply put it in the {\tt
    /incoming} directory; or
\item if you are submitting a set of files intended to be used
  together as a package, please create a directory within {\tt
    /incoming} with: {\tt mkdir your\_name} (replace the string
  {your\_name} with the directory name you wish to use), then: {\tt cd
    your\_name}, then put your files in this directory.
  \end{enumerate} 
Be sure to use the proper mode (ascii or binary)
when you put your files into this directory.  Following this, please
send an electronic mail message to: {\tt ctan-mgr@shsu.edu} with the
suggested subject of: {\em CTAN Submission}. Your message should (a)
state what file(s) you have put where, (b) include a brief overview
of what the file(s) is/are intended to do, and (c) [optionally]
where you recommend placing your submission within the CTAN
directory hierarchy.

Once classified and moved into the CTAN directory hierarchy, your
submission will automatically be propagated to the other CTAN hosts.

Please do not abuse your privilege to access the {\tt /incoming} directory
by placing unauthorized files in it or for purposes of making your
files accessible to another site without the prior knowledge and consent
of the host university.  All {\em ftp} transactions to the host are
logged.  Abuse of this service will very likely result in complete loss
of {\em ftp} access to the host from your site until your system administrators
have been notified and appropriate intervention is made on their behalf.

Please forward any inquiries about this service to {\tt ctan-mgr@shsu.edu}.

\section{Archive hierarchy description}
We now describe the main directories which make up
CTAN; readers are referred to David Jones' {\em Index of \TeX\
Styles and Macros} for details of macro packages and
individual style files. 

{\small
\begin{description}
\item[archive-tools] contains the various archiving tools which users
  may find useful.
\item[bibliography] contains bibliography-related files, such as
  \BibTeX.
\item[digests] contains back issues of \TeX-related periodicals.
\item[documentation] contains files and tutorials which document
  various aspect of \TeX.
\item[dviware] contains the various dvi-to-whatever filters and drivers.
\item[fonts] contains a collection of fonts, both sources and
  pre-compiled.
\item[graphics] contains utilities and macros related to graphics.
\item[help] contains files which provide an overview to the archive
  and the \TeX\ system.
\item[indexing] contains utilities and related files for indexing
  documents.
\item[languages] contains non-English related implementations of \TeX.
\item[macros] contains macros for \TeX\ and its derivatives in unique
  subdirectories.
\item[support] contains files and programs which can be used in
  support of \TeX.
\item[systems] contains complete system setups, organized by operating
  system.
\item[web] contains WEB-related files and utilities.
\end{description}
}
\end{article}

