summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex')
-rw-r--r--Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex110
1 files changed, 41 insertions, 69 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex b/Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex
index cc349bdcb11..f07eef697a8 100644
--- a/Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex
+++ b/Master/texmf-dist/doc/generic/FAQ-en/faq-getit.tex
@@ -1,4 +1,4 @@
-% $Id: faq-getit.tex,v 1.9 2011/05/08 10:16:43 rf10 Exp $
+% $Id: faq-getit.tex,v 1.10 2012/03/31 09:22:17 rf10 Exp rf10 $
\section{Acquiring the Software}
@@ -13,56 +13,28 @@ in this \acro{FAQ}
is archived at the \acro{CTAN} sites (see the lists of software at the
end of each answer).
-\begin{flatversion}
- The \acro{CTAN} sites are in Germany and the UK; the
- directory layout is the same on each of the sites, starting from a
- tree root of \path{tex-archive/} The sites are
- \texttt{dante.ctan.org} (Dante, Germany) and \texttt{www.tex.ac.uk}
- (Cambridge, UK).% and \texttt{tug.ctan.org} (TUG, USA).
-\end{flatversion}
-\begin{hyperversion}
- The \acro{CTAN} sites are
- \href{http://dante.ctan.org/tex-archive}{Dante (Germany)} and
- \href{http://www.tex.ac.uk/tex-archive}{Cambridge (UK)};
-% \href{http://tug.ctan.org/tex-archive}{TUG (USA)};
- the links are to
- the root of the \acro{CTAN} tree, above which the layout is
- identical at each site.
-\end{hyperversion}
-
-The \TeX{} files at each \acro{CTAN} node may also be accessed using
-\texttt{ftp} at \acro{URL}s \URL{ftp://dante.ctan.org/tex-archive} and
-\URL{ftp://ftp.tex.ac.uk/tex-archive}
-%and \URL{ftp://www.ctan.org/tex-archive}
-respectively.
-
-As a matter of course, to reduce network load,
-please use the \acro{CTAN} site
-or mirror closest to you. A complete and current list of \acro{CTAN} sites
-and known mirrors is available as file \CTANref{CTAN-sites} on the
-archives themselves.
-
-Better still, the script behind \URL{http://mirror.ctan.org/} will
-cunningly choose a ``nearby'' mirror for you, using information from
-the database `behind' \CTANref{CTAN-sites}; it will offer a connection
-using \texttt{http} (web) protocol if one is available, otherwise one
-using \texttt{ftp} protocol.
+There are two main \acro{CTAN} sites (in Germany and the \acro{UK}),
+but users should ordinarily collect material via the % ! line break
+\href{http://mirror.ctan.org/}{\acro{CTAN} mirror redirector}
+(which connects you to a mirror that is in some sense ``near'' to
+you).
To access a particular thing through the \texttt{mirror.ctan.org}
mechanism, simply place the \acro{CTAN} path after the base
\acro{URL}; so
\URL{http://mirror.ctan.org/macros/latex/contrib/footmisc/} will
connect you to the \Package{footmisc} directory at some \acro{CTAN}
-site (or a mirror)~--- note that the \File{tex-archive} part of the
-\acro{CTAN} path isn't needed.
+mirror.
For details of how to find files at \acro{CTAN} sites, see
``\Qref*{finding \AllTeX{} files}{Q-findfiles}''.
The \TeX{} user who has no access to any sort of
network may buy a copy of the archive as part of the
-\Qref*{\texlive{} distribution}{Q-CD}.
-\LastEdit{2011-04-26}
+\Qref*{\texlive{} distribution}{Q-CD}; the disc is, necessarily, out
+of date, but it is likely to be better than what (if anything) came
+with your operating system.
+\LastEdit{2012-12-14}
\Question[Q-tds-zip]{Ready-built installation files on the archive}
@@ -143,13 +115,14 @@ the main tree''.
\Question[Q-uploads]{Contributing a file to the archives}
-You have something to submit to the archive~--- great! Before we even
-start, here's a check-list of things to sort out:
+You have something to submit to the archive~--- good news!
+
+Before we even start, here's a check-list of things to sort out:
\begin{enumerate}
\item Licence: in the spirit of \TeX{}, we hope for free software; in
the spirit of today's lawyer-enthralled society, \acro{CTAN}
provides a % ! line break
- \href{http://mirrors.ctan.org/help/Catalogue/licenses.html}{list of ``standard'' licence statements}.
+ \href{http://mirror.ctan.org/help/Catalogue/licenses.html}{list of ``standard'' licence statements}.
Make sure that there's a formal statement of the licence of your
package, somewhere in the files you upload; beyond the \acro{CTAN}
installation, your package is a candidate for inclusion in \AllTeX{}
@@ -177,41 +150,40 @@ start, here's a check-list of things to sort out:
it's clear that names such as \File{mypackage} or \File{jiffy}
aren't suitable.
\end{enumerate}
-
-If you are able to use anonymous \ProgName{ftp}, you can upload that
-way. The file \File{README.uploads} on \acro{CTAN} tells you
-where to upload, what to upload, and how to notify the \acro{CTAN}
-management about what you want doing with your upload.
-
-You may also upload via the Web: each of the principal \acro{CTAN}
-sites offers an upload page~--- choose from
-% \URL{http://www.ctan.org/upload.html},
-\URL{http://www.dante.de/CTAN/upload.html} or
-\URL{http://www.tex.ac.uk/upload.html}; the pages lead you through the
-process, showing you the information you need to supply. This method
-enforces one file per upload: if you had intended to upload lots of
-files, you need to bundle them into an `archive' file of some sort;
-acceptable formats are \extension{zip} and \extension{tar.gz} (or
-\extension{tar.bz2}). Most uploads are packed in \extension{zip}
-format.
-
-If you can use neither of these methods, or if you find something
-confusing, ask advice of the
+You upload via the
\begin{flatversion}
- \acro{CTAN} management (\mailto{ctan@dante.de}).
+ CTAN upload redirector: \URL{http://www.ctan.org/upload}
\end{flatversion}
\begin{hyperversion}
- \href{mailto:ctan@dante.de}{\acro{CTAN} management}
+ \href{http://www.ctan.org/upload}{CTAN upload redirector}
\end{hyperversion}
-
+(the archive's main page has a link). The upload page shows what it
+needs to know, and allows you to enter the information. The mechanism
+can only accept one file per upload: if you had intended to upload
+lots of files, you need to bundle them into an `archive' file of some
+sort; acceptable formats are \extension{zip} and \extension{tar.gz}
+(most uploads are packed in \extension{zip} format). Once you have
+completed your upload, the redirector assigns it to a member of the
+team for processing.
+
+If you can't use this method, or if you find something confusing, ask
+advice of the
+\begin{flatversion}
+ \acro{CTAN} management team (\mailto{ctan@dante.de}).
+\end{flatversion}
+\begin{hyperversion}
+ \href{mailto:ctan@dante.de}{\acro{CTAN} management team}
+\end{hyperversion}
+
If your package is large, or regularly updated, it may be appropriate
-to \ProgName{mirror} your contribution direct into \acro{CTAN}.
-Mirroring is only practical using \texttt{ftp} or \texttt{rsync}
-protocols, so this facility is limited to those who can establish
-their own server for one of those protocols.
+to `mirror' your contribution direct into \acro{CTAN}.
+Mirroring is only practical using \texttt{ftp} or \texttt{rsync}, so
+this facility is limited to packages offered by a server that uses one
+of those protocols.
\begin{ctanrefs}
\item[README.uploads]\CTANref{CTAN-uploads}
\end{ctanrefs}
+\LastEdit{2013-01-31}
\Question[Q-findfiles]{Finding \AllTeX{} files}