From b82296f4b89901e7b41f2ea8da56222f72a19aa3 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Wed, 27 Apr 2011 22:42:51 +0000 Subject: doc updates git-svn-id: svn://tug.org/texlive/trunk@22225 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/README | 3 +-- Build/source/libs/README | 31 ++++++++++++++++++++++--------- Build/source/texk/README | 32 ++++++++++++++++---------------- Build/source/utils/README | 31 +++++++++++++------------------ Master/tlpkg/doc/coding-style.txt | 14 ++++++-------- 5 files changed, 58 insertions(+), 53 deletions(-) diff --git a/Build/source/README b/Build/source/README index 8440069f6a5..628c49cf0aa 100644 --- a/Build/source/README +++ b/Build/source/README @@ -1,6 +1,5 @@ $Id$ -Copyright 2004, 2006, 2007, 2008, 2009 TeX Users Group. -You may freely use, modify and/or distribute this file. +Public domain. Originally written 2005 by Karl Berry. For a high-level overview of building TeX Live, see http://tug.org/texlive/build.html. diff --git a/Build/source/libs/README b/Build/source/libs/README index 2d571b2ba08..e7182ea443d 100644 --- a/Build/source/libs/README +++ b/Build/source/libs/README @@ -11,29 +11,42 @@ See also comments in ../texk/README. freetype 1.5 - ? -freetype2 2.4.4 - http://savannah.nongnu.org/download/freetype/ +freetype2 2.4.4 - checked 25apr11 + http://savannah.nongnu.org/download/freetype/ -gd 2.0.35 - http://www.libgd.org/releases/ +gd 2.0.35 - unchecked 25apr11, site down + http://www.libgd.org/releases/ + http://www.boutell.com/gd/ + https://bitbucket.org/pierrejoye/gd-libgd/overview -graphite 2.3.1 - the directory silgraphite-2.3.1/engine/ from - http://sourceforge.net/projects/silgraphite/ +graphite 2.3.1 - checked 25apr11 + the directory silgraphite-2.3.1/engine/ from + http://sourceforge.net/projects/silgraphite/files/silgraphite/ icu 4.6 - http://download.icu-project.org/files/icu4c/ with modifications required for xetex, also used by bibtexu -libpng 1.5.2 - http://www.libpng.org/ - used by many +libpng 1.5.2 - checked 25apr11 + http://www.libpng.org/ - used by many + http://www.libpng.org/pub/png/pngcode.html obsdcompat - used by pdftex and luatex poppler 0.12.4 - http://poppler.freedesktop.org/ - used by luatex -t1lib 5.1.2 - ftp://sunsite.unc.edu/pub/Linux/libs/graphics/ +t1lib 5.1.2 - checked 25apr11 + (apparently unmaintained) + ftp://sunsite.unc.edu/pub/Linux/libs/graphics/ -teckit 2.5.1 - http://scripts.sil.org/svn-view/teckit/ +teckit 2.5.1 - checked 25apr11 + http://scripts.sil.org/svn-view/teckit/ xpdf 3.02pl4 - http://www.foolabs.com/xpdf/ with modifications for pdftex and xetex -zlib 1.2.5 - http://www.zlib.net/ - used by many +zlib 1.2.5 - checked 25apr11 + http://www.zlib.net/ - used by many + http://www.libpng.org/pub/png/pngcode.html -zziplib 0.13.60 - http://zziplib.sourceforge.net/ - used by luatex +zziplib 0.13.60 - checked 25apr11 + http://zziplib.sourceforge.net/ - used by luatex diff --git a/Build/source/texk/README b/Build/source/texk/README index 01f0a024ed9..731334b1f09 100644 --- a/Build/source/texk/README +++ b/Build/source/texk/README @@ -1,5 +1,5 @@ $Id$ -Copyright 2006, 2007, 2008, 2009, 2010 TeX Users Group. +Copyright 2006, 2007, 2008, 2009, 2010, 2011 TeX Users Group. You may freely use, modify and/or distribute this file. This TeX Live directory contains the programs that use the kpathsea @@ -30,14 +30,14 @@ bibtexu - ? cjkutils 4.8.2 - checked 18dec10 http://cjk.ffii.org/cjk-4.8.2.tar.gz -detex 2.8 - checked 21may10 +detex 2.8 - checked 25apr11 http://www.cs.purdue.edu/homes/trinkle/detex/ devnag - from devnag package installed in texmf-dist. dtl - ? -dvi2tty 5.3.4 - checked 13nov10 +dvi2tty 5.3.4 - checked 25apr11 http://www.mesa.nl/pub/dvi2tty/ ftp://ftp.mesa.nl/pub/dvi2tty/ @@ -45,30 +45,30 @@ dvidvi - ? dviljk - maintained here, by Joachim Schrod -dvipdfmx - checked 9mar11 +dvipdfmx - checked 25apr11, need 0311 http://project.ktug.or.kr/dvipdfmx/snapshot/latest/ - http://project.ktug.or.kr/dvipdfmx/snapshot/latest/dvipdfmx-20110309.tar.gz + http://project.ktug.or.kr/dvipdfmx/snapshot/latest/dvipdfmx-20110311.tar.gz dvipdfmx@project.ktug.or.kr (ChoF, Matthias, Hirata) -dvipng 1.14 - checked 15dec10 - http://www.ctan.org/tex-archive/dviware/dvipng/ (but maybe stale) +dvipng 1.14 - checked 25apr11 + http://mirror.ctan.org/dviware/dvipng/ (but maybe stale) http://savannah.nongnu.org/files/?group=dvipng dvipos - ? dvipsk - maintained here by Tom Rokicki, Karl Berry, Akira Kakuto, ... -dvisvgm - checked 4mar11 - http://downloads.sourceforge.net/dvisvgm/dvisvgm-1.0.5.tar.gz +dvisvgm - checked 25apr11, need 1.06 + http://sourceforge.net/projects/dvisvgm/files/dvisvgm/ gsftopk - from Paul Vojta's xdvi? -kpathsea - maintained here by Karl Berry, Akira Kakuto, ... +kpathsea - maintained here by Karl Berry, et al. -lacheck - checked 10dec10 +lacheck - checked 25apr11 http://mirror.ctan.org/support/lacheck/lacheck-1.26.tar.gz -lcdf-typetools - checked 9mar11 +lcdf-typetools 2.88 - checked 25apr11 http://www.lcdf.org/type/ http://www.lcdf.org/type/lcdf-typetools-2.88.tar.bz2 @@ -78,8 +78,8 @@ ps2pkm - ? seetexk - ? -tex4htk - http://www.cse.ohio-state.edu/~gurari/TeX4ht/ +tex4htk - checked 25apr11 + http://tug.org/tex4ht/ texlive - maintained here, scripts @@ -87,13 +87,13 @@ ttf2pk - maintained here, by us ttfdump - ? -web2c - maintained here by Karl Berry et al. - core web2c, plain tex, omega. +web2c - maintained here by Karl Berry et al. - core web2c, plain tex, etc. The TeX variant dirs (pdftexdir, xetexdir, etc.) updated here by their respective maintainers. xdv2pdf - Jonathan Kew -xdvik 22.84.16 - checked 18may09 +xdvik 22.84.16 - checked 25apr11 ftp://tug.org/tex/ xdvipdfmx - Jonathan Kew diff --git a/Build/source/utils/README b/Build/source/utils/README index 0fe3c59b56a..899e1411c17 100644 --- a/Build/source/utils/README +++ b/Build/source/utils/README @@ -9,40 +9,35 @@ asymptote 2.02 - checked 12jul10 see http://tug.org/texlive/build.html#asymptote and tlpkg/bin/tl-update-asy -chktex 1.6.4 - checked 3may10 +chktex 1.6.4 - checked 25apr11 http://baruch.ev-en.org/proj/chktex/chktex-1.6.4.tar.gz -dialog 1.1-20110302 - checked 2mar11 +dialog 1.1-20110302 - checked 25apr11 ftp://invisible-island.net/dialog/dialog.tar.gz -ps2eps 1.68 - checked 15dec10 +ps2eps 1.68 - checked 25apr11 http://tm.uka.de/~bless/ps2eps -psutils p17 - checked 25nov06 +psutils p17 - checked 25apr11 http://www.tardis.ed.ac.uk/~ajcd/psutils/index.html - -> http://www.ctan.org/support/psutils/ + -> http://mirror.ctan.org/support/psutils/ https://savannah.nongnu.org/bugs/?30782 -> http://www.connochaetos.org/misc/psutils-libre-1.17.tar.gz (Fabrice made small modifications for Windows, it seems) -t1utils 1.36 - checked 7jun10 +t1utils 1.36 - checked 25apr11 http://www.lcdf.org/type/ -tpic2pdftex 1.97 - checked 9may10 - http://www.ctan.org/graphics/tpic2pdftex +tpic2pdftex 1.97 - checked 25apr11 + http://mirror.ctan.org/graphics/tpic2pdftex/ -vlna 1.2 - checked 26jun08 - ftp://math.feld.cvut.cz/pub/olsak/vlna +vlna 1.2 - checked 25apr11, need 1.5 + ftp://math.feld.cvut.cz/pub/olsak/vlna/ -xindy 2.4 - checked 11may10 - http://www.ctan.org/indexing/xindy/ - -After building clisp as described below, run the TL - Build --enable-xindy CLISP=$clisp_builddir/clisp -to include xindy in the build. It is disabled by default. +xindy - see just below -xpdfopen 0.80 - checked 5may10 - http://mirror.ctan.org/support/xpdfopen.zip +xpdfopen 0.80 - checked 25apr11 + http://mirror.ctan.org/support/xpdfopen/ xindy 2.4 - checked 13may10 diff --git a/Master/tlpkg/doc/coding-style.txt b/Master/tlpkg/doc/coding-style.txt index 6a98ecc77a8..e2637edfde8 100644 --- a/Master/tlpkg/doc/coding-style.txt +++ b/Master/tlpkg/doc/coding-style.txt @@ -13,8 +13,7 @@ our variables, etc., and then: exit (&main ()); -sub main -{ +sub main { ... return 0; } @@ -34,22 +33,21 @@ the regex includes a /, use ",". When it includes both "/" and ",", use "!". top-down rather than bottom-up. So main would come first. -* Indent by two spaces and put the function-opening { in column 1 (as above), +* Normal indentation is two spaces per level. Put a space between arguments of function calls. Karl puts a space before the ( of function calls but no one else does :). * Handle subroutine arguments like this: -sub foo -{ +sub foo { my ($arg1,$arg2,@rest) = @_; ... } Use this in preference to `shift' even when there is only one argument. It takes up only one line, which is good. And if the number of -arguments to the function changes, text changes are minimized. +arguments to the function later changes, text changes are minimized. * It looks strange to write hash keys as if they were keywords (although @@ -92,7 +90,7 @@ In contrast, EXPORT_OK should list all the "public" symbols (but not private ones) of a module. It is good to list them in the same order as they are defined in the file, since that both makes it obvious where a new symbol should be added, and provides a sort of check that all and -onyl the right symbols are there. The EXPORT symbols need not and +only the right symbols are there. The EXPORT symbols need not and should not be listed again in EXPORT_OK. Then, use TeXLive::SomeModule; @@ -111,7 +109,7 @@ brains tend to think of as "local". If you want to import every single EXPORT_OK symbol, use TeXLive::SomeModule (/./); should do it (I've never actually tried it). This is certainly far -better than explicitly listing every symbol yet again. +better than explicitly listing every symbol again. Documentation: http://search.cpan.org/~ferreira/Exporter-5.63/lib/Exporter.pm -- cgit v1.2.3