diff options
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.tex | 110 |
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} |