From b53103d1ed32baf22565a9f6b9f2f1f415ed2288 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 11 Jun 2009 00:19:40 +0000 Subject: faq 3.19 (10jun09) git-svn-id: svn://tug.org/texlive/trunk@13704 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/FAQ-en/CHANGES-3.19 | 67 + Master/texmf-dist/doc/generic/FAQ-en/ChangeLog | 773 +++++- Master/texmf-dist/doc/generic/FAQ-en/archive.list | 4 - Master/texmf-dist/doc/generic/FAQ-en/dirctan.tex | 137 +- Master/texmf-dist/doc/generic/FAQ-en/faq.sty | 30 +- Master/texmf-dist/doc/generic/FAQ-en/faqbody.tex | 2466 ++++++++++++++------ Master/texmf-dist/doc/generic/FAQ-en/filectan.tex | 12 +- .../doc/generic/FAQ-en/html/FAQ-2colfloat.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-2colfltorder.html | 4 +- .../generic/FAQ-en/html/FAQ-2letterfontcmd.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-AMSpkg.html | 15 +- .../doc/generic/FAQ-en/html/FAQ-BibTeXing.html | 8 +- .../texmf-dist/doc/generic/FAQ-en/html/FAQ-CD.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-ECfonts.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-HPdrivers.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html | 13 +- .../doc/generic/FAQ-en/html/FAQ-LaTeX3.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-LaTeXtoPlain.html | 4 +- .../texmf-dist/doc/generic/FAQ-en/html/FAQ-MP.html | 3 +- .../doc/generic/FAQ-en/html/FAQ-PSpreview.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-RCS.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-SGML2TeX.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-TeXfuture.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-TeXsystems.html | 83 +- .../doc/generic/FAQ-en/html/FAQ-WYGexpts.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-abspos.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-acroantics.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-acrobat.html | 27 +- .../doc/generic/FAQ-en/html/FAQ-activechars.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-addtoreset.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-algorithms.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-alreadydef.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-altabcr.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-ant.html | 15 +- .../doc/generic/FAQ-en/html/FAQ-appendix.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-archives.html | 9 +- .../doc/generic/FAQ-en/html/FAQ-askquestion.html | 6 + .../doc/generic/FAQ-en/html/FAQ-atsigns.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-backref.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-balance.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-bibinline.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-biblatex.html | 24 +- .../doc/generic/FAQ-en/html/FAQ-bibplain.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-bibstrtl.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-bibtocorder.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-bold-extras.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-boldgreek.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-books.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-braket.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-breakbox.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-breaklinks.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-buffovl.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-buildbib.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-cancellation.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-captsty.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-casechange.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-changebars.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-changemargin.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-chapbib.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-chngmargonfly.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-citeURL.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-citesort.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-cmdstar.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-codelist.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-commercial.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-compactbib.html | 11 +- .../doc/generic/FAQ-en/html/FAQ-complist.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-concrete.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-conditional.html | 26 +- .../doc/generic/FAQ-en/html/FAQ-context.html | 5 +- .../doc/generic/FAQ-en/html/FAQ-crop.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-custbib.html | 4 +- .../texmf-dist/doc/generic/FAQ-en/html/FAQ-cv.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-dec_comma.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-destable.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-divzero.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-doc-wiki.html | 15 +- .../doc/generic/FAQ-en/html/FAQ-docotherdir.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-docpictex.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-dpfloat.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-drawFeyn.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-drawing.html | 45 +- .../doc/generic/FAQ-en/html/FAQ-dropping.html | 30 +- .../doc/generic/FAQ-en/html/FAQ-dtx.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-dvi-bmp.html | 11 +- .../doc/generic/FAQ-en/html/FAQ-dvi.html | 2 +- .../generic/FAQ-en/html/FAQ-dvipdfmgraphics.html | 25 +- .../doc/generic/FAQ-en/html/FAQ-dvips-pdf.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-dvips.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-dvipsgraphics.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-editors.html | 43 +- .../doc/generic/FAQ-en/html/FAQ-empty.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-endingroup.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-enumerate.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-epigraph.html | 35 +- .../doc/generic/FAQ-en/html/FAQ-eplain.html | 15 +- .../doc/generic/FAQ-en/html/FAQ-eps.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-eqnarray.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-erroradvice.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-euro.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-extref.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-extsizes.html | 9 +- .../doc/generic/FAQ-en/html/FAQ-fancyhdr.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-fig.html | 21 - .../doc/generic/FAQ-en/html/FAQ-figetc.html | 28 + .../doc/generic/FAQ-en/html/FAQ-figurehere.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-filename.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-filesused.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-findfiles.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-findfont.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-fixwidtab.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-floats.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-flushboth.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-fmtconv.html | 28 +- .../doc/generic/FAQ-en/html/FAQ-fontname.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-fonts-pln.html | 22 +- .../doc/generic/FAQ-en/html/FAQ-fontsize.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-fontunavail.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-footintab.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-footnpp.html | 23 +- .../doc/generic/FAQ-en/html/FAQ-formbiblabel.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-ftncapt.html | 25 +- .../doc/generic/FAQ-en/html/FAQ-ftnsect.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-getbitmap.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-gethelp.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-graphicspath.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-grffilenames.html | 50 + .../doc/generic/FAQ-en/html/FAQ-howmanypp.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-htmlbib.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-hyphen.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-hyphoff.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-i18nbib.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-ifpdf.html | 30 +- .../doc/generic/FAQ-en/html/FAQ-impgraph.html | 26 +- .../doc/generic/FAQ-en/html/FAQ-inclplain.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-inst-tds-zip.html | 13 +- .../doc/generic/FAQ-en/html/FAQ-inst1cm.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-install-find.html | 5 +- .../generic/FAQ-en/html/FAQ-instprinterfont.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-instt1font.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-interruptlist.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-isitanum.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-journalpaper.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-keyval.html | 157 ++ .../doc/generic/FAQ-en/html/FAQ-labelfig.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-labelformat.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-labundef.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-landscape.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-latex2e.html | 15 +- .../generic/FAQ-en/html/FAQ-latexpronounce.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-latexqual.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-letterclass.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-letterspace.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-linenos.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-linespace.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-linespread.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-linmacnames.html | 147 ++ .../doc/generic/FAQ-en/html/FAQ-lit.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-logos.html | 32 +- .../doc/generic/FAQ-en/html/FAQ-lollipop.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-longtab.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-ltxcmds.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-luatex.html | 44 +- .../doc/generic/FAQ-en/html/FAQ-make.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-makebib.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-makeindex.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-man-latex.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-man-tex.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-manymathalph.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-marginparside.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-marginpkgs.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-matchbrak.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-mathlips.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-mathml.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-mathonlyref.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-mathsize.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-mathstext.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-mcfloat.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-mcite.html | 33 +- .../doc/generic/FAQ-en/html/FAQ-metrics.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-mfptutorials.html | 7 +- .../doc/generic/FAQ-en/html/FAQ-minitoc.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-misssymb.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-moren9.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-mpprologues.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-msxy.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-multbib.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-multfoot.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-multidoc.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-multind.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-multirow.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-music.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-nameref.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-newans.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-newfunction.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-newlang.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nocitestar.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nofm.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nohyph.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-noline.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nonfree.html | 44 +- .../doc/generic/FAQ-en/html/FAQ-nonpdfsp.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nonum.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-nopagebrk.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-nopageno.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-noroom.html | 43 +- .../doc/generic/FAQ-en/html/FAQ-numbersets.html | 72 +- .../doc/generic/FAQ-en/html/FAQ-oddhyphen.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-oddpage.html | 13 +- .../doc/generic/FAQ-en/html/FAQ-ol-books.html | 11 +- .../doc/generic/FAQ-en/html/FAQ-omegaleph.html | 29 +- .../doc/generic/FAQ-en/html/FAQ-onecolabs.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-osf.html | 58 + .../doc/generic/FAQ-en/html/FAQ-otherprinters.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-outszwrng.html | 30 - .../doc/generic/FAQ-en/html/FAQ-overfull.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-overstrike.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-pagebychap.html | 3 +- .../doc/generic/FAQ-en/html/FAQ-papergeom.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-papersize.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-parallel.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-parskip.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-patch.html | 19 +- .../doc/generic/FAQ-en/html/FAQ-pdf-fig-chars.html | 41 + .../doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html | 2 +- .../generic/FAQ-en/html/FAQ-pdftexgraphics.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-pkfix.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-pkgdoc.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-plainvltx.html | 9 +- .../doc/generic/FAQ-en/html/FAQ-poster.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-previewers.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-proof.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-protect.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-psatempty.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-psfchoice.html | 49 +- .../doc/generic/FAQ-en/html/FAQ-ragright.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-readML.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-readtex.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-reallyblank.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-recovertex.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-ref-doc.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-repeatgrf.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-repfootnote.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-replstdcls.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-rerun.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-resolns.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-reuseq.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-rulethk.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-run-fn-nos.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-runheadtoobig.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-running-nos.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-scriptfonts.html | 26 +- .../doc/generic/FAQ-en/html/FAQ-seccntfmt.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-secindent.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-secnumdep.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-secthead.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-setURL.html | 21 +- .../doc/generic/FAQ-en/html/FAQ-slashbox.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-slidecls.html | 26 +- .../doc/generic/FAQ-en/html/FAQ-spell.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-splitfoot.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-srchpdf.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-struttab.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-subsubsub.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-symbols.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-tabacc.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-tabcellalign.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-tds-zip.html | 15 +- .../doc/generic/FAQ-en/html/FAQ-tds.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-texcad.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-texinfo.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-texorpdf.html | 45 + .../doc/generic/FAQ-en/html/FAQ-textflow.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-texthings.html | 169 ++ .../doc/generic/FAQ-en/html/FAQ-textrace.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-theoremfmt.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-thesis.html | 14 +- .../doc/generic/FAQ-en/html/FAQ-time.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-titlsty.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-tmupfl.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-toascii.html | 16 +- .../doc/generic/FAQ-en/html/FAQ-tocbibind.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-tocloft.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-tradesyms.html | 3 +- .../doc/generic/FAQ-en/html/FAQ-tutbitslatex.html | 13 +- .../doc/generic/FAQ-en/html/FAQ-twooptarg.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-type1T1.html | 18 +- .../doc/generic/FAQ-en/html/FAQ-typo-style.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-underline.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-underscore.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-unkgrfextn.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-uploads.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-upquot.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-useMF.html | 129 +- .../doc/generic/FAQ-en/html/FAQ-uselmfonts.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-usepictex.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-usepsfont.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-usesymb.html | 40 + .../doc/generic/FAQ-en/html/FAQ-varwidcol.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-varwidth.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-verbfile.html | 10 +- .../doc/generic/FAQ-en/html/FAQ-verbwithin.html | 29 +- .../doc/generic/FAQ-en/html/FAQ-virtualfonts.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-watermark.html | 12 +- .../doc/generic/FAQ-en/html/FAQ-webpkgs.html | 22 +- .../doc/generic/FAQ-en/html/FAQ-weirdhyphen.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-what-TDS.html | 8 +- .../doc/generic/FAQ-en/html/FAQ-whatTeX.html | 6 +- .../doc/generic/FAQ-en/html/FAQ-whatbst.html | 2 +- .../doc/generic/FAQ-en/html/FAQ-whatmacros.html | 65 + .../doc/generic/FAQ-en/html/FAQ-whatpdftex.html | 11 +- .../doc/generic/FAQ-en/html/FAQ-whereFAQ.html | 19 +- .../doc/generic/FAQ-en/html/FAQ-wholerow.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-widefigs.html | 4 +- .../doc/generic/FAQ-en/html/FAQ-wideflt.html | 30 + .../doc/generic/FAQ-en/html/FAQ-wordcount.html | 19 +- .../doc/generic/FAQ-en/html/FAQ-writecls.html | 20 +- .../doc/generic/FAQ-en/html/FAQ-xetex.html | 33 +- .../doc/generic/FAQ-en/html/FAQ-xspace.html | 2 +- .../texmf-dist/doc/generic/FAQ-en/html/index.html | 124 +- Master/texmf-dist/doc/generic/FAQ-en/letterfaq.pdf | Bin 2833151 -> 3630335 bytes Master/texmf-dist/doc/generic/FAQ-en/newfaq.pdf | Bin 2721186 -> 3539943 bytes 322 files changed, 5293 insertions(+), 2207 deletions(-) create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/CHANGES-3.19 delete mode 100644 Master/texmf-dist/doc/generic/FAQ-en/archive.list delete mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fig.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figetc.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-grffilenames.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-keyval.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linmacnames.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-osf.html delete mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-outszwrng.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdf-fig-chars.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texorpdf.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texthings.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-usesymb.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-whatmacros.html create mode 100644 Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-wideflt.html (limited to 'Master/texmf-dist/doc/generic/FAQ-en') diff --git a/Master/texmf-dist/doc/generic/FAQ-en/CHANGES-3.19 b/Master/texmf-dist/doc/generic/FAQ-en/CHANGES-3.19 new file mode 100644 index 00000000000..1e429919a29 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/CHANGES-3.19 @@ -0,0 +1,67 @@ +Changes in version 3.19 + +This file lists changes since its most recent release (with version 3.18 +of the FAQ). + +New answers: + +Label grffilenames: "modern" file names in graphics + +Label keyval: using key-value input in macros and package + +Label linmacnames: why non-letters in macro names are a bad idea + +Label osf: using fonts with "old-style" numbers + +Label pdf-fig-chars: disappearing glyphs in pdfTeX figures (from Thanh) + +Label texorpdf: error "not allowed in PDFDocEncoded string" + +Label texthings: what all these TeX names are + +Label usesymb: using symbols + +Label whatmacros:brief outline of macros for "bits and pieces" section + +Label wideflt: centre a float wider than text area + +Relabelled answers: + +Label xfigetc: discusses xfig and asymptote (so far) (was label xfig) + +Revised answers: + +Label askquestion: what to do if your minimal example needs a figure + +Label acroantics:content of old label outszwrng merged in + +Label biblatex: updated, now also mentions biber + +Label books: mention Lulu version of TeX by Topic + +Label chngmargonfly: mention addlines package + +Label compactbib:mention the compactbib package (surprise!) + +Label drawing: describe pictex, epic and eepic (all previously skated over) + +Label editors: mention texworks + +Label figurehere:mention \MakeSorted from perpage package + +Label fonts-pln: mention varisize + +Label footnpp: mention zref package perpage module + +Label ftncapt: clarification (I hope) + +Label latex2html:mention plastex + +Label latexe: reworked for clarity + +Label latexpronounce: following on from latexe + +Label linenos: numline package now obsolete + +Label luatex: tidied up, now I'm clearer about LuaTeX, myself + +Label logos: clarified, in light of changes to printing layout we now use + +Label man-latex: added pointer to first-latex-doc + +Label marginpkgs:changepage package supplants chngpage + +Label mcite: mention mciteplus and collref packages + +Label nonfree: explain what went wrong and what is happening + +Label ifpdf: mention ifxetex and ifluatex + +Label noroom: tidied up e-TeX related part of answer + +Label ref-doc: mention latexcheat + +Label setURL: mention spaces and hyphens options of url.sty + +Label texsystems:mention MikTeX-for-Linux + +Label wordcount: mention TeXcount + +Label writecls: mention Oberdiek's splendid source2e pdf file + +Label wygexpts: preview-latex now part of auctex + +Deleted answers: + +Label outszwrng +(remember, as of the previous release, links to "old" labels remain +valid, pointing to an answer that is as near relevant as possible) + +Web interface: + The initial list of questions no longer gives a URL containing all + the answers -- Google was returning that for every match, which + didn't help! + All links to CTAN files, directory .zips and directories for + browsing are now http, and there's no longer any mention of .tar.gz + archives of CTAN directories (since they're no longer available) + +Robin Fairbairns +2009-06-10 diff --git a/Master/texmf-dist/doc/generic/FAQ-en/ChangeLog b/Master/texmf-dist/doc/generic/FAQ-en/ChangeLog index 8d4f3747781..3c437317f15 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/ChangeLog +++ b/Master/texmf-dist/doc/generic/FAQ-en/ChangeLog @@ -1,9 +1,780 @@ +2009-06-10 Robin Fairbairns + + * CHANGES-3.19: final released version + + * faqbody.tex: today's date + + * Makefile.CTAN (CHANGES): muck about with installation of new file + + * locations.mk: add HTMLDIREL, define HTMLDIR in relation to it + + * Makefile (release): new target, generate pdfs and html tar file + +2009-06-09 Robin Fairbairns + + * dirctan.tex: add collref; bring macros/blu, systems/msdos/e4t, + support/et, support/jpeg2ps, macros/scripttex from nonfree; junk + oztex-german (now obsolete), patches (nonsense) + + * faqbody.tex (section{References from articles}): rearrange q-mcite a + bit, and add collref to it + +2009-06-09 Robin Fairbairns + + * Makefile.CTAN: don't do .ps files any longer + + * Makefile: don't generate .ps files in "all", just pdf + + * sanitize.pl: up to date with -beta changes + + * texfaq2html: up to date with -beta changes + + * texfaq2html-beta: removed debugging statements (already commented) + +2009-06-08 Robin Fairbairns + + * faqbody.tex (section{Background}): micro-editorial in q-latexpron... + +2009-06-07 Robin Fairbairns + + * faqbody.tex (section{Background}): untangle logos in re. q-latexe, + and modify q-latexpronounce accordingly + (subsection{Odds and ends}): adjust q-logos to cope with non-bumpy text + such as we now use + + * faq.sty: add \latexe + +2009-06-03 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): new + q-linmacname from add-general + +2009-05-29 Robin Fairbairns + + * add-general.tex (subsection{"Generic" macros and techniques}): change + name of q-macronames to q-linmacnames, yet more editorial + + * faqbody.tex (section{Format conversions}): editorial in q-recovertex + (section{The joy of TeX errors}): new q-texorpdf from add-general + +2009-05-29 Robin Fairbairns + + * add-general.tex (subsection{"Generic" macros and techniques}): a bit + of editorial on q-macronames + +2009-05-28 Robin Fairbairns + + * sanitize-beta.pl (sanitize_line): translate \c{c} + + * faqbody.tex (section{Current TeX-related projects}): revised q-xetex + from francois charette + (intro): add francois to list of acknowledgements + (first line): today's date + +2009-05-27 Robin Fairbairns + + * faqbody.tex (section{Graphics}): minor editorial on q-drawing + + * dirctan.tex: add epic + + * faqbody.tex (section{Graphics}): add brief descriptions of pictex, + epic and eepic[emu] to q-drawing + +2009-05-25 Robin Fairbairns + + * dirctan.tex: add first-latex-doc + + * faqbody.tex: today's date + (section{Documentation and Help}): mention first-latex-doc in + q-man-latex + +2009-05-20 Robin Fairbairns + + * faqbody.tex (section{Symbols, etc.}): new q-osf from add-general + + * add-general.tex (subsection{"Generic" macros and techniques}): refer + to q-whatmacros rather than spelling out the rules, in q-macronames + +2009-05-19 Robin Fairbairns + + * faqbody.tex (section{TeX Systems}): update link for textures in + q-commercial + (various places): minor editorial work + + * add-general.tex (subsection{Odds and ends}): editorial on q-osf + + * faqbody.tex (section{Support Packages for TeX}): correct \href for + texcount,in q-wordcount + + * dirctan.tex: add asymptote + + * faqbody.tex (section{Support Packages for TeX}): retitle q-xfig as + q-figetc, and mention asymptote in it (now it's on ctan!) + +2009-05-18 Robin Fairbairns + + * faqbody.tex (section{Graphics}): q-grffilenames from add-general + + * add-general.tex (subsection{Graphics}): tidy q-grffilenames, correct + previous text about knuthian constraints on input file name format + + * faqbody.tex (section{Bits and pieces of (La)TeX}): moved q-whatmacros + from add-general *already* + (subsection{Floating tables, figures, etc.}): q-wideflt from + add-general, too!! + + * add-general.tex (subsection{Bits and pieces of (La)TeX}): new "what + are macros" (q-whatmacros) + (subsection{Tables, figures and diagrams}): new "wide figures and + tables" (q-wideflt) + (subsection{Odds and ends}): editorial on q-osf + +2009-05-16 Robin Fairbairns + + * filectan.tex: add miktex-portable + + * faqbody.tex (section{TeX Systems}): mention miktex-portable in + q-texsystems + +2009-05-14 Robin Fairbairns + + * faq.sty: tidy include/exclude comments; make introduction into a real + env + + * faqbody.tex (intro): simplify \nothtml code in introduction env + +2009-05-13 Robin Fairbairns + + * faqbody.tex (intro): v3.19, today + +2009-05-12 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): yet more + editorial on q-keyval + + * sanitize-beta.pl (sanitize_line): translate \par{} as
+ +2009-05-10 Robin Fairbairns + + * add-general.tex (subsection{"Generic" macros and techniques}): yet + another diddle of q-macronames ... just can't quite satisfy myself + about this thing + +2009-05-08 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): list macro + names for class/package options in xkeyval + +2009-05-07 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): mention + ifxetex and ifluatex in q-ifpdf + + * add-general.tex (subsection{"Generic" macros and techniques}): yet + more diddling with q-macronames + (subsection{\LaTeX{} macro tools and techniques}): wrap a terrible wide + line in an example in q-keyval + + * dirctan.tex: add texcount + + * faqbody.tex (section{Support Packages for TeX}): add ctan links for + (la)texcount and description of texcount in q-wordcount + +2009-05-03 Robin Fairbairns + + * add-general.tex (subsection{"Generic" macros and techniques}): minor + update of q-macronames on internal macros and why they work + +2009-05-02 Robin Fairbairns + + * dirctan.tex: psfig back on main tree; xypic link as catalogue, now; + xfig, xdvi and usergrps now browse-only; + remove arc521, arj, atob, binhex, boo, bsplit, checksum, comm, compact, + compress, filehdr, ftpd, ftpmail, hexbin, lharc, machdr, macunpack, + macutils, mcvert, mirror, mixed, parc, stuffit, tar, tex88, tex8fmts, + transname, unarj, unpack, unstuff, uue, uuencode, vtree, vtree-fix, + vvcode, xbin (tools/*); + remove two borceux subdirs -- diagram, user-guides + + * add-general.tex (subsection{LaTeX macro tools and techniques}): add + final(?) paragraphs of q-keyval + +2009-05-01 Robin Fairbairns + + * add-general.tex (subsection{LaTeX macro tools and techniques}): add + pgfkeys to q-keyval, and make a start on scrbase + + * dirctan.tex: add biblatex-contrib + + * faqbody.tex (section{Current TeX-related projects}): update + q-biblatex and mention biber therein + +2009-04-29 Robin Fairbairns + + * faqbody.tex (subsection{Typesetting specialities}): mention setspaces + spaces and hyphens options of url.sty, in q-setURL + + * add-general.tex (subsection{"Generic" macros and techniques}): don't + use |$| in q-catcodes, since it confuses auctex's text colouring -- + \texttt{\$} instead + (subsection{"Generic" macros and techniques}): hack at q-macronames + after staring at it a bit + + * faqbody.tex (subsection{Tables, figures and diagrams}): give + \textasciicircum a null argument in q-wholerow + +2009-04-18 Robin Fairbairns + + * add-general.tex (subsection{LaTeX macro tools and techniques}): add + xkeyval to q-keyval + + * faqbody.tex (rogue's gallery): add joseph wright and philipp stephani + in recognition of help on q-keyval answer + +2009-04-17 Robin Fairbairns + + * add-general.tex (subsection{LaTeX macro tools and techniques}): add + kvoptions and kvsetkeys to q-keyval + +2009-04-14 Robin Fairbairns + + * add-general.tex (subsection{LaTeX macro tools and techniques}): more + work on q-keyval + +2009-04-14 Robin Fairbairns + + * add-general.tex (subsection{LaTeX macro tools and techniques}): new + q-keyval + + * faqbody.tex (subsection{Why does it do that?}): editorial on + q-pdf-fig-chars following thanh's comment + +2009-04-13 Robin Fairbairns + + * faqbody.tex (subsection{Common errors}): new q-pdf-fig-chars from + add-general + + * add-general.tex (subsection{Graphics}): flesh out q-grffilenames + +2009-04-12 Robin Fairbairns + + * faqbody.tex (subsection{Page layout}): complete sentence that + previously ended "but" (no full stop!) in q-changemargin + + * add-general.tex (subsection{Why does it do that?}): further editorial + on q-pdf-fig-chars + + * texfaq2html-beta: remove the "complete set" link at bottom of search + + * faqbody.tex (subsection{Adobe Type 1 (PS) fonts}): editorial on cm + bright in T1 (now a bit less pompous, i hope) + +2009-04-12 (small hours) Robin Fairbairns + + * add-general.tex (subsection{Why does it do that?}): new + q-pdf-fig-chars at thanh's request + +2009-04-11 Robin Fairbairns + + * faqbody.tex (section{Current TeX-related projects}): improvements to + q-luatex from manuel pegourie-gonnard + (intro): add mpg to list of names + +2009-04-09 Robin Fairbairns + + * faqbody.tex (section{Documentation and Help}): editorial on + q-mfptutorials + (section{Acquiring the Software}): editorial on q-nonfree + + * dirctan.tex: add latex-tds + + * faqbody.tex (section{Documentation and Help}): mention heiko's + source2e in q-writecls + + * filectan.tex: add latexcheat + + * faqbody.tex (section{Documentation and Help}): add bullet item about + figures in q-askquestion + (section{Documentation and Help}): editorial on q-man-latex, + q-typo-style + (section{Documentation and Help}): correct link for pgf/tikz examples + in q-tutbitslatex + (section{Documentation and Help}): add cheat sheet in q-ref-doc + +2009-04-07 Robin Fairbairns + + * faqbody.tex (paragraph{TeX distributions}): editorial work on + q-texthings, q-plainvltx, q-amspkg, q-eplain, q-texfuture + (section{Documentation and Help}): editorial work on q-wherefaq, + q-gethelp, q-maillists* + +2009-04-04 Robin Fairbairns + + * faqbody.tex (section{Bits and pieces of (La)TeX}): add link to + liang's thesis in q-hyphen + +2009-04-02 Robin Fairbairns + + * faqbody.tex (section{The Background}): add sentence to the end of + first para of q-whattex; hack away at q-whatpdftex + + * dirctan.tex: delete preview-latex & fptex, make auctex browse only + + * faqbody.tex (section{Current TeX-related projects}): preview-latex + now part of auctex, in q-wygexpts + + * dirctan.tex: remove ghostview, move plnfss up one and remove * + + * faqbody.tex (subsection{Finding the Files}): further iteration, + now checked in all 3 formats + (section{Hypertext and PDF}): ghostview now an unprogram in q-acrobat + (subsection{Adobe Type 1 fonts}): replace ghostview with gv + + * Makefile (web,web-beta): correct shell syntax of yesterday's patch(!) + +2009-04-01 Robin Fairbairns + + * faqbody.tex (subsection{Finding the Files}): further iteration + + * Makefile (update web files): deal with case that file doesn't exist + +2009-03-31 Robin Fairbairns + + * faqbody.tex (subsection{Finding the Files}): get rid of a link- + without-visible-anchor in the pdf, generally tidy + +2009-03-27 Robin Fairbairns + + * sanitize-beta.pl (sanitize_line): stupid error in sub of \wideonly + + * texfaq2file: various errors thrown up by -w ... so remove -w + +2009-03-26 Robin Fairbairns + + * sanitize-beta.pl (generate_CTAN_ref): + + * texfaq2file: restore list of protocols and hosts (since they're used) + ... but don't overdo it ... this lot is a mess and needs tidying + + * label-to-file.pl: the list of file names corresponding to q labels + + * texfaq2file+texfaq2html-beta: use label-to-file.pl in place of list + in file + +2009-03-25 Robin Fairbairns + + * filectan.tex: add compactbib + + * faqbody.tex (subsection{Creating citations}): mention compactbib in + q-compactbib (where else? ;-) + +2009-03-21 Robin Fairbairns + + * dirctan.tex: rename bibtex-doc-pdf to bibtex-doc (overwriting old + one) so that link takes you to something readable + + * faqbody.tex: 3.18b, today + (section{Documentation and Help}): make bibtex docs link just + bibtex-doc -- see dirctan change + (subsection{Creating bibliographies}): ditto in q-custbib + +2009-03-20 Robin Fairbairns + + * check-ctan-lists: check status of directory .zip files ... + + * dirctan.tex: bunch of anomalies shown up by latest version of scanner + + * sanitize-beta.pl (generate_CTAN_ref): suppress .tar.gz link + + * texfaq2html-beta: sort lists of matching answers numerically, at last + (initialisation): close CTANFILES and CTANDIR after reading them... + + * faqbody.tex (section{Current TeX-related projects}): more twiddling + with q-xetex + (section{Current TeX-related projects}): ditto q-luatex + (section{Current TeX-related projects}): ditto q-omegaleph (more + downbeat still than previously :-( + (section{Symbols, etc.}): add q-usesymb from add-general + +2009-03-19 Robin Fairbairns + + * add-general.tex (subsection{Symbols, etc.}): add initial body for + q-usesymb + + * faqbody.tex (section{TeX Systems}): mention miktex-for-linux in + q-texsystems + (section{Current TeX-related projects}): more hacking at q-luatex + (section{Current TeX-related projects}): rearrange q-omegaleph, + q-xetex, q-luatex, q-ant, q-extex into that order + +2009-03-18 Robin Fairbairns + + * faqbody.tex (section{Current TeX-related projects}): more fiddling + with latex project answer + (section{Current TeX-related projects}): mimetex now superseded by + mathtex + (section{Current TeX-related projects}): don't compare ant to nts, + since we no longer mention nts ;-) + (section{Current \TeX{}-related projects}): hack at q-luatex + + * dirctan.tex: add keys3, numparse3 + + * faqbody.tex (section{Format conversions}): reword q-fmtconv as + suggested by jose carlos santos + + * dirctan.tex: add yagusylo + + * add-general.tex (subsection{Symbols, etc.}): skeleton q-usesymb + +2009-03-12 Robin Fairbairns + + * faqbody.tex (subsection{Footnotes}): try to clarify text of q-ftncapt + in re. complaint on c.t.t + (section{The joy of TeX errors}): tidy up talk about etex.sty in + q-noroom, and mention \reserveinserts + +2009-03-10 Robin Fairbairns + + * dirctan.tex: add blackboard + + * faqbody.tex (section{Symbols, etc.}): redo q-numbersets, mention + blackboard doc + +2009-03-09 Robin Fairbairns + + * dirctan.tex: add urw-base35, remove plain urw + + * faqbody.tex (section{Symbols, etc.}): redo refs to urw chancery, add + link to URW base35, in q-scriptfonts + +2009-03-07 Robin Fairbairns + + * faqbody.tex (section{Documentation and Help}): tidy wording about tbt + in q-books + +2009-03-06 Robin Fairbairns + + * faqbody.tex (section{TeX Systems}): typo in q-editors + +2009-03-04 Robin Fairbairns + + * faqbody.tex (section{TeX Systems}): slightly less frivolity, in + pursuit of better comprehensibility, among the unix editors + + * sanitize-beta.pl (sanitize_line): translate \texshop{}, \texworks{}; + reorganise the list of "programs" for ease of editing + + * faq.sty: define \texshop, \texworks + + * faqbody.tex (section{TeX Systems}): add a wildcard entry to the list + for texworks, in q-editors + +2009-02-12 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): micro- + typo in q-patch + +2009-02-11 Robin Fairbairns + + * dirctan.tex: add expl3, xpackages + + * faqbody.tex (section{Current TeX-related projects}): update q-latex3 + +2009-02-09 Robin Fairbairns + + * faqbody.tex (section{The Background}): add q-texthings, from + add-general + +2009-01-29 Robin Fairbairns + + * add-general.tex (subsection{The Joy of TeX errors}): add q-texorpdf + +2009-01-22 Robin Fairbairns + + * faqbody.tex (section{Documentation and Help}): revise view of the + wiki books (which seem to have improved a lot) + +2009-01-21 Robin Fairbairns + + * texfaq2html-beta: correct period positioning after previous mod + + * faqbody.tex (subsection{Document structure}): chappg documented + "normally" now in q-pagebychap + (subsection{Document structure}): remove q-outszwrng + (subsection{Document structure}): merge (and condense) list from old + q-outszwrng into q-acroantics + + +2009-01-19 Robin Fairbairns + + * sanitize-beta.pl (sanitize_line): exptl translation for \paragraph + + * faq.sty: redefine \paragraph, too + + * add-general.tex (subsection{"Generic" macros and techniques}): more + minor diddling with q-macronames + (subsection{The Background}): similar for q-texthings + +2009-01-13 Robin Fairbairns + + * faqbody.tex (subsection{Document structure}): rewrite warning about + programming zoonekynd's stuff, in q-secthead + +2009-01-06 Robin Fairbairns + + * dirctan.tex: add revised tth ;-) + + * filectan.tex: remove tth + +2009-01-05 Robin Fairbairns + + * faqbody.tex (subsection{Typesetting specialities}): tidy up following + obsoleting of numline, in q-linenos + + * dirctan.tex: remove rsfs-type1 + + * faqbody.tex (section{Symbols, etc.}): rsfs type 1 now part of base + distribution in q-scriptfonts + + * filectan.tex: numline now in obsolete + +2008-12-31 Robin Fairbairns + + * add-general.tex (subsection{The Background}): editorial on list of + enhanced tex engines + +2008-12-28 Robin Fairbairns + + * add-general.tex (subsection{"Generic" macros and techniques}): add + q-macronames from scott pakin + (subsection{The Background}): add q-texthings from scott pakin + +2008-12-14 Robin Fairbairns + + * faqbody.tex (section{Graphics}): typo in q-graphicspath spotted by + jim diamond + +2008-11-27 Robin Fairbairns + + * faqbody.tex (section{Acquiring the Software}): minor tidy of q-tds-zip + (section{Installing (La)TeX files}): clear up gross \qref error in + q-inst-tds-zip, and tidy up rest of question + +2008-11-26 Robin Fairbairns + + * faqbody.tex (section{TeX Systems}): mention tl network install, tl + and miktex package net update + + * filectan.tex: add texlive-unix, texlive-windows + + * faqbody.tex (section{Current TeX-related projects}): a bit of + rewording of the presumed prospects for omega 2 + +2008-11-26 Robin Fairbairns + + * faqbody.tex ([throughout]): minor edits for untidinesses spotted by + karl berry + +2008-11-07 Robin Fairbairns + + * faqbody.tex (section{Bits and pieces of (La)TeX}): minor ed of q-eps + + * add-general.tex (subsection{Graphics}): added q-grffilenames + (initial stab ... not even complete in itself) + +2008-09-21 Robin Fairbairns + + * texfaq2html: as -beta + + * texfaq2html-beta: add home link at end of answer, after next/prev + links if present + +2008-09-19 Robin Fairbairns + + * faqbody.tex (subsection{Tables, figures and diagrams}): correct + invocation of topcapt package in q-destable + +2008-09-14 Robin Fairbairns + + * faqbody.tex (section{Graphics}): try to refer to dvipdfmx in parallel + in q-dvipdfmgraphics + +2008-09-13 Robin Fairbairns + + * faqbody.tex (section{Documentation and Help}): add ptr to emory + latex2e ref in q-ref-doc + +2008-08-31 Robin Fairbairns + + * Makefile (dist): new target for manual pegouri\'e-gonnard + +2008-08-28 Robin Fairbairns + + * faqbody.tex (section{Documentation and Help}): mention lulu version + of tbt, both in q-ol-books and q-books + +2008-08-22 Robin Fairbairns + + * dirctan.tex: add varisize + + * faqbody.tex (subsection{Macros for using fonts}): mention varisize in + q-fonts-pln + +2008-08-18 Robin Fairbairns + + * faqbody.tex (subsection{Typesetting specialities}): deprecate + dropping, rewrite descr of lettrine appropriately + (subsection{Floating tables, figures, etc.}): mention perpage's + \MakeSorted in q-figurehere + +2008-08-13 Robin Fairbairns + + * add-general.tex (subsection{Generic macros and techniques}): store + a copy of donald a's \moverlay in q-ovwtsym, for future reference + +2008-08-10 Robin Fairbairns + + * dirctan.tex: add addlines + + * faqbody.tex (section{Graphics}): mention eplain as a plain route to + to loading graphics in q-impgraph (per kb's suggestion) + (subsection{Page layout}): mention addlines in q-chngmargonfly + +2008-07-31 Robin Fairbairns + + * sanitize-beta.pl (sanitize_line): add \htmlentity to deal with + q-dropping guillemet problem + + * faqbody.tex (subsection{Typesetting specialities}): use \htmlentity + in \latexhtml (guillemets) in q-dropping + +2008-07-30 Robin Fairbairns + + * faqbody.tex (subsection{Page layout}): remove chngpage from + q-marginpkgs + + * filectan.tex: chngpage->changepage; remove pdftex + + * dirctan.tex: add mciteplus, pdftex, record move of aro-bend + + * faqbody.tex (subsection{Creating citations}): mention mciteplus in + q-mcite + +2008-07-28 Robin Fairbairns + + * texfaq2file: ruthless stamping on problems produces a use full output + +2008-07-28 Robin Fairbairns + + * texfaq2file: more minor adjustments + + * faqbody.tex (section{Introduction}): now a real (unnumbered) section + +2008-07-25 Robin Fairbairns + + * faq.sty: include comment introduction + + * faqbody.tex: put environment introduction around introduction + +2008-07-22 Robin Fairbairns + + * texfaq2html-gamma: minor tidies, use index.html for intro, pro tem + + * faqbody.tex (subsection{Common errors}): editorial in q-verbwithin + +2008-07-21 Robin Fairbairns + + * texfaq2html-gamma: correct repeated-code subroutine from 19th + (print_intro_para, etc): attempt to sort out coherent "whole path" + +2008-07-19 Robin Fairbairns + + * texfaq2html-gamma: some tidying of repeated code, clarification of + logic of the code -- lots more still to do... + +2008-07-14 Robin Fairbairns + + * faqbody.tex (subsection{"Generic" macros and techniques}): discuss + \ifpatchable in the bit about etoolbox in q-patch + (section{Current TeX-related projects}): brief scribble about how lua + operates inside tex, in q-luatex + +2008-07-12 Robin Fairbairns + + * faqbody.tex (subsection{Footnotes}): mention zref/perpage in + q-footnpp + +2008-07-09 Robin Fairbairns + + * faqbody.tex (subsection{MetaFont fonts}): more modernisation of + q-usemf (no longer mentions virmf, for example) + +2008-07-08 Robin Fairbairns + + * texfaq2html-gamma: major upheavals: beginning to show signs of + working in the various parts separately + + * faqbody.tex (subsection{Alternative document classes}): tidy text of + both q-thesis and q-journalpaper + (subsection{MetaFont fonts}): tidy up q-usemf (though whether to keep + it at all remains a matter of debate) + +2008-07-07 Robin Fairbairns + + * dirctan.tex: add plastex + + * faqbody.tex (section{Format conversions}): add plastex to + q-latex2html + +2008-07-02 Robin Fairbairns + + * faqbody.tex (subsection{Alternative document classes}): enumerate the + complete set of memoir document sizes in q-extsizes + +2008-07-02 Robin Fairbairns + + * Makefile: add target inst-perl-gamma (just texfaq2html-gamma) + + * texfaq2html-gamma: add description meta element to start_html + + * texfaq2html-beta: added a description meta element + + * texfaq2html-gamma: comment out setting of $seclevel hash, since it's + not used and therefore logging errors + +2008-07-01 Robin Fairbairns + + * faqbody.tex (section{Current TeX-related projects}): miktex already + has xetex ('cos it's got to 2.7 already) + +2008-06-23 Robin Fairbairns + + * Makefile: delete FAQ-html.tar.gz in "clean" + +2008-06-22 Robin Fairbairns + + * faqbody.tex: today's date + (section{Documentation and Help}): make clear we're talking about latex + packages in re. the comp. list in q-symbols + +2008-06-21 Robin Fairbairns + + * texfaq2file: add inst-miktex* to label_to_file (per mpg); + correct generation of links from index.html (per jonathan k) + + * faqbody.tex: 3.18a, today + (subsection{Lists}): add mention of expdlist in q-interruptlist + + **FAQ-html.tar.gz patched on archive** + 2008-06-20 Robin Fairbairns * faqbody.tex: today's date, for release (section{Bits and pieces of (La)TeX}): correct typo in q-dtx wideversion + **RELEASE** + 2008-06-19 Robin Fairbairns * texfaq2html: carried -beta modifications forward @@ -13,7 +784,7 @@ 2008-06-17 Robin Fairbairns * faqbody.tex (subsection{"Generic" macros and techniques}): tidy descr - of patch.doc in q-patch, and mention ted and etooolbox + of patch.doc in q-patch, and mention ted and etoolbox 2008-06-13 Robin Fairbairns diff --git a/Master/texmf-dist/doc/generic/FAQ-en/archive.list b/Master/texmf-dist/doc/generic/FAQ-en/archive.list deleted file mode 100644 index 60945ca30d0..00000000000 --- a/Master/texmf-dist/doc/generic/FAQ-en/archive.list +++ /dev/null @@ -1,4 +0,0 @@ -ftp.tex.ac.uk tex-archive -ftp.dante.de tex-archive -tug2.cs.umb.edu tex-archive -ftp.cdrom.com pub/tex/ctan diff --git a/Master/texmf-dist/doc/generic/FAQ-en/dirctan.tex b/Master/texmf-dist/doc/generic/FAQ-en/dirctan.tex index 927736d1e15..6c8a31592aa 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/dirctan.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/dirctan.tex @@ -1,4 +1,4 @@ -% + % protect ourself against being read twice \csname readCTANdirs\endcsname \let\readCTANdirs\endinput @@ -6,23 +6,25 @@ % declarations of significant directories on CTAN \CTANdirectory{2etools}{macros/latex/required/tools} \CTANdirectory{4spell}{support/4spell} -\CTANdirectory{Catalogue}{help/Catalogue} -\CTANdirectory{CJK}{language/chinese/CJK} -\CTANdirectory{MimeTeX}{support/mimetex} +\CTANdirectory*{Catalogue}{help/Catalogue} +\CTANdirectory*{CJK}{language/chinese/CJK} +\CTANdirectory*{MathTeX}{support/mathtex} +\CTANdirectory*{MimeTeX}{support/mimetex} \CTANdirectory{Tabbing}{macros/latex/contrib/Tabbing} -\CTANdirectory{TeXtelmExtel}{systems/msdos/emtex-contrib/TeXtelmExtel} +\CTANdirectory*{TeXtelmExtel}{systems/msdos/emtex-contrib/TeXtelmExtel} \CTANdirectory{TftI}{info/impatient} \CTANdirectory{a0poster}{macros/latex/contrib/a0poster} \CTANdirectory{a2ping}{graphics/a2ping} \CTANdirectory{a4}{macros/latex/contrib/a4} -\CTANdirectory{abc2mtex}{support/abc2mtex} +\CTANdirectory*{abc2mtex}{support/abc2mtex} \CTANdirectory{abstract}{macros/latex/contrib/abstract} \CTANdirectory{abstyles}{biblio/bibtex/contrib/abstyles} \CTANdirectory{accents}{support/accents} -\CTANdirectory{acorn}{obsolete/systems/acorn} +\CTANdirectory*{acorn}{obsolete/systems/acorn} \CTANdirectory{acronym}{macros/latex/contrib/acronym} -\CTANdirectory{ada}{web/ada} +\CTANdirectory*{ada}{web/ada/aweb} \CTANdirectory{addindex}{indexing/addindex} +\CTANdirectory{addlines}{macros/latex/contrib/addlines} \CTANdirectory{adjkerns}{fonts/utilities/adjkerns} \CTANdirectory{ae}{fonts/ae} \CTANdirectory{aeguill}{macros/latex/contrib/aeguill} @@ -33,7 +35,7 @@ \CTANdirectory{algorithm2e}{macros/latex/contrib/algorithm2e} \CTANdirectory{algorithmicx}{macros/latex/contrib/algorithmicx} \CTANdirectory{algorithms}{macros/latex/contrib/algorithms} -\CTANdirectory{alpha}{nonfree/systems/mac/support/alpha} +\CTANdirectory*{alpha}{nonfree/systems/mac/support/alpha} \CTANdirectory{amiga}{systems/amiga} \CTANdirectory*{ams-AMStype1}{fonts/amsfonts/ps-type1} \CTANdirectory{amsfonts-euler}{fonts/amsfonts/sources/euler} @@ -52,31 +54,28 @@ \CTANdirectory{appl}{web/reduce/rweb/appl} \CTANdirectory{appendix}{macros/latex/contrib/appendix} \CTANdirectory{arabtex}{language/arabic/arabtex} -\CTANdirectory{arc521}{tools/arc521} -\CTANdirectory{arj}{tools/arj} \CTANdirectory{armenian}{fonts/armenian} -\CTANdirectory{aro-bend}{info/aro-bend} +\CTANdirectory{aro-bend}{info/challenges/aro-bend} \CTANdirectory{asc2tex}{systems/msdos/asc2tex} \CTANdirectory{ascii}{fonts/ascii} \CTANdirectory*{aspell}{support/aspell} \CTANdirectory{astro}{fonts/astro} +\CTANdirectory{asymptote}{graphics/asymptote} \CTANdirectory{atari}{systems/atari} -\CTANdirectory{atob}{tools/atob} \CTANdirectory{atops}{support/atops} -\CTANdirectory{auctex}{support/auctex} +\CTANdirectory*{auctex}{support/auctex} \CTANdirectory{autolatex}{support/autolatex} \CTANdirectory{auto-pst-pdf}{macros/latex/contrib/auto-pst-pdf} \CTANdirectory{aweb}{web/ada/aweb} -\CTANdirectory{awk}{web/spiderweb/src/awk} +\CTANdirectory*{awk}{web/spiderweb/src/awk} \CTANdirectory{axodraw}{graphics/axodraw} \CTANdirectory{babel}{macros/latex/required/babel} \CTANdirectory{babelbib}{biblio/bibtex/contrib/babelbib} \CTANdirectory{badge}{macros/plain/contrib/badge} \CTANdirectory{bakoma}{fonts/cm/ps-type1/bakoma} -\CTANdirectory{bakoma-tex}{systems/win32/bakoma} +\CTANdirectory*{bakoma-tex}{systems/win32/bakoma} \CTANdirectory*{bakoma-texfonts}{systems/win32/bakoma/fonts} -\CTANdirectory{barcodes}{fonts/barcodes} -\CTANdirectory{bard}{fonts/bard} +\CTANdirectory*{bard}{fonts/bard} \CTANdirectory{barr}{macros/generic/diagrams/barr} \CTANdirectory{bashkirian}{fonts/cyrillic/bashkirian} \CTANdirectory{basix}{macros/generic/basix} @@ -93,31 +92,30 @@ \CTANdirectory{bib-fr}{biblio/bibtex/contrib/bib-fr} \CTANdirectory{bib2dvi}{biblio/bibtex/utils/bib2dvi} \CTANdirectory{bib2xhtml}{biblio/bibtex/utils/bib2xhtml} -\CTANdirectory{bibcard}{biblio/bibtex/utils/bibcard} -\CTANdirectory{bibclean}{biblio/bibtex/utils/bibclean} -\CTANdirectory{bibdb}{support/bibdb} +\CTANdirectory*{bibcard}{biblio/bibtex/utils/bibcard} +\CTANdirectory*{bibclean}{biblio/bibtex/utils/bibclean} +\CTANdirectory*{bibdb}{support/bibdb} \CTANdirectory{bibextract}{biblio/bibtex/utils/bibextract} \CTANdirectory{bibgerm}{biblio/bibtex/contrib/germbib} \CTANdirectory{bibindex}{biblio/bibtex/utils/bibindex} \CTANdirectory{biblatex}{macros/latex/exptl/biblatex} +\CTANdirectory*{biblatex-contrib}{macros/latex/exptl/biblatex-contrib} \CTANdirectory{biblio}{info/biblio} \CTANdirectory{biblist}{macros/latex209/contrib/biblist} \CTANdirectory{bibsort}{biblio/bibtex/utils/bibsort} -\CTANdirectory{bibtex}{support/lsedit/bibtex} -\CTANdirectory{bibtex-doc}{biblio/bibtex/distribs/doc} -\CTANdirectory{bibtex-doc-pdf}{biblio/bibtex/contrib/doc} +\CTANdirectory{bibtex-doc}{biblio/bibtex/contrib/doc} \CTANdirectory{bibtool}{biblio/bibtex/utils/bibtool} \CTANdirectory{bibtools}{biblio/bibtex/utils/bibtools} \CTANdirectory{bibtopic}{macros/latex/contrib/bibtopic} \CTANdirectory{bibunits}{macros/latex/contrib/bibunits} \CTANdirectory{bibview}{biblio/bibtex/utils/bibview} \CTANdirectory{bigfoot}{macros/latex/contrib/bigfoot} -\CTANdirectory{binhex}{tools/binhex} \CTANdirectory{bit2spr}{graphics/bit2spr} \CTANdirectory{black}{fonts/cm/utilityfonts/black} +\CTANdirectory{blackboard}{info/symbols/blackboard} \CTANdirectory{blackletter}{fonts/blackletter} \CTANdirectory{blocks}{macros/text1/blocks} -\CTANdirectory{blu}{nonfree/macros/blu} +\CTANdirectory{blu}{macros/blu} \CTANdirectory*{bluesky}{fonts/cm/ps-type1/bluesky} \CTANdirectory{bluesky-maps}{fonts/cm/ps-type1/bluesky-contrib/dvips} \CTANdirectory{bm2font}{graphics/bm2font} @@ -125,13 +123,11 @@ \CTANdirectory{boites}{macros/latex/contrib/boites} \CTANdirectory{bold}{fonts/cm/mf-extra/bold} \CTANdirectory{bonus}{systems/msdos/emtex-contrib/bonus} -\CTANdirectory{boo}{tools/boo} \CTANdirectory{booktabs}{macros/latex/contrib/booktabs} \CTANdirectory{borceux}{macros/generic/diagrams/borceux} \CTANdirectory{breakurl}{macros/latex/contrib/breakurl} \CTANdirectory{bridge}{macros/plain/contrib/bridge} \CTANdirectory{brief_t}{support/brief_t} -\CTANdirectory{bsplit}{tools/bsplit} \CTANdirectory{bst}{biblio/bibtex/contrib/germbib/bst} \CTANdirectory{btable}{macros/plain/contrib/btable} \CTANdirectory{btex8fmt}{macros/generic/cptex/btex8fmt} @@ -169,7 +165,6 @@ \CTANdirectory{chbar}{macros/plain/contrib/chbar} \CTANdirectory{chbars}{macros/latex209/contrib/chbars} \CTANdirectory{check}{support/check} -\CTANdirectory{checksum}{tools/checksum} \CTANdirectory{chemstruct}{macros/latex209/contrib/chemstruct} \CTANdirectory{chemtex}{macros/latex209/contrib/chemtex} \CTANdirectory{cheq}{fonts/chess/cheq} @@ -189,7 +184,7 @@ \CTANdirectory*{cm-AMStype1}{fonts/cm/ps-type1/bluesky} \CTANdirectory{cm-lgc}{fonts/ps-type1/cm-lgc} \CTANdirectory{cm-super}{fonts/ps-type1/cm-super} -\CTANdirectory{cmactex}{nonfree/systems/mac/cmactex} +\CTANdirectory{cmactex}{systems/mac/cmactex} \CTANdirectory{cmap}{macros/latex/contrib/cmap} \CTANdirectory{cmastro}{fonts/cmastro} \CTANdirectory{cmcyralt}{macros/latex/contrib/cmcyralt} @@ -202,14 +197,12 @@ \CTANdirectory{cms_help_files}{macros/text1/cms_help_files} \CTANdirectory{cmtest}{fonts/cm/cmtest} \CTANdirectory{cnoweb}{web/c_cpp/cnoweb} +\CTANdirectory{collref}{macros/latex/contrib/collref} \CTANdirectory{combine}{macros/latex/contrib/combine} -\CTANdirectory{comm}{tools/macutils/comm} \CTANdirectory{comment}{macros/latex/contrib/comment} \CTANdirectory{committee}{fonts/unsupported/committee} \CTANdirectory{comp-fonts-FAQ}{help/comp-fonts-FAQ} -\CTANdirectory{compact}{tools/compact} \CTANdirectory{components-of-TeX}{info/components-of-TeX} -\CTANdirectory{compress}{tools/compress} \CTANdirectory{compugraphics_8600}{macros/text1/compugraphics_8600} \CTANdirectory{concmath}{macros/latex/contrib/concmath} \CTANdirectory{concmath-f}{fonts/concmath} @@ -249,7 +242,6 @@ \CTANdirectory{dc-nfss}{language/hyphen-accent/dc-nfss} \CTANdirectory{detex}{support/detex} \CTANdirectory{devanagari}{language/devanagari} -\CTANdirectory{diagram}{macros/generic/diagrams/borceux/diagram} \CTANdirectory{diagrams}{macros/generic/diagrams} \CTANdirectory{dijkstra}{web/spiderweb/src/dijkstra} \CTANdirectory{dinbrief}{macros/latex/contrib/dinbrief} @@ -301,7 +293,7 @@ \CTANdirectory{dvisun}{dviware/dvisun} \CTANdirectory{dvitty}{dviware/dvitty} \CTANdirectory{dvivga}{dviware/dvivga} -\CTANdirectory{e4t}{nonfree/systems/msdos/e4t} +\CTANdirectory{e4t}{systems/msdos/e4t} \CTANdirectory*{e-TeX}{systems/e-tex} \CTANdirectory{easytex}{systems/msdos/easytex} \CTANdirectory{ebib}{biblio/bibtex/utils/ebib} @@ -327,6 +319,7 @@ \CTANdirectory{engwar}{fonts/engwar} \CTANdirectory{enumitem}{macros/latex/contrib/enumitem} \CTANdirectory{environment}{support/lsedit/environment} +\CTANdirectory{epic}{macros/latex/contrib/epic} \CTANdirectory{epigraph}{macros/latex/contrib/epigraph} \CTANdirectory{eplain}{macros/eplain} \CTANdirectory{epmtex}{systems/os2/epmtex} @@ -336,7 +329,7 @@ \CTANdirectory{ergotex}{systems/msdos/ergotex} \CTANdirectory{errata}{systems/knuth/dist/errata} \CTANdirectory{eso-pic}{macros/latex/contrib/eso-pic} -\CTANdirectory{et}{nonfree/support/et} +\CTANdirectory{et}{support/et} \CTANdirectory{ethiopia}{language/ethiopia} \CTANdirectory{ethtex}{language/ethiopia/ethtex} \CTANdirectory{etoolbox}{macros/latex/contrib/etoolbox} @@ -353,6 +346,7 @@ \CTANdirectory{excel2latex}{support/excel2latex} \CTANdirectory{excerpt}{web/spiderweb/tools/excerpt} \CTANdirectory{expdlist}{macros/latex/contrib/expdlist} +\CTANdirectory{expl3}{macros/latex/contrib/expl3} \CTANdirectory{extracm}{fonts/amsfonts/sources/extracm} \CTANdirectory{extract}{macros/latex/contrib/extract} \CTANdirectory{extsizes}{macros/latex/contrib/extsizes} @@ -365,8 +359,8 @@ \CTANdirectory{fig2eng}{graphics/fig2eng} \CTANdirectory{fig2mf}{graphics/fig2mf} \CTANdirectory{fig2mfpic}{graphics/fig2mfpic} -\CTANdirectory{filehdr}{tools/filehdr} \CTANdirectory{fink}{macros/latex/contrib/fink} +\CTANdirectory{first-latex-doc}{info/first-latex-doc} \CTANdirectory{fixfoot}{macros/latex/contrib/fixfoot} \CTANdirectory{float}{macros/latex/contrib/float} \CTANdirectory{floatflt}{macros/latex/contrib/floatflt} @@ -388,8 +382,6 @@ \CTANdirectory{fouriernc}{fonts/fouriernc} \CTANdirectory{frankenstein}{macros/latex/contrib/frankenstein} \CTANdirectory{french-faq}{help/LaTeX-FAQ-francaise} -\CTANdirectory{ftpd}{tools/ftpd} -\CTANdirectory{ftpmail}{tools/ftpmail} \CTANdirectory{funnelweb}{web/funnelweb} \CTANdirectory{futhark}{fonts/futhark} \CTANdirectory{futhorc}{fonts/futhorc} @@ -402,7 +394,6 @@ \CTANdirectory{germbib}{biblio/bibtex/contrib/germbib} \CTANdirectory{gfs}{info/examples/FirstSteps} % gratzer's \CTANdirectory*{ghostscript}{support/ghostscript} -\CTANdirectory*{ghostview}{support/ghostscript/gnu/ghostview} \CTANdirectory{glo+idxtex}{indexing/glo+idxtex} \CTANdirectory{gnuplot}{graphics/gnuplot} \CTANdirectory{go}{fonts/go} @@ -416,7 +407,7 @@ \CTANdirectory{greektex}{fonts/greek/greektex} \CTANdirectory{gregory}{web/noweb/contrib/gregory} \CTANdirectory{gsftopk}{fonts/utilities/gsftopk} -\CTANdirectory*{gsview}{nonfree/support/ghostscript/ghostgum} +\CTANdirectory*{gsview}{support/ghostscript/ghostgum} \CTANdirectory{gut}{usergrps/gut} \CTANdirectory*{gv}{support/gv} \CTANdirectory{ha-prosper}{macros/latex/contrib/ha-prosper} @@ -428,7 +419,6 @@ \CTANdirectory{hebrew}{language/hebrew} \CTANdirectory{help}{help} \CTANdirectory{hershey}{fonts/hershey} -\CTANdirectory{hexbin}{tools/macutils/hexbin} \CTANdirectory{hfbright}{fonts/ps-type1/hfbright} \CTANdirectory{hge}{fonts/hge} \CTANdirectory{hieroglyph}{fonts/hieroglyph} @@ -454,6 +444,7 @@ \CTANdirectory{iching}{fonts/iching} \CTANdirectory{icons}{support/icons} \CTANdirectory{ifmslide}{macros/latex/contrib/ifmslide} +\CTANdirectory{ifxetex}{macros/generic/ifxetex} \CTANdirectory{imaketex}{support/imaketex} \CTANdirectory{impact}{web/systems/mac/impact} \CTANdirectory{index}{macros/latex/contrib/index} @@ -473,7 +464,7 @@ \CTANdirectory{jemtex2}{systems/msdos/jemtex2} \CTANdirectory{jknappen-macros}{macros/latex/contrib/jknappen} \CTANdirectory{jonkrom}{web/noweb/contrib/jonkrom} -\CTANdirectory{jpeg2ps}{nonfree/support/jpeg2ps} +\CTANdirectory{jpeg2ps}{support/jpeg2ps} \CTANdirectory{jspell}{support/jspell} \CTANdirectory{jurabib}{macros/latex/contrib/jurabib} \CTANdirectory{kaelin}{web/noweb/contrib/kaelin} @@ -483,6 +474,7 @@ \CTANdirectory{kd}{fonts/greek/kd} \CTANdirectory{kelem}{web/spiderweb/src/kelem} \CTANdirectory{kelly}{fonts/greek/kelly} +\CTANdirectory{keys3}{macros/latex/exptl/keys3} \CTANdirectory{klinz}{fonts/klinz} \CTANdirectory{knit}{web/knit} \CTANdirectory{knot}{fonts/knot} @@ -512,6 +504,7 @@ \CTANdirectory{lastpage}{macros/latex/contrib/lastpage} \CTANdirectory{latex-essential}{info/latex-essential} \CTANdirectory{latex-help-texinfo}{info/latex-help-texinfo} +\CTANdirectory*{latex-tds}{macros/latex/contrib/latex-tds} \CTANdirectory*{latex2html}{support/latex2html} \CTANdirectory{latex2rtf}{support/latex2rtf} \CTANdirectory{latexdiff}{support/latexdiff} @@ -526,7 +519,6 @@ \CTANdirectory{lextex}{macros/plain/contrib/lextex} \CTANdirectory{lgc}{info/examples/lgc} \CTANdirectory{lgrind}{support/lgrind} -\CTANdirectory{lharc}{tools/lharc} \CTANdirectory{lineno}{macros/latex/contrib/lineno} \CTANdirectory{listbib}{macros/latex/contrib/listbib} \CTANdirectory{listings}{macros/latex/contrib/listings} @@ -542,11 +534,8 @@ \CTANdirectory{luximono}{fonts/LuxiMono} \CTANdirectory{lwc}{info/examples/lwc} \CTANdirectory{ly1}{macros/latex/contrib/psnfssx/ly1} -\CTANdirectory{machdr}{tools/macunpack/machdr} \CTANdirectory*{mactex}{systems/mac/mactex} \CTANdirectory{mactotex}{graphics/mactotex} -\CTANdirectory{macunpack}{tools/macunpack} -\CTANdirectory{macutils}{tools/macutils} \CTANdirectory{mailing}{macros/latex/contrib/mailing} \CTANdirectory{make_latex}{support/make_latex} \CTANdirectory{makeafm.dir}{fonts/utilities/t1tools/makeafm.dir} @@ -566,8 +555,8 @@ \CTANdirectory{mathsci2bibtex}{biblio/bibtex/utils/mathsci2bibtex} \CTANdirectory{mathspic}{graphics/mathspic} \CTANdirectory{mcite}{macros/latex/contrib/mcite} +\CTANdirectory{mciteplus}{macros/latex/contrib/mciteplus} \CTANdirectory{mctex}{support/mctex} -\CTANdirectory{mcvert}{tools/mcvert} \CTANdirectory{mdwtools}{macros/latex/contrib/mdwtools} \CTANdirectory{memoir}{macros/latex/contrib/memoir} \CTANdirectory{messtex}{support/messtex} @@ -593,8 +582,6 @@ \CTANdirectory{miktex-AXP}{obsolete/systems/win32/miktex-AXP} \CTANdirectory{minionpro}{fonts/minionpro} \CTANdirectory{minitoc}{macros/latex/contrib/minitoc} -\CTANdirectory{mirror}{tools/mirror} -\CTANdirectory{mixed}{tools/macutils/mixed} \CTANdirectory{mma2ltx}{graphics/mma2ltx} \CTANdirectory{mnsymbol}{fonts/mnsymbol} \CTANdirectory{mnu}{support/mnu} @@ -635,6 +622,7 @@ \CTANdirectory{ntheorem}{macros/latex/contrib/ntheorem} \CTANdirectory{nts-l}{digests/nts-l} \CTANdirectory{nts}{systems/nts} +\CTANdirectory{numparse3}{macros/latex/exptl/numparse3} \CTANdirectory{numprint}{macros/latex/contrib/numprint} \CTANdirectory{nuweb}{web/nuweb} \CTANdirectory{nuweb0.87b}{web/nuweb/nuweb0.87b} @@ -651,23 +639,21 @@ \CTANdirectory{os2}{systems/os2} \CTANdirectory{osmanian}{fonts/osmanian} \CTANdirectory{overpic}{macros/latex/contrib/overpic} -\CTANdirectory{oztex}{nonfree/systems/mac/oztex} -\CTANdirectory{oztex-german}{nonfree/systems/mac/oztex-german} +\CTANdirectory{oztex}{systems/mac/oztex} \CTANdirectory{page}{support/lametex/page} \CTANdirectory{palladam}{language/tamil/palladam} \CTANdirectory{pandora}{fonts/pandora} \CTANdirectory{paralist}{macros/latex/contrib/paralist} \CTANdirectory{parallel}{macros/latex/contrib/parallel} -\CTANdirectory{parc}{tools/parc} \CTANdirectory{passivetex}{macros/xmltex/contrib/passivetex} \CTANdirectory{patchcmd}{macros/latex/contrib/patchcmd} -\CTANdirectory{patches}{web/spiderweb/patches} \CTANdirectory{pbm2tex}{support/pbm2tex} \CTANdirectory{pbmtopk}{graphics/pbmtopk} \CTANdirectory{pbox}{macros/latex/contrib/pbox} \CTANdirectory{pcwritex}{support/pcwritex} \CTANdirectory{pdcmac}{macros/plain/contrib/pdcmac} \CTANdirectory{pdfpages}{macros/latex/contrib/pdfpages} +\CTANdirectory{pdftex}{systems/pdftex} \CTANdirectory{pdftex-graphics}{macros/pdftex/graphics} \CTANdirectory{pdftricks}{macros/latex/contrib/pdftricks} \CTANdirectory{penelope}{web/spiderweb/src/penelope} @@ -689,7 +675,8 @@ \CTANdirectory{pkfix-helper}{support/pkfix-helper} \CTANdirectory{placeins}{macros/latex/contrib/placeins} \CTANdirectory{plain}{macros/plain/base} -\CTANdirectory*{plnfss}{macros/plain/contrib/plnfss} +\CTANdirectory*{plastex}{support/plastex} +\CTANdirectory{plnfss}{macros/plain/plnfss} \CTANdirectory{plttopic}{support/plttopic} \CTANdirectory{pmtex}{systems/os2/pmtex} \CTANdirectory{pmx}{support/pmx} @@ -701,7 +688,6 @@ \CTANdirectory{pp}{support/pp} \CTANdirectory{preprint}{macros/latex/contrib/preprint} \CTANdirectory{preview}{macros/latex/contrib/preview} -\CTANdirectory*{preview-latex}{support/preview-latex} \CTANdirectory{print-fine}{support/print-fine} \CTANdirectory{printbib}{biblio/bibtex/utils/printbib} \CTANdirectory{printsamples}{fonts/utilities/mf2ps/doc/printsamples} @@ -718,7 +704,7 @@ \CTANdirectory{psbook}{systems/msdos/dviware/psbook} \CTANdirectory{psbox}{macros/generic/psbox} \CTANdirectory{pseudocode}{macros/latex/contrib/pseudocode} -\CTANdirectory{psfig}{nonfree/graphics/psfig} +\CTANdirectory{psfig}{graphics/psfig} \CTANdirectory{psfrag}{macros/latex/contrib/psfrag} \CTANdirectory{psfragx}{macros/latex/contrib/psfragx} \CTANdirectory{psizzl}{macros/psizzl} @@ -761,7 +747,6 @@ \CTANdirectory{rotating}{macros/latex/contrib/rotating} \CTANdirectory{rotfloat}{macros/latex/contrib/rotfloat} \CTANdirectory{rsfs}{fonts/rsfs} -\CTANdirectory{rsfs-type1}{fonts/rsfs/ps-type1/hoekwater} \CTANdirectory{rtf2tex}{support/rtf2tex} \CTANdirectory{rtf2html}{support/rtf2html} \CTANdirectory{rtf2latex}{support/rtf2latex} @@ -783,7 +768,7 @@ \CTANdirectory{sciposter}{macros/latex/contrib/sciposter} \CTANdirectory{screenview}{dviware/screenview} \CTANdirectory{script}{macros/latex/contrib/script} -\CTANdirectory{scripttex}{nonfree/macros/scripttex} +\CTANdirectory{scripttex}{macros/scripttex} \CTANdirectory{sectsty}{macros/latex/contrib/sectsty} \CTANdirectory{seminar}{macros/latex/contrib/seminar} \CTANdirectory{sfware}{fonts/softfonts/sfware} @@ -811,7 +796,6 @@ \CTANdirectory{ssqquote}{macros/latex/contrib/ssqquote} \CTANdirectory{stmaryrd}{fonts/stmaryrd} \CTANdirectory{sttools}{macros/latex/contrib/sttools} -\CTANdirectory{stuffit}{tools/stuffit} \CTANdirectory{subeqnarray}{macros/latex/contrib/subeqnarray} \CTANdirectory{subfig}{macros/latex/contrib/subfig} \CTANdirectory{subfiles}{macros/latex/contrib/subfiles} @@ -832,7 +816,6 @@ \CTANdirectory{tabulary}{macros/latex/contrib/tabulary} \CTANdirectory{talk}{macros/latex/contrib/talk} \CTANdirectory{tamil}{language/tamil} -\CTANdirectory{tar}{tools/tar} \CTANdirectory{tbe}{macros/plain/contrib/tbe} \CTANdirectory{tcdmanual}{info/tcdmanual} \CTANdirectory{tde-macros}{language/swedish/slatex/tde-macros} @@ -852,12 +835,11 @@ \CTANdirectory{tex-surface}{support/tex-surface} \CTANdirectory{tex2mail}{support/tex2mail} \CTANdirectory{tex2rtf}{support/tex2rtf} -\CTANdirectory{tex88}{digests/tex88} -\CTANdirectory{tex8fmts}{macros/generic/cptex/tex8fmts} \CTANdirectory{texbytopic}{info/texbytopic} \CTANdirectory{texcalc}{support/texcalc} \CTANdirectory{texchord}{macros/generic/texchord} \CTANdirectory{texcnvfaq}{help/wp-conv} +\CTANdirectory{texcount}{support/texcount} \CTANdirectory{texdraw}{graphics/texdraw} \CTANdirectory{texed}{support/texed} \CTANdirectory{texfilt}{support/texfilt} @@ -906,12 +888,12 @@ \CTANdirectory{tr2latex}{support/tr2latex} \CTANdirectory{transfig}{graphics/transfig} \CTANdirectory{translit}{support/translit} -\CTANdirectory{transname}{tools/macunpack/transname} \CTANdirectory{tree}{graphics/tree} \CTANdirectory{troff}{indexing/makeindex/troff} \CTANdirectory{tsipa}{fonts/tsipa} \CTANdirectory{tspell}{support/tspell} \CTANdirectory{tt2001}{fonts/ps-type1/tt2001} +\CTANdirectory{tth}{support/tth/dist} \CTANdirectory{ttn}{digests/ttn} \CTANdirectory{tug}{usergrps/tug} \CTANdirectory{tugboat}{digests/tugboat} @@ -934,24 +916,18 @@ \CTANdirectory{umlaute}{macros/latex/contrib/umlaute} \CTANdirectory{umrand}{macros/generic/umrand} \CTANdirectory{unadobe}{fonts/utilities/unadobe} -\CTANdirectory{unarj}{tools/unarj} \CTANdirectory{uncompressing}{fonts/utilities/mf2ps/mf2ps/uncompressing} \CTANdirectory{undump}{obsolete/support/undump} \CTANdirectory{unix}{systems/unix} -\CTANdirectory{unpack}{tools/macunpack/unpack} \CTANdirectory{unpacked}{macros/latex/unpacked} -\CTANdirectory{unstuff}{tools/unstuff} \CTANdirectory{untex}{support/untex} \CTANdirectory{urlbst}{biblio/bibtex/contrib/urlbst} -\CTANdirectory{urw}{fonts/urw} -\CTANdirectory{user-guides}{macros/generic/diagrams/borceux/user-guides} -\CTANdirectory{usergrps}{usergrps} +\CTANdirectory{urw-base35}{fonts/urw/base35} \CTANdirectory{usl}{fonts/thai/usl} \CTANdirectory{utopia}{fonts/utopia} \CTANdirectory{utthesis}{macros/latex/contrib/utthesis} -\CTANdirectory{uue}{tools/uue} -\CTANdirectory{uuencode}{tools/uuencode} -\CTANdirectory{va}{fonts/va} +CTANdirectory{va}{fonts/va} +\CTANdirectory{varisize}{macros/plain/contrib/varisize} \CTANdirectory{vc}{support/vc} \CTANdirectory{vector}{macros/latex/contrib/vector} \CTANdirectory{vertex}{macros/plain/contrib/vertex} @@ -968,10 +944,7 @@ \CTANdirectory{vtex-common}{systems/vtex/common} \CTANdirectory{vtex-linux}{systems/vtex/linux} \CTANdirectory{vtex-os2}{systems/vtex/os2} -\CTANdirectory{vtree}{tools/vtree} -\CTANdirectory{vtree-fix}{tools/vtree-fix} \CTANdirectory{vutex}{dviware/vutex} -\CTANdirectory{vvcode}{tools/vvcode} \CTANdirectory{w2latex}{support/w2latex} \CTANdirectory{wallpaper}{macros/latex/contrib/wallpaper} \CTANdirectory{was}{macros/latex/contrib/was} @@ -982,7 +955,6 @@ \CTANdirectory{webtoc}{support/makeprog/webtoc} \CTANdirectory{whatstex}{info/whatstex} \CTANdirectory{williams}{macros/latex/contrib/williams} -\CTANdirectory{fptex}{obsolete/systems/win32/fptex} \CTANdirectory*{winedt}{systems/win32/winedt} \CTANdirectory{winw2ltx}{support/winw2ltx} \CTANdirectory{word2tex}{support/word2tex} @@ -993,18 +965,19 @@ \CTANdirectory{wsuipa}{fonts/wsuipa} \CTANdirectory{xargs}{macros/latex/contrib/xargs} \CTANdirectory{xbibfile}{biblio/bibtex/utils/xbibfile} -\CTANdirectory{xbin}{tools/xbin} \CTANdirectory{xcolor}{macros/latex/contrib/xcolor} -\CTANdirectory{xdvi}{dviware/xdvi} +\CTANdirectory*{xdvi}{dviware/xdvi} \CTANdirectory{xetal}{support/xetal} \CTANdirectory{xettex}{language/xettex} -\CTANdirectory{xfig}{graphics/xfig} -\CTANdirectory*{xindy}{support/xindy} +\CTANdirectory*{xfig}{graphics/xfig} +\CTANdirectory*{xindy}{indexing/xindy} \CTANdirectory{xkeyval}{macros/latex/contrib/xkeyval} \CTANdirectory{xmltex}{macros/xmltex/base} +\CTANdirectory{xpackages}{macros/latex/contrib/xpackages} \CTANdirectory*{xpdf}{support/xpdf} \CTANdirectory{xtab}{macros/latex/contrib/xtab} -\CTANdirectory{xypic}{macros/generic/diagrams/xypic} +\CTANdirectory{xypic}{macros/generic/diagrams/xypic/xy} +\CTANdirectory{yagusylo}{macros/latex/contrib/yagusylo} \CTANdirectory{yhmath-fonts}{fonts/yhmath} \CTANdirectory{yhmath-macros}{macros/latex/contrib/yhmath} \CTANdirectory{zefonts}{fonts/zefonts} diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faq.sty b/Master/texmf-dist/doc/generic/FAQ-en/faq.sty index e9acef465a4..111c3f121d6 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/faq.sty +++ b/Master/texmf-dist/doc/generic/FAQ-en/faq.sty @@ -146,8 +146,6 @@ \DeclareRobustCommand\MP{Meta\-Post} \let\textlogo\textmd % -% get texnames package (as amended) -%\RequirePackage{stupid_names} % define substitutes for stupid_names \newcommand\LaTeXo{\LaTeX\,2.09} \newcommand\AMSTeX{AMS\TeX} @@ -155,6 +153,7 @@ \newcommand\BibTeX{Bib\TeX} \newcommand\PiCTeX{PiC\TeX} \newcommand\texlive{\TeX{} Live} +% and... % % ifthenelse for the undefined references \RequirePackage{ifthen} @@ -167,15 +166,16 @@ \excludecomment{htmlversion} \ifpdf \includecomment{pdfversion} - \excludecomment{dviversion} \includecomment{wideversion} + \excludecomment{dviversion} \excludecomment{narrowversion} \else \excludecomment{pdfversion} + \excludecomment{wideversion} \includecomment{dviversion} \includecomment{narrowversion} - \excludecomment{wideversion} \fi +\newenvironment{introduction}{}{} % % but we also want short versions, like LaTeX2HTML's \let\htmlonly\@gobble @@ -200,10 +200,13 @@ \providecommand\DANTE{\acro{DANTE}} \providecommand\MSDOS{\acro{MS-DOS}} \providecommand\CDROM{\acro{CD-ROM}} -\providecommand\elatex{e-LaTeX} +% +\providecommand\elatex{e-\LaTeX{}} +\providecommand\plaintex{Plain \TeX{}} \providecommand\miktex{MiKTeX} +\providecommand\texshop{\ProgName{TeXshop}} +\providecommand\texworks{\ProgName{TeXworks}} \providecommand\xetex{XeTeX} -\providecommand\plaintex{Plain \TeX{}} % %% \providecommand\TeXXeT{\TeX-{}-X\lower.5ex\hbox{E}\kern-.1667emT\@} %\providecommand\MLTeX{ML-\TeX} @@ -309,6 +312,7 @@ \newcommand\PDFLaTeX{PDF\LaTeX} \renewcommand\LaTeX{La\TeX} \newcommand\twee{2e} +\renewcommand\LaTeXe{\LaTeX\twee} % % Other odds and ends (appear differently in TeX and http or plain % text @@ -835,6 +839,20 @@ } \newcommand*\questionmark[1]{} \newcommand*\l@question{\@dottedtocline{2}{2.0em}{2.3em}} + +% +% \paragraph: has appeared in a submission, so let's give it a faq +% definition... +\renewcommand\paragraph{\@startsection{paragraph}% + 4% + \z@ + {1.25ex \@plus 1ex \@minus.2ex}% + {-1em} + {% + \normalfont + \normalsize + \bfseries + }} % % alias questions make a little perl script to set up a hash array % that takes one from old question to current one. diff --git a/Master/texmf-dist/doc/generic/FAQ-en/faqbody.tex b/Master/texmf-dist/doc/generic/FAQ-en/faqbody.tex index 1b35a314993..2fd9eff8f33 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/faqbody.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/faqbody.tex @@ -1,4 +1,4 @@ -\def\faqfileversion{3.18} \def\faqfiledate{2008-06-20} +\def\faqfileversion{3.19} \def\faqfiledate{2009-06-10} % % The above line defines the file version and date, and must remain % the first line with any `assignment' in the file, or things will @@ -16,90 +16,73 @@ % ... files \input{filectan} +% this environment is for the benefit of new-style file generation +\begin{introduction} +% suppress section numbers until end environment +\nothtml{\csname c@secnumdepth\endcsname=-1 } \section{Introduction} This is a set of Frequently Asked Questions (\acro{FAQ}) for -English-speaking users of \TeX{}. The questions answered here cover a -wide range of topics, but the actual typesetting issues are mostly +English-speaking users of \TeX{}. The questions answered here cover +a wide range of topics, but the actual typesetting issues are mostly covered from the viewpoint of a \LaTeX{} user. You may use the \acro{FAQ} \begin{itemize} -\item by reading a printed document, +\item by reading a printed document, \item by viewing a \acro{PDF} file, with hyperlinks to assist browsing: copies are available formatted for printing on \CTANhref{faq-a4}{A4 paper} or on % ! line break \CTANhref{faq-letter}{North American ``letter'' paper}, or \item by using the \acro{FAQ}'s web interface (base \acro{URL}: - \URL{http://www.tex.ac.uk/faq}); this version provides simple search - capabilities, as well as a link to Google for a more sophisticated - search restricted to the \acro{FAQ} itself, or + \URL{http://www.tex.ac.uk/faq}); this version provides simple + search capabilities, as well as a link to Google for a more + sophisticated search restricted to the \acro{FAQ} itself, or \item via Scott Pakin's \CTANhref{visualFAQ}{Visual FAQ}. \end{itemize} -\begin{htmlversion} -% pseudo-subsection here, because of limitations of latex->html translator -\textbf{Caveat: Acquiring files} - -Most answers in this \acro{FAQ} provide links for downloading -software; a large proportion of these links direct you to entire -directories on the \acro{CTAN} archives. Unfortunately, some browsers -issue a sequence of commands that causes \acro{CTAN} servers to deny -the existence of compressed archive files of the directory, that the -server would be happy to create ``on the fly''. The \acro{FAQ} -therefore offers three possible links for downloading directories -(that aren't already designated ``browse only''): the links give you -\extension{zip} and \extension{tar.gz} archives, and a link for browsing -the directory. - -Fortunately, \acro{CTAN} is switching to statically-generated -directory archive files; many directories mentioned in this \acro{FAQ} -will also exist as \extension{zip} files on the archives, and won't fall -foul of the browser problem. Of course, if the \extension{zip} file -does not exist, and the browser is playing up, you will need to use -the ``browse'' link. -\end{htmlversion} - -\htmlignore -\subsection*{Finding the Files} - -Unless otherwise specified, all files mentioned in this \acro{FAQ} are -available from a \acro{CTAN} archive, or from one of their mirrors. -\Qref[Question]{}{Q-archives} % this one doesn't need anchor text -gives details of the \acro{CTAN} archives, and how to retrieve files from -them. If you don't have access to the Internet, the -\Qref*{\texlive{} distribution}{Q-CD} offers off-line snapshots of -the archives. - -The reader should also note that the first directory name of the path -name of every file on \acro{CTAN} has been elided from what follows, for the -simple reason that it's always the same (\path{tex-archive/}). - -To avoid confusion, we've also elided the full stop -from the end of any sentence whose last item is a path name (such -sentences are rare, and only occur at the end of paragraphs). Though -the path names are set in a different font from running text, it's not -easy to distinguish the font of a single dot! -\endhtmlignore +\subsection{Finding the Files} + +Unless otherwise specified, all files mentioned in this \acro{FAQ} +are available from a \acro{CTAN} archive, or from a mirror of +\acro{CTAN}~--- see \Qref[question]{later discussion}{Q-archives}% ! space +\narrowonly{, which gives details} of the \acro{CTAN} +archives\wideonly{ and}\narrowonly{, including} how to retrieve files +from them. If you don't have access to the internet, the +\Qref*{\texlive{} distribution}{Q-CD} offers off-line snapshots of the +archives. + +The reader should also note that the first directory name of the +path name of every file on \acro{CTAN} is omitted from what +follows, for the simple reason that, while it's always the same +(\path{tex-archive/}) on the main sites, mirror sites often choose +something else. + +To avoid confusion, we also omit the full stop from the end of +any sentence whose last item is a path name (such sentences are +rare, and only occur at the end of paragraphs). Though the path +names are set in a different font from running text, it's not easy +to distinguish the font of a single dot! \latexhtml{\subsection*{Origins}}{\textbf{Origins}} -The \acro{FAQ} was originated by the Committee of the \acro{UK} \TeX{} -Users' Group (\acro{UK}~\acro{TUG}) as a development of a regular -posting to the \emph{Usenet} newsgroup \Newsgroup{comp.text.tex} that -was maintained for some time by Bobby Bodenheimer. The first -\acro{UK} version was much re-arranged and corrected from the -original, and little of Bodenheimer's work now remains. +The \acro{FAQ} was originated by the Committee of the \acro{UK} +\TeX{} Users' Group (\acro{UK}~\acro{TUG}) as a development of a +regular posting to the \emph{Usenet} newsgroup +\Newsgroup{comp.text.tex} that was maintained for some time by Bobby +Bodenheimer. The first \acro{UK} version was much re-arranged and +corrected from the original, and little of Bodenheimer's work now +remains. The following people (at least~--- there are almost certainly others whose names weren't correctly recorded) have contributed help or -advice on the development of the \acro{FAQ}: -Donald Arseneau, +advice on the development of the \acro{FAQ}: Donald Arseneau, Rosemary Bailey, % lots of initial set of maths answers Barbara Beeton, % one of first reviewers outside cttee -Karl Berry, +Karl Berry, % often provides comments & suggestions Giuseppe Bilotta, Charles Cameron, +Fran\c{c}ois Charette, % update of q-xetex Damian Cugley, Michael Dewey, Michael Downes, % (RIP) on (ams)maths stuff @@ -130,7 +113,8 @@ Oleg Katsitadze, % revision of q-eplain Isaac Khabaza, % kindersley book Ulrich Klauer, % pointed out twaddle in TeXpronounce Markus Kohm, % help with functionality of Koma-script -David Kraus, % help with tocbibind (spotted embarrassing typo :-} ) +Stefan Kottwitz % picked up text of q-wideflt +David Kraus, % help with tocbibind (spotted embarrassing typo :-} ) Ryszard Kubiak, % comment about q-driver Simon Law, Daniel Luecking, @@ -140,7 +124,7 @@ Andreas Matthias, Brooks Moses, % editorial suggestion Iain Murray, % alternative solution in q-hyperdupdest Vilar Camara Neto, % explain breakurl pkg, suggest use of numprint -Dick Nickalls, % now a member of the committee +Dick Nickalls, Ted Nieland, Hans Nordhaug, Pat Rau, @@ -148,23 +132,27 @@ Heiko Oberdiek, Piet van Oostrum, Scott Pakin, Oren Patashnik, +Manuel P\'egouri\'e-Gonnard, % improvement of q-luatex Steve Peter, % comprehensive review, lots of typos etc Sebastian Rahtz, % without whom there would be no... Philip Ratcliffe, % help with a bibtex oddity Chris Rowley, % founding father -Jos\'e Carlos Santos, % very assiduous reader of new versions +Jos\'e Carlos Santos, % assiduous reader of new versions Walter Schmidt, Hans-Peter Schr\"ocker, Joachim Schrod, Maarten Sneep, % summary of c.t.t thread for outszwrng, inter alia Axel Sommerfeldt, % suggested rewrite of q-hyperdupdest +Philipp Stephani, % xlation of komascript keyval stuff James Szinger, % who responded on c.t.t to request for answer Ulrik Vieth, Mike Vulis, Chris Walker, % revtex alert, ite suggestion (q-labelfig) Peter Wilson, % several, incl functionality of memoir +Joseph Wright, % help with keyval Rick Zaccone and Reinhard Zierke. +\end{introduction} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -176,8 +164,12 @@ Reinhard Zierke. \href{http://sunburn.stanford.edu/~knuth/}{Donald E. Knuth}, who says in the Preface to his book on \TeX{} (see \Qref[question]{books about TeX}{Q-books}) that it is -%% beware line wrap -``\emph{intended for the creation of beautiful books~--- and especially for books that contain a lot of mathematics}''. +%% !line wrap avoided by two commands +``\emph{intended for the creation of beautiful books~---} +\emph{and especially for books that contain a lot of mathematics}''. +(If \TeX{} were \emph{only} good for mathematical books, much of its +use nowadays would not happen: it's actually a pretty good general +typesetting system.) Knuth is Emeritus Professor of the Art of Computer Programming at Stanford University in California, \acro{USA}. Knuth developed the @@ -279,6 +271,191 @@ A mailing list discussing \MP{} is available; The \acro{TUG} website also hosts a % ! line break \href{http://tug.org/metapost.html}{\MP{} summary page}. +%**** +\Question[Q-texthings]{Things with ``\TeX{}'' in the name} + +New \TeX{} users are often baffled by the myriad terms with ``\TeX{}'' +in the name. The goal of this answer is to clarify some of the more +common \TeX{} terms. + +\paragraph{\TeX{} itself} +\TeX{} proper is a typesetting system based on a set of low-level +control sequences that instruct \TeX{} how to lay out text on the +page. For example, \csx{hskip} inserts a given amount of horizontal +space into the document, and \csx{font} makes a given font available +to \TeX{}. \TeX{} is fully programmable using an integrated macro +scripting language that supports variables, scoping, conditional +execution, control flow, and function (really, macro) definitions. +See % ! line break +\Qref[question]{What is \TeX{}?}{Q-whatTeX} for some background +information on \TeX{} and % ! line break +\Qref[question]{Reference documents}{Q-ref-doc} for pointers to +descriptions of \TeX{} control sequences, data types, and other key +parts of \TeX{}. + +\paragraph{\TeX{} macro packages (a.k.a.~\TeX{} formats)} +\TeX{}'s control sequences are tedious to use directly; they are +intended primarily as building blocks for higher-level---and therefore +more user-friendly---abstractions. For example, there is no way in +base \TeX{} to specify that a piece of text should be typeset in a +larger font. Instead, one must keep track of the current size and +typeface, load a new font with the same typeface but a (specified) +larger size, and tell \TeX{} to use that new font until instructed +otherwise. Fortunately, because \TeX{} is programmable, it is +possible to write a macro that hides this complexity behind a simple, +new control sequence. For example, +% +\cmdinvoke{larger}{my text} can be defined to typeset ``my text'' in +the next larger font). + +While some users write their own, perfectly customized set of +macros---which they then typically reuse across many documents---it is +far more common to rely upon a \emph{macro package}, a collection of +\TeX{} macros written by experts. For the user's convenience, these +macro packages are often combined with the base \TeX{} engine into a +standalone executable. The following are some of that macro packages +that you are likely to encounter: +\begin{description} + \item[Plain \TeX{} (executable: \ProgName{tex})] + See + \Qref[questions]{Books on \TeX{} and its relations}{Q-books}, + \Qref[]{Online introductions: \TeX{}}{Q-man-tex}, + \Qref[]{Should I use Plain \TeX{} or \LaTeX{}?}{Q-plainvltx} and + \Qref[]{Freely available \AllTeX{} books}{Q-ol-books}. + Note that the Plain \TeX{} executable is called \ProgName{tex}; the + base \TeX{} engine is generally provided by a separate executable + such as \ProgName{initex} or as a \texttt{-ini} flag to + \ProgName{tex}. + + \item[\LaTeX{} (executable: \ProgName{latex})] + See + \Qref[questions]{Books on \TeX{} and its relations}{Q-books}, + \Qref[]{\AllTeX{} Tutorials, etc.}{Q-tutorials*}, + \Qref[]{Online introductions: \LaTeX{}}{Q-man-latex}, + \Qref[]{Specialized \AllTeX{} tutorials}{Q-tutbitslatex} and + \Qref[]{Directories of \AllTeX{} information}{Q-doc-dirs}. + Note that there have been two major versions of \LaTeX{}: \LaTeXe{} + refers to the current version of \LaTeX{} while \LaTeXo{} is the + long-since-obsolete (since 1994) version (cf.~% + \Qref[question]{What is \LaTeXe{}?}{Q-latex2e} for more information). + + \item[\CONTeXT{} (executable: \ProgName{texexec})] + See + \Qref[question]{What is \CONTeXT{}?}{Q-context}. + + \item[Texinfo (executables: \ProgName{tex}, \ProgName{makeinfo})] + See + \Qref[question]{What is Texinfo?}{Q-texinfo}. \ProgName{makeinfo} + converts Texinfo documents to \acro{HTML}, DocBook, Emacs info, + \acro{XML}, and plain text. \ProgName{Tex} (or wrappers such as + \ProgName{texi2pdf} and \ProgName{texi2pdf}) produce one of \TeX{}'s + usual output formats such as \acro{DVI} or \acro{PDF}. Because + \ProgName{tex} loads the Plain \TeX{} macros, not the Texinfo ones, + a Texinfo document must begin with \cmdinvoke{input}{texinfo} to + explicitly load the Texinfo macro package. + + \item[\Eplain{}---Extended Plain \TeX{} (executable: \ProgName{eplain})] + See + \Qref[question]{What is \Eplain{}?}{Q-eplain}. +\end{description} + +\paragraph{Modified \ProgName{tex} executables} +The original \ProgName{tex} executable was produced in the late 1970s +(cf.~\Qref[question]{What is \TeX{}?}{Q-whatTeX}) and consequently +lacked some features that users have come to expect from today's +software. The following programs address these issues by augmenting +the \TeX{} engine with some additional useful features: + +\begin{description} + \item[\PDFTeX{} (executable: \ProgName{pdftex})] + \TeX{}, which predates the \acro{PDF} file format by a decade, + outputs files in a \TeX{}-specific format called \acro{DVI} + (cf.~\Qref[question]{What is a \acro{DVI} file?}{Q-dvi}). In + contrast, \PDFTeX{} can output both \acro{DVI} \emph{and} \acro{PDF} + files. In \acro{PDF} mode, it lets documents exploit various + \acro{PDF} features such as hyperlinks, bookmarks, and annotations, + \PDFTeX{} additionally supports two sophisticated micro-typographic + features: character protrusion and font expansion. See + \Qref[question]{What is \PDFTeX{}?}{Q-whatpdftex}. + + \item[\xetex{} (executable: \ProgName{xetex})] + \TeX{} not only predates all major font technologies in use today + (e.g.,~TrueType, OpenType, and PostScript Type~1) but also predates + the notion that fonts be included with an operating system. + Consequently, \TeX{} uses its own font formats, which are + incompatible with anything a user is likely to have preinstalled. + \xetex{} addresses this issue by enhancing \TeX{}'s \csx{font} + control sequence to support all of the fonts made available by the + operating system. See + \Qref[question]{What is \xetex{}?}{Q-xetex}. + + \item[\LuaTeX{} (executable: \ProgName{luatex})] + \TeX{} is programmed in its own, integrated, macro-based programming + language. Many users have criticized this language for being + needlessly difficult to program. \LuaTeX{} addresses that criticism + by integrating a modern scripting language, Lua, into the base + \TeX{} engine. See + \Qref[question]{What is \LuaTeX{}?}{Q-luatex}. + + \item[\eTeX{} (executable: \ProgName{etex})] + \eTeX{} provides a number of features that are only indirectly + useful to end users but that can be immensely useful to package + developers. Consequently, there is an increasing number of macro + packages that require the use of \eTeX{}. (Note: Be careful not to + confuse \eTeX{}, which enhances the \TeX{} engine, with \Eplain{}, + which enhances the Plain \TeX{} macro package.) See + \Qref[question]{What is \eTeX{}?}{Q-etex}. +\end{description} + +Because each of the above modifies only the base \TeX{} engine, it is +possible to combine any of those with any of the \TeX{} macro packages +listed earlier to produce executables with both sets of features. For +example, the \ProgName{pdflatex}, \ProgName{xelatex} and +\ProgName{lualatex} executables each combine +\LaTeX{} with an enhanced \TeX{} engine. Some executables combine the +features of multiple enhanced \TeX{} engine: \ProgName{pdfetex} +combines \PDFTeX{} and \eTeX{} into a single executable. + +As combining features is a generally desirable tendency, current +\TeX{} distributions (see below) incorporate the features of \PDFTeX{} +and \eTeX{} into a single executable. This executable may be +offered with a \LaTeX{} format (as \ProgName{latex} or +\ProgName{pdflatex}) or with a \plaintex{} format (as +\ProgName{pdftex}). (\ProgName{Tex} remains with an unadorned \TeX{} +executable using \plaintex{}, for people such as Knuth himself, who +want the certainty of the ``original''.) + + +\paragraph{\TeX{} distributions} +A \emph{\TeX{} distribution} is a collection of \TeX{}-related +software. Generally, a \TeX{} distribution includes a set of core +\TeX{} executables such as \ProgName{tex} and \ProgName{latex}; +various fonts optimized for use with \TeX{}; helper programs such as +the \BibTeX{} bibliographic-database formatter, editors, integrated +development environments, file-format-conversion programs; numerous +\LaTeX{} packages; configuration tools; and any other goodies the +distributor chooses to include. Commonly encountered \TeX{} +distributions include \texlive{}, \miktex{} and Mac\TeX{}; older ones +include oz\TeX{}, \acro{CM}ac\TeX{} and te\TeX{}. Some \TeX{} +distributions target a specific operating system and/or processor +architecture; others run on multiple platforms. Some \TeX{} +distributions are free; others require payment. See % ! line break +\Qref[question]{\AllTeX{} for different machines}{Q-TeXsystems} for a +list of free and shareware \TeX{} distributions and % ! line break +\Qref[question]{Commercial \TeX{} implementations}{Q-commercial} for a +list of commercial \TeX{} distributions. + + +\paragraph{Summary} +If your document begins with \csx{documentclass}, you're using some +form of the \LaTeX{} macro package. Even if hidden behind a button in +a \TeX{}-aware GUI, this document is getting compiled by a \TeX{} +executable---probably \ProgName{latex} or \ProgName{pdflatex}---to +produce an output file. The executable came bundled as part of a +\TeX{} distribution such as \miktex{}, which includes various other +\TeX{}-related components. +%**** + \Question[Q-triptrap]{How can I be sure it's really \TeX{}?} \TeX{} (and \MF{} and \MP{}) are written in a @@ -399,10 +576,17 @@ individually contributed) may require \eTeX{} for optimum performance. \Question[Q-whatpdftex]{What is \PDFTeX{}?} -\PDFTeX{} has entered the main stream of \TeX{} distributions: most -\LaTeX{} and \CONTeXT{} users nowadays use \PDFTeX{} whether they know -it or not (more precisely, they use an amalgam of \PDFTeX{} and -\Qref*{\eTeX{}}{Q-etex}). So what is \PDFTeX{}? +One can reasonably say that \PDFTeX{} is (today) the main stream of +\TeX{} distributions: most \LaTeX{} and \CONTeXT{} users nowadays use +\PDFTeX{} whether they know it or not (more precisely, they use +\PDFTeX{} extended by +\begin{wideversion} + \Qref*{\eTeX{}}{Q-etex}). +\end{wideversion} +\begin{narrowversion} + \eTeX{}~--- \Qref{}{Q-etex}). +\end{narrowversion} +So what is \PDFTeX{}? \PDFTeX{} is a development of \TeX{} that is capable of generating typeset \acro{PDF} output in place of \acro{DVI}. \PDFTeX{} has @@ -457,14 +641,20 @@ was superseded in 1994 by a new version (\LaTeXe{}) provided by \Qref*{the \LaTeX{} team}{Q-LaTeX3}. \LaTeXe{} is now the only readily-available version of \LaTeX{}, and draws together several threads of \LaTeX{} development -from the later days of \LaTeXo{}. +from the later days of \LaTeXo{}. The ``e'' of the name is (in the +% next (ghastly) line needed to maintain typesetting +\wideonly{\Qref{official logo}{Q-logos}}\narrowonly{official logo~--- \Qref{\relax}{Q-logos}}) +% the \relax allows sanitize to cope with the line. just don't ask... +a single-stroke epsilon +(\latexhtml{\ensuremath{\varepsilon}}{ε}, supposedly +indicative of no more than a small change. \LaTeXe{} has several enhancements over \LaTeXo{}, but they were all rather minor, with a view to continuity and stability rather than the ``big push'' that some had expected from the team. \LaTeXe{} continues to this day to offer a compatibility mode in which most files prepared for use with \LaTeXo{} will run (albeit with somewhat -reduced performance, and subject to bitter complaints in the log +reduced performance, and subject to voluminous complaints in the log file). Differences between \LaTeXe{} and \LaTeXo{} are outlined in a series of `guide' files that are available in every \LaTeX{} distribution (the same directory also contains ``news'' about @@ -473,20 +663,18 @@ each new release of \LaTeXe{}). \item[\nothtml{\rmfamily}\LaTeX{} guides and news]\CTANref{latexdoc} \end{ctanrefs} - -\nothtml{\begingroup\ifboldmathavail\boldmath\fi} \Question[Q-latexpronounce]{How should I pronounce ``\LaTeX{}(\twee{})''?} -\nothtml{\afterquestion} Lamport never recommended how one should pronounce \LaTeX{}, but a lot of people pronounce it `Lay \TeX{}' or perhaps `Lah \TeX{}' (with \TeX{} pronounced as the program itself; see \Qref[question]{the rules for TeX}{Q-TeXpronounce}). It is definitely -\emph{not} to be pronounced in the same way as the rubber-tree gum. +\emph{not} to be pronounced in the same way as the rubber-tree gum +(which would be `lay teks'). -The `epsilon' in `\LaTeXe{}' is supposed to be suggestive of a small -improvement over the old \LaTeXo{}. Nevertheless, most people -pronounce the name as `\LaTeX{}-two-ee'. +The \LaTeXe{} logo is supposed to end with an +\latexhtml{\ensuremath{\varepsilon}}{ε}; nevertheless, most +people pronounce the name as `\LaTeX{}-two-ee'. \Question[Q-plainvltx]{Should I use \plaintex{} or \LaTeX{}?} @@ -495,12 +683,13 @@ by \plaintex{}, and produce highly respectable documents using it (Knuth is an example of this, of course). But equally, many people are happy to let someone else take the design decisions for them, accepting a small loss of flexibility in exchange for a saving of -brain power. +(mental) effort. The arguments around this topic can provoke huge amounts of noise and -heat, without offering much by way of light; your best bet is to find -out what those around you are using, and to go with the crowd. Later -on, you can always switch your allegiance; don't bother about it. +heat, without offering much by way of light; your best bet may be to +find out what those around you are using, and to follow them in the +hope of some support. Later on, you can always switch your +allegiance; don't bother about it. If you are preparing a manuscript for a publisher or journal, ask them what markup they want before you @@ -583,9 +772,7 @@ prodigious energy. Support is available via a % ! line break \item[\nothtml{\rmfamily}\CONTeXT{} distribution]\CTANref{context} \end{ctanrefs} -\nothtml{\begingroup\ifboldmathavail\boldmath\fi} \Question[Q-AMSpkg]{What are the \acro{AMS} packages (\AMSTeX{}, \emph{etc}.)?} -\nothtml{\afterquestion} \AMSTeX{} is a \TeX{} macro package, originally written by Michael Spivak for the American Mathematical Society (\acro{AMS}) during 1983--1985 and @@ -599,14 +786,12 @@ numbering, ellipsis dots, matrices, double accents, multi-line subscripts, syntax checking (faster processing on initial error-checking \TeX{} runs), and other things. -As \LaTeX{} increased in popularity, authors asked to submit papers to -the \acro{AMS} in \LaTeX{}, and so the \acro{AMS} developed -\AMSLaTeX{}, which is a -collection of \LaTeX{} packages and classes that offer authors most of +As \LaTeX{} increased in popularity, authors sought to submit papers to +the \acro{AMS} in \LaTeX{}, so \AMSLaTeX{} was developed. \AMSLaTeX{} +is a collection of \LaTeX{} packages and classes that offer authors most of the functionality of \AMSTeX{}. The \acro{AMS} no longer recommends the use of \AMSTeX{}, and urges -its users to use \AMSLaTeX{} instead. -\checked{RAB}{1994/11/12} % edited by RF; input from Michael Downes, too +its authors to use \AMSLaTeX{} instead. \begin{ctanrefs} \item[\nothtml{\rmfamily}\AMSTeX{} distribution]\CTANref{amstex} \item[\nothtml{\rmfamily}\AMSLaTeX{} distribution]\CTANref{amslatex} @@ -617,9 +802,10 @@ its users to use \AMSLaTeX{} instead. The \href{http://tug.org/eplain}{\Eplain{}} macro package expands on and extends the definitions in \plaintex{}. \Eplain{} is not intended to provide ``generic typesetting -capabilities'', as do \LaTeX{} or \Qref*{Texinfo}{Q-texinfo}. Instead, it -defines macro tools that should be useful whatever commands you choose -to use when you prepare your manuscript. +capabilities'', as do \CONTeXT{}, \LaTeX{} or +\Qref*{Texinfo}{Q-texinfo}. Instead, it defines macro tools that +should be useful whatever commands you choose to use when you prepare +your manuscript. For example, \Eplain{} does not have a command \csx{section}, which would format section headings in an ``appropriate'' way, as @@ -632,9 +818,9 @@ of luck. On the other hand, almost everyone would like capabilities such as cross-referencing by labels, so that you don't have to put actual page -numbers in the manuscript. The authors of \Eplain{} are not aware of -any generally available macro packages that do not force their -typographic style on an author, and yet provide such capabilities. +numbers in the manuscript. The authors of \Eplain{} believe it is the +only generally available macro package that does not force its +typographic style on an author, and yet provides these such capabilities. Another useful feature of \Eplain{} is the ability to create PDF files with hyperlinks. The cross-referencing macros can implicitly generate @@ -757,16 +943,18 @@ he will continue to fix any bugs that are reported to him (though bugs are rare). This decision was made soon after \TeX{} version~3.0 was released; at each bug-fix release the version number acquires one more digit, so that it tends to the -limit~\ensuremath{\pi} (at the time of writing, Knuth's latest release is version -3.141592). Knuth wants \TeX{} to be frozen at version~\ensuremath{\pi} when he -dies; thereafter, no further changes may be made to Knuth's source. -(A similar rule is applied to \MF{}; its version number tends to the -limit~\ensuremath{e}, and currently stands at 2.71828.) +limit~\ensuremath{\pi} (at the time of writing, Knuth's latest release +is version 3.1415926). Knuth wants \TeX{} to be frozen at +version~\ensuremath{\pi} when he dies; thereafter, no further changes +may be made to Knuth's source. (A similar rule is applied to \MF{}; +its version number tends to the limit~\ensuremath{e}, and currently +stands at 2.718281.) Knuth explains his decision, and exhorts us all to respect it, in a -paper originally published in \TUGboat{} 11(4) (and reprinted in the -% ! line break -\href{http://www.ntg.nl/maps/pdf/5_34.pdf}{NTG journal MAPS}). +paper originally published in % ! line break +\href{http://tug.org/TUGboat/Articles/tb11-4/tb30knut.pdf}{\TUGboat{} 11(4)}, +and reprinted in the % ! line break +\href{http://www.ntg.nl/maps/pdf/5_34.pdf}{NTG journal MAPS}. There are projects (some of them long-term projects: see, for example, @@ -976,7 +1164,9 @@ other books covering \TeX{}: Krantz (CRC Press, 1994, \ISBN{0-849-37159-7}) \item[\TeX{} by Topic]by Victor Eijkhout (Addison-Wesley, 1992, \ISBN{0-201-56882-9}~--- now out of print, but see - \Qref[question]{online books}{Q-ol-books}) + \Qref[question]{online books}{Q-ol-books}; you can now buy a copy + printed, on demand, by Lulu~--- see + \url{http://www.lulu.com/content/2555607}) \item[\TeX{} for the Beginner]by Wynter Snow (Addison-Wesley, 1992, \ISBN{0-201-54799-6}) \item[\TeX{} for the Impatient]by Paul W.~Abrahams, Karl Berry and @@ -1208,13 +1398,14 @@ Other non-English \acro{FAQ}s are available (off-\acro{CTAN}): \item[German]Posted regularly to \Newsgroup{de.comp.tex}, and archived on \acro{CTAN}; the \acro{FAQ} also appears at \URL{http://www.dante.de/faq/de-tex-faq/} -\item[French]An interactive (full-screen!) FAQ may be found at - \URL{http://www.frenchpro6.com/screen.pdf/FAQscreen.pdf}, and a copy - for printing at \URL{http://frenchle.free.fr/FAQ.pdf}; +\item[French]% +%% An interactive (full-screen!) FAQ may be found at +%% \URL{http://www.frenchpro6.com/screen.pdf/FAQscreen.pdf}, and a copy +%% for printing at \URL{http://frenchle.free.fr/FAQ.pdf}; A FAQ used to be posted regularly to \Newsgroup{fr.comp.text.tex}, and is archived on \acro{CTAN}~--- sadly, that effort seems to have fallen by the wayside. -\item[Spanish]See \URL{http://apolo.us.es/CervanTeX/FAQ/} +%% \item[Spanish]See \URL{http://apolo.us.es/CervanTeX/FAQ/} \item[Czech]See \URL{http://www.fi.muni.cz/cstug/csfaq/} \end{booklist} @@ -1238,8 +1429,8 @@ don't know what to do. If you are seeking a particular package or program, look on your own system first: you might already have it~--- the better \TeX{} distributions contain a wide range of supporting material. The -\acro{CTAN} Catalogue can also help: you can -\href{http://www.tex.ac.uk/search}{search it}, or you can browse it +\acro{CTAN} Catalogue can also identify packages that might help: you +can \href{http://www.tex.ac.uk/search}{search it}, or you can browse it % !!!! line break ``\href{http://www.tex.ac.uk/tex-archive/help/Catalogue/bytopic.html}{by topic}''. A catalogue entry has a brief description of the package, and links to @@ -1359,6 +1550,12 @@ application of your own common sense. needs your local \Class{xyzthesis} class, or some other resource not generally available, be sure to include a pointer to how the resource can be obtained. +\item Figures are special, of course. Sometimes the figure itself is + \emph{really} needed, but most problems may be demonstrated with a + ``figure substitute'' in the form of a + \cmdinvoke*{rule}{width}{height} command, for some value of + \meta{width} and \meta{height}. If the (real) figure is needed, + don't try posting it: far better to put it on the web somewhere. \item Be as succinct as possible. Your helpers don't usually need to know \emph{why} you're doing something, just \emph{what} you're doing and where the problem is. @@ -1490,12 +1687,17 @@ available on the web at \URL{http://www.ntg.nl/doc/wilkins/pllong.pdf} \Question[Q-man-latex]{Online introductions: \LaTeX{}} +A pleasing little document, ``Getting something out of \LaTeX{}'' is +designed to give a feel of \LaTeX{} to someone who's never used it at +all. It's not a tutorial, merely helps the user to decide whether to +go on to a tutorial, and to `real' use of \LaTeX{}. + Tobias Oetiker's `(Not so) Short Introduction to \LaTeXe{}', is regularly updated, as people suggest better ways of explaining things, etc. The introduction is available on \acro{CTAN}, together with translations into a rather large set of languages. -Peter Flynn's ``Beginner's \LaTeX{}'' (which also started as course +Peter Flynn's ``Beginner's \LaTeX{}'' (which started life as course material) is a pleasing read. A complete copy may be found on \acro{CTAN}, but it may also be browsed over the web (\URL{http://www.tex.ac.uk/tex-archive/info/beginlatex/html/}). @@ -1543,6 +1745,7 @@ tutorial is available from \acro{CTAN} as a \acro{PDF} file (though the source is also available). \begin{ctanrefs} \item[\nothtml{\rmfamily}Beginner's \LaTeX{}]\CTANref{beginlatex-pdf} +\item[\nothtml{\rmfamily}First \LaTeX{} document]\CTANref{first-latex-doc} \item[\nothtml{\rmfamily}Not so Short Introduction]\CTANref{lshort} (in English, you may browse for sources and other language versions at \CTANref{lshort-parent}) @@ -1559,8 +1762,9 @@ The \acro{AMS} publishes a ``Short Math Guide for \LaTeX{}'', which is available (in several formats) via \URL{http://www.ams.org/tex/short-math-guide.html} -Herbert Vo\ss{} is developing a parallel document, that is also very -useful; it's part of his ``\Qref*{tips and tricks}{Q-doc-dirs}'' and +Herbert Vo\ss{} has written an extensive guide to mathematics in +\LaTeX{} (a German version of which is published as a book). The +guide is part of his ``\Qref*{tips and tricks}{Q-doc-dirs}'' and a copy is maintained on \acro{CTAN}. %\URL{http://www.perce.de/LaTeX/math/Mathmode-TeX.pdf} @@ -1594,7 +1798,7 @@ soon''). Kjell Magne Fauske offers a set of examples of the use of the drawing packages % ! line break \Qref*{\acro{PGF} and \acro{T}ik\acro{Z}}{Q-drawing}; the % ! line break -\href{http://www.fauskes.net/pgftikzexamples/}{examples catalogue} +\href{http://www.texample.net/tikz/examples/}{examples catalogue} includes examples (with output) from the package documentation as well as code written by the author himself. @@ -1677,14 +1881,26 @@ description, which includes page references to the \TeX{}book. There doesn't seem to be a reference that takes in \plaintex{} as well as the primitive commands. +An interesting \LaTeX{} ``cheat sheet'' is available from \acro{CTAN}: +it's a list of (more or less) everything you `ought to' remember, for +basic \LaTeX{} use. (It's laid out very compactly for printing on N.\ +American `letter'; printed on \acro{ISO} \acro{A}4, it strains aged eyes\dots{}) + Similarly, there's no completely reliable command-organised reference -to \LaTeX{}, but the NASA % ! line break +to \LaTeX{}. The page (provided by NASA) % ! line break \href{http://www.giss.nasa.gov/latex/}{Hypertext Help with LaTeX} is recently much improved. It still talks in \LaTeXo{}-isms in places, -but it's been updated for current \LaTeX{}; there are a number of +but it's been updated for current \LaTeX{}. There are a number of mirrors of the site, and it may be worth choosing a ``local'' one if you're going to use it a lot. +Another \LaTeXe{} reference (provided by the Emerson Center of Emory +University) is: % ! line break +\href{http://www.emerson.emory.edu/services/latex/latex2e/latex2e_toc.html}{LaTeXe help} +\begin{ctanrefs} +\item[\nothtml{\rmfamily}Cheat sheet]\CTANref{latexcheat} +\end{ctanrefs} + \Question[Q-doc-wiki]{WIKI pages for \TeX{} and friends} The \emph{WIKI} concept can be a boon to everyone, if used sensibly. @@ -1694,18 +1910,20 @@ for chaos, there is evidence that a strong user community can keep a WIKI under control. Following the encouraging performance of the % ! line break -\href{http://contextgarden.net/}{\CONTeXT{} WIKI}, both a -\href{http://en.wikibooks.org/wiki/TeX}{(Plain) \TeX{} WIKI} and a -\href{http://en.wikibooks.org/wiki/LaTeX}{\LaTeX{} WIKI} have been -established. Both seem rather sparse, as yet, and the \LaTeX{} WIKI -contains some suggestions that go counter to established advice (e.g., -the \LaTeX{} WIKI has details on the % ! line break -\Qref*{use of the \environment{eqnarray} environment}{Q-eqnarray}); -however one may hope that both will become useful resources in the -longer term. +\href{http://contextgarden.net/}{\CONTeXT{} WIKI}, valiant efforts +have been made generating ``WIKI books'' for \AllTeX{} users. Thus we +have \href{http://en.wikibooks.org/wiki/TeX}{(Plain) \TeX{} WIKI} and +\href{http://en.wikibooks.org/wiki/LaTeX}{\LaTeX{} WIKI} are well +established. Neither would seem yet to be of publication quality, but +they both seem useful reference sources. \Question[Q-typo-style]{Typography tutorials} +Peter Wilson's manual for his \Class{memoir} class has a lengthy +introductory section on typographic considerations, which is a fine +tutorial, written by someone who is aware of the issues as they apply +to \AllTeX{} users. + There's also (at least one) typographic style tutorial available on the Web, the excellent % ! line break ``\href*{http://www.nbcs.rutgers.edu/~hedrick/typography/typography.janson-syntax.107514.pdf}{Guidelines for Typography in NBCS}''. @@ -1718,11 +1936,6 @@ ambition to supplant such excellent books as \Qref*{Bringhurst's}{Q-typebooks}, but the document (though it does contain its Rutgers-local matter) is a fine introduction to the issues of producing readable documents. - -Peter Wilson's manual for his \Class{memoir} class has a lengthy -introductory section on typographic considerations, which is a fine -tutorial, written by someone who is aware of the issues as they apply -to \AllTeX{} users. \begin{ctanrefs} \item[memoir \nothtml{\rmfamily}distribution]\CTANref{memoir} \end{ctanrefs} @@ -1746,7 +1959,10 @@ the web, and until relatively recently this demand went un-answered. The first to appear was Victor Eijkhout's excellent ``\TeX{} by Topic'' in 2001 (it had been published by Addison-Wesley, but was long out of print). The book is now available on \acro{CTAN}; it's not a -beginner's tutorial but it's a fine reference. +beginner's tutorial but it's a fine reference. It's also available, +as a printed copy, via the on-line publishers +\href{http://www.lulu.com/content/2555607/}{Lulu} (not quite free, of +course, but not a \emph{bad} deal\dots{}). Addison-Wesley have also released the copyright of ``\TeX{} for the Impatient'' by Paul W.~Abrahams, Karl Berry and Kathryn A.~Hargreaves, @@ -1784,9 +2000,9 @@ distributions, the \ProgName{texdoc} command often helps, as in: texdoc footmisc \end{verbatim} \end{quote} -which opens a \acro{DVI} viewer window showing documentation of the +which opens a window showing documentation of the \Package{footmisc} package. According to the type of file -\ProgName{texdoc} finds, it will launch a \acro{DVI} or \PS{} viewer +\ProgName{texdoc} finds, it will launch a \acro{DVI} viewer or a \acro{PDF} reader. If \ProgName{texdoc} can't find any documentation, it may launch a Web @@ -1862,9 +2078,12 @@ knowledge it is possible to use the documented source of \LaTeX{} as reference material (dedicated authors will acquaint themselves with the source as a matter of course). A complete set of the documented source of \LaTeX{} may be prepared by processing the file -\File{source2e.tex} in the \LaTeX{} distribution, but individual files -in the distribution may be processed separately with \LaTeX{}, like -any well-constructed \Qref*{\extension{dtx} file}{Q-dtx}. +\File{source2e.tex} in the \LaTeX{} distribution. Such processing is +noticeably tedious, but Heiko Oberdiek has prepared a well-linked +\acro{PDF} version, which is in the file \File{base.tds.zip} of his +\ProgName{latex-tds} distribution. Individual files in the \LaTeX{} +distribution may be processed separately with \LaTeX{}, like any +well-constructed \Qref*{\extension{dtx} file}{Q-dtx}. Writing good classes is not easy; it's a good idea to read some established ones (\File{classes.dtx}, for example, is the documented @@ -1882,6 +2101,7 @@ understanding \File{classes.dtx} \begin{ctanrefs} \item[classes.dtx]\CTANref{latex-classes} \item[clsguide.pdf]\CTANref{clsguide} +\item[latex-tds \nothtml{rmfamily}collection]\CTANref{latex-tds} \item[ltxguide.cls]\CTANref{ltxguide} \item[\nothtml{\rmfamily}\LaTeX{} documentation]\CTANref{latexdoc} \item[source2e.tex]\CTANref{latex-source} @@ -1934,7 +2154,6 @@ written more as a document, and presented in \acro{PDF}. \begin{ctanrefs} \item[\nothtml{\rmfamily}Beginners' guide]\CTANref{mf-beginners} \item[\nothtml{\rmfamily}Peter Wilson's ``experiences'']\CTANref{metafp-pdf} - (\acro{PDF} format) \item[\nothtml{\rmfamily}Vincent Zoonekynd's examples]\CTANref{zoon-mp-eg} \end{ctanrefs} @@ -1964,8 +2183,6 @@ may also be found on \acro{CTAN}. A summary and \acro{FAQ} recommended. \begin{ctanrefs} \item[\nothtml{\rmfamily}\BibTeX{} documentation]\CTANref{bibtex-doc} -\item[\nothtml{\rmfamily}\BibTeX{} documentation, in \acro{PDF}]% - \CTANref{bibtex-doc-pdf} \item[btxFAQ.pdf]\CTANref{bibtex-faq} \item[\nothtml{\rmfamily}Tame the BeaST]\CTANref{ttb-pdf} \end{ctanrefs} @@ -1980,7 +2197,7 @@ of which are not shown (or even mentioned) in \AllTeX{} books. \emph{The Comprehensive \LaTeX{} Symbol List} (by Scott Pakin % beware line wrap \emph{et al.}\@) illustrates over 2000 symbols, and details the -commands and packages needed to produce them. +commands and the \LaTeX{} packages needed to produce them. Other questions in this \acro{FAQ} offer specific help on kinds of symbols: @@ -2164,6 +2381,71 @@ fonts (it uses \TeX{} to parse a description of the virtual font, and \item[qdtexvpl]\CTANref{qdtexvpl} \end{ctanrefs} +\Question[Q-whatmacros]{What are (\TeX{}) macros} + +\TeX{} is a \emph{macro processor}: this is a computer-science-y term +meaning ``text expander'' (more or less); \TeX{} typesets text as it +goes along, but \emph{expands} each macro it finds. \TeX{}'s macros +may include instructions to \TeX{} itself, on top of the simple text +generation one might expect. + +Macros are a \emph{good thing}, since they allow the user to +manipulate documents according to context. For example, the macro +\csx{TeX} is usually defined to produce ``TEX'' with the `E' lowered, +but in these \acro{FAQ}s the default definition of the macro is +overridden, and it simply expands to the letters ``TeX''. (\emph{You} +may not think this a good thing, but the author of the macros has his +reasons~-- see \Qref[question]{\TeX{}-related logos}{Q-logos}.) + +Macro names are conventionally built from a \texttt{\textbackslash } +followed by a sequence of letters, which may be upper or lower case +(as in \csx{TeX}, mentioned above). They may also be % ! line break +\texttt{\textbackslash \meta{any single character}}, which allows all +sorts of oddities (many built in to most \TeX{} macro sets, all the +way up from the apparently simple `\csx{ }' meaning ``insert a space +here''). + +Macro programming can be a complicated business, but at their very +simplest they need little introduction~--- you'll hardly need to be +told that: +\begin{quote} +\begin{verbatim} +\def\foo{bar} +\end{verbatim} +\end{quote} +replaces each instance of \csx{foo} with the text ``bar''. The +command \csx{def} is \plaintex{} syntax for defining commands; +\LaTeX{} offers a macro \csx{newcommand} that goes some way towards +protecting users from themselves, but basically does the same thing: +\begin{quote} +\begin{verbatim} +\newcommand{\foo}{bar} +\end{verbatim} +\end{quote} +Macros may have ``arguments'', which are used to substitute for marked +bits of the macro expansion: +\begin{quote} +\begin{verbatim} +\def\foo#1{This is a #1 bar} +... +\foo{2/4} +\end{verbatim} +\end{quote} +or, in \LaTeX{} speak: +\begin{quote} +\begin{verbatim} +\newcommand{\foo}[1]{This is a #1 bar} +... +\foo{3/4} +\end{verbatim} +\end{quote} +Macro writing can get very complicated, very quickly. If you are a +beginner \AllTeX{} programmer, you are well advised to read something +along the lines of the \Qref*{\TeX{}book}{Q-books}; once you're under +way, \Qref*{\TeX{} by Topic}{Q-ol-books} is possibly a more satisfactory +choice. Rather a lot of the answers in these \acro{FAQ}s tell you +about various issues of how to write macros. + \Question[Q-specials]{\csx{special} commands} \TeX{} provides the means to express things that device drivers can @@ -2213,8 +2495,10 @@ to a single language at a single locale needs to be able to change its hyphenation rules from time to time. \TeX{} uses a pretty good system for hyphenation (originally designed -by Frank Liang), and while it's capable of missing ``sensible'' -hyphenation points, it seldom selects grossly wrong ones. The +by Frank Liang~--- you may view his % ! line break +\href{http://tug.org/docs/liang/}{Ph.D.\ thesis online}), and while +it's capable of missing ``sensible'' hyphenation points, it seldom +selects grossly wrong ones. The algorithm matches candidates for hyphenation against a set of ``hyphenation patterns''. The candidates for hyphenation must be sequences of letters (or other single characters that \TeX{} may be @@ -2526,10 +2810,10 @@ available on \acro{CTAN}. \item[\nothtml{\rmfamily}\acro{TDS} specification]\CTANref{tds} \end{ctanrefs} -\Question[Q-eps]{What is ``Encapsulated \PS{}'' (``\acro{EPS}'')} +\Question[Q-eps]{What is ``Encapsulated \PS{}'' (``\acro{EPS}'')?} \PS{} has been for many years a \emph{lingua franca} of powerful -printers (modern high-quality printers now tend to require some +printers (though modern high-quality printers now tend to require some constrained form of Adobe Acrobat, instead); since \PS{} is also a powerful graphical programming language, it is commonly used as an output medium for drawing (and other) packages. @@ -2617,7 +2901,7 @@ change colour within a Type~1 font glyph, but there's no such restriction on a Type~3 font, which opens opportunities for some startling effects. -\Question[Q-resolns]{What are ``resolutions''} +\Question[Q-resolns]{What are ``resolutions''?} ``Resolution'' is a word that is used with little concern for its multiple meanings, in computer equipment marketing. The word suggests @@ -2671,7 +2955,7 @@ One commonly-used approach is to declare a resolution of 8000 (``better than any device''), and this is reasonably successful though it does have its \Qref*{problems}{Q-8000}. -\Question[Q-fontname]{What is the ``Berry naming scheme''} +\Question[Q-fontname]{What is the ``Berry naming scheme''?} In the olden days, \AllTeX{} distributions were limited by the feebleness of file systems' ability to represent long names. (The @@ -2757,8 +3041,9 @@ 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~--- note that the -\File{tex-archive} part of the \acro{CTAN} path isn't needed. +connect you to the \Package{footmisc} directory at some \acro{CTAN} +site~--- note that the \File{tex-archive} part of the \acro{CTAN} path +isn't needed. For details of how to find files at \acro{CTAN} sites, see ``\Qref*{finding \AllTeX{} files}{Q-findfiles}''. @@ -2767,25 +3052,31 @@ 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}. -\Question[Q-tds-zip]{Prebuilt installation files on the archive} +\Question[Q-tds-zip]{Ready-built installation files on the archive} The \Qref*{\acro{TDS}}{Q-tds} is a simple structure, and almost all files can be installed simply by putting them in the ``right'' place, and updating a single index. (Note, this simple idea typically doesn't work for fonts, unless they're distributed as \MF{} source.) -The CTAN network is therefore acquiring ``\acro{TDS-ZIP}'' files, +The CTAN network is therefore acquiring ``\acro{TDS}-\acro{ZIP}'' files, which have a built-in directory structure that matches the \acro{TDS}. These files have to be built, and the \acro{CTAN} team has asked that package authors supply them (the team will advise, of course, if the -author has trouble). Everyone hopes that the extra work involved will -contrinute to happier lives for package users, which in turn must -surely help keep the TeX community lively and active. +author has trouble). The \acro{CTAN} team hopes that the extra work +involved will contribute to happier lives for package users, which in +turn must surely help keep the TeX community lively and active. + +At the time of writing, there are rather few \extension{tds.zip} +files (by comparison with the huge number of packages that are +available). As packages are updated, the number of files is +steadily increasing, but it will be a long time before the whole set +is covered. Use of the files is discussed in % ! line break -``\Qref*{installing using preformatted \acro{ZIP} files}{Q-inst-tds-zip}''. +``\Qref*{installing using ready-built \acro{ZIP} files}{Q-inst-tds-zip}''. -\Question[Q-nonfree]{What's the \acro{CTAN} \texttt{nonfree} tree?} +\Question[Q-nonfree]{What is the \acro{CTAN} \texttt{nonfree} tree?} When \acro{CTAN} was founded, in the 1990s, it was unusual to publish the terms under which a \TeX{}-related package was distributed (or, at @@ -2806,7 +3097,7 @@ From the start, the \texttt{nonfree} tree was controversial: the terms under which a package would be placed on the tree were hotly contested, and the \acro{CTAN} team were only able slowly to populate the tree. It is now obvious to the team that the project would never -be completed. +have been completed. The \acro{CTAN} catalogue now records the nature of the licences of a good proportion of the packages it describes (though there remain @@ -2819,44 +3110,24 @@ the general rule for distributors has become whether you should distribute; if the package is not listed in the catalogue, don't think of distributing it''. \end{quote} - (The catalogue only has a modest % ! line break \CTANhref{cat-licences}{list of licences}, but it covers the set used by packages on \acro{CTAN}, with a wild-card ``\texttt{other-free}'' which covers packages that the \acro{CTAN} administrators believe to be free even though the authors haven't used a standard licence.) +There is a corollary to the `general rule': if you notice something +that ought to be in the distributions, for which there is no catalogue +entry, please let the \acro{CTAN} team (\mailto{ctan@dante.de}) know. +It may well be that the package has simply been missed, but some aren't +catalogued because there's no documentation and the team just doesn't +understand the package. + In the light of the above, the \texttt{nonfree} tree is being -dismantled, and its contents moved to the main \acro{CTAN} tree. So -the answer to the question is, now, ``the nonfree tree is a part of -\acro{CTAN}, and is now being merged with the main tree''. - - -% The \acro{CTAN} archives are currently restructuring their holdings -% so that files that are `not free' are held in a separate tree. The -% definition of what is `free' (for this purpose) is influenced by, but -% not exactly the same as the -% \begin{narrowversion} % really non-hyper version -% Debian Free Software Guidelines (\acro{DFSG}: see -% \URL{http://www.debian.org/social_contract#guidelines}). -% \end{narrowversion} -% \begin{wideversion} -% % don't let the line wrap... -% \href{http://www.debian.org/social_contract#guidelines}{Debian Free Software Guidelines (\acro{DFSG})}. -% \end{wideversion} - -% Material is placed on the \texttt{nonfree} tree if it is not -% freely-usable (e.g., if the material is shareware, commercial, or if -% its usage is not permitted in certain domains at all, or without -% payment). Users of the archive should check that they are entitled to -% use material they have retrieved from the \texttt{nonfree} tree. - -% The Catalogue (one of the prime sources for finding \TeX{}-related -% material via \nothtml{web search~--- }% -% \Qref{web search}{Q-findfiles}) lists the licence details in each -% entry in its lists. -% For details of the licence categories, see its % !line break -% \href{http://www.tex.ac.uk/tex-archive/help/Catalogue/licenses.html}{list of licences}. +dismantled, and its contents moved (or moved \emph{back}) to the main +\acro{CTAN} tree. So the answer to the question is, now, ``the +nonfree tree is a part of \acro{CTAN}, and is now being merged with +the main tree''. \Question[Q-uploads]{Contributing a file to the archives} @@ -3089,13 +3360,19 @@ see \Qref{}{Q-commercial} for details of commercial packages. \Qref*{\TeX{} collection}{Q-CD}. Members of many \TeX{} user groups receive copies of the collection - (on \acro{CD} and \acro{DVD}), as part of their membership of the - groups. + (on \acro{DVD}), as part of their membership of the groups. MacOS/X is also a Unix-based system; however users should refer to the information below, under item ``Mac''. + + \texlive{} may also be installed ``over the network''; a network + installer is provided, and once you have a system, a manager + (\ProgName{tlmgr}) can both keep your installation up-to-date and + add packages you didn't install at first. + \begin{ctanrefs} \item[texlive]Browse \CTANref{texlive} + \item[texlive installer (Unix)]\CTANref{texlive-unix} \end{ctanrefs} \item[Linux] GNU/Linux users are supported by \texlive{} (as noted above). @@ -3106,19 +3383,37 @@ see \Qref{}{Q-commercial} for details of commercial packages. production of \acro{PDF} from \AllTeX{} input. Sadly, it's no longer supported, and the ready-built images are made for use with a rather ancient Linux kernel. + + For the future, the \miktex{} developer intends to release a version + of that excellent (Windows) system for use on Linux; a beta version + is available via \href{http://miktex.org/unx/}{the \miktex{} site}. \begin{ctanrefs} \item[texlive]Browse \CTANref{texlive} \item[vtex]\CTANref{vtex-linux} \item[vtex \nothtml{\rmfamily}required common files]\CTANref{vtex-common} \end{ctanrefs} -\item[\acro{PC}: Windows post-95] +\item[\acro{PC}: Windows] \miktex{}, by Christian Schenk, is a comprehensive distribution. It has its own previewer, \acro{YAP}, which is itself capable of printing, though the distribution also includes a port of \ProgName{dvips}. The current version is available for file-by-file download (the - \acro{HTML} files in the directory offer hints - on what you need to get going). The \miktex{} developers provide a - ready-to-run copy of the distribution, on \acro{CD} (for purchase) via the + \acro{HTML} files in the directory offer hints on what you need to + get going). \miktex{} can automatically install packages that it + ``knows about'', but that aren't in your system (it gets them over + the network). Furthermore, users may keep their installation + up-to-date, over the network: the distribution contains a ``package + manager'', through which the user may select individual packages, or + request that every extant update be retrieved. + + \miktex{} may also be used in a configuration which involves no + installation at all: its ``portable'' distribution may be unpacked + on a memory stick, and used on any windows computer without making + any direct use of the hard drive. This is the first ``official'' + release of such a setup, though a similar object has been available + on the net for some time. + + The \miktex{} developers also provide a ready-to-run copy of the + distribution, on \acro{CD} (for purchase) via the % ! line break \href{http://www.miktex.org/cd/}{\miktex{} web site}; otherwise the \File{setup} executable is available on \acro{CTAN}, together with all the optional packages. @@ -3132,8 +3427,8 @@ see \Qref{}{Q-commercial} for details of commercial packages. Windows users are also supported directly by the \texlive{} distribution; a system is provided on the installation disc of the - \TeX{} collection (and it can, with some difficulty, be run ``from - the disc'' without installing \emph{anything}). + \TeX{} collection. The system may also be installed over the + network, using an installer application tailored for use with Windows. \href{http://foundry.supelec.fr/projects/xemtex/}{XEm\TeX{}}, by Fabrice Popineau (he who created the excellent, but now defunct, @@ -3174,9 +3469,11 @@ see \Qref{}{Q-commercial} for details of commercial packages. \item[miktex]Acquire \CTANref{miktex-setup} (also available from the \miktex{} web site), and read installation instructions from % % ! line break - \href{http://www.miktex.org/2.5/Setup.aspx}{the \miktex{} installation page} + \href{http://www.miktex.org/2.7/setup}{the \miktex{} installation page} + \item[\nothtml{\bgroup\rmfamily}Portable\nothtml{\egroup} miktex]\CTANref{miktex-portable} \item[protext.exe]\CTANref{protext} - \item[tetex]\CTANref{tetex} + \item[texlive]Browse \CTANref{texlive} + \item[texlive installer (Windows)]\CTANref{texlive-windows} \end{ctanrefs} \item[\acro{PC}: \MSDOS{} or \acro{OS/}2] Em\TeX{}, by Eberhard Mattes, includes \LaTeX{}, \BibTeX{}, previewers, and drivers, and is @@ -3303,20 +3600,21 @@ There are good \TeX{}-writing environments and editors for most operating systems; some are described below, but this is only a personal selection: \begin{description} -\item[Unix] Try +\item[Unix] The commonest choices are \ProgName{[X]Emacs} or + \ProgName{vim}, though several others are available. + \href{http://www.gnu.org/software/emacs/emacs.html}{\acro{GNU}\nobreakspace\ProgName{emacs}} - or \href{http://www.xemacs.org/}{\ProgName{XEmacs}}, and - the \acro{AUC}-\TeX{} + and \href{http://www.xemacs.org/}{\ProgName{XEmacs}} are supported + by the \acro{AUC}-\TeX{} bundle (available from \acro{CTAN}). \acro{AUC}-\TeX{} provides menu items and control sequences for common constructs, checks syntax, lays out markup nicely, lets you call \TeX{} and drivers from within the editor, and everything else like this that you can think of. Complex, but very powerful. - Many who consider the versions of \ProgName{emacs} spawn of the devil, prefer - \href{http://vim.sourceforge.net}{\ProgName{vim}}, a highly configurable - editor (also available for Windows and Macintosh systems). Many - plugins are available to support the needs of the \AllTeX{} user, + \href{http://vim.sourceforge.net}{\ProgName{Vim}} is also highly + configurable (also available for Windows and Macintosh systems). + Many plugins are available to support the needs of the \AllTeX{} user, including syntax highlighting, calling \TeX{} programs, auto-insertion and -completion of common \AllTeX{} structures, and browsing \LaTeX{} help. The scripts \File{auctex.vim} and @@ -3371,13 +3669,20 @@ personal selection: works with MacOS~X. For MacOS~X users, the free tool of choice appears to be - \href{http://www.uoregon.edu/~koch/texshop/texshop.html}{TeXShop}, which + \href{http://www.uoregon.edu/~koch/texshop/texshop.html}{\texshop{}}, which combines an editor and a shell with a coherent philosophy of dealing with \AllTeX{} in the OS~X environment. TeXShop is distributed as part of the MacTeX system, and will therefore be available out of the box on machines on which MacTeX has been installed. \ProgName{Vim} is also available for use on Macintosh systems. +\item[Wildcard] \acro{TUG} is sponsoring the development of a + cross-platform editor and shell, modelled on the excellent + \texshop{} for the Macintosh. While this program, + \href{http://www.tug.org/texworks/}{\texworks{}}, is still under + development, it is already quite usable: if you're looking for a + \AllTeX{} development environment, and are willing to step beyond + the boundaries, it may be for you. \end{description} Atari, Amiga and \acro{N}e\acro{XT} users also have nice environments. \LaTeX{} users looking for \ProgName{make}-like @@ -3508,7 +3813,7 @@ also have email, and normal telephone and fax support. Source: Mail from Christopher Mabb, August 2007 \item[Macintosh; Textures] ``A \TeX{} system `for the rest of us'\,''. A beta release of Textures for MacOS/X is - available \URL{http://www.bluesky.com/news/220b.html} + available~--- see \URL{http://www.bluesky.com/news/news_frames.html} (Blue Sky also gives away a \MF{} implementation and some font manipulation tools for Macs.) @@ -3653,9 +3958,10 @@ source~--- not everything that you can write in \AllTeX{} can be translated to \acro{HTML} (at least, portable \acro{HTML} that may be viewed in `most' browsers), so the commonest avoiding action is to generate a bitmap of the missing bit. Examples are maths (a maths -extension to the |*|\acro{ML} family is available but not widely -used), and `exotic' typescripts (ones that you cannot guarantee your -readers will have available). Other common examples are generation of +extension to the `|*|\acro{ML}' family is available but not +universally supported by browsers), and `exotic' typescripts (ones +that you cannot guarantee your readers will have available). Other +common examples are generation of sample bitmaps, and generation for insertion into some other application's display~--- to insert equations into Microsoft PowerPoint, or to support the enhanced-\ProgName{emacs} setup called @@ -3691,21 +3997,30 @@ for speed. \section{Support Packages for \TeX{}} -\Question[Q-fig]{Fig, a \AllTeX{}-friendly drawing package} +\Question[Q-figetc]{\AllTeX{}-friendly drawing packages} +\AliasQuestion{Q-xfig} \ProgName{(X)Fig} is a menu driven tool that allows you to draw objects on the screen of an \acro{X} workstation; \ProgName{transfig} is a set of tools which translate the code \ProgName{fig}. The list of export formats is very long, and includes \MF{} and \MP{}, Encapsulated \PS{} and \acro{PDF}, as well as combinations that wrap -a graphics format in a \LaTeX{} import file. +a graphics format in a \LaTeX{} import file, which may include +\LaTeX{} commands to place text (compiled by \LaTeX{} itself) as +labels, etc., in the figures. There's no explicit port of \ProgName{xfig} to windows (although it is believed to work under \ProgName{cygwin} with their X-windows system). However, the program % ! line break \href{http://tech-www.informatik.uni-hamburg.de/applets/javafig/}{\ProgName{jfig}} is thought by many to be an acceptable substitute, written in Java. + +\ProgName{Asymptote} is a widely-praised development of the \MP{} +language, which can draw 2D or 3D diagrams, and can also label +diagrams with \LaTeX{} text; copious documentation is available via +\href{http://asymptote.sourceforge.net}{\ProgName{asymptote}'s web site}. \begin{ctanrefs} +\item[asymptote]\CTANref{asymptote} \item[xfig]\CTANref{xfig} \item[transfig]\CTANref{transfig} \end{ctanrefs} @@ -3799,15 +4114,27 @@ easily configured (see documentation inside the script). \ProgName{Winedt} (see \Qref[question]{editors and shells}{Q-editors}) provides this functionality direct in the Windows environment. -Simply stripping \AllTeX{} markup isn't entirely reliable, however: -that markup itself may contribute typeset words, and this could be a -problem. The \Package{wordcount} package +\ProgName{TeXcount} also goes a long way with heuristics for counting, +starting from a \LaTeX{} file; the documentation is comprehensive, and +you may try the script on-line via the % ! line break +\begin{wideversion} + \href{http://folk.uio.no/einarro/Comp/texwordcount.html}{package home page}. +\end{wideversion} +\begin{narrowversion} + package home page~(see + \URL{http://folk.uio.no/einarro/Comp/texwordcount.html}). +\end{narrowversion} +Even quite sophisticated stripping of \AllTeX{} markup can never be +entirely reliable, however: that markup itself may contribute typeset +words, and this could be a problem. The \Package{wordcount} package contains a Bourne shell (i.e., typically Unix) script for running a \LaTeX{} file with a special piece of supporting \TeX{} code, and then counting word indications in the log file. This is probably as -accurate automatic counting as you can get. +accurate automatic counting as you can get, if it works for you. \begin{ctanrefs} \item[detex]\CTANref{detex} +\item[latexcount.pl]\CTANref{latexcount} +\item[TeXcount]\CTANref{texcount} \item[wordcount]\CTANref{wordcount} \end{ctanrefs} @@ -4086,7 +4413,11 @@ For today, possible packages are: \ProgName{tex4ht}'s macros included. As a result, it's pretty robust against the macros you include in your document, and it's also pretty fast. -\item[\ProgName{TeXpider}] a commercial program from +\item[\ProgName{plasTeX}]a Python-based \LaTeX{} document processing + framework. It gives DOM-like access to a \LaTeX{} document, as + well as the ability to generate mulitple output formats + (e.g. HTML, DocBook, tBook, etc.). +\item[\ProgName{TeXpider}]a commercial program from \Qref*{Micropress}{Q-commercial}, which is described on \URL{http://www.micropress-inc.com/webb/wbstart.htm}; it uses bitmaps for equations. @@ -4107,6 +4438,7 @@ The World Wide Web Consortium maintains a list of ``filters'' to \URL{http://www.w3.org/Tools/Word_proc_filters.html} \begin{ctanrefs} \item[latex2html]Browse \CTANref{latex2html} +\item[plasTeX]Browse \CTANref{plastex} \item[tex4ht]\CTANref{tex4ht} \item[tth]\CTANref{tth} \end{ctanrefs} @@ -4139,8 +4471,8 @@ The World Wide Web Consortium maintains a list of ``filters'' to converting Microsoft's Rich Text Format to \TeX{}. There is also a converter to \LaTeX{} by Erwin Wechtl, called \ProgName{rtf2latex}. The latest converter, by Ujwal Sathyam and Scott Prahl, is - \ProgName{rtf2latex2e}; this system seems rather good already, and - is still being improved. + \ProgName{rtf2latex2e} which seems rather good, though development + of it seems to have stalled. Translation \emph{to} \acro{RTF} may be done (for a somewhat constrained set of \LaTeX{} documents) by \TeX{}2\acro{RTF}, which @@ -4269,7 +4601,7 @@ thence to well-formed \acro{XHTML}, and import the results into Microsoft \ProgName{Word} (2000 or later). From there, one may convert to \AllTeX{} using one of the techniques discussed in % beware line break -\htmlonly{``}\Qref[question]{converting to and from \AllTeX{}}{Q-fmtconv}\htmlonly{''}. +\wideonly{``}\Qref[question]{converting to and from \AllTeX{}}{Q-fmtconv}\wideonly{''}. The result will typically (at best) be poorly marked-up. Problems may also arise from the oddity of typical \TeX{} font encodings (notably @@ -4342,12 +4674,16 @@ How did you learn about the package? If the information came from these \acro{FAQ}s, you should already have a link to the file (there are lists at the end of each answer): \begin{narrowversion} - copy that link into a browser, + make a browser link from \URL{http://mirror.ctan.org/} and the text + in the list; if the link returns a directory listing, you can + generally retrieve the whole directory by appending the link with + \extension{zip} \end{narrowversion} \begin{wideversion} - click on that link, + click on one of the links associated with the package, and you can + get the package (which may be one file or several). +% need searate wording for pdfversion and htmlversion, here \end{wideversion} -and you can get the file, one way or another. If you heard about the file somewhere else, it's possible that the source told you where to look; if not, try the \acro{CTAN} searching @@ -4539,7 +4875,7 @@ The % ! line break suggests that you should create % ! line break ``\texttt{C:\textbackslash Local TeX Files}'', which is good if you manage your own machine, but often not even possible in corporate, or -similar, environments~­-- in such situations, the user may have no +similar, environments~--- in such situations, the user may have no control over the hard disc of the computer, at all. So the real criterion is that your local tree should be somewhere that @@ -4547,7 +4883,7 @@ So the real criterion is that your local tree should be somewhere that provide a ``home directory'' for each user, mounted as a network drive; this is a natural home for the user's local tree. Other (often academic) environments assume the user is going to provide a memory -stick, and will assign it a defined drive letter~­-- another good +stick, and will assign it a defined drive letter~--- another good candidate location. Note that the semantics of such a tree are indistinguishable from those of a % ! line break \Qref*{``home'' \acro{TEXMF} tree}{Q-privinst}. @@ -4556,7 +4892,7 @@ There are circumstances when you might not wish to use the `local' tree: \begin{itemize} \item if the package, or whatever, is ``personal'' (for example, something commercial that has been licensed to you alone, or - something you're developing yourself), the package should go in your + something you're developing yourself), it should go in your \Qref*{``home'' \acro{TEXMF} tree}{Q-privinst}; \item if you \emph{know} that the package you are installing is a replacement for the copy on the \acro{TEXMF} tree of your \AllTeX{} @@ -4573,7 +4909,7 @@ have an effect like: \begin{itemize} \item distribution comes with package version \ensuremath{n}; \item you install package version \ensuremath{n+1} on the local tree; and -\item the updated distribution comes with package version \ensuremath{n+2}. +\item the updated distribution provides package version \ensuremath{n+2}. \end{itemize} In such a situation, you will find yourself using version \ensuremath{n+1} (from the local tree) \emph{after} the new @@ -4743,7 +5079,7 @@ mpm --install= (which of course assumes you know the name by which \miktex{} refers to your package). -\Question[Q-inst-tds-zip]{Installing using preformatted \acro{ZIP} files} +\Question[Q-inst-tds-zip]{Installing using ready-built \acro{ZIP} files} Installing packages, as they (``traditionally'') appear on \acro{CTAN}, involves: @@ -4756,15 +5092,15 @@ Installing packages, as they (``traditionally'') appear on Most people, for most packages, find the first two steps onerous, the last being easy (unless it is forgotten!). -Preformatted \acro{ZIP} files (also known as % ! line break -\Qref{\acro{TDS} \acro{ZIP} files}{Q-tds-zip}) are designed to lighten +Ready-built \acro{ZIP} files~--- also known as % ! line break +\Qref*{\acro{TDS}-\acro{ZIP} files}{Q-tds-zip}~--- are designed to lighten the load of performing the first two steps of installation: they contain all the files that are that's to be installed for a given package, in their ``correct'' locations in a % ! line break \Qref*{\acro{TDS} tree}{Q-tds}. To install such a file on a Unix system (we assume that you'll install -into the local \acro{TEXMF} tree): +into the local \acro{TEXMF} tree, at \texttt{\$TEXMFLOCAL}): \begin{quote} \begin{verbatim} cd $TEXMFLOCAL @@ -4785,12 +5121,6 @@ the package provides a font, you also need to enable the font's map, which is discussed in % ! line break ``\Qref*{Installing a Type~1 font}{Q-instt1font}'' -At the time of writing, there are rather few \extension{tds.zip} -files (by comparison with the huge number of packages that are -available). As packages are updated, the number of files is -steadily increasing, but it will be a long time before the whole set -is covered. - \Question[Q-tempinst]{``Temporary'' installation of \AllTeX{} files} Operating systems and applications need to know where to find files: @@ -5295,49 +5625,45 @@ which may be found on \acro{CTAN}. \Question[Q-useMF]{Getting \MF{} to do what you want} \MF{} allows you to create your own fonts, and most \TeX{} users -will never need to use it. \MF{}, unlike \TeX{}, requires some -customisation: each output device for which you will be generating -fonts needs a mode associated with it. Modes are defined using the -|mode_def| convention described on page~94 of \emph{The \MF{}book} +will never need to use it~--- modern \AllTeX{} systems contain +rather few \MF{} fonts of any significance, and when \MF{} output is +needed the font generation is done, automatically, ``on the fly''. + +If you find you have some special requirement that the system doesn't +satisfy, you need to know about \MF{} in rather more detail. \MF{}, +unlike \TeX{}, requires customisation for each output device: such +customisation is conventionally held in a ``mode'' associated with the +device. Modes are commonly defined using the \texttt{mode\_def} +convention described on page~94 of \emph{The \MF{}book} % ! line break (see \Qref[question]{\TeX{}-related books}{Q-books}). You will need -a file, which conventionally called \File{local.mf}, containing all the -|mode_def|s you will be using. If \File{local.mf} doesn't already -exist, Karl Berry's collection of modes (\File{modes.mf}) -is a good starting point -(it can be used as a `\File{local.mf}' without modification in a `big -enough' implementation of \MF{}). Lists of +a file, conventionally called \File{local.mf}, containing all the +\texttt{mode\_def}s you will be using. In the unlikely event that +\File{local.mf} doesn't already exist, Karl Berry's collection of +modes (\File{modes.mf}) is a good starting point +(it can be used as a `\File{local.mf}' without modification in a +typical modern implementation of \MF{}). Lists of settings for various output devices are also published periodically in \textsl{TUGboat} (see \Qref[question]{\acro{TUG}}{Q-TUG*}). Now create -a \texttt{plain} base -file using \ProgName{inimf}, \texttt{plain.mf}, and \texttt{local.mf}: +a \texttt{plain} base file using \ProgName{mf} (in ``initialisation'' +mode), \texttt{plain.mf}, and \texttt{local.mf}: \begin{htmlversion} +\begin{quote} \begin{verbatim} - % inimf - This is METAFONT... - **plain # you type plain - (output) - *input local # you type this - (output) - *dump # you type this - Beginning to dump on file plain... - (output) +% mf -ini +This is METAFONT... +**plain # you type plain +(output) +*input local # you type this +(output) +*dump # you type this +Beginning to dump on file plain... +(output) \end{verbatim} +\end{quote} \end{htmlversion} \htmlignore -\par\vspace{\topsep} -%\begin{tabular}{@{}l@{}l@{}} -%|% inimf|\\ -%This is METAFONT\dots{}\\{} -%**|plain|& you type `|plain|'\\{} -%(output)\\{} -%*|input local|& you type this\\{} -%(output)\\{} -%*|dump|& you type this\\{} -%Beginning to dump on file plain\dots{}\\{} -%(output)\\{} -%\end{tabular}\par \begin{list}{}{}\item\relax - |% inimf|\\ + \texttt{\% mf -ini}\\ This is METAFONT\dots{}\\{} \fullline{**\texttt{plain}\hss you type `\texttt{plain}'} (\emph{output})\\{} @@ -5348,32 +5674,26 @@ file using \ProgName{inimf}, \texttt{plain.mf}, and \texttt{local.mf}: (\emph{output}) \end{list}\par \endhtmlignore -This will create a base file named \File{plain.base} (or something -similar; for example, it will be -\htmlignore -\acro{\File{PLAIN.BAS}} -\endhtmlignore -\begin{htmlversion} - \File{PLAIN.BAS} -\end{htmlversion} -on \MSDOS{} systems) which should be moved to the directory containing -the base files on your system (note that some systems have two or more -such directories, one for each `size' of \MF{} used). +This will create a base file named \File{plain.base} +(or something similar; for example, it will be \File{PLAIN.BAS} +on \MSDOS{} systems). Move the file to the directory containing +the base files on your system. Now you need to make sure \MF{} loads this new base when it starts up. If \MF{} loads the \texttt{plain} base by default on your system, then you're -ready to go. Under Unix (using the default \ProgName{web2c} -distribution% +ready to go. Under Unix (using the default \texlive{} (and earlier) +distributions this does indeed happen, but we could for instance +define a command \ProgName{plainmf}% \begin{footnoteenv} - The \ProgName{command_name} is symbolically linked to - \ProgName{virmf}, and \ProgName{virmf} loads \File{command_name.base} -\end{footnoteenv}) -this does indeed happen, but we could for instance define a command -\ProgName{mf} which executes \texttt{virmf \&plain} loading the -\texttt{plain} base file. - -The usual way to create a font with \texttt{plain} \MF{} is to start -it with the + On the grounds that a command \ProgName{plain} could be misconstrued + as a reference to \plaintex{} +\end{footnoteenv} +which executes `\texttt{mf -base=plain}' (or, in more traditional +style `\texttt{mf \&plain}') which loads the \texttt{plain} base +file. + +The usual way to create a font with \MF{} (with an appropriate base +file loaded) is to start \MF{}'s input with the \begin{narrowversion} lines \begin{quote} @@ -5389,55 +5709,60 @@ line \end{verbatim} \end{wideversion} in response to the `\texttt{**}' prompt or on the \MF{} command line. (If -\texttt{} is unknown or omitted, the mode defaults to `proof' and -\MF{} will produce an output file called -% beware!! -- argument of \File naturally breaks across line end +\texttt{} is unknown or omitted, the mode defaults to +`proof' mode and \MF{} will produce an output file called % ! line break \File{.2602gf}) The \texttt{} is a floating point number or `magstep' (magsteps are defined in \emph{The \MF{}book} and \emph{The \TeX{}book}). If \texttt{mag=} is omitted, then the default -is 1 (magstep 0). For example, to generate cmr10 at 12pt for an epson -printer you would type +is 1~(magstep 0). For example, to generate cmr10 at 12pt for an Epson +printer you might type +\begin{quote} \begin{verbatim} - mf \mode=epson; mag=magstep 1; input cmr10 +mf \mode=epson; mag=magstep 1; input cmr10 \end{verbatim} +\end{quote} Note that under Unix the \texttt{\textbackslash } and \texttt{;} characters must usually be quoted or escaped, so this would typically look something like +\begin{quote} \begin{verbatim} mf '\mode=epson; mag=magstep 1; input cmr10' \end{verbatim} - -If you don't have \ProgName{inimf} or need a special mode that isn't -in the base, you can put its commands in a file (\emph{e.g.}, -\File{ln03.mf}) and invoke it on the fly with the \csx{smode} command. -For example, to create \File{cmr10.300gf} for an \acro{LN}03 printer, using -the file +\end{quote} +If you need a special mode that isn't in the base, you can put its +commands in a file (\emph{e.g.}, \File{ln03.mf}) and invoke it on the +fly with the \csx{smode} command. For example, to create +\File{cmr10.300gf} for an \acro{LN}03 printer, using the file +\begin{quote} \begin{verbatim} - % This is ln03.mf as of 1990/02/27 - % mode_def courtesy of John Sauter - proofing:=0; - fontmaking:=1; - tracingtitles:=0; - pixels_per_inch:=300; - blacker:=0.65; - fillin:=-0.1; - o_correction:=.5; +% This is ln03.mf as of 1990/02/27 +% mode_def courtesy of John Sauter +proofing:=0; +fontmaking:=1; +tracingtitles:=0; +pixels_per_inch:=300; +blacker:=0.65; +fillin:=-0.1; +o_correction:=.5; \end{verbatim} +\end{quote} (note the absence of the \texttt{mode\_def} and \texttt{enddef} commands), you would type +\begin{quote} \begin{verbatim} - mf \smode="ln03"; input cmr10 +mf \smode="ln03"; input cmr10 \end{verbatim} +\end{quote} This technique isn't one you should regularly use, but it may prove useful if you acquire a new printer and want to experiment with parameters, or for some other reason are regularly editing the parameters you're using. Once you've settled on an appropriate set of parameters, you should use them to rebuild the base file that you use. -Other sources of help are mentioned in % beware line break -\Qref[question]{\MF{} and \MP{} Tutorials}{Q-mfptutorials}. +Other sources of help are discussed in our list of % ! line break +\Qref*{\MF{} and \MP{} Tutorials}{Q-mfptutorials}. \begin{ctanrefs} \item[modes.mf]\CTANref{modes-file} \end{ctanrefs} @@ -5602,7 +5927,7 @@ this, you have three options: \PS{} previewer. Some systems offer this capability as standard, but most people will need to use a separate previewer such as \ProgName{ghostscript} or \ProgName{ghostscript}-based viewers - such as \ProgName{ghostview} or shareware offering \ProgName{GSview}. + such as \ProgName{gv} or shareware offering \ProgName{GSview}. \item Under Windows on a \acro{PC}, or on a Macintosh, let Adobe Type Manager display the fonts (textures, on the Macintosh, works like this). %% , and under @@ -5627,9 +5952,9 @@ this, you have three options: \end{itemize} \begin{ctanrefs} \item[ghostscript]Browse \CTANref{ghostscript} -\item[ghostview]Browse \CTANref{ghostview} \item[gsftopk]\CTANref{gsftopk} \item[GSview]Browse \CTANref{gsview} +\item[gv]Browse \CTANref{gv} \item[ps2pk]\CTANref{ps2pk} \item[xdvi]\CTANref{xdvi} \end{ctanrefs} @@ -5899,8 +6224,9 @@ commercially, include: set of files for use with \LaTeX{}. The \acro{CM} Bright fonts are supplied in Type~1 format by MicroPress, Inc. The \Package{hfbright} bundle offers free Type~1 fonts for text using - the \acro{OT}1 encoding~--- the \Package{cm-super} set for - use with \acro{T}1 texts doesn't (yet) offer support for mathematics. + the \acro{OT}1 encoding~--- the \Package{cm-super} fonts provide the + fonts in \acro{T}1 text encoding but don't support \acro{CM} bright + mathematics. \nothtml{\bgroup\raggedwithindent} For further details of Micropress' offering (including samples) see\\ @@ -6220,7 +6546,6 @@ If you want to use an italic version of \csx{foo}, you need to use Text set using nonstdfont italic... \end{verbatim} \end{quote} - This is all very elementary stuff, and serves for simple use of fonts. However, there are wrinkles, the most important of which is the matter of \Qref*{font encodings}{Q-whatenc}. Unfortunately, many fonts that @@ -6285,6 +6610,14 @@ document is going to use, and the package provides commands to select fonts as they're needed. The distribution includes a configuration to use Adobe `standard' fonts for typesetting text. (\Eplain{} itself seems not to offer a font selection scheme.) + +Simply to change font \emph{size} in a document (i.e., not changing +the default font itself), may be done using the rather straightforward +\Package{varisize}, which offers font sizes ranging from 7~points to +20~points (nominal sizes, all). Font size commands are generated when +any of the package files is loaded, so the \File{11pt.tex} defines a +command \csx{elevenpoint}; each of the files ensures there's a ``way +back'', by defining a \csx{tenpoint} command. \begin{ctanrefs} \item[ec-plain]\CTANref{ec-plain} \item[fontch]\CTANref{fontch} @@ -6292,6 +6625,7 @@ seems not to offer a font selection scheme.) \item[ofs]\CTANref{ofs} \item[pdcmac]\CTANref{pdcmac} \item[plnfss]\CTANref{plnfss} +\item[varisize]\CTANref{varisize} \end{ctanrefs} \subsection{Particular font families} @@ -6385,8 +6719,8 @@ files), but copy the other three into your existing Local \Qref*{update the filename database}{Q-inst-wlcf}. Now, incorporate the fonts in the set searched by \PDFLaTeX{}, -\ProgName{dvips}, \ProgName{dvipdfm}, your previewers and -Type~1-to-\acro{PK} conversion programs, by +\ProgName{dvips}, \ProgName{dvipdfm}/\ProgName{dvipdfmx}, your +previewers and Type~1-to-\acro{PK} conversion programs, by \begin{itemize} \item On a te\TeX{} system earlier than version~2.0, edit the file \File{$TEXMF/dvips/config/updmap} and insert an absolute path for @@ -6519,13 +6853,14 @@ can operate using \PDFTeX{} primitives, the hyper\TeX{} \csx{special}s, or \acro{DVI} driver-specific \csx{special} commands. Both \ProgName{dvips} and \YandY{}'s \acro{\ProgName{DVIPSONE}} can translate the \acro{DVI} with these \csx{special} commands into -\PS{} acceptable to Distiller, and \ProgName{dvipdfm} has \csx{special} -commands of its own. +\PS{} acceptable to Distiller, and +\ProgName{dvipdfm} and \ProgName{dvipdfmx} have \csx{special} commands of +its own. If you use \plaintex{}, the \Qref*{\Eplain{} macros}{Q-eplain} can help you create \acro{PDF} documents with hyper-references. It can operate using \PDFTeX{} primitives, or \csx{special} commands -for the \ProgName{dvipdfm} \acro{DVI} driver. +for the \ProgName{dvipdfm}/\ProgName{dvipdfmx} \acro{DVI} drivers. While there is no free implementation of all of \ProgName{Adobe} \ProgName{Distiller}'s @@ -6537,9 +6872,8 @@ For viewing (and printing) the resulting files, Adobe's \ProgName{Acrobat} \ProgName{Reader} is available for a fair range of platforms; for those for which Adobe's reader is unavailable, remotely current versions of \ProgName{ghostscript} combined with -\ProgName{gv}, \ProgName{GSview} (or even the unsupported -\ProgName{ghostview}) can display and print \acro{PDF} files, as can -\ProgName{xpdf}. +\ProgName{gv} or \ProgName{GSview} can display and print \acro{PDF} +files, as can \ProgName{xpdf}. In many circumstances, \ProgName{Ghostscript} combined with a viewer application is actually preferable to Acrobat Reader. For example, on @@ -6554,9 +6888,8 @@ mistake. \item[dvipdfm]\CTANref{dvipdfm} \item[dvipdfmx]\CTANref{dvipdfmx} \item[ghostscript]Browse \CTANref{ghostscript} -\item[ghostview]Browse \CTANref{ghostview} \item[GSview]Browse \CTANref{gsview} -\item[gv]\CTANref{gv} +\item[gv]Browse \CTANref{gv} \item[hyper.sty]\CTANref{hyper} \item[hyperref.sty]\CTANref{hyperref} \end{ctanrefs} @@ -7028,10 +7361,13 @@ the above two cases), but their code could be configured for others. The obvious next step was to make the code configurable dynamically. The \LaTeX{} standard \Package{graphics} package and its derivatives -made this step: it is strongly preferred for all current work. It can -also be used (with the help of the \Package{miniltx} ``\LaTeX{} -emulator'' and the \Package{graphicx.tex} front-end) in documents -written in \plaintex{}. +made this step: it is strongly preferred for all current work. + +Users of \plaintex{} have two options allowing them to use +\Package{graphicx}: the \Package{miniltx} ``\LaTeX{} emulator'' and +the \Package{graphicx.tex} front-end allow you to load +\Package{graphicx}, and \Qref*{\Eplain}{Q-eplain} allows you to load +it (using the full \LaTeX{} syntax) direct. The \Package{graphics} package takes a variety of ``driver options''~--- package options that select code to generate the @@ -7209,17 +7545,17 @@ which is targeted at the use of \Package{pstricks} in \Question[Q-dvipdfmgraphics]{Imported graphics in \ProgName{dvipdfm}} -\ProgName{Dvipdfm} translates direct from \acro{DVI} to \acro{PDF} -(all other available routes produce \PS{} output using -\ProgName{dvips} and then convert that to \acro{PDF} with +\ProgName{Dvipdfm} (and \ProgName{dvipdfmx}) translates direct from +\acro{DVI} to \acro{PDF} (all other available routes produce \PS{} +output using \ProgName{dvips} and then convert that to \acro{PDF} with \ProgName{ghostscript} or \ProgName{Acrobat} \ProgName{Distiller}). -\ProgName{Dvipdfm} is a particularly flexible application. It will -permit the inclusion of bitmap and \acro{PDF} graphics, as does -\Qref*{\PDFTeX{}}{Q-pdftexgraphics}, but is also capable of employing -\ProgName{ghostscript} ``on the fly'' so as to be able to permit the -inclusion of encapsulated \PS{} (\extension{eps}) files by translating -them to \acro{PDF}. In this way, \ProgName{dvipdfm} combines the good +\ProgName{Dvipdfm}/\ProgName{Dvipdfmx} are particularly flexible +applications. They permit the inclusion of bitmap and \acro{PDF} +graphics, as does \Qref*{\PDFTeX{}}{Q-pdftexgraphics}, but are also +capable of employing \ProgName{ghostscript} ``on the fly'' so as to be +able to permit the inclusion of encapsulated \PS{} (\extension{eps}) +files by translating them to \acro{PDF}. In this way, they combine the good qualities of \ProgName{dvips} and of \PDFTeX{} as a means of processing illustrated documents. @@ -7246,7 +7582,7 @@ containing the information; the above numbers came from an %%CreationDate: Mon Mar 8 15:17:47 2004 \end{verbatim} \end{quote} -However, if such a file is available, you may abbreviate the inclusion +If such a file is available, you may abbreviate the inclusion code, above, to read: \begin{quote} \begin{verbatim} @@ -7269,9 +7605,59 @@ configuration file (of most distributions) ``guesses'' the \texttt{dvips} option if you're using \TeX{}. \begin{ctanrefs} \item[dvipdfm]\CTANref{dvipdfm} +\item[dvipdfmx]\CTANref{dvipdfmx} \item[ebb]Distributed as part of \CTANref{dvipdfm} \end{ctanrefs} +\Question[Q-grffilenames]{``Modern'' graphics file names} + +\TeX{} was designed in a world where file names were very simple +indeed, typically strictly limited both in character set and length. +In modern systems, such restrictions have largely disappeared, which +leaves \TeX{} rather at odds with its environment. Particular +problems arise with spaces in file names, but things like multiple +period characters can seriously confuse the \Package{graphics} +package. + +The specification of \TeX{} leaves some leeway for distributions to +adopt file access appropriate to their operating system, but this +hasn't got us very far. Many modern distributions allow you to +specify a file name as \texttt{"file name.tex"} (for example), which +helps somewhat, but while this allows us to say +\begin{quote} +\begin{verbatim} +\input "foo bar.tex" +\end{verbatim} +\end{quote} +the analogous usage +\begin{quote} +\begin{verbatim} +\includegraphics{"gappy graphics.eps"} +\end{verbatim} +\end{quote} +using ``ordinary'' \LaTeX{} causes confusion in \ProgName{xdvi} and +\ProgName{dvips}, even though it works at compilation time. Sadly, +even within such quotes, multiple dots give \csx{includegraphics} +difficulties. Note that +\begin{quote} +\begin{verbatim} +\includegraphics{"gappy graphics.pdf"} +\end{verbatim} +\end{quote} +works in a similar version of \PDFTeX{}. + +If you're using the \Package{graphics} package, the \Package{grffile} +package will help. The package offers several options, the simplest +of which are \pkgoption{multidot} (allowing more than one dot in a +file name) and \pkgoption{space} (allowing space in a file name). The +\pkgoption{space} option requires that you're running on a +sufficiently recent version of \PDFTeX{}, in \acro{PDF} mode~--- and +even then it won't work for \MP{} files, which are read as \TeX{} +input, and therefore use the standard input mechanism). +\begin{ctanrefs} +\item[grffile.sty]Distributed as part of \CTANref{oberdiek} +\end{ctanrefs} + \Question[Q-graphicspath]{Importing graphics from ``somewhere else''} By default, graphics commands like \csx{includegraphics} look @@ -7615,14 +8001,25 @@ the question\dots{} There are many packages to do pictures in \AllTeX{} itself (rather than importing graphics created externally), ranging from simple use of \LaTeX{} \environment{picture} environment, through enhancements like -\ProgName{epic}, to +\ProgName{eepic}, to sophisticated (but slow) drawing with \PiCTeX{}. Depending on your type of drawing, and setup, here are a few systems you may consider: \begin{itemize} +\item \PiCTeX{} is a venerable, and very powerful, system, that draws + by placing dots on the page to give the effect of a line or curve. While + this has the potential of great power, it is (of course) much slower + than any of the other established packages. What's more, there + are problems with its \Qref*{documentation}{Q-docpictex}. +\item \Package{epic} was designed to make use of the \LaTeX{} + \environment{picture} environment somewhat less agonising; + \Package{eepic} extends it, and is capable of using \ProgName{tpic} + \csx{special} commands to improve printing performance. (If the + \csx{special}s aren't available, the \Package{eepicemu} will do the + business, far less efficiently. \item \Package{pict2e}; this was advertised in % !line break \Qref*{the \LaTeX{} manual}{Q-books}, but didn't appear for nearly ten years after publication of the book! It removes all the petty - niggles that surround the use of the \environment{picture} + restrictions that surround the use of the \environment{picture} environment. It therefore suffers \emph{only} from the rather eccentric drawing language of the environment, and is a far more useful tool than the original environment has ever been. (Note that @@ -7631,9 +8028,11 @@ of drawing, and setup, here are a few systems you may consider: \item \Package{PSTricks}; this gives you access to all the power of \PS{} from \TeX{} itself, by sophisticated use of \Qref*{\csx{special} commands}{Q-specials}. Since \PS{} is itself a - pretty powerful programming language, many astounding things can in - principle be achieved using \Package{PSTricks}. - \Package{pstricks}' \csx{special}s are + pretty powerful programming language, many astounding things can in + principle be achieved using \Package{PSTricks} (a wide range of + contributed packages, ranging from world mapping to lens design + diagrams, is available). + \Package{Pstricks}' \csx{special}s are by default specific to \ProgName{dvips}, but V\TeX{} (both in its commercial and in its free versions) understands them. \PDFTeX{} users may use \Package{pst-pdf}, which (like @@ -7675,12 +8074,16 @@ of drawing, and setup, here are a few systems you may consider: \end{itemize} \begin{ctanrefs} \item[dratex.sty]\CTANref{dratex} +\item[epic.sty]\CTANref{epic} +\item[eepic.sty]\CTANref{eepic} +\item[eepicemu.sty]\CTANref{eepic} \item[mfpic]\CTANref{mfpic} \item[preview.sty]\CTANref{preview} \item[pspicture.sty]\CTANref{pspicture} \item[pst-pdf.sty]\CTANref{pst-pdf} \item[pgf.sty]\CTANref{pgf} \item[pict2e.sty]\CTANref{pict2e} +\item[pictex.sty]\CTANref{pictex} \item[pstricks]\CTANref{pstricks} \item[tikz.sty]Distributed with \CTANref{pgf} \end{ctanrefs} @@ -8886,9 +9289,9 @@ the \Package{natbib} and \Package{hyperref} packages will interwork. A convention sometimes used in physics journals is to ``collapse'' a group of related citations into a single entry in the bibliography. \BibTeX{}, by default, can't cope with this arrangement, but the \Package{mcite} -package deals with the problem. +and \Package{mciteplus} packages deal with the problem. -The package overloads the \csx{cite} command to recognise a +\Package{mcite} overloads the \csx{cite} command to recognise a ``\texttt{*}'' at the start of a key, so that citations of the form \begin{quote} \begin{verbatim} @@ -8913,19 +9316,32 @@ You need to make a small change to the bibliography style (\extension{bst}) file you use; the \Package{mcite} package documentation tells you how to do that. -Unfortunately, the \Class{revtex} system doesn't play with -\Package{mcite}. As a result, for that (primarily physics-targeted -system) you need to play silly games like: +(Despite these multiple citations being primarily a physics-oriented +requirement, the \Class{RevTeX} (Physics support) class doesn't work +with \Package{mcite}. + +The \Package{mciteplus} package adresses many of the infelicites of +\Package{mcite}, and \emph{does} work with \Class{RevTeX}. Again, +`ordinary' \extension{bst} files will not work with +\Package{mciteplus}, but the package documentation explains how to +patch an existing \BibTeX{} style. + +The \Package{collref} package takes a rather different approach to the +problem, and will work with most (if not all) \BibTeX{} packages. +\Package{Collref} spots common subsets of the references, so if it +sees a sequence \begin{quote} \begin{verbatim} -\cite{paper0,paper1,paper3} -\nocite{paper2} +\cite{paper0,paper1,paper2,paper3} +... +\cite{some_other_paper,paper1,paper2,and_another} \end{verbatim} \end{quote} -and then edit the \extension{bbl} file to merge the two citations, to -achieve the effects of \Package{mcite}. +it will collect \texttt{paper1} and \texttt{paper2} as a multiple reference. \begin{ctanrefs} +\item[collref.sty]\CTANref{collref} \item[mcite.sty]\CTANref{mcite} +\item[mciteplus.sty]\CTANref{mciteplus} \item[revtex \nothtml{\rmfamily}bundle]\CTANref{revtex} \end{ctanrefs} @@ -8986,6 +9402,11 @@ simple~--- add \end{quote} to the preamble of your document. +The \Package{compactbib} package has a similar effect. Its primary +purpose is to produce two bibliographies, and it seems to preclude use +of \BibTeX{} (though the package documentation, in the package file +itself, isn't particularly clear). + Otherwise, one is into unseemly hacking of something or other. The \Package{mdwlist} package actually does the job, but it doesn't work here, because it makes a different-named list, while the name @@ -9006,6 +9427,7 @@ plethora of space-saving measures: you can, in principle, suppress all its other actions, and have it provide you a compressed bibliography \emph{only}. \begin{ctanrefs} +\item[compactbib.sty]\CTANref{compactbib} \item[mdwlist.sty]Distributed as part of \CTANref{mdwtools} \item[natbib.sty]\CTANref{natbib} \item[savetrees.sty]\CTANref{savetrees} @@ -9393,12 +9815,13 @@ route): Thesis styles are usually very specific to your University, so it's usually not profitable to ask around for a package outside your own University. Since many Universities (in their eccentric way) still -require double-spacing, you may care to refer to -\Qref[question]{the relevant question}{Q-linespace}. -If you want to write your own, a good place to start is the University -of California style, but it's not worth going to a lot of trouble. (If -officials won't allow standard typographic conventions, you won't be -able to produce an \ae{}sthetically pleasing document anyway!) +require double-spaced thesis text, you may also need separately to set +up \Qref*{double spacing}{Q-linespace}. + +If you want to write a new thesis class of your own, a good place to +start is the University of California style, but remember that it's +often difficult to produce a thesis that both looks good and conforms +with the style that your Univeristy demands. \begin{ctanrefs} \item[UC thesis style]\CTANref{ucthesis} \end{ctanrefs} @@ -9412,8 +9835,8 @@ public archives. Nevertheless, there are considerable numbers of macros of one sort or another available on \acro{CTAN}; searching for your journal name in -the CTAN catalogue (see % ! line wrap -\Qref[question]{searching \acro{CTAN}}{Q-findfiles}) +the CTAN catalogue~--- see % ! line break +\Qref{searching \acro{CTAN}}{Q-findfiles})~--- may well turn up what you're seeking. Failing that, you may be well advised to contact the prospective @@ -9598,7 +10021,8 @@ may not be optimal~--- but they're certainly practical. More satisfactory are the \emph{\acro{KOMA}-script} classes, which are designed to work properly with the class option files that come with \Package{extsizes}, and the \Class{memoir} class that has its own -options for document font sizes 9pt, 14pt and 17pt. +options for document font sizes 9pt--12pt, 14pt, 17pt, 20pt, 25pt, +30pt, 36pt, 48pt and 60pt. \begin{ctanrefs} \item[extsizes bundle]\CTANref{extsizes} \item[\nothtml{\rmfamily}KOMA script bundle]\CTANref{koma-script} @@ -9704,8 +10128,8 @@ to program alternative % don't let these \href suffer line-breaks \href{http://zoonek.free.fr/LaTeX/LaTeX_samples_chapter/0.html}{chapter heading styles} and \href{http://zoonek.free.fr/LaTeX/LaTeX_samples_section/0.html}{section heading styles}. -The web pages are not useful to users unless they are willing to do -their own \LaTeX{} programming. +The web pages provide programming examples, and expect users to adapt +them to their own \LaTeX{} use. \begin{ctanrefs} \item[anonchap.sty]\CTANref{anonchap} \item[fncychap.sty]\CTANref{fncychap} @@ -10311,8 +10735,6 @@ was written: it does the obvious things, and more. Users have been known to ask for running page numbers within a section, but this really doesn't make sense: you need to run page numbers within document objects that always start on a fresh page. - -Documentation of \Package{chappg} is to be found in the package file. \begin{ctanrefs} \item[chappg.sty]\CTANref{chappg} \end{ctanrefs} @@ -10355,6 +10777,7 @@ together with a sample document and prototype outputs. \end{ctanrefs} \Question[Q-acroantics]{Adobe \ProgName{Reader} messing with print size} +\AliasQuestion{Q-outszwrng} Printing from Adobe \ProgName{Reader} shrinks the page ``to fit'' (\emph{by default}). Unfortunately, its calculation doesn't consider @@ -10364,17 +10787,22 @@ The effect typically looks as if your margins have expanded. Solve this problem by adjusting the \ProgName{Reader}'s default in the print dialogue; unfortunately, this dialogue varies from one version -to the next. On \ProgName{Reader} version 7, there are two entries to -check: -\begin{quote} +to the next: +\begin{itemize} +\item \ProgName{Reader} version 7:\\ Page Scaling (default: ``Fit to printer margins'')~--- change to ``None'', and\\ - Scale (default 95\textpercent {} of Normal size)~--- change to + Scale (default 95\textpercent{} of Normal size)~--- change to ``100\textpercent''. -% NB the space after \textpercent seems to be necessary for the health -% of sanitize.pl :-( -\end{quote} - +\item Adobe Reader 6:\\ + in the print dialogue, on the ``copies \& pages'' pane, you'll find a + popup menu/drop-down list titled ``Page Scaling''~--- change to ``None''. +\item Windows, Linux Acrobat (Reader) 5.0:\\ + In the print dialog, make sure the ``Shrink oversized pages to fit'' + checkbox is unchecked. It may also be useful to uncheck the + ``Expand small pages to fit paper size'' checkbox as well. +\end{itemize} + \Question[Q-papergeom]{Getting the right paper geometry from \AllTeX{}} If your output is the wrong size, and you've checked that it's not due @@ -10496,8 +10924,10 @@ Style'~--- ``don't do it''~--- should not lightly be ignored. This set of \acro{FAQ}s recommends that you use a package to establish consistent settings of the parameters: the interrelationships are -taken care of in the established packages, without you needing to -think about them, but +taken care of in the established packages, without you \emph{needing} +to think about them, but remember~--- the packages only provide +consistent, working, mechanisms: they don't analyse the quality of +what you propose to do. The following answers deal with the ways one may choose to proceed: \begin{itemize} @@ -10631,10 +11061,12 @@ environment (which is a close relation of the \LaTeX{} as far as \TeX{} is concerned: it merely moves text around inside the width that \TeX{} believes in. -The \Package{changepage} package provides ready-built commands to do the -above; it includes provision for changing the shifts applied to your -text according to whether you're on an odd (\emph{recto}) or an even -(\emph{verso}) page of a two-sided document. +The \Package{changepage} package provides ready-built commands to do +the above; it includes provision for changing the shifts applied to +your text according to whether you're on an odd (\emph{recto}) or an +even (\emph{verso}) page of a two-sided document. +\Package{Changepage}'s structure matches that of the \Class{memoir} +class. The (earlier) package \Package{chngpage} provides the same facilities, but it uses rather different syntax. \Package{Changepage}'s structure @@ -10655,10 +11087,15 @@ to make the page one line longer, or \enlargethispage{-\baselineskip} \end{verbatim} \end{quote} -to make the page one line shorter. +to make the page one line shorter. The process is (to an extent) +simplified by the \Package{addlines} package: its \csx{addlines} +command takes as argument the \emph{number} of lines to add to the +page (rather than a length): the package documentation also provides a +useful analysis of when the command may (or may not) be expected to +work. \begin{ctanrefs} +\item[addlines.sty]\CTANref{addlines} \item[changepage.sty]\CTANref{changepage} -\item[chngpage.sty]\CTANref{chngpage} \end{ctanrefs} \Question[Q-nopageno]{How to get rid of page numbers} @@ -11181,33 +11618,33 @@ facilities. \item[quotchap.sty]\CTANref{quotchap} \end{ctanrefs} -\Question[Q-outszwrng]{\AllTeX{} \acro{PDF} output prints at wrong size} - -Having got everything \emph{else} right, you should be aware that the -problem may have nothing to do with \AllTeX{} and everything to do -with the program you use for printing. A regular cause for such -problems lies with Acrobat Reader, which by default enables its option -to scale pages to fit on the printable area of the paper. Since a -printer can rarely print right to the edge, this means that pdf-files -will be shrunk by some (small) factor (even if the pdf-file is -formatted for A4, and your paper size is set to A4 as well). - -Correcting this silliness is not very hard, but the exact details -depend on the version of Acrobat Reader (or "Adobe Reader" from -version 6.0 onwards) you have installed: -\begin{itemize} -\item Mac OS X, Adobe Reader 6:\\ - in the print dialogue, on the ``copies \& pages'' pane, you'll find a - popup menu titled ``Page Scaling''. Make sure that the menu reads - ``None''. -\item Windows, Adobe Reader 6:\\ - in the print dialogue, select ``None'' from the drop-down list - ``Page Scaling''. -\item Windows, Linux Acrobat (Reader) 5.0:\\ - In the print dialog, make sure the ``Shrink oversized pages to fit'' - checkbox is unchecked. It may also be useful to uncheck the - ``Expand small pages to fit paper size'' checkbox as well. -\end{itemize} +% \Question[Q-outszwrng]{\AllTeX{} \acro{PDF} output prints at wrong size} + +% Having got everything \emph{else} right, you should be aware that the +% problem may have nothing to do with \AllTeX{} and everything to do +% with the program you use for printing. A regular cause for such +% problems lies with Acrobat Reader, which by default enables its option +% to scale pages to fit on the printable area of the paper. Since a +% printer can rarely print right to the edge, this means that pdf-files +% will be shrunk by some (small) factor (even if the pdf-file is +% formatted for A4, and your paper size is set to A4 as well). + +% Correcting this silliness is not very hard, but the exact details +% depend on the version of Acrobat Reader (or "Adobe Reader" from +% version 6.0 onwards) you have installed: +% \begin{itemize} +% \item Mac OS X, Adobe Reader 6:\\ +% in the print dialogue, on the ``copies \& pages'' pane, you'll find a +% popup menu titled ``Page Scaling''. Make sure that the menu reads +% ``None''. +% \item Windows, Adobe Reader 6:\\ +% in the print dialogue, select ``None'' from the drop-down list +% ``Page Scaling''. +% \item Windows, Linux Acrobat (Reader) 5.0:\\ +% In the print dialog, make sure the ``Shrink oversized pages to fit'' +% checkbox is unchecked. It may also be useful to uncheck the +% ``Expand small pages to fit paper size'' checkbox as well. +%\end{itemize} \subsection{Spacing of characters and lines} @@ -11439,13 +11876,16 @@ The \Class{memoir} class includes the relevant functionality of the For general numbering of lines, there are two packages for use with \LaTeX{}, \Package{lineno} (which permits labels attached to individual lines of typeset output) and \Package{numline}. +(\Package{Numline} is considered obsolete, but remains available from +the archive.) Both of these packages play fast and loose with the \LaTeX{} output routine, which can cause problems: the user should beware\dots{} If the requirement is for numbering verbatim text, \Package{moreverb}, -\Class{memoir} or \Package{fancyvrb} (see % beware line break +or \Package{fancyvrb} (see % ! line break \Qref[question]{including files verbatim}{Q-verbfile}) may be used. +Class \Class{memoir} also provides the necessary facilities. One common use of line numbers is in critical editions of texts, and for this the \Package{edmac} package offers comprehensive support; @@ -11765,9 +12205,17 @@ There are three packages that help solve this problem: maths mode. It can produce (\LaTeX{}-style) `robust' commands % beware line break within paren (\htmlonly{see }\Qref{use of \csx{protect}}{Q-protect}) for use - within moving arguments. Note that, because the operation is - conducted in maths mode, spaces within the \acro{URL} argument are - ignored unless special steps are taken. + within moving arguments. + + The package ordinarily ignores spaces in the \acro{URL}, but + unfortunately \acro{URL}s that contain spaces do exist; to typeset + them, call the package with the \pkgoption{obeyspaces} option. Two + other useful options allow line breaks in the \acro{URL} in places + where they are ordinarily suppressed to avoid confusion: + \pkgoption{spaces} to allow breaks at spaces (note, this requires + \pkgoption{obeyspaces} as well, and \pkgoption{hyphens} to allow + breaks after hyphens. (Note that the package \emph{never} does + ``ordinary'' hyphenation of names inside an \acro{URL}.) It is possible to use the \Package{url} package in \plaintex{}, with the assistance of the \Package{miniltx} package (which was @@ -11930,24 +12378,24 @@ is to start a paragraph (in books, usually the first of a chapter) with its first letter set large enough to span several lines. This style is known as ``dropped capitals'', or (in French) -\latexhtml{``lettrines''}{«lettrines»}, and \TeX{}'s primitive -facilities for hanging indentation make its (simple) implementation -pretty straightforward. +\latexhtml{``lettrines''}{\htmlentity{laquo}lettrines\htmlentity{raquo}}, +and \TeX{}'s primitive facilities for hanging indentation make its +(simple) implementation pretty straightforward. The \Package{dropping} package does the job simply, but has a curious attitude to the calculation of the size of the font to be used for the big letters. Examples appear in the package documentation, so before -you process the \extension{dtx}, the package itself must already be installed. -Unfortunately, \Package{dropping} has an intimate relation to the set -of device drivers available in an early version of the \LaTeX{} -graphics package, and it cannot be trusted to work with recent -offerings like \PDFTeX{}, V\TeX{} or \acro{DVI}pdfm. - -On such occasions, the more recent \Package{lettrine} package is more -likely to succeed. It has a well-constructed array of options, and -the examples (a pretty impressive set) come as a separate file in the -distribution (also available in \PS{}, so that they can be viewed -without installing the package itself). +you process the \extension{dtx}, the package itself must already be +installed. Unfortunately, \Package{dropping} has an intimate relation +to the set of device drivers available in an early version of the +\LaTeX{} graphics package, and it cannot be trusted to work with +modern offerings such as \PDFTeX{}, V\TeX{} or \acro{DVI}pdfm, let +alone such modernisms as \xetex{}. As a result, the package is widely +deprecated, nowadays. + +The more recent \Package{lettrine} package is generally more reliable. +It has a well-constructed array of options, and an impressive set of +examples adds to the package's document. \begin{ctanrefs} \item[dropping]\CTANref{dropping} \item[lettrine]\CTANref{lettrine} @@ -12632,9 +13080,26 @@ have the .aux file, write: \end{verbatim} \end{narrowversion} \end{quote} +Heiko Oberdiek's experimental \Package{zref} bundle includes a +hyper-crossreferencing mechanism using its \Package{zref-xr} module. +Usage is closely modelled on \Package{xr} and \Package{xr-hyper}; a +trivial example (from a \Newsgroup{comp.text.tex} posting) is +\begin{quote} +\begin{verbatim} +\usepackage{zref-xr,zref-user} +\zexternaldocument*{xr02} +... +\zref{foo} +\end{verbatim} +\end{quote} +The module provides all the facilities of the older packages, and can +deal both with ``traditional'' \LaTeX{} labels and with +\Package{zref}'s style of labels. \begin{ctanrefs} \item[xr.sty]Distributed as part of \CTANref{2etools} \item[xr-hyper.sty]Distributed with \CTANref{hyperref} +\item[zref \nothtml{\rmfamily\itshape}bundle]Distributed as part of + \CTANref{oberdiek} \end{ctanrefs} %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% @@ -13559,6 +14024,24 @@ which feels just as ``natural'' as the \Package{mdwtools} facility, and has the advantage of playing well with the other excellent facilities of \Package{enumitem}. +\Package{Expdlist} has a neat way of providing for comments, with its +\csx{listpart} command. The command's argument becomes a comment +between items of the list: +\begin{quote} +\begin{verbatim} +\begin{enumerate} +\item item 1 +\item item 2 + \listpart{interpolated comment} +\item item 3 +\end{enumerate} +\end{verbatim} +\end{quote} +This, you will realise, means it doesn't even have to think about +suspending or resuming the list, and of course it works equally well +in any of the list environments (thought it's not actually +\emph{necessary} for any but \environment{enumerate}). + \Package{Enumitem} also allows multi-level suspension and resumption of lists: \begin{quote} @@ -13582,13 +14065,14 @@ of lists: % end outer enumerate \end{enumerate} \end{verbatim} -However, the comment interpolated in the nested enumeration appears as -if it were a second paragraph to ``outer item 2'', which is hardly -satisfactory. \end{quote} +However, the `nested comment' interpolated in the nested enumeration +appears as if it were a second paragraph to ``outer item 2'', which is +hardly satisfactory. \begin{ctanrefs} \item[enumerate.sty]Distributed as part of \CTANref{2etools} \item[enumitem.sty]\CTANref{enumitem} +\item[expdlist.sty]\CTANref{expdlist} \item[mdwlist.sty]Distributed as part of \CTANref{mdwtools} \end{ctanrefs} @@ -13633,7 +14117,7 @@ position wrong (by \texttt{10pt}) if you simply write: The \Package{topcapt} package solves this problem: \begin{quote} \begin{verbatim} -\usepackage{topcaption} +\usepackage{topcapt} ... \begin{table} \topcaption{Example table} @@ -14288,7 +14772,7 @@ than columns. So, we set things up by: \end{wideversion} \end{quote} Now, we put `\texttt{\$}' before the first column specifier; and we -put `\texttt{\textasciicircum}' +put `\texttt{\textasciicircum{}}' before the modifiers of subsequent ones. We then use \csx{rowstyle} at the start of each row we want to modify: \begin{quote} @@ -14517,6 +15001,47 @@ not work with obsolete (pre-\LaTeXe{}) packages such as \Qref[question]{graphics inclusion}{Q-impgraph} for discussion of the genesis of \csx{includegraphics}. +\Question[Q-wideflt]{Centring a very wide figure or table} + +The normal means of centring a figure or table object is to include +\csx{centering} at the top of the float. This doesn't help if the +object is wider than \csx{textwidth}~--- the object starts at the left +margin and juts out into the right margin (which is actually doubly +unsatisfactory, since as well as looking bad, the float won't be +placed until the next \csx{clearpage} or the like.) + +You can avoid the problem by rescaling the figure or table to fit, but +this is often not satisfactory, for several reasons. + +Otherwise, if the object is wider than the printable area of the page, +you've no choice other than to \Qref*{rotate it}{Q-landscape}. If, +however, the object is \emph{just} wider than the text block, you can +make it pretend to be the right size by: +\begin{quote} +\begin{wideversion} +\begin{verbatim} +\begin{figure} + \noindent + \makebox[\textwidth]{\includegraphics{my-wide-figure}}% + \caption{This figure juts out into both margins} +\end{figure} +\end{verbatim} +\end{wideversion} +\begin{narrowversion} +\begin{verbatim} +\begin{figure} + \noindent + \makebox[\textwidth]{% + \includegraphics{my-wide-figure}% + }% + \caption{This figure juts out into both margins} +\end{figure} +\end{verbatim} +\end{narrowversion} +\end{quote} +Note the \csx{noindent}: the \csx{makebox} starts a paragraph, and you +really don't want that indented by \csx{parindent}. + \Question[Q-2colfloat]{Placing two-column floats at bottom of page} You specified placement `\texttt{[htbp]}' for your full-width figure or @@ -14721,10 +15246,26 @@ overtake ``real floats'', so that the numbers of figures will be out of order: figure 6 could be on page 12, while figure 5 had floated to page 13. It's best, therefore, either to stay with floating figures throughout a document, or to use fixed figures throughout. + +If it's really impossible to follow that counsel of perfection, you +can use the \Package{perpage} package's command \csx{MakeSorted} +command: +\begin{quote} +\begin{verbatim} +... +\usepackage{float} +\usepackage{perpage} +\MakeSorted{figure} +\MakeSorted{table} +... +\end{verbatim} +\end{quote} +and the sequence of float numbers is all correct. \begin{ctanrefs} \item[capt-of.sty]\CTANref{capt-of} \item[caption.sty]\CTANref{caption} \item[float.sty]\CTANref{float} +\item[perpage.sty]Distributed as part \CTANref{bigfoot} \end{ctanrefs} \subsection{Footnotes} @@ -14832,12 +15373,18 @@ To suppress the footnote in headings and table of contents: Footnotes in captions are especially tricky: they present problems of their own, on top of the problems one experiences with -\Qref*{footnotes in section titles}{Q-ftnsect} and with % ! line break -\Qref*{footnotes in tables}{Q-footintab}. Fortunately, the -requirement for footnotes in captions is extremely rare: if you are -experiencing problems, it is worth reviewing what you are trying to -say by placing this footnote. Note that the \Package{threeparttable} -scheme (see, again, % ! line break +\Qref*{footnotes in section titles}{Q-ftnsect} (footnotes migrating to +to the list of figures or tables, or % ! line break +\Qref{apparently random errors}{Q-extrabrace} because +\csx{footnote} is a fragile command), and with % ! line break +\Qref*{footnotes in tables}{Q-footintab} (typically, the footnote +simply disappears). Fortunately, the requirement for footnotes in +captions is extremely rare: if you are experiencing problems, it is +worth reviewing what you are trying to say by placing this footnote: +other options are to place text at the bottom of the float, or to +place a footnote at the point where you refer to the float. + +Note that the \Package{threeparttable} scheme (see, again, % ! line break \Qref[question]{footnotes in tables}{Q-footintab}) also applies to notes in captions, and may very well be preferable to whatever you were thinking of. @@ -14872,10 +15419,10 @@ command in a \environment{minipage} environment within a float (as in the example above) can produce \emph{two} copies of the footnote body ``blah''. (In fact, the effect only occurs with captions that are long enough to require two lines to be typeset, and so wouldn't appear -with such a short caption.) +with such a short caption as that in the example above.) The documentation of the \Package{ccaption} package describes a really -rather awful work-around. +rather awful work-around for this problem. \begin{ctanrefs} \item[ccaption.sty]\CTANref{ccaption} \item[threeparttable.sty]\CTANref{threeparttable} @@ -15000,13 +15547,13 @@ The obvious solution is to make the footnote number reset whenever the page number is stepped, using the % ! line break \Qref*{\LaTeX{} internal mechanism}{Q-addtoreset}. Sadly, the place in the document where the page number is stepped is unpredictable, not -(``tidily'') at the end of the printed page; so the link only ever -works by luck. +(``tidily'') at the end of the printed page; so changing the footnote +number only ever works by `luck'. As a result, resetting footnotes is inevitably a complicated process, using labels of some sort. It's nevertheless important, given the common requirement for footnotes marked by symbols (with painfully -small symbol sets). There are three packages that manage it, one way +small symbol sets). There are four packages that manage it, one way or another. The \Package{perpage} package provides a general mechanism for @@ -15015,7 +15562,14 @@ The interface is pretty simple: \cmdinvoke{MakePerPage}{footnote} will do the job. If you want to restart the counter at something other than~1 (for example to avoid something in the \LaTeX{} footnote symbol list), you can use: \cmdinvoke{MakePerPage}[2]{footnote}. It's a -first-rate package, small and efficient +first-rate package, small and efficient. + +The \Package{zref} package provides the same facilities with its +\pkgoption{perpage} module, which defines a command \csx{zmakeperpage} +whose syntax is identical to that of \Package{perpage}, above. You can +load the module by \cmdinvoke{usepackage}[perpage]{zref} (or as +\cmdinvoke{usepackage}{zref-perpage}, if your needs so require~--- +look at \Package{zref}'s documentation for details). The \Package{footmisc} package provides a variety of means of controlling footnote appearance, among them a package option @@ -15031,6 +15585,9 @@ probably not particularly useful any more. (Documentation is \item[footmisc.sty]\CTANref{footmisc} \item[footnpag.sty]\CTANref{footnpag} \item[perpage.sty]Distributed as part \CTANref{bigfoot} +\item[zref.sty]Distributed as a collection member in \CTANref{oberdiek} +\item[zref-perpage.sty]Distributed as a collection member in + \CTANref{oberdiek} \end{ctanrefs} \Question[Q-run-fn-nos]{Not resetting footnote numbers per chapter} @@ -15560,8 +16117,8 @@ following minimal solution: \begin{wideversion} \begin{verbatim} \def\RCS$#1: #2 ${\expandafter\def\csname RCS#1\endcsname{#2}} -\RCS$Revision: 1.548 $ % or any RCS keyword -\RCS$Date: 2008/06/20 13:37:44 $ +\RCS$Revision: 1.612 $ % or any RCS keyword +\RCS$Date: 2009/06/09 22:45:20 $ ... \date{Revision \RCSRevision, \RCSDate} \end{verbatim} @@ -15571,8 +16128,8 @@ following minimal solution: \def\RCS$#1: #2 ${\expandafter \def\csname RCS#1\endcsname{#2}% } -\RCS$Revision: 1.548 $ % or any RCS keyword -\RCS$Date: 2008/06/20 13:37:44 $ +\RCS$Revision: 1.612 $ % or any RCS keyword +\RCS$Date: 2009/06/09 22:45:20 $ ... \date{Revision \RCSRevision, \RCSDate} \end{verbatim} @@ -16230,25 +16787,14 @@ the selections before setting up hyphenation exceptions. Knuth was making a particular point about the capabilities of \TeX{} when he defined the logo. Unfortunately, many believe, he thereby opened floodgates to give the world a whole range of rather silly -`bumpy road' logos such as \AMSTeX{}, \PiCTeX{}, \BibTeX{}, and so on, -produced in a flurry of different fonts, sizes, and baselines~--- indeed, -everything one might hope to cause them to obstruct the reading process. -In particular, Lamport invented \LaTeX{} -\htmlignore -(silly enough in itself) -\endhtmlignore -\begin{htmlversion} - (silly enough in itself, with a raised small `A' and a lowered `E') -\end{htmlversion} -and marketing input from Addison-Wesley led to the even -stranger current logo -\htmlignore -\LaTeXe{}. -\endhtmlignore -\begin{htmlversion} - \LaTeXe{}, which appends a lowered single-stroke Greek letter - epsilon. -\end{htmlversion} +`bumpy road' logos for \TeX{} entities such as \AMSTeX{}, \PiCTeX{}, +\BibTeX{}, and so on, produced in a flurry of different fonts, sizes, +and baselines~--- indeed, everything one might hope to cause them to +obstruct the reading process. In particular, Lamport invented +\LaTeX{} (silly enough in itself, with a raised small `A' and a +lowered `E') and marketing input from Addison-Wesley led to the even +stranger current logo for \LaTeXe{}, which appends a lowered % !line break +\latexhtml{\ensuremath{\varepsilon}}{single-stroke Greek letter ε}. Sensible users don't have to follow this stuff wherever it goes, but, for those who insist, a large collection of logos is defined in @@ -16265,23 +16811,16 @@ use of the Knuthian font for \MP{} (you might get % which is nice, given the feebleness of representing all these silly % logos in html otherwise... \begin{htmlversion} - something like `META O T'). + something like `META\ \ O\ \ T'). \end{htmlversion} -You needn't despair, however~--- the author himself uses just `MetaPost'. +You needn't despair, however~--- most versions of the logo font +distributed nowadays contain the missing letters, and the author +himself uses just `MetaPost'. For those who don't wish to acquire the `proper' logos, the canonical thing to do is to say \texttt{AMS-}\cmdinvoke{TeX}{} -\htmlignore -(\acro{AMS}-\TeX{}) -\endhtmlignore for \AMSTeX{}, \texttt{Pic}\cmdinvoke{TeX}{} -\htmlignore -(Pic\TeX{}) -\endhtmlignore for \PiCTeX{}, \texttt{Bib}\cmdinvoke{TeX}{} -\htmlignore -(Bib\TeX{}) -\endhtmlignore for \BibTeX{}, and so on. \begin{ctanrefs} \item[mflogo.sty]\CTANref{mflogo} @@ -16433,24 +16972,70 @@ a variety of jobs. \section{Symbols, etc.} +\Question[Q-usesymb]{Using symbols} + +Most symbol font sets come with a package that defines commands for +every symbol in the font. While this is convenient, it can lead to +difficulties, particularly with name clashes when you load packages +that cover fonts which duplicate symbols~--- an issue which is +discussed in +\begin{narrowversion} + \Qref[question]{}{Q-alreadydef}. +\end{narrowversion} +\begin{wideversion} + ``\Qref{symbol already defined}{Q-alreadydef}''. +\end{wideversion} +Some font sets (for example, \FontName{MnSymbol}) are huge, and the +accompanying macros cover so many symbols that name clashes are surely +a serious problem. + +The \Package{pifont} package (originally designed to use the Adobe +\FontName{Zapf Dingbats} font) avoids this sort of problem: it requires +you to know the font position of any symbol you want to use (the +documentation provides font tables). The basic command is +\cmdinvoke*{ding}{number} for a single symbol; there are commands for +other fancier uses. \Package{Pifont} also allows you to select other +fonts, for similar use. + +The \Package{yagusylo} describes itself as ``an extended version of +\Package{pifont}, gone technicolor''. It provides all the facilities +of \Package{pifont}, but allows you to create your own mnemonic names +for symbols. Thus, while you can say % ! line break +\cmdinvoke*{yagding}[family]{symbol number}[colour], you can also +define symbol names with \csx{defdingname}, and then use them +with \cmdinvoke*{yagding*}{symbol name} (the defined name carries the +font family and colour specified in the arguments of +\csx{defdingname}). + +\Package{Yagusylo} is somewhat complicated, but its documentation is +clear; it is probably the best tool to use for picking and choosing +symbols from a variety of font families. +\begin{ctanrefs} +\item[mnsymbol \nothtml{\rmfamily}fonts]\CTANref{mnsymbol} +\item[pifont.sty]Distributed as part of \CTANref{psnfss} +\item[yagusylo.sty]\CTANref{yagusylo} +\end{ctanrefs} + \Question[Q-numbersets]{Symbols for the number sets} -It is a good idea to have commands such as \csx{R} for the real numbers and +Mathematicians commonly use special lettering for the real numbers and other standard number sets. Traditionally these were typeset in bold. Because, in the ordinary course of events, mathematicians do not have -access to bold chalk, they invented the special symbols that are now -often used for \csx{R}, \csx{C}, \emph{etc}. These symbols are known -as ``blackboard bold''. Before insisting on using them, consider -whether going back to the old system of ordinary bold might not be -acceptable (it is certainly simpler). +access to bold chalk, they invented special symbols that are now +often used for the number sets; these symbols are known as +``blackboard bold'' (or double-stroked fonts); in place of the heavier +strokes of a bold font, (some) strokes of the letters are doubled. +The minimum useful set is upper-case letters `I', `N', `R', `Q' and +`Z'; some fonts offer a figure `1' (for a unit matrix~--- not a number +set at all). A set of blackboard bold capitals is available in the \acro{AMS} \FontName{msbm} fonts (\FontName{msbm} is available at a range of -design sizes, with names such as \FontName{msbm10}). The pair of font +design sizes, with names such as \FontName{msbm10}). The pair of font families (the other is called \FontName{msam}) have a large number of -mathematical symbols to supplement the ones in the standard \TeX{} -distribution, and are available in Type~1 format with most modern -distributions. Support files for using the fonts, both under +mathematical symbols to supplement those provided in the Knuth's +original \TeX{} distribution, and are available in Type~1 format in +modern distributions. Support files for using the fonts, both under \plaintex{} and \LaTeX{} (packages \Package{amssymb} and \Package{amsfonts}), are available. The font shape is a rather austere sans, which many people don't like (though it captures the @@ -16472,6 +17057,11 @@ and sans shapes, at a single weight, and is available both as \MF{} sources and as Type~1; the font covers the uppercase latin letters, lowercase `h' and 'k', and the digit `1'. +A document that shows the \FontName{bbm}, \FontName{bbold}, +\FontName{doublestroke} and \FontName{msbm} fonts, so that you can get +a feel for their appearance, is available (\acro{CTAN} package +\Package{blackboard}). + An alternative source of Type~1 fonts with blackboard bold characters may be found in the steadily increasing set of complete families, both commercial and free, that have been prepared for use with \AllTeX{} @@ -16488,23 +17078,24 @@ the digit `1', and lower-case `k'. The ``lazy person's'' blackboard bold macros: \begin{quote} \begin{verbatim} -\newcommand{\R}{{\sf R\hspace*{-0.9ex}% +\newcommand{\R}{{\textsf{R}\hspace*{-0.9ex}% \rule{0.15ex}{1.5ex}\hspace*{0.9ex}}} -\newcommand{\N}{{\sf N\hspace*{-1.0ex}% +\newcommand{\N}{{\textsf{N}\hspace*{-1.0ex}% \rule{0.15ex}{1.3ex}\hspace*{1.0ex}}} -\newcommand{\Q}{{\sf Q\hspace*{-1.1ex}% +\newcommand{\Q}{{\textsf{Q}\hspace*{-1.1ex}% \rule{0.15ex}{1.5ex}\hspace*{1.1ex}}} -\newcommand{\C}{{\sf C\hspace*{-0.9ex}% +\newcommand{\C}{{\textsf{C}\hspace*{-0.9ex}% \rule{0.15ex}{1.3ex}\hspace*{0.9ex}}} \end{verbatim} \end{quote} are almost acceptable at normal size if the surrounding text is -\FontName{cmr10}. However, they are not part of a proper maths font, -and so do not work in sub- and superscripts. Moreover, the size and -position of the vertical bar can be affected by the font of the -surrounding text. As we've seen, there are plenty of alternatives: -don't try the macros, or anything similar using capital `I' (which -looks even worse!). +\FontName{cmr10} (the position of the vertical bar can be affected by +the surrounding font). However, they are not part of a proper maths font, +and do not work in sub- and superscripts. As we've seen, there are +plenty of alternatives: that mythical ``lazy'' person can inevitably +do better than the macros, or anything similar using capital `I' +(which looks even worse!). Voluntary \AllTeX{} effort has redefined +the meaning of laziness (in this respect!). \begin{ctanrefs} \item[AMS support files (Plain)]\CTANref{amsfonts-plain} \item[AMS support files (LaTeX)]\CTANref{amsfonts-latex} @@ -16513,6 +17104,7 @@ looks even worse!). \item[bbm fonts]\CTANref{bbm} \item[bbm macros]\CTANref{bbm-macros} \item[bbold fonts]\CTANref{bbold} +\item[blackboard \nothtml{\rmfamily}evaluation set]\CTANref{blackboard} \item[doublestroke fonts]\CTANref{doublestroke} \item[fourier fonts]\CTANref{fourier} \item[mathpazo fonts]\CTANref{mathpazo} @@ -16535,11 +17127,9 @@ modern \TeX{} distributions. distribution. \item[RSFS] The \Package{mathrsfs} package uses a really fancy script font (the name stands for ``Ralph Smith's Formal Script'') which is - already part of most modern \TeX{} distributions. The package + already part of most modern \TeX{} distributions (Type~1 versions of + the font are also provided, courtesy of Taco Hoekwater). The package creates a new command \csx{mathscr}. - - Type 1 versions of the font have been made available by Taco - Hoekwater. \item[Zapf Chancery] is the standard \PS{} calligraphic font. There is no package but you can easily make it available by means of the command @@ -16560,8 +17150,9 @@ modern \TeX{} distributions. Adobe Zapf Chancery (which the above examples use) is distributed in any but the most basic \PS{} printers. A substantially identical font (to the extent that the same metrics may be used) is - available from \acro{URW} and is distributed with - \ProgName{ghostscript}. + available from \acro{URW}, called URW Chancery L: it is distributed + with Ghostscript, and as part of the ``URW base35'' bundle, which is + available in most distributions. \end{description} Examples of the available styles are available on \acro{CTAN}. \begin{ctanrefs} @@ -16571,8 +17162,8 @@ Examples of the available styles are available on \acro{CTAN}. \item[ghostscript]Browse \CTANref{ghostscript} \item[mathrsfs.sty]Distributed as part of \CTANref{jknappen-macros} \item[rsfs fonts]\CTANref{rsfs} -\item[rsfs fonts, in Type 1 format]\CTANref{rsfs-type1} \item[Script font examples]\CTANref{mathscript} +\item[URW Chancery L]Distributed as part of \CTANref{urw-base35} \end{ctanrefs} \Question[Q-boldgreek]{Setting bold Greek letters in \LaTeX{}} @@ -16831,12 +17422,252 @@ errors: you \emph{must} use \end{verbatim} \end{quote} +\Question[Q-osf]{Using ``old-style'' figures} + +These numbers are also called medieval or lowercase figures and their +use is mostly font-specific. Terminology is confusing since the +lining figures (which are now the default) are a relatively recent +development (19th century) and before they arrived, oldstyle figures +were the norm, even when setting mathematics. (An example is Thomas +Harriot's \emph{Artis Analyticae Praxis} published in 1631). In a +typical old style 3, 4, 5, 7 and 9 have descenders and 6 and 8 ascend +above the x-height; sometimes 2 will also ascend (this last seems to +be a variation associated with French typography). + +\LaTeX{} provides a command \cmdinvoke*{oldstylenums}{digits}, which +by default uses an old-style set embedded in Knuth's `math italic' +font. The command isn't sensitive to the font style of surrounding +text: the glyphs are only available to match the normal medium weight +Computer Modern Roman fonts. + +The \Package{textcomp} package changes \csx{oldstylenums} to use the +glyphs in the Text Companion fonts (\LaTeX{} \acro{TS}1 encoding) when +in text mode, and also makes them available using the macros of the +form \csx{textoldstyle}, e.g., \csx{textzerooldstyle}. +(Of course, not all font families can provide this facility.) + +Some font packages (e.g., \Package{mathpazo}) make old-style figures +available and provide explicit support for making them the default: +\cmdinvoke{usepackage}[osf]{mathpazo} selects a form where digits are +always old-style in text. The \Package{fontinst} package will +automatically generate ``old-style versions'' of commercial Adobe Type +1 font families for which ``expert'' sets are available. + +It's also possible to make virtual fonts, that offer old-style digits, +from existing font packages. The \FontName{cmolddig} bundle provides +a such a virtual version of Knuth's originals, and the \FontName{eco} +or \FontName{hfoldsty} bundles both provide versions of the \acro{EC} +fonts. The \FontName{lm} family offers old-style figures to OpenType +users (see below), but we have no stable mapping for \FontName{lm} +with old-style digits from the Adobe Type 1 versions of the fonts. + +Originally, oldstyle figures were only to be found the expert sets of +commercial fonts, but now they are increasingly widely available. An +example is Matthew Carter's Georgia font, which has old-style figures +as its normal form (the font was created for inclusion with certain +Microsoft products and is intended for on-screen viewing). + +OpenType fonts have a pair of axes for number variations~--- +proportional/tabular and lining/oldstyle selections are commonly +available. ``Full feature access'' to OpenType fonts, making such +options available to the \AllTeX{} user, is already supported by +\Qref*{\xetex{}}{Q-xetex} using, for example, the \Package{fontspec} +package. Similar support is also in the works for +\Qref*{\LuaTeX{}}{Q-luatex}. +\begin{ctanrefs} +\item[cmolddig \nothtml{\rmfamily}fonts]\CTANref{cmolddig} +\item[eco \nothtml{\rmfamily}fonts]\CTANref{eco} +\item[fontinst]\CTANref{fontinst} +\item[fontspec.sty]\CTANref{fontspec} +\item[mathpazo \nothtml{\rmfamily}fonts]\CTANref{mathpazo} +\end{ctanrefs} + %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% \section{Macro programming} \subsection{``Generic'' macros and techniques} +\Question[Q-linmacnames]{Non-letters in macro names} + +New \LaTeX{} users are often suprised that macro definitions +containing non-letters, such as +\begin{quote} +\begin{verbatim} +\newcommand{\cul8r}{Goodbye!} +\end{verbatim} +\end{quote} +fail to compile. The reason is that the \TeX{} macro language, unlike +most programming languages, allows % ! loin break (twatbili) +\Qref*{nothing but letters in macro names}{Q-whatmacros}. + +There are a number of techniques for defining a macro with a name like +\csx{cul8r}. Unfortunately, none of the techniques is particularly +good: +\begin{enumerate} +\item Use \csx{csname}\dots\csx{endcsname} to define and invoke the + macro: + \begin{quote} +\begin{narrowversion} +\begin{verbatim} +\expandafter\newcommand + \csname cul8r\endcsname{Goodbye!} +I said, ``\csname cul8r\endcsname''. +\end{verbatim} +\end{narrowversion} +\begin{wideversion} +\begin{verbatim} +\expandafter\newcommand\csname cul8r\endcsname{Goodbye!} +I said, ``\csname cul8r\endcsname''. +\end{verbatim} +\end{wideversion} + \end{quote} + \begin{description} + \item[Pro:] No unexpected side effects + \item[Con:] So verbose as to be unusable + \end{description} +\item Define a ``special-command generator'', and use the resulting + commands: +\begin{quote} +\begin{narrowversion} +\begin{verbatim} +\newcommand{\DefineRemark}[2]{% + \expandafter\newcommand + \csname rmk-#1\endcsname{#2}% +} +\newcommand{\Remark}[1]{% + \csname rmk-#1\endcsname% +} +... +\DefineRemark{cul8r}{Goodbye!} +... +I said, ``\Remark{cul8r}''. +\end{verbatim} +\end{narrowversion} +\begin{wideversion} +\begin{verbatim} +\newcommand{\DefineRemark}[2]{% + \expandafter\newcommand\csname rmk-#1\endcsname{#2}% +} +\newcommand{\Remark}[1]{\csname rmk-#1\endcsname} +... +\DefineRemark{cul8r}{Goodbye!} +... +\Remark{cul8r} +\end{verbatim} +\end{wideversion} +\end{quote} + \begin{description} + \item[Pro:] Straightforward to use, not too untidy + \item[Con:] It's hardly doing what we set out to do (experts will + see that you are defining a macro, but others likely won't) + \end{description} +\item Convince \TeX{} that ``\texttt{8}'' is a letter: + \begin{quote} +\begin{verbatim} +\catcode`8 = 11 +\newcommand{\cul8r}{Goodbye!} +I said, ``\cul8r''. +\end{verbatim} + \end{quote} + \begin{description} + \item[Pro:] \csx{cul8r} can be used directly + \item[Con:] Likely to break other uses of ``\texttt{8}'' (such as + numbers or dimensions; so + \cmdinvoke{setlength}{\csx{paperwidth}}{8in} tells us: + \begin{quote} +\begin{verbatim} +! Missing number, treated as zero. + + 8 +\end{verbatim} + \end{quote} + \end{description} + As a general rule, changing category codes is something to use + \emph{in extremis}, after detailed examination of options. It is + conceivable that such drastic action could be useful for you, but + most ordinary users are well advised not even to try such a + technique. +\item Define a macro \csx{cul} which must always be followed by + ``\texttt{8r}'': + \begin{quote} +\begin{verbatim} +\def\cul8r{Goodbye!} +I said, ``\cul8r''. +\end{verbatim} + \end{quote} + \begin{description} + \item[Pro:] \csx{cul8r} can be used directly + \item[Con~\#1:] Breaks if \csx{cul} is followed by anything other + than ``\texttt{8r}'', with a confusing diagnostic~--- + \csx{cul99} produces: + \begin{quote} +\begin{wideversion} +\begin{verbatim} +! Use of \cul doesn't match its definition. +<*> \cul9 + 9 +\end{verbatim} +\end{wideversion} +\begin{narrowversion} +\begin{verbatim} +! Use of \cul doesn't match its + definition. +<*> \cul9 + 9 +\end{verbatim} +\end{narrowversion} + \end{quote} + (which would confuse someone who hadn't even realised there + \emph{was} a definition of \csx{cul} in the document). + \item[Con~\#2:] Silently redefines existing \csx{cul}, if any; + as a result, the technique cannot be used to define both a + \csx{cul8r} and, say, a \csx{cul123} macro in the same + document. + \end{description} +\end{enumerate} +Technique~3 is in fact commonly used~--- in a limited form~--- within +most \LaTeX{} packages and within \LaTeX{} itself. The convention is to +use ``\texttt{@}'' within the names of internal macros to hide them +from the user and thereby prevent naming conflicts. To this end, +\LaTeX{} automatically treats ``\texttt{@}'' as a letter while +processing classes and packages and as a non-letter while processing +the user's document. The key to this technique is the separation: +internally a non-letter is used for macro names, and the user doesn't +see anything of it, while the status remains ``frozen'' in all the +definitions created within the class or package. See % ! line break +\Qref[question]{\csx{@} and \texttt{@} in macro names}{Q-atsigns} for +more information. + +Note that analogous use of technique~3 in this example would give us +\begin{quote} +\begin{verbatim} +\begingroup + \catcode`8 = 11 + \gdef\cul8r{Goodbye!} + \gdef\later{\cul8r} +\endgroup +I said, ``\later''. +\end{verbatim} +\end{quote} +which works, but rather defeats the object of the exercise. +(\csx{later} has the ``frozen'' catcode for `8', even though the value +has reverted to normal by the time it's used; note, also, the use of +the primitive command \csx{gdef}, since \csx{newcommand} can't make a +macro that's available outside the group.) + +\emph{Recommendation}: Either choose another mechanism (such as +\csx{DefineRemark} above), or choose another name for your macro, one +that contains only ordinary letters. A common approach is to use +roman numerals in place of arabic ones: +\begin{quote} +\begin{verbatim} +\newcommand{\culVIIIr}{Goodbye!} +\end{verbatim} +\end{quote} +which rather spoils the intent of the joke implicit in the example +\csx{cul8r}! + \Question[Q-findwidth]{Finding the width of a letter, word, or phrase} Put the word in a box, and measure the width of the box. For example, @@ -16877,7 +17708,7 @@ would naturally write: \end{quote} However, this would not work: a call to \csx{splat} would execute \csx{mumble}, and the call the redefined \csx{splat} again; this is an -infinite recursive loop, that will quickly exhaust \TeX{}'s memory. +unterminated recursion, that will quickly exhaust \TeX{}'s memory. Fortunately, the \TeX{} primitive \csx{let} command comes to our rescue; it allows us to take a ``snapshot'' of the current state of a @@ -16948,7 +17779,12 @@ The \Package{etoolbox} (which provides user access to \eTeX{}'s programming facilities) provides a command \csx{patchcmd} which will perform a ``string substitution'' in a macro's definition. The package also provides commands that prepend (\csx{pretocmd}) or append -(\csx{apptocmd}) to the definition of a command. +(\csx{apptocmd}) to the definition of a command. Not all commands may +be patched in this way; the package provides a command +\csx{ifpatchable} which checks the prerequisites, and checks that the +target command's body does indeed include the patch string you propose +to use. (The command \csx{ifpatchable*} omits the test on the patch +string.) Finally, we'll briefly consider a package that is (just about) usable, but not really recommendable. \Package{Patch} gives you an @@ -16966,7 +17802,7 @@ Fortunately, the file (\File{patch.doc}) may be input directly, and Roughly speaking, one gives the command a set of instructions analogous to \ProgName{sed} substitutions, and it regenerates the command thus amended. Unless you can't do your job any other way, you -had probably best avoid \Package{Patch}. +had probably best avoid \Package{patch}. \begin{ctanrefs} \item[etoolbox.sty]\CTANref{etoolbox} \item[patch.doc]\CTANref{patch} @@ -17414,6 +18250,179 @@ accurately. \item[keyval.sty]Distributed as part of \CTANref{graphics} \end{ctanrefs} +\Question[Q-keyval]{Key-value input for macros and package options} + +When we discussed % !line break +\Qref*{extending the number of arguments to a macro}{Q-moren9}, we +suggested that large numbers of arguments, distinguished only by their +position, aren't very kind to the user, and that a package such as +\Package{keyval} offers a more attractive user interface. We now +consider the packages that the macro programmer might use, to create +such a user interface. + +The simplest key-value processor remains \Package{keyval}; it has a +command \csx{define@key} to declare a key and a \emph{handler} to +process it, and a macro \csx{setkeys} to offer values to the handler +of one or more keys. Thus: +\begin{quote} +\begin{verbatim} +\define@key{my}{foo}{Foo is #1\par} +\define@key{my}{bar}[99]{Bar is #1\par} +... +\setkeys{my}{foo=3,bar} +\end{verbatim} +\end{quote} +will produce output saying: +\begin{quote} + Foo is 3\par{} + Bar is 99 +\end{quote} +This has defined two keys `\texttt{foo}' and `\texttt{bar}' in family +`\texttt{my}', and then executed them, the first with argument +`\texttt{3}' and the second with no argument, so that the default +value of `\texttt{99}' is picked up. In effect, the two calls to +\csx{define@key} are simply defining commands, as (for example): +\begin{quote} +\begin{verbatim} +\newcommand{\KV@my@foo}[1]{Foo is #1} +\end{verbatim} +\end{quote} +(the definition of \csx{KV@my@bar} is similar, but trickier). The +command \csx{setkeys} knows how to find those commands when it needs to +process each key~--- it is easy to regurgitate the structure of the +command name, with family name (`\texttt{my}', here) after the first +`\texttt{@}', and the key name after the second `\texttt{@}'. (The +`\texttt{KV}' part is fixed, in \Package{keyval}.) + +These simple commands are enough, in fact, to process the botanical +example offered as replacement for multi-argument commands in % ! line break +\Qref[question]{the question mentioned above}{Q-moren9}, or the +optional arguments of the \csx{includegraphics} command of the +\Package{graphicx} package. (The last is, in fact, what +\Package{keyval} was designed to do.) + +However, we need more if we're to to have package options in +`key-value' form. Packages like \Package{hyperref} have enormously +complicated package options which need key-value processing at +\csx{ProcessOptions} time: \Package{keyval} can't do that on its own. + +Heiko Oberdiek's \Package{kvoptions} package comes to our help: it +enables the programmer to declare class or package options that +operate as key and value pairs. The package defines commands +\csx{DeclareBoolOption} for options whose value should be either +\emph{true} or \emph{false}, and \csx{DeclareStringOption} for all +other options that have a value. Keys are declared using +\Package{keyval} and may remain available for use within the document, +or may be `cancelled' to avoid confusion. If you have loaded +\Package{kvoptions}, the \LaTeX{} kernel's \csx{DeclareOption} becomes +\csx{DeclareVoidOption} (it's an option with no value), and +\csx{DeclareOption*} becomes \csx{DeclareDefaultOption}. + +Heiko also provides \Package{kvsetkeys} which is a more robust version +of \Package{setkeys}, with some of the rough edges made smoother. + +Hendri Adriaens' \Package{xkeyval} offers more flexibility than +the original \Package{keyval} and is more robust than the original, +too. Like \Package{kvoptions}, the package also has mechanisms to +allow class and package options in key-value form (macros +\csx{DeclareOptionX}, \csx{ExecuteOptionsX} and \csx{ProcessOptionsX}. +\Package{Pstricks} bundle packages use a \Package{xkeyval} derivative +called \Package{pst-xkey} for their own key-value manipulation. +% xkvview? (i think we can ignore xkvltxp for these purposes) + +The (widely-respected) \Package{pgf} graphics package has its own +key-value package called \Package{pgfkeys}. The documentation of the +package (part of the huge \Package{pgf} manual, in part 5, +``utilities'') contains a useful comparison with other key-value +systems; some notable differences are: +\begin{itemize} +\item key organisation: \Package{pgfkeys} uses a tree structure, while + \Package{keyval} and \Package{xkeyval} both associate keys with a family; +\item \Package{pgfkeys} supports multi-argument key code; and +\item \Package{pgfkeys} can support call-backs when an unknown key + appears (these things are called \emph{handlers}. +\end{itemize} +Keys are organized in a tree that is reminiscent of the Unix fille +tree. A typical key might be, \File{/tikz/coordinate system/x} or +just \File{/x}. When you specify keys you can provide the complete +path of the key, but you usually just provide the name of the key +(corresponding to the file name without any path) and the path is +added automatically. So a \csx{pgfkeys} command might be: +\begin{wideversion} +\begin{quote} +\begin{verbatim} +\pgfkeys{/my key=hello,/your keys/main key=something\strange, + key name without path=something else} +\end{verbatim} +\end{quote} +\end{wideversion} +\begin{narrowversion} +\begin{quote} +\begin{verbatim} +\pgfkeys{/my key=hello, + /your keys/main key=something\strange, + key name without path=something else} +\end{verbatim} +\end{quote} +\end{narrowversion} +and for each key mentioned, the associated code will be executed. +\dots{} and that code is also set up using \csx{pgfkeys}: +\begin{quote} +\begin{verbatim} +\pgfkeys{/my key/.code=The value is '#1'.} +\end{verbatim} +\end{quote} +after which +\begin{quote} +\begin{verbatim} +\pgfkeys{/my key=hi!} +\end{verbatim} +\end{quote} +will produce just +\begin{quote} + The value is 'hi!'. +\end{quote} +The manual goes on, showing how to define a key with two arguments, +how to provide default value for a key, and how to define aliases for +particular key sequences (which are called ``styles''). All in all, +it seems a well thought-out system, offering a lot of flexibility that +isn't available with the other keys packages. However, there seems to +be no mechanism for using \Package{pgfkeys} keys as part of the +options of another package, in the way that \Package{kvoptions} does. + +Another key-value system that's part of larger set of macros is +\Package{scrbase}, which uses the facilities of \Package{keyval} to +build a larger set of facilities, originally for use within the +\Class{KOMA-script} bundle. For English-speaking authors, there are +difficulties from the German-only documentation; however, from a +partial translation available to the author of this answer, a summary +is possible. The package may build on the facilities either of +\Package{kyeval} or of \Package{xkeyval}, and builds its functionality +on the structure of the `key family'. The user may define family +`members' and keys are defined relative to the members. (For example, +the package \Package{scrbase} is part of the \Class{KOMA-script} +bundle; so its keys are all members of the \Package{scrbase.sty} +family within the \Package{KOMA} family. The function +\csx{FamilyProcessOptions} allows the programmer to decode the options +of the package in terms of the package's key family. Note that there +is no special provision made for ``traditional'' package options, as +in the \Package{kvoptions} package. + +This brief summary was guided by input from two sources: a draft article +for \textsl{TUGboat} by Joseph Wright, and the partial translation of the +documentation of package \Package{scrbase} prepared by Philipp +Stephani. At Joseph's suggestion, discussion of his \Package{keys3} +package, which is designed for use with the experimental \LaTeX{}3, +has been omitted. +\begin{ctanrefs} +\item[keyval.sty]Distributed as part of \CTANref{graphics} +\item[kvoptions.sty]Distributed as part of \CTANref{oberdiek} +\item[kvsetkeys.sty]Distributed as part of \CTANref{oberdiek} +\item[pgfkeys.sty]Distributed as part of \CTANref{pgf} +\item[scrbase.sty]Distributed as part of \CTANref{koma-script} +\item[xkeyval.sty]\CTANref{xkeyval} +\end{ctanrefs} + \Question[Q-activechars]{Defining characters as macros} Single characters can act as macros (defined commands), and both @@ -17827,9 +18836,9 @@ was present in the very first releases of \PDFTeX{}) is \begin{quote} \begin{verbatim} \ifx\pdfoutput\undefined - + ... % not running PDFTeX \else - + ... % running PDFTeX \fi \end{verbatim} \end{quote} @@ -17852,12 +18861,12 @@ test may need to be elaborated: \begin{quote} \begin{verbatim} \ifx\pdfoutput\undefined - + ... % not running PDFTeX \else \ifx\pdfoutput\relax - + ... % not running PDFTeX \else - + ... % running PDFTeX \fi \fi \end{verbatim} @@ -17871,16 +18880,16 @@ output, you also need to know about the value of \csx{pdfoutput}: \begin{quote} \begin{verbatim} \ifx\pdfoutput\undefined - + ... % not running PDFTeX \else \ifx\pdfoutput\relax - + ... % not running PDFTeX \else - + % running PDFTeX, with... \ifnum\pdfoutput>0 - <...PDF output> + ... % PDF output \else - <...DVI output> + ... % DVI output \fi \fi \fi @@ -17889,8 +18898,17 @@ output, you also need to know about the value of \csx{pdfoutput}: The above is, in essence, what Heiko Oberdiek's \Package{ifpdf} package does; the reasoning is the \acro{FAQ}'s interpretation of Heiko's explanation. + +As an aside: there are now analogous packages \Package{ifxetex} and +\Package{ifluatex}, for the two up-and-coming \TeX{}-like engines (see +the ``\TeX{} project'' answers covering % ! line break +\Qref[\xetex{}~--- question]{\xetex{}}{Q-xetex}, and +\Qref[\LuaTeX{}~--- question]{\LuaTeX{}}{Q-luatex}). \begin{ctanrefs} \item[ifpdf.sty]Distributed with Heiko Oberdiek's packages \CTANref{oberdiek} +\item[ifluatex.sty]Distributed with Heiko Oberdiek's packages + \CTANref{oberdiek} +\item[ifxetex.sty]\CTANref{ifxetex} \end{ctanrefs} \Question[Q-subverttoks]{Subverting a token register} @@ -18986,19 +20004,13 @@ then examined (in a \Package{hyperref}-safe way) to set a conditional \csx{ifoddpage}. Of course, the \csx{label} contributes to \LaTeX{}'s ``Rerun to get cross-references right'' error messages\dots{} -The (older) \Package{chngpage} provides the same facilities (though it -provides a \csx{ifcpoddpage} command; \Package{changepage} (whose -functions are extracted from the author's \Class{memoir} class) is the -designated successor to \Package{chngpage}. - The Koma-Script classes have an \environment{addmargin*} environment -that also provides the sorts of facilities that the \Package{chngpage} +that also provides the sorts of facilities that the \Package{changepage} offers. Koma-Script's supporting command is % !line break \cmdinvoke{ifthispageodd}{}{} executes different things depending on the page number. \begin{ctanrefs} \item[changepage.sty]\CTANref{changepage} -\item[chngpage.sty]\CTANref{chngpage} \item[\nothtml{\rmfamily}KOMA script bundle]\CTANref{koma-script} \item[memoir.cls]\CTANref{memoir} \end{ctanrefs} @@ -19962,7 +20974,7 @@ necessary?''. address or the like, then the \csx{url} command from the \Package{url} will help: it doesn't suffer from all the problems of \csx{verb}, though it's still not robust; % ! line break - ''\Qref*{typesetting \acro{URL}s}{Q-setURL}'' offers advice here. + ``\Qref*{typesetting \acro{URL}s}{Q-setURL}'' offers advice here. \item If you're putting \csx{verb} into the argument of a boxing command (such as \csx{fbox}), consider using the \environment{lrbox} environment: @@ -19983,13 +20995,13 @@ Otherwise, there are three partial solutions to the problem. \item Some packages have macros which are designed to be responsive to verbatim text in their arguments. For example, the \Package{fancyvrb} package defines a command - \csx{VerbatimFootnotes}, which redefines the \csx{footnotetext} (and - hence the \csx{footnote}) commands in such a way that you can include - \csx{verb} commands in its argument. This approach could in - principle be extended to the arguments of other commands, but it can - clash with other packages: for example, \csx{VerbatimFootnotes} - interacts poorly with the |para| option to the \Package{footmisc} - package. + \csx{VerbatimFootnotes}, which redefines the \csx{footnotetext} + command, and hence also the behaviour of the \csx{footnote}) + command, in such a way that you can include \csx{verb} commands in + its argument. This approach could in principle be extended to the + arguments of other commands, but it can clash with other packages: + for example, \csx{VerbatimFootnotes} interacts poorly with the + \pkgoption{para} option of the \Package{footmisc} package. The \Class{memoir} class defines its \csx{footnote} command so that it will accept verbatim in its arguments, without any supporting package. @@ -19998,8 +21010,9 @@ Otherwise, there are three partial solutions to the problem. and then to reuse the content of its argument; for details of this extremely powerful facility, see the package documentation. - Rather simpler is the \Package{verbdef} package, which defines a - (robust) command which expands to the verbatim argument given. + Rather simpler is the \Package{verbdef} package, whose \csx{verbdef} + command defines a (robust) command which expands to the verbatim + argument given. \item If you have a single character that is giving trouble (in its absence you could simply use \csx{texttt}), consider using \csx{string}. \cmdinvoke{texttt}{my\csx{string}\_name} @@ -20442,6 +21455,49 @@ parentheses, but the issue seldom arises since such arguments rarely contain text. If it were to arise, the same solution (enclosing the confused characters in braces) would solve the problem. +\Question[Q-pdf-fig-chars]{Characters disappear from figures in \PDFTeX{}} + +You have a \acro{PDF} figure, which you want to use in your +\PDFLaTeX{} document. When you compile the document, \PDFTeX{} +complains about ``missing glyphs'', and some (or all) of the labelling +text or symbols in the original figure is no longer visible. + +What has happened is: +\begin{enumerate} +\item Your figure file (say \File{fig.pdf}) has a font \File{font.pfb} + embedded in it. +\item \PDFTeX{} notes that it has \File{font.pfb} on disc, and loads + that in place of the copy in \File{fig.pdf}. +\item It turns out that the copy in \File{fig.pdf} has glyphs that + aren't in \File{font.pfb} on disc, so that you get errors while + compiling and you see that characters are missing when you view the + output. (\PDFTeX{} can't know that the fonts are different, since + they have the same name.) +\end{enumerate} +Which is all very undesirable. + +\PDFTeX{} does this to keep file sizes down: suppose you have a +document that loads figures \File{fig1.pdf} and \File{fig2.pdf}; both +of those use font \File{font.pfb}. If \PDFTeX{} takes no action, +there will be \emph{two} copies of \File{font.pfb} in the output. +(If your document also uses the font, there could be three copies.) + +A real case is the \acro{URW} font \File{NimbusRomNo9L-Regu} (a clone +of Times Roman), which is available in a version with Cyrillic +letters, while the version in \TeX{} distributions doesn't have those +letters. Both versions, as distributed, have the same name. + +The simple (``quick and dirty'') solution is to add the command +\begin{quote} + \csx{pdfinclusioncopyfonts}\texttt{=1} +\end{quote} +to the preamble of your document. + +The ``real'' solution is that one or other font should be renamed. In +either case, this would require that you reconfigure some program's +(\TeX{}'s or your drawing package's) font tables~--- inevitably a +tiresome job. + \subsection{Common misunderstandings} \Question[Q-include]{What's going on in my \csx{include} commands?} @@ -21863,16 +22919,18 @@ There is nothing that can directly be done about this error, as you can't extend the number of available registers without extending \TeX{} itself. \begin{htmlversion} - Of course, \Qref{\eTeX{}}{Q-etex} and \Qref{Omega}{Q-omegaleph} + Of course, \Qref{\eTeX{}}{Q-etex}, \Qref{Omega}{Q-omegaleph} and + \Qref{\LuaTeX{}}{Q-luatex} \end{htmlversion} \htmlignore % beware line wrap here - Of course, \ensuremath{\Omega} and \eTeX{}~--- - \Qref[see questions]{}{Q-omegaleph} \Qref[and]{}{Q-etex} respectively~--- + Of course, \eTeX{}, \ensuremath{\Omega} and \LuaTeX{}~--- + \Qref[see questions]{}{Q-etex} \Qref[,]{}{Q-omegaleph} and + \Qref[and]{}{Q-luatex} respectively~--- \endhtmlignore - both do this, as does \Qref*{MicroPress Inc's V\TeX{}}{Q-commercial}. +all do this, as does \Qref*{MicroPress Inc's V\TeX{}}{Q-commercial}. -The commonest way to encounter one of these error messages is to have +One common way to encounter one of these error messages is to have broken macros of some sort, or incorrect usage of macros (an example is discussed in \Qref[question]{epsf problems}{Q-epsf}). @@ -21880,14 +22938,41 @@ However, sometimes one just \emph{needs} more than \TeX{} can offer, and when this happens, you've just got to work out a different way of doing things. An example is the % beware line wrap \Qref*{difficulty of loading \PiCTeX{} with \LaTeX{}}{Q-usepictex}. -In cases like \PiCTeX{}, it may be possible to use -\Qref*{\eTeX{}}{Q-etex} (all modern distributions provide it). The -\LaTeX{} package \Package{etex} modifies the register allocation -mechanism to make use of \eTeX{}'s extended register sets (it's a +The more modern drawing package, \Package{pgf} with its higher-level +interface \Package{TikZ} is a common problem. + +In such cases, it is usually possible to use the +\Qref*{\eTeX{}}{Q-etex} extensions (all modern distributions provide +them). The \LaTeX{} package \Package{etex} modifies the register allocation +mechanism to make use of \eTeX{}'s extended register sets. +\Package{Etex} is a derivative of the \plaintex{} macro file \Package{etex.src}, which is used in building the \eTeX{} Plain format; both files are part of the -\eTeX{} distribution). Unfortunately, \eTeX{} doesn't help with -\csx{read} or \csx{write} objects. +\eTeX{} distribution and are available in current distributions. + +It is possible that, even with \Package{etex} loaded, you still find +yourself running out of things. Problems could be caused by packages +that use large numbers of ``inserts'' (combinations of counter, box, +dimension and skip registers, used for storing floats and footnotes). +\Package{Morefloats} does this, of course (naturally enough, +allocating new floats), and footnote packages such as +\Package{manyfoot} and \Package{bigfoot} (which uses \Package{manyfoot} +can also give problems. The \Package{etex} allows you to deal with +these things: the command \cmdinvoke*{reserveinserts}{n} ensures there +is room for \meta{n} more inserts. (Hint: \Package{morefloats} needs +18 inserts, and \Package{manyfoot} seems to be happy with 10 +reserved.) Load \Package{etex} before any others, and reserve the +inserts immediately: +\begin{quote} +\begin{verbatim} +\documentclass[...]{...} +\usepackage{etex} +\reserveinserts{28} +\end{verbatim} +\end{quote} + +Unfortunately, \eTeX{} doesn't help with \csx{read} or \csx{write} +objects (and neither will the \Package{etex} package). \Question[Q-epsf]{\texttt{epsf} gives up after a bit} @@ -22741,7 +23826,7 @@ However, for those improbable (or machine-generated) situations, some distributions offer the opportunity to adjust the parameter |max_in_open| in a configuration file. -\Question[Q-hyperdupdest]{\PDFTeX{} destination \dots{} ignored} +\Question[Q-hyperdupdest]{\PDFTeX{} destination \dots{}\ ignored} The warning: \begin{quote} @@ -23331,6 +24416,49 @@ This author has also encountered the error when developing macros that used the \LaTeX{} internal float mechanisms. Most people doing that sort of thing are expected to be able to work out their own problems\dots{} +\Question[Q-texorpdf]{Token not allowed in PDFDocEncoded string} + +The package \Package{hyperref} produces this error when it doesn't +know how to make something into a ``character'' that will go into one +of its \acro{PDF} entries. For example, the (unlikely) sequence +\begin{quote} +\begin{verbatim} +\newcommand{\filled}[2]{% + #1% + \hfil + #2% +} +\section{\filled{foo}{bar}} +\end{verbatim} +\end{quote} +provokes the error. \Package{Hyperref} goes on to tell you: +\begin{quote} +\begin{verbatim} +removing `\hfil' on input line ... +\end{verbatim} +\end{quote} +It's not surprising: how would \emph{you} put the +typesetting instruction \csx{hfil} into a \acro{PDF} bookmark? + +\Package{Hyperref} allows you to define an alternative for such +things: the command \csx{texorpdfstring}, which takes two +arguments~--- the first is what is typeset, the second is what is put +into the bookmark. For example, what you would probably like in this +case is just a single space in the bookmark; if so, the erroneous +example above would become: +\begin{quote} +\begin{verbatim} +\newcommand{\filled}[2]{% + #1% + \texorpdfstring{\hfil}{\space}% + #2% +} +\section{\filled{foo}{bar}} +\end{verbatim} +\end{quote} +and with that definition, the example will compile succesfully +(\Package{hyperref} knows about the macro \csx{space}). + \Question[Q-optionclash]{Option clash for package} So you've innocently added: @@ -23572,13 +24700,22 @@ found on the project web site (\URL{http://www.latex-project.org/papers/}), as is some of the project's experimental code (see \URL{http://www.latex-project.org/code.html}, which allows you to -read the project's source repository). You can +read the project's source repository); a recent snapshot of two major +collections from the code, \Package{expl3} and \Package{xpackages}, +are available. Contributed code, such as \Package{keys3} (for +key-value argument decoding) and \Package{numparse3} (for number +processing) are available in the \acro{CTAN} `\LaTeX{} experimental' tree. + +You can participate in discussions of the future of \LaTeX{} through the mailing list \texttt{latex-l}. Subscribe to the list by sending a message `\texttt{subscribe latex-l <\emph{your name}>}' to \mailto{listserv@urz.Uni-Heidelberg.de} \begin{ctanrefs} +\item[expl3 \nothtml{\rmfamily}bundle]\CTANref{expl3} +\item[keys3.sty]\CTANref{keys3} \item[\nothtml{\rmfamily}\LaTeX{} project publications]\CTANref{ltx3pub} +\item[xpackages \nothtml{\rmfamily}bundle]\CTANref{xpackages} \end{ctanrefs} \Question[Q-mathml]{Future \acro{WWW} technologies and \AllTeX{}} @@ -23672,25 +24809,27 @@ support for new Web standards. onus on the browser user; and however technically proficient \emph{you} are, it's never safe to assume too much of your readers. An interesting alternative is - \href{http://www.forkosh.com/mimetex.html}{Mime\TeX{}}, which sits + \href{http://www.forkosh.com/mathtex.html}{Math\TeX{}}, which sits on your server as a \acro{CGI} script, and you use it to include your \TeX{}, in your \acro{HTML}, as if it were an image: \begin{quote} \begin{wideversion} \begin{verbatim} - + \end{verbatim} \end{wideversion} \begin{narrowversion} \begin{verbatim} - \end{verbatim} \end{narrowversion} \end{quote} +(\Package{Mathtex} supersedes the author's earlier \Package{mimetex}.) \end{description} \begin{ctanrefs} \item[GELLMU]\CTANref{gellmu} +\item[MathTeX]\CTANref{MimeTeX} \item[MimeTeX]\CTANref{MimeTeX} \item[TeX4HT]\CTANref{tex4ht} \end{ctanrefs} @@ -23833,19 +24972,113 @@ separate window), degree of correspondence of the display to the final output, and the balance they strike between visual aid and visual distraction. \begin{ctanrefs} -\item[preview-latex]Browse \CTANref{preview-latex} +\item[preview-latex]Distributed as part of \CTANref{auctex} \item[texmacs]Browse \CTANref{texmacs} \end{ctanrefs} +\Question[Q-omegaleph]{Omega and Aleph} + +Omega \nothtml{(\ensuremath{\Omega})} was developed as an extension of +\TeX{}, to use with multilingual texts, expressed in a variety of +input encodings. Omega uses 16-bit, Unicode-encoded, characters. It +provides many innovative concepts, notably including the ``translation +process'' that takes a character stream and transforms it according to +various processes that may be internally specified, or be a separate +program. + +While Omega showed a lot of promise at its mid-1990s announcement, +progress was slow, and development was essentially dead by the time +that one of the original developers withdrew (taking with him a bunch +of research students). + +Before that distressing event, a separate thread of development had +started, to produce a program % !avoid space between Aleph and comma +called Aleph\nothtml{ (\ensuremath{\aleph})}, which merged the facilities of +\Qref*{\eTeX{}}{Q-etex} into a stable Omega codebase and added other +extensions. Aleph also proved an attractive platform for many people; +but its development, too, has dried up. + +A presentation at Euro\TeX{} 2006 claimed that development of Omega +was picking up again, in parallel with research into what the (new) +developers consider a rational scheme for supporting \TeX{}-style +typesetting. The new system was to be known as Omega-2 +(\latexhtml{\ensuremath{\Omega_2}}{Omega subscript 2}), and was to be +designed in a modular fashion so that support of new facilities (such +as use of advanced OpenType fonts) could be added in a relatively +straightforward fashion. A quick web search leads to a recommendation +that potential users consider \Qref{\LuaTeX{}}{Q-luatex} instead. +Fortunately, lessons learned in Aleph project are being carried +forward in the \Qref*{\LuaTeX{}}{Q-luatex} project. + +\Question[Q-xetex]{The \xetex{} project} + +\href{http://scripts.sil.org/xetex}{\xetex{}}, by Jonathan Kew, is a +successor to the shareware \TeX{}/\acro{GX} program for Macintoshes. +It is a Unicode-based \TeX{} implementation which is able to make +direct use of the fonts installed on a system. It supports the +advanced typographical features available in modern font technology +(OpenType, \acro{AAT} on Mac~\acro{OS}~X, Graphite). \xetex{} was +originally developed for Mac~\acro{OS}~X but it is now fully +integrated in \texlive{} on a wide range of platforms, as well as +being available as part of \miktex{}. \xetex{} supports Unicode +character sets and bidirectional typesetting (via \eTeX{} primitives). +It is popular among linguists and scholars in the humanities, as well +as an increasing range of people working in other fields. Support for +mathematical Unicode fonts (such as Asana Math and Cambria) is +progressing. + +The project has an active % ! line break +\href{http://www.tug.org/mailman/listinfo/xetex}{mailing list}; a +collection of other information is to be found in a set of % ! line break +\href{http://www.tug.org/xetex/}{links on the \acro{TUG} web site}. + +\Question[Q-luatex]{\PDFTeX{} and \LuaTeX{}} + +As is said elsewhere in these \acro{FAQ}s, development of +\Qref*{\PDFTeX{}}{Q-whatpdftex} is ``in essence'' complete~--- +no new facilities are being developed, since the limitations of the +present structure mean that the returns on effort invested are +diminishing. The \PDFTeX{} team has announced that no further +developments will be added after the release of \PDFTeX{} 1.50.0, +which will be the next major release. + +In parallel with the running-down of \PDFTeX{} development, +development of a new system, \LuaTeX{} is under way. +\href{http://www.lua.org/}{\ProgName{Lua}} is a script +language, designed to offer an interpreter that may be incorporated +into other applications. \LuaTeX{} consists of a \TeX{}-like engine +with a \ProgName{lua} interpreter built into it; the \ProgName{lua} +interpreter has access to many of the data structures used for +typesetting, and the user may also interpolate chunks of +\ProgName{lua} code into their \AllTeX{} macros, or as `call-backs' +for use when the \TeX{}-like engine does certain operations. + +This arrangement offers the prospect of a ``semi-soft'' typesetting +engine: it will have its basic behaviour, but the user gets to +redefine functionality if an idea occurs~--- there will be no need to +persuade the world first, and then find a willing developer to work on +the sources of of the distribution. + +The \href{http://www.luatex.org/}{\LuaTeX{} project} is (with monetary +support from various sources) pursuing avenues that many of the other +current projects have in their sights, notably Unicode character +representations and support for OpenType fonts. The intention is +to integrate the extensions pioneered by \Qref*{Aleph}{Q-omegaleph}. + +A release of \LuaTeX{} whose functionality is declared (version 0.50) +has recently appeared. \texlive{} 2008 incorporates an early release +of \LuaTeX{}, and the upcoming \miktex{} version 2.8 (no current +release date) will probably incorporate \LuaTeX{}. \CONTeXT{} +distributions can already make use of \LuaTeX{}. + \Question[Q-ant]{The \textsf{ANT} typesetting system} -Achim Blumensath's \href{http://ant.berlios.de}{\textsf{ANT}} project, -in contrast to \NTS{}, aims -not to replicate \TeX{} with a different implementation technique, but -rather to provide a replacement for \TeX{} which uses \TeX{}-like -typesetting algorithms in a very different programming environment. -\textsf{ANT} remains under development, but it is now approaching the -status of a usable typesetting system. +Achim Blumensath's \href{http://ant.berlios.de}{\textsf{ANT}} project +aims not to replicate \TeX{} with a different implementation +technique, but rather to provide a replacement for \TeX{} which uses +\TeX{}-like typesetting algorithms in a very different programming +environment. \textsf{ANT} remains under development, but it is now +approaching the status of a usable typesetting system. \textsf{ANT}'s markup language is immediately recognisable to the \AllTeX{} user, but the scheme of implementing design in @@ -23880,88 +25113,6 @@ filtering mechanisms will please those who have long struggled with \ExTeX{} will accept Unicode input, from the start. In the longer term, drawing primitives are to be considered. -\Question[Q-omegaleph]{Omega and Aleph} - -Omega \nothtml{(\ensuremath{\Omega})} was developed as an extension of -\TeX{}, to use with multilingual texts, expressed in a variety of -input encodings. Omega uses 16-bit, Unicode-encoded, characters. It -provides many innovative concepts, notably including the ``translation -process'' that takes a character stream and transforms it according to -various processes that may be internally specified, or be a separate -program. - -While Omega showed a lot of promise at its mid-1990s announcement, its -development was slow, and development was essentially dead by the time -that one of the original developers withdrew (taking with him a bunch -of research students). - -Before that distressing event, a separate thread of development was -started, to produce a program called Aleph -\nothtml{(\ensuremath{\aleph})}, which merged the facilities of -\Qref*{\eTeX{}}{Q-etex} into a stable Omega codebase and added other -extensions. Aleph also proved an attractive platform for many people; -but its development, too, has dried up. - -The latest news (from Euro\TeX{} 2006) is that development of Omega is -picking up again, in parallel with research into what the (new) -authors consider a rational scheme for supporting \TeX{}-style -typesetting. The new system is to be known as Omega-2 -(\latexhtml{\ensuremath{\Omega_2}}{Omega subscript 2}), and is being -designed in a modular fashion so that support of new facilities (such -as use of advanced OpenType fonts) can be added in a relatively -straightforward fashion. - -The work done in the Aleph project is also being carried forward in -the \Qref*{\LuaTeX{}}{Q-luatex} project. - -\Question[Q-luatex]{\PDFTeX{} becomes \LuaTeX{}} - -As is said elsewhere in these \acro{FAQ}s, development of -\Qref*{\PDFTeX{}}{Q-whatpdftex} is ``in essence'' complete~--- -development of new facilities continues, but the limitations of the -present structure impose a strong limit on what facilities are -possible. (The \PDFTeX{} team has announced that no further -developments will be added after the release of \PDFTeX{} 1.50.0, -which will be the next major release.) - -In this context, the idea of \LuaTeX{} arose. -\href{http://www.lua.org/}{\ProgName{Lua}} is a script -language, designed to offer an interpreter with a very small -``footprint'', so it is rather easy to build it into other -applications. So \LuaTeX{} was launched as a \PDFTeX{} -executable with a \ProgName{Lua} interpreter built into it. - -A \href{http://www.luatex.org/}{\LuaTeX{} project} is now proceeding -(with monetary support from various sources) and is pursuing avenues -that many of the other -current projects have in their sights, notably Unicode character -representations and support for OpenType fonts. Work is also in hand -to integrate the extensions pioneered by \Qref*{Aleph}{Q-omegaleph}. - -The next release of \texlive{} (due in July 2008) and \miktex{} -version 2.8 (no current release date) will incorporate \LuaTeX{}. -\CONTeXT{} distributions can already make use of it. - -\Question[Q-xetex]{The \xetex{} project} - -\xetex{} (by Jonathan Kew) is a successor to the shareware \TeX{}/\acro{GX} -program for Macintoshes. It is a Unicode-based (\acro{UTF}-8) TeX -implementation which is able to make use of Mac~\acro{OS}~X \acro{AAT} -(Apple Advanced Typography) \extension{dfonts} and OpenType fonts. It -uses Apple's Quartz system (which facilitates the afore-mentioned font -access) to generate \acro{PDF} output. \xetex{} supports Unicode -character sets and bidirectional typesetting, and is widely used by -people studying linguistics, as well as an increasing range of people -working in other fields. - -A Linux and Unix-system version is available in \texlive{}~2007; that -version (of course) relies on OpenType fonts alone. A version is -planned for \miktex{} version 2.7 (currently planned for December 2007). - -The project has a \href{http://scripts.sil.org/xetex}{web site} for -the user who wants more than this simple answer, and you can also sign -up to a \href{http://www.tug.org/mailman/listinfo/xetex}{mailing list}. - \Question[Q-biblatex]{Replacing the \BibTeX{}--\LaTeX{} mechanism} Producing a successor to \BibTeX{} has long been a favoured activity @@ -24018,7 +25169,7 @@ a \cmdinvoke{nocite}{*} command enables \BibTeX{} to produce a usable \Package{Amsrefs} is maintained by the AMS as part of its author support programme, -\Package{Biblatex} uses \BibTeX{} more-or-less as normal, but with +\Package{Biblatex} uses \BibTeX{} simply to sort the citations using \Package{biblatex}'s own style; the style of citations and of the bibliography itself is determined by the way your \Package{biblatex} style has been set up. This structure eliminates the collections of @@ -24032,10 +25183,25 @@ sections of these \acro{FAQ}s. \Package{Biblatex} is released as experimental software, but it's clear that many users are already using it happily; Lehman is responsive to problem reports, at the moment, but a set of expert -users is already establishing itself. +users is already establishing itself. A set of contributed styles has +appeared, which cover some of the trickier bibliography styles. The +road map of the project shows one more \emph{beta} release before the +``stable'' \Package{biblatex}~1.0. + +A related project is +\href{http://biblatex-biber.sourceforge.net/}{\ProgName{biber}} (or +\ProgName{biblatex-biber}, to distinguish it from an older, defunct, +\BibTeX{} replacement project). \ProgName{Biber} is a +\ProgName{Perl}-based system to produce a \BibTeX{} replacement that +is specifically tuned to the requirements of \Package{biblatex}. +While it supports `traditional' \BibTeX{}, \ProgName{biber} aims at an +interface language that is closely tuned to the requirements of +\Package{biblatex}, including use of a Unicode-based character set to +ease the generation multilingual citations. \begin{ctanrefs} \item[amsrefs.sty]\CTANref{amsrefs} \item[biblatex.sty]\CTANref{biblatex} +\item[\nothtml{\rmfamily}biblatex contributions]\CTANref{biblatex-contrib} \item[\nothtml{\rmfamily}CrossTeX]\CTANref{crosstex} \end{ctanrefs} diff --git a/Master/texmf-dist/doc/generic/FAQ-en/filectan.tex b/Master/texmf-dist/doc/generic/FAQ-en/filectan.tex index cdfe79c55b8..6f11a17116a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/filectan.tex +++ b/Master/texmf-dist/doc/generic/FAQ-en/filectan.tex @@ -28,10 +28,10 @@ \CTANfile{capt-of}{macros/latex/contrib/misc/capt-of.sty} \CTANfile{catalogue}{help/Catalogue/catalogue.html} \CTANfile{cat-licences}{help/Catalogue/licenses.html} -\CTANfile{changepage}{macros/latex/contrib/misc/changepage.sty} \CTANfile{chngcntr}{macros/latex/contrib/misc/chngcntr.sty} -\CTANfile{chngpage}{macros/latex/contrib/misc/chngpage.sty} +\CTANfile{changepage}{macros/latex/contrib/misc/changepage.sty} \CTANfile{clsguide}{macros/latex/doc/clsguide.pdf} +\CTANfile{compactbib}{macros/latex/contrib/compactbib/compactbib.sty} %\CTANfile{compan-ctan}{info/companion.ctan} \CTANfile{context-tmf}{macros/context/current/cont-tmf.zip} \CTANfile{dblfloatfix}{macros/latex/contrib/misc/dblfloatfix.sty} @@ -62,6 +62,7 @@ \CTANfile{latex-classes}{macros/latex/base/classes.dtx} \CTANfile{latex-source}{macros/latex/base/source2e.tex} \CTANfile{latexcount}{support/latexcount/latexcount.pl} +\CTANfile{latexcheat}{info/latexcheat/latexcheat/latexsheet.pdf} \CTANfile{letterspacing}{macros/generic/misc/letterspacing.tex} \CTANfile{lshort}{info/lshort/english/lshort.pdf} \CTANfile{ltablex}{macros/latex/contrib/ltablex/ltablex.sty} @@ -75,6 +76,7 @@ \CTANfile{metafp-pdf}{info/metafont/metafp/metafp.pdf} \CTANfile{mf-beginners}{info/metafont/beginners/metafont-for-beginners.pdf} \CTANfile{mf-list}{info/metafont-list} +\CTANfile{miktex-portable}{systems/win32/miktex/setup/miktex-portable.exe} \CTANfile{miktex-setup}{systems/win32/miktex/setup/setup.exe} \CTANfile{miktex-usb}{info/MiKTeX+Ghostscript+GSview+USB-drive-HOWTO.txt} \CTANfile{mil}{info/mil/mil.pdf} @@ -90,12 +92,11 @@ \CTANfile{notoccite}{macros/latex/contrib/misc/notoccite.sty} \CTANfile{noTeX}{biblio/bibtex/utils/misc/noTeX.bst} \CTANfile{nopageno}{macros/latex/contrib/carlisle/nopageno.sty} -\CTANfile{numline}{macros/latex/contrib/numline/numline.sty} +\CTANfile{numline}{obsolete/macros/latex/contrib/numline/numline.sty} \CTANfile{optional}{macros/latex/contrib/misc/optional.sty} \CTANfile{parskip}{macros/latex/contrib/misc/parskip.sty} \CTANfile{patch}{macros/generic/misc/patch.doc} \CTANfile{path}{macros/latex/contrib/misc/path.sty} -\CTANfile{pdftex}{systems/pdftex/pdftex.zip} \CTANfile{pdftex-oztex}{nonfree/systems/mac/pdftex/pdftex_for_oztex.sit.bin} \CTANfile{picins-summary}{macros/latex209/contrib/picins/picins.txt} \CTANfile{pk300}{fonts/cm/pk/pk300.zip} @@ -113,6 +114,8 @@ \CTANfile{tex2bib}{biblio/bibtex/utils/tex2bib/tex2bib} \CTANfile{tex2bib-doc}{biblio/bibtex/utils/tex2bib/README} \CTANfile{tex4ht}{support/TeX4ht/tex4ht-all.zip} +\CTANfile{texlive-unix}{systems/texlive/tlnet/2008/install-tl-unx.tar.gz} +\CTANfile{texlive-windows}{systems/texlive/tlnet/2008/install-tl.zip} \CTANfile{texnames}{info/biblio/texnames.sty} \CTANfile{texsis-index}{macros/texsis/index/index.tex} \CTANfile{threeparttable}{macros/latex/contrib/misc/threeparttable.sty} @@ -120,7 +123,6 @@ \CTANfile{topcapt}{macros/latex/contrib/misc/topcapt.sty} \CTANfile{tracking}{macros/latex/contrib/tracking/tracking.sty} \CTANfile{ttb-pdf}{info/bibtex/tamethebeast/ttb_en.pdf} -\CTANfile{tth}{nonfree/support/tth/dist/tth_C.tgz} \CTANfile{type1ec}{fonts/ps-type1/cm-super/type1ec.sty} \CTANfile{ukhyph}{language/hyphenation/ukhyphen.tex} \CTANfile{upquote}{macros/latex/contrib/upquote/upquote.sty} diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfloat.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfloat.html index 79fddff663a..209b9b679f0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfloat.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfloat.html @@ -26,9 +26,9 @@ LaTeX honour ‘[h]’ placement of double-column floats, but the midfloat package can be pressed into service to provide something approximating the effect it would have.)
-
dblfloatfix.sty
macros/latex/contrib/misc/dblfloatfix.sty +
dblfloatfix.sty
macros/latex/contrib/misc/dblfloatfix.sty
stfloats.sty, midfloat.sty
Distributed as part of - macros/latex/contrib/sttools (gzipped tar, browse) + macros/latex/contrib/sttools (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=2colfloat diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfltorder.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfltorder.html index a16ff8fe4dc..9e5a041b7cb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfltorder.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2colfltorder.html @@ -24,8 +24,8 @@ at [b] placement. whole requirement is to patch the output routine; no extra commands are needed.

-
dblfloatfix.sty
macros/latex/contrib/misc/dblfloatfix.sty -
fix2col.sty
Distributed as part of macros/latex/contrib/carlisle (gzipped tar, browse) +
dblfloatfix.sty
macros/latex/contrib/misc/dblfloatfix.sty +
fix2col.sty
Distributed as part of macros/latex/contrib/carlisle (or browse the directory)
fixltx2e.sty
Part of the LaTeX distribution

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=2colfltorder diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2letterfontcmd.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2letterfontcmd.html index c87a5c088e6..94904a00111 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2letterfontcmd.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-2letterfontcmd.html @@ -118,7 +118,7 @@ needs LaTeX’s simplest font selection commands:

-
smallcap.sty
macros/latex/contrib/smallcap (gzipped tar, browse) +
smallcap.sty
macros/latex/contrib/smallcap (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=2letterfontcmd diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-AMSpkg.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-AMSpkg.html index 18d62bc7e03..b1b38a44dcf 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-AMSpkg.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-AMSpkg.html @@ -2,7 +2,6 @@ UK TeX FAQ -- question label AMSpkg

What are the AMS packages (AMSTeX, etc.)?

-

AMSTeX is a TeX macro package, originally written by Michael Spivak for the American Mathematical Society (AMS) during 1983–1985 and is described in the book “The Joy of TeX”. @@ -14,17 +13,15 @@ aspects covered include multi-line displayed equations, equation numbering, ellipsis dots, matrices, double accents, multi-line subscripts, syntax checking (faster processing on initial error-checking TeX runs), and other things. -

As LaTeX increased in popularity, authors asked to submit papers to -the AMS in LaTeX, and so the AMS developed -AMSLaTeX, which is a -collection of LaTeX packages and classes that offer authors most of +

As LaTeX increased in popularity, authors sought to submit papers to +the AMS in LaTeX, so AMSLaTeX was developed. AMSLaTeX +is a collection of LaTeX packages and classes that offer authors most of the functionality of AMSTeX. The AMS no longer recommends the use of AMSTeX, and urges -its users to use AMSLaTeX instead. - +its authors to use AMSLaTeX instead.

-
AMSTeX distribution
macros/amstex (gzipped tar, browse) -
AMSLaTeX distribution
macros/latex/required/amslatex (gzipped tar, browse) +
AMSTeX distribution
macros/amstex (or browse the directory) +
AMSLaTeX distribution
macros/latex/required/amslatex (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=AMSpkg diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-BibTeXing.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-BibTeXing.html index 7591756e032..0b8334cd9e5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-BibTeXing.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-BibTeXing.html @@ -23,11 +23,9 @@ may also be found on CTAN. A summary and FAQ (btxFAQ), by Michael Shell and David Hoadley, is also to be recommended.

-
BibTeX documentation
biblio/bibtex/distribs/doc (gzipped tar, browse) -
BibTeX documentation, in PDF
- biblio/bibtex/contrib/doc (gzipped tar, browse) -
btxFAQ.pdf
biblio/bibtex/contrib/doc/btxFAQ.pdf -
Tame the BeaST
info/bibtex/tamethebeast/ttb_en.pdf +
BibTeX documentation
biblio/bibtex/contrib/doc (or browse the directory) +
btxFAQ.pdf
biblio/bibtex/contrib/doc/btxFAQ.pdf +
Tame the BeaST
info/bibtex/tamethebeast/ttb_en.pdf

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=BibTeXing diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-CD.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-CD.html index 42f4b0a63f8..988565eef92 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-CD.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-CD.html @@ -36,9 +36,9 @@ they are all pretty large downloads. on the TUG site.

-
MacTeX
systems/mac/mactex/ -
ProTeXt
systems/win32/protext/ -
TeXlive install image
systems/texlive/ +
MacTeX
systems/mac/mactex/ +
ProTeXt
systems/win32/protext/ +
TeXlive install image
systems/texlive/

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=CD diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ECfonts.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ECfonts.html index 17985361f8d..dc33c6e4351 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ECfonts.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ECfonts.html @@ -65,10 +65,10 @@ for Adobe Type 1 fonts, and also by the txfonts and (see “choice of scalable fonts”).

-
CM-super fonts
fonts/ps-type1/cm-super (gzipped tar, browse) -
CM-LGC fonts
fonts/ps-type1/cm-lgc (gzipped tar, browse) -
EC and TC fonts
fonts/ec (gzipped tar, browse) -
Latin Modern fonts
fonts/lm (gzipped tar, browse) +
CM-super fonts
fonts/ps-type1/cm-super (or browse the directory) +
CM-LGC fonts
fonts/ps-type1/cm-lgc (or browse the directory) +
EC and TC fonts
fonts/ec (or browse the directory) +
Latin Modern fonts
fonts/lm (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ECfonts diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-HPdrivers.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-HPdrivers.html index 7b59a98ca4d..3df98306c6c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-HPdrivers.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-HPdrivers.html @@ -10,8 +10,8 @@ DEC-20s.

For Unix systems, Karl Berry’s dviljk uses the same path-searching library as web2c.

-
Beebe drivers
dviware/beebe (gzipped tar, browse) -
dviljk
dviware/dviljk (gzipped tar, browse) +
Beebe drivers
dviware/beebe (or browse the directory) +
dviljk
dviware/dviljk (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=HPdrivers diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html index e0f2d5d30c9..151536cc4a7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX2HTML.html @@ -51,7 +51,11 @@ browsing may be brighter — see tex4ht’s macros included. As a result, it’s pretty robust against the macros you include in your document, and it’s also pretty fast. -

TeXpider
a commercial program from +
plasTeX
a Python-based LaTeX document processing + framework. It gives DOM-like access to a LaTeX document, as + well as the ability to generate mulitple output formats + (e.g. HTML, DocBook, tBook, etc.). +
TeXpider
a commercial program from Micropress, which is described on http://www.micropress-inc.com/webb/wbstart.htm; it uses bitmaps for equations. @@ -70,9 +74,10 @@ page gives lists of pros and cons, by way of comparison. HTML, with sections on (La)TeX and BibTeX — see http://www.w3.org/Tools/Word_proc_filters.html
-
latex2html
Browse support/latex2html/ -
tex4ht
support/TeX4ht/tex4ht-all.zip -
tth
nonfree/support/tth/dist/tth_C.tgz +
latex2html
Browse support/latex2html/ +
plasTeX
Browse support/plastex/ +
tex4ht
support/TeX4ht/tex4ht-all.zip +
tth
support/tth/dist (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=LaTeX2HTML diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX3.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX3.html index 2a29b0b7692..2597c7adc45 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX3.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeX3.html @@ -21,13 +21,21 @@ found on the project web site (http://www.latex-project.org/papers/), as is some of the project’s experimental code (see http://www.latex-project.org/code.html, which allows you to -read the project’s source repository). You can +read the project’s source repository); a recent snapshot of two major +collections from the code, expl3 and xpackages, +are available. Contributed code, such as keys3 (for +key-value argument decoding) and numparse3 (for number +processing) are available in the CTAN ‘LaTeX experimental’ tree. +

You can participate in discussions of the future of LaTeX through the mailing list latex-l. Subscribe to the list by sending a message ‘subscribe latex-l <your name>’ to listserv@urz.Uni-Heidelberg.de

-
LaTeX project publications
info/ltx3pub (gzipped tar, browse) +
expl3 bundle
macros/latex/contrib/expl3 (or browse the directory) +
keys3.sty
macros/latex/exptl/keys3 (or browse the directory) +
LaTeX project publications
info/ltx3pub (or browse the directory) +
xpackages bundle
macros/latex/contrib/xpackages (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=LaTeX3 diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeXtoPlain.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeXtoPlain.html index 4a0148e2129..b62a3f12982 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeXtoPlain.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-LaTeXtoPlain.html @@ -21,9 +21,9 @@ user more than the “bare minimum” that Plain TeX is designed to offer.)

\latexhtml{\textrm{The}}{The} eplain system
- macros/eplain (gzipped tar, browse) + macros/eplain (or browse the directory)
\latexhtml{\textrm{‘Plain TeX’}}{Plain TeX} graphics
- macros/plain/graphics (gzipped tar, browse) + macros/plain/graphics (or browse the directory)

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=LaTeXtoPlain diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-MP.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-MP.html index e9a6ceaaa3e..c4ccf432443 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-MP.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-MP.html @@ -22,5 +22,6 @@ Knuth’s permission. TUG mailman interface. The TUG website also hosts a MetaPost summary page. -

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=MP +

+

This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=MP diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-PSpreview.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-PSpreview.html index 8b6bd2a9737..2b2e0a382c1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-PSpreview.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-PSpreview.html @@ -19,7 +19,7 @@ this, you have three options: PostScript previewer. Some systems offer this capability as standard, but most people will need to use a separate previewer such as ghostscript or ghostscript-based viewers - such as ghostview or shareware offering GSview. + such as gv or shareware offering GSview.

  • Under Windows on a PC, or on a Macintosh, let Adobe Type Manager display the fonts (textures, on the Macintosh, works like this). @@ -38,12 +38,12 @@ this, you have three options: this if you have purchased the fonts.
    -
    ghostscript
    Browse support/ghostscript/ -
    ghostview
    Browse support/ghostscript/gnu/ghostview/ -
    gsftopk
    fonts/utilities/gsftopk (gzipped tar, browse) -
    GSview
    Browse nonfree/support/ghostscript/ghostgum/ -
    ps2pk
    fonts/utilities/ps2pk (gzipped tar, browse) -
    xdvi
    dviware/xdvi (gzipped tar, browse) +
    ghostscript
    Browse support/ghostscript/ +
    gsftopk
    fonts/utilities/gsftopk (or browse the directory) +
    GSview
    Browse support/ghostscript/ghostgum/ +
    gv
    Browse support/gv/ +
    ps2pk
    fonts/utilities/ps2pk (or browse the directory) +
    xdvi
    dviware/xdvi/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=PSpreview diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-RCS.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-RCS.html index d8ef63eaa2c..81b1908c6af 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-RCS.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-RCS.html @@ -20,8 +20,8 @@ following minimal solution:

     \def\RCS$#1: #2 ${\expandafter\def\csname RCS#1\endcsname{#2}}
    -\RCS$Revision: 1.543 $ % or any RCS keyword
    -\RCS$Date: 2008/06/21 18:54:02 $
    +\RCS$Revision: 1.612 $ % or any RCS keyword
    +\RCS$Date: 2009/06/09 22:45:20 $
     ...
     \date{Revision \RCSRevision, \RCSDate}
     
    @@ -63,11 +63,11 @@ Plain TeX. Note that vc is the only option that currently claims to support Bazaar- and Git-controlled repositories.
    -
    rcs.sty
    macros/latex/contrib/rcs (gzipped tar, browse) -
    rcsinfo.sty
    macros/latex/contrib/rcsinfo (gzipped tar, browse) -
    svn.sty
    macros/latex/contrib/svn (gzipped tar, browse) -
    svninfo.sty
    macros/latex/contrib/svninfo (gzipped tar, browse) -
    vc
    support/vc (gzipped tar, browse) +
    rcs.sty
    macros/latex/contrib/rcs (or browse the directory) +
    rcsinfo.sty
    macros/latex/contrib/rcsinfo (or browse the directory) +
    svn.sty
    macros/latex/contrib/svn (or browse the directory) +
    svninfo.sty
    macros/latex/contrib/svninfo (or browse the directory) +
    vc
    support/vc (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=RCS diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-SGML2TeX.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-SGML2TeX.html index 8a5d7f1fd4e..e828d3ed966 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-SGML2TeX.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-SGML2TeX.html @@ -59,7 +59,7 @@ source is available on CTAN. SGML, and of public domain tools for writing and manipulating it, in TUGboat 16(2).

    -
    html2latex source
    support/html2latex (gzipped tar, browse) +
    html2latex source
    support/html2latex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=SGML2TeX diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXfuture.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXfuture.html index 6db8acf7837..140f1518971 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXfuture.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXfuture.html @@ -7,15 +7,17 @@ he will continue to fix any bugs that are reported to him (though bugs are rare). This decision was made soon after TeX version 3.0 was released; at each bug-fix release the version number acquires one more digit, so that it tends to the -limit pi (at the time of writing, Knuth’s latest release is version -3.141592). Knuth wants TeX to be frozen at version pi when he -dies; thereafter, no further changes may be made to Knuth’s source. -(A similar rule is applied to Metafont; its version number tends to the -limit e, and currently stands at 2.71828.) +limit pi (at the time of writing, Knuth’s latest release +is version 3.1415926). Knuth wants TeX to be frozen at +version pi when he dies; thereafter, no further changes +may be made to Knuth’s source. (A similar rule is applied to Metafont; +its version number tends to the limit e, and currently +stands at 2.718281.)

    Knuth explains his decision, and exhorts us all to respect it, in a -paper originally published in TUGboat 11(4) (and reprinted in the - -NTG journal MAPS). +paper originally published in +TUGboat 11(4), +and reprinted in the +NTG journal MAPS.

    There are projects (some of them long-term projects: see, for example, the LaTeX3 project) diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXsystems.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXsystems.html index 40217a1f6c7..657afe58153 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXsystems.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-TeXsystems.html @@ -13,12 +13,16 @@ TeX Live, which is distributed as part of the TeX collection.

    Members of many TeX user groups receive copies of the collection - (on CD and DVD), as part of their membership of the - groups. + (on DVD), as part of their membership of the groups.

    MacOS/X is also a Unix-based system; however users should refer to the information below, under item “Mac”. -

    -
    texlive
    Browse systems/texlive/ +

    TeX Live may also be installed “over the network”; a network + installer is provided, and once you have a system, a manager + (tlmgr) can both keep your installation up-to-date and + add packages you didn’t install at first. +

    +
    texlive
    Browse systems/texlive/ +
    texlive installer (Unix)
    systems/texlive/tlnet/2008/install-tl-unx.tar.gz
    Linux
    GNU/Linux users are supported by TeX Live (as noted above). @@ -28,19 +32,34 @@ production of PDF from (La)TeX input. Sadly, it’s no longer supported, and the ready-built images are made for use with a rather ancient Linux kernel. +

    For the future, the MiKTeX developer intends to release a version + of that excellent (Windows) system for use on Linux; a beta version + is available via the MiKTeX site.

    -
    texlive
    Browse systems/texlive/ -
    vtex
    systems/vtex/linux (gzipped tar, browse) -
    vtex required common files
    systems/vtex/common (gzipped tar, browse) +
    texlive
    Browse systems/texlive/ +
    vtex
    systems/vtex/linux (or browse the directory) +
    vtex required common files
    systems/vtex/common (or browse the directory)
    -
    PC: Windows post-95
    +
    PC: Windows
    MiKTeX, by Christian Schenk, is a comprehensive distribution. It has its own previewer, YAP, which is itself capable of printing, though the distribution also includes a port of dvips. The current version is available for file-by-file download (the - HTML files in the directory offer hints - on what you need to get going). The MiKTeX developers provide a - ready-to-run copy of the distribution, on CD (for purchase) via the + HTML files in the directory offer hints on what you need to + get going). MiKTeX can automatically install packages that it + “knows about”, but that aren’t in your system (it gets them over + the network). Furthermore, users may keep their installation + up-to-date, over the network: the distribution contains a “package + manager”, through which the user may select individual packages, or + request that every extant update be retrieved. +

    MiKTeX may also be used in a configuration which involves no + installation at all: its “portable” distribution may be unpacked + on a memory stick, and used on any windows computer without making + any direct use of the hard drive. This is the first “official” + release of such a setup, though a similar object has been available + on the net for some time. +

    The MiKTeX developers also provide a ready-to-run copy of the + distribution, on CD (for purchase) via the MiKTeX web site; otherwise the setup executable is available on CTAN, together with all the optional packages. @@ -52,8 +71,8 @@ steps, along with explanations.

    Windows users are also supported directly by the TeX Live distribution; a system is provided on the installation disc of the - TeX collection (and it can, with some difficulty, be run “from - the disc” without installing anything). + TeX collection. The system may also be installed over the + network, using an installer application tailored for use with Windows.

    XEmTeX, by Fabrice Popineau (he who created the excellent, but now defunct, fpTeX distribution), is an integrated distribution of TeX, LaTeX, @@ -86,13 +105,15 @@ comes with a bunch of Type 1 fonts packaged to work with BaKoMa TeX, which further the focus.

    -
    bakoma
    systems/win32/bakoma (gzipped tar, browse) -
    miktex
    Acquire systems/win32/miktex/setup/setup.exe (also available from the +
    bakoma
    systems/win32/bakoma/ +
    miktex
    Acquire systems/win32/miktex/setup/setup.exe (also available from the MiKTeX web site), and read installation instructions from - the MiKTeX installation page -
    protext.exe
    systems/win32/protext/ -
    tetex
    obsolete/systems/unix/teTeX/current/distrib/ + the MiKTeX installation page +
    Portable miktex
    systems/win32/miktex/setup/miktex-portable.exe +
    protext.exe
    systems/win32/protext/ +
    texlive
    Browse systems/texlive/ +
    texlive installer (Windows)
    systems/texlive/tlnet/2008/install-tl.zip
    PC: MSDOS or OS/2
    EmTeX, by Eberhard Mattes, includes LaTeX, BibTeX, previewers, and drivers, and is @@ -110,15 +131,15 @@ operating systems, who want an up-to-date (La)TeX system, need to migrate to Win32-based systems.
    -
    emtex
    systems/msdos/emtex (gzipped tar, browse) -
    emtexTDS
    obsolete/systems/os2/emtex-contrib/emtexTDS (gzipped tar, browse) +
    emtex
    systems/msdos/emtex (or browse the directory) +
    emtexTDS
    obsolete/systems/os2/emtex-contrib/emtexTDS (or browse the directory)
    PC: MSDOS
    The most recent MSDOS offering is a port of the Web2C 7.0 implementation, using the GNU djgpp compiler. While this package is more recent than emTeX, it still implements a rather old instance of (La)TeX.
    -
    djgpp
    systems/msdos/djgpp (gzipped tar, browse) +
    djgpp
    systems/msdos/djgpp (or browse the directory)
    PC: OS/2
    EmTeX, by Eberhard Mattes (see above), was actually developed under OS/2, and lives happily @@ -128,10 +149,10 @@ in direct production of PDF from (La)TeX input. (This version is, like the Linux version, unfortunately no longer supported.)
    -
    emtex
    systems/msdos/emtex (gzipped tar, browse) -
    emtexTDS
    obsolete/systems/os2/emtex-contrib/emtexTDS (gzipped tar, browse) -
    vtex
    systems/vtex/os2 (gzipped tar, browse) -
    vtex required common files
    systems/vtex/common (gzipped tar, browse) +
    emtex
    systems/msdos/emtex (or browse the directory) +
    emtexTDS
    obsolete/systems/os2/emtex-contrib/emtexTDS (or browse the directory) +
    vtex
    systems/vtex/os2 (or browse the directory) +
    vtex required common files
    systems/vtex/common (or browse the directory)
    @@ -174,24 +195,24 @@ The MacTeX-on-OSX mailing list is a useful resource for users; mail MacOSX-TeX-on@email.esm.psu.edu to subscribe.
    -
    cmactex
    nonfree/systems/mac/cmactex (gzipped tar, browse) -
    mactex
    systems/mac/mactex/ -
    oztex
    nonfree/systems/mac/oztex (gzipped tar, browse) +
    cmactex
    systems/mac/cmactex (or browse the directory) +
    mactex
    systems/mac/mactex/ +
    oztex
    systems/mac/oztex (or browse the directory)
    OpenVMS
    TeX for OpenVMS is available, though it seems unlikely that the version on CTAN is the latest available.
    -
    OpenVMS
    systems/OpenVMS/TEX97_CTAN.ZIP +
    OpenVMS
    systems/OpenVMS/TEX97_CTAN.ZIP
    Atari
    TeX for the Atari ST is available from CTAN.
    -
    Atari TeX
    systems/atari (gzipped tar, browse) +
    Atari TeX
    systems/atari (or browse the directory)
    Amiga
    Full implementations of TeX 3.1 (PasTeX) and Metafont 2.7 are available.
    -
    PasTeX
    systems/amiga (gzipped tar, browse) +
    PasTeX
    systems/amiga (or browse the directory)
    TOPS-20
    TeX was originally written on a DEC-10 under WAITS, diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-WYGexpts.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-WYGexpts.html index 5de14a4523d..a01cbced43b 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-WYGexpts.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-WYGexpts.html @@ -89,8 +89,8 @@ separate window), degree of correspondence of the display to the final output, and the balance they strike between visual aid and visual distraction.
    -
    preview-latex
    Browse support/preview-latex/ -
    texmacs
    Browse systems/unix/TeXmacs/ +
    preview-latex
    Distributed as part of support/auctex/ +
    texmacs
    Browse systems/unix/TeXmacs/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=WYGexpts diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-abspos.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-abspos.html index 34d7cedaf42..25c3448f6b6 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-abspos.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-abspos.html @@ -26,9 +26,9 @@ must therefore also be available.)

    -
    eso-pic.sty
    macros/latex/contrib/eso-pic (gzipped tar, browse) -
    everyshi.sty
    Distributed as part of macros/latex/contrib/ms (gzipped tar, browse) -
    textpos.sty
    macros/latex/contrib/textpos (gzipped tar, browse) +
    eso-pic.sty
    macros/latex/contrib/eso-pic (or browse the directory) +
    everyshi.sty
    Distributed as part of macros/latex/contrib/ms (or browse the directory) +
    textpos.sty
    macros/latex/contrib/textpos (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=abspos diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acroantics.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acroantics.html index 9768f8a3c7b..53b0f91abaa 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acroantics.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acroantics.html @@ -2,22 +2,27 @@ UK TeX FAQ -- question label acroantics

    Adobe Reader messing with print size

    -

    Printing from Adobe Reader shrinks the page “to fit” +

    Printing from Adobe Reader shrinks the page “to fit” (by default). Unfortunately, its calculation doesn’t consider the existing margins of the document, so that it shrinks what it believes is your whole page onto what it believes is its output page. The effect typically looks as if your margins have expanded.

    Solve this problem by adjusting the Reader’s default in the print dialogue; unfortunately, this dialogue varies from one version -to the next. On Reader version 7, there are two entries to -check: -

    +to the next: +
      +
    • Reader version 7:
      Page Scaling (default: “Fit to printer margins”) — change to “None”, and
      - Scale (default 95% of Normal size) — change to + Scale (default 95textpercent of Normal size) — change to “100%”. - - -

    +

  • Adobe Reader 6:
    + in the print dialogue, on the “copies & pages” pane, you’ll find a + popup menu/drop-down list titled “Page Scaling” — change to “None”. +
  • Windows, Linux Acrobat (Reader) 5.0:
    + In the print dialog, make sure the “Shrink oversized pages to fit” + checkbox is unchecked. It may also be useful to uncheck the + “Expand small pages to fit paper size” checkbox as well. +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=acroantics diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acrobat.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acrobat.html index da4bb7af6b0..047c6933ec3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acrobat.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-acrobat.html @@ -42,12 +42,13 @@ can operate using PDFTeX primitives, the hyperTeX \specials, or DVI driver-specific \special commands. Both dvips and Y&Y’s DVIPSONE can translate the DVI with these \special commands into -PostScript acceptable to Distiller, and dvipdfm has \special -commands of its own. +PostScript acceptable to Distiller, and +dvipdfm and dvipdfmx have \special commands of +its own.

    If you use Plain TeX, the Eplain macros can help you create PDF documents with hyper-references. It can operate using PDFTeX primitives, or \special commands -for the dvipdfm DVI driver. +for the dvipdfm/dvipdfmx DVI drivers.

    While there is no free implementation of all of Adobe Distiller’s functionality, any but the very oldest versions of Ghostscript @@ -57,9 +58,8 @@ provide pretty reliable distillation (but beware of the problems with Acrobat Reader is available for a fair range of platforms; for those for which Adobe’s reader is unavailable, remotely current versions of ghostscript combined with -gv, GSview (or even the unsupported -ghostview) can display and print PDF files, as can -xpdf. +gv or GSview can display and print PDF +files, as can xpdf.

    In many circumstances, Ghostscript combined with a viewer application is actually preferable to Acrobat Reader. For example, on Windows Acrobat Reader locks the .pdf file it’s displaying: this @@ -70,14 +70,13 @@ mistake.

    Acrobat Reader
    browse ftp://ftp.adobe.com/pub/adobe/acrobatreader -
    dvipdfm
    dviware/dvipdfm (gzipped tar, browse) -
    dvipdfmx
    dviware/dvipdfmx (gzipped tar, browse) -
    ghostscript
    Browse support/ghostscript/ -
    ghostview
    Browse support/ghostscript/gnu/ghostview/ -
    GSview
    Browse nonfree/support/ghostscript/ghostgum/ -
    gv
    support/gv/ -
    hyper.sty
    macros/latex/contrib/hyper (gzipped tar, browse) -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) +
    dvipdfm
    dviware/dvipdfm (or browse the directory) +
    dvipdfmx
    dviware/dvipdfmx (or browse the directory) +
    ghostscript
    Browse support/ghostscript/ +
    GSview
    Browse support/ghostscript/ghostgum/ +
    gv
    Browse support/gv/ +
    hyper.sty
    macros/latex/contrib/hyper (or browse the directory) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=acrobat diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-activechars.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-activechars.html index 7bb7a695e11..8f21c60a556 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-activechars.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-activechars.html @@ -113,8 +113,8 @@ made active — the definition of the command persists even if the character’s catcode reverts to its original value; the definition becomes accessible again if the character once again becomes active.

    -
    doc.sty
    Distributed as part of the source of LaTeX, macros/latex/base (gzipped tar, browse) -
    shortvrb.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    doc.sty
    Distributed as part of the source of LaTeX, macros/latex/base (or browse the directory) +
    shortvrb.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=activechars diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-addtoreset.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-addtoreset.html index 219c4a1d6ba..30c2fc51553 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-addtoreset.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-addtoreset.html @@ -67,8 +67,8 @@ a label-like mechanism, and may require more than one run of LaTeX to stabilise counter values — LaTeX will generate the usual warnings about labels changing.

    -
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty -
    perpage.sty
    Distributed as part macros/latex/contrib/bigfoot (gzipped tar, browse) +
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty +
    perpage.sty
    Distributed as part macros/latex/contrib/bigfoot (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=addtoreset diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-algorithms.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-algorithms.html index 61cf79d5c30..aaf4f057efb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-algorithms.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-algorithms.html @@ -93,15 +93,15 @@ algorithms to float like figures and tables.

    -
    algorithm2e.sty
    macros/latex/contrib/algorithm2e (gzipped tar, browse) -
    algorithmicx bundle
    macros/latex/contrib/algorithmicx (gzipped tar, browse) -
    algorithms bundle
    macros/latex/contrib/algorithms (gzipped tar, browse) -
    alg.sty
    macros/latex/contrib/alg (gzipped tar, browse) -
    clrscode.sty
    macros/latex/contrib/clrscode (gzipped tar, browse) -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) -
    newalg.sty
    macros/latex/contrib/newalg (gzipped tar, browse) -
    program.sty
    macros/latex/contrib/program (gzipped tar, browse) -
    pseudocode.sty
    macros/latex/contrib/pseudocode (gzipped tar, browse) +
    algorithm2e.sty
    macros/latex/contrib/algorithm2e (or browse the directory) +
    algorithmicx bundle
    macros/latex/contrib/algorithmicx (or browse the directory) +
    algorithms bundle
    macros/latex/contrib/algorithms (or browse the directory) +
    alg.sty
    macros/latex/contrib/alg (or browse the directory) +
    clrscode.sty
    macros/latex/contrib/clrscode (or browse the directory) +
    float.sty
    macros/latex/contrib/float (or browse the directory) +
    newalg.sty
    macros/latex/contrib/newalg (or browse the directory) +
    program.sty
    macros/latex/contrib/program (or browse the directory) +
    pseudocode.sty
    macros/latex/contrib/pseudocode (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=algorithms diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-alreadydef.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-alreadydef.html index 748ce8e51cc..762e7a60d13 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-alreadydef.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-alreadydef.html @@ -53,9 +53,9 @@ and making the txfonts version of the command available as

    Documentation of savesym doesn’t amount to much: the only commands are \savesymbol and \restoresymbol, as noted above.

    -
    amsmath.sty
    Part of macros/latex/required/amslatex (gzipped tar, browse) -
    savesym.sty
    macros/latex/contrib/savesym/savesym.sty -
    txfonts.sty
    Part of fonts/txfonts (gzipped tar, browse) +
    amsmath.sty
    Part of macros/latex/required/amslatex (or browse the directory) +
    savesym.sty
    macros/latex/contrib/savesym/savesym.sty +
    txfonts.sty
    Part of fonts/txfonts (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=alreadydef diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-altabcr.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-altabcr.html index b895f454cad..0d4e430e0a0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-altabcr.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-altabcr.html @@ -71,7 +71,7 @@ following & appears to LaTeX just like the second \tabularnewline explicitly, or use the \RBS trick described there.

    -
    array.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    array.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=altabcr diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ant.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ant.html index 9fda82f2995..a76e084feac 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ant.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ant.html @@ -2,13 +2,12 @@ UK TeX FAQ -- question label ant

    The ANT typesetting system

    -

    Achim Blumensath’s ANT project, -in contrast to NTS, aims -not to replicate TeX with a different implementation technique, but -rather to provide a replacement for TeX which uses TeX-like -typesetting algorithms in a very different programming environment. -ANT remains under development, but it is now approaching the -status of a usable typesetting system. +

    Achim Blumensath’s ANT project +aims not to replicate TeX with a different implementation +technique, but rather to provide a replacement for TeX which uses +TeX-like typesetting algorithms in a very different programming +environment. ANT remains under development, but it is now +approaching the status of a usable typesetting system.

    ANT’s markup language is immediately recognisable to the (La)TeX user, but the scheme of implementing design in ANT’s own implementation language (presently @@ -17,7 +16,7 @@ writer. This architecture holds the promise of a system that avoids a set of serious problems with TeX’s user interface: those that derive from the design language being the same as the markup language.

    -
    ANT
    systems/ant (gzipped tar, browse) +
    ANT
    systems/ant (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ant diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-appendix.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-appendix.html index 89083a05049..9f81f957890 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-appendix.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-appendix.html @@ -102,9 +102,9 @@ user is referred to the package documentation for further details. appendix package. The KOMA-script classes offer a \appendixprefix command for manipulating the appearance of appendixes.

    -
    appendix.sty
    macros/latex/contrib/appendix (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    appendix.sty
    macros/latex/contrib/appendix (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=appendix diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-archives.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-archives.html index c5d5971f4f9..262c0e4d2c9 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-archives.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-archives.html @@ -25,19 +25,20 @@ CTAN mirrors are Web-accessible.

    As a matter of course, to reduce network load, please use the CTAN site or mirror closest to you. A complete and current list of CTAN sites -and known mirrors is available as file CTAN.sites on the +and known mirrors is available as file CTAN.sites on the archives themselves.

    Better still, the script behind http://mirror.ctan.org/ will cunningly choose a “nearby” mirror for you, using information from -the database ‘behind’ CTAN.sites; at present it uses +the database ‘behind’ CTAN.sites; at present it uses ftp protocol for transfers, but the intention is to convert it to using http (web) protocol in the near future.

    To access a particular thing through the mirror.ctan.org mechanism, simply place the CTAN path after the base URL; so http://mirror.ctan.org/macros/latex/contrib/footmisc/ will -connect you to the footmisc directory — note that the -tex-archive part of the CTAN path isn’t needed. +connect you to the footmisc directory at some CTAN +site — note that the tex-archive part of the CTAN path +isn’t needed.

    For details of how to find files at CTAN sites, see “finding (La)TeX files”.

    The TeX user who has no access to any sort of diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-askquestion.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-askquestion.html index f2f9211afd8..c6e66a4cc52 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-askquestion.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-askquestion.html @@ -53,6 +53,12 @@ application of your own common sense. needs your local xyzthesis class, or some other resource not generally available, be sure to include a pointer to how the resource can be obtained. +

  • Figures are special, of course. Sometimes the figure itself is + really needed, but most problems may be demonstrated with a + “figure substitute” in the form of a + \rule{width}{height} command, for some value of + <width> and <height>. If the (real) figure is needed, + don’t try posting it: far better to put it on the web somewhere.
  • Be as succinct as possible. Your helpers don’t usually need to know why you’re doing something, just what you’re doing and where the problem is. diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-atsigns.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-atsigns.html index 1c73cdc7fbe..c4245c16ff3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-atsigns.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-atsigns.html @@ -46,7 +46,7 @@ bundling them up into a .sty file and including them with \usepackage; this way you hide your LaTeX internal code somewhere that LaTeX internal code is expected, which often looks ‘tidier’.
    -
    Examples from the Companion
    info/examples/tlc2 (gzipped tar, browse) +
    Examples from the Companion
    info/examples/tlc2 (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=atsigns diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-backref.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-backref.html index 882a922f255..862ecf161be 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-backref.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-backref.html @@ -16,8 +16,8 @@ forgiveable in the case of the hyperref-related backref, since the concept of multiple hyperlinks from the same anchor is less than appealing.)

    -
    backref.sty
    Distributed with macros/latex/contrib/hyperref (gzipped tar, browse) -
    citeref.sty
    macros/latex/contrib/citeref (gzipped tar, browse) +
    backref.sty
    Distributed with macros/latex/contrib/hyperref (or browse the directory) +
    citeref.sty
    macros/latex/contrib/citeref (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=backref diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-balance.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-balance.html index f04c9d28794..4ffe7eac66a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-balance.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-balance.html @@ -39,9 +39,9 @@ It is this difficulty (what’s required in any instance can’t really expressed in current LaTeX) that led the author of multicol to suppress single-column-wide floats.

    -
    balance.sty
    Distributed as part of macros/latex/contrib/preprint (gzipped tar, browse) -
    flushend.sty
    Distributed as part of macros/latex/contrib/sttools (gzipped tar, browse) -
    multicol.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    balance.sty
    Distributed as part of macros/latex/contrib/preprint (or browse the directory) +
    flushend.sty
    Distributed as part of macros/latex/contrib/sttools (or browse the directory) +
    multicol.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=balance diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibinline.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibinline.html index 6bf4d75f2d8..feb98644284 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibinline.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibinline.html @@ -32,10 +32,10 @@ footnotes. Therefore, in a document which has other footnotes, it may be advisable to use jurabib (or of course inlinebib), to avoid confusion of footnotes and foot-citations.

    -
    bibentry.sty
    Distributed with macros/latex/contrib/natbib (gzipped tar, browse) -
    footbib.sty
    macros/latex/contrib/footbib (gzipped tar, browse) -
    inlinebib.sty
    biblio/bibtex/contrib/inlinebib (gzipped tar, browse) -
    jurabib.sty
    macros/latex/contrib/jurabib (gzipped tar, browse) +
    bibentry.sty
    Distributed with macros/latex/contrib/natbib (or browse the directory) +
    footbib.sty
    macros/latex/contrib/footbib (or browse the directory) +
    inlinebib.sty
    biblio/bibtex/contrib/inlinebib (or browse the directory) +
    jurabib.sty
    macros/latex/contrib/jurabib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=bibinline diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-biblatex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-biblatex.html index 055e46b3acb..2b694e6a089 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-biblatex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-biblatex.html @@ -46,7 +46,7 @@ a \nocite{*} command enables BibTeX to produce a usabl amsrefs bibliography database.)

    Amsrefs is maintained by the AMS as part of its author support programme, -

    Biblatex uses BibTeX more-or-less as normal, but with +

    Biblatex uses BibTeX simply to sort the citations using biblatex’s own style; the style of citations and of the bibliography itself is determined by the way your biblatex style has been set up. This structure eliminates the collections of @@ -59,11 +59,25 @@ sections of these FAQs.

    Biblatex is released as experimental software, but it’s clear that many users are already using it happily; Lehman is responsive to problem reports, at the moment, but a set of expert -users is already establishing itself. +users is already establishing itself. A set of contributed styles has +appeared, which cover some of the trickier bibliography styles. The +road map of the project shows one more beta release before the +“stable” biblatex 1.0. +

    A related project is +biber (or +biblatex-biber, to distinguish it from an older, defunct, +BibTeX replacement project). Biber is a +Perl-based system to produce a BibTeX replacement that +is specifically tuned to the requirements of biblatex. +While it supports ‘traditional’ BibTeX, biber aims at an +interface language that is closely tuned to the requirements of +biblatex, including use of a Unicode-based character set to +ease the generation multilingual citations.

    -
    amsrefs.sty
    macros/latex/contrib/amsrefs (gzipped tar, browse) -
    biblatex.sty
    macros/latex/exptl/biblatex (gzipped tar, browse) -
    CrossTeX
    biblio/crosstex/ +
    amsrefs.sty
    macros/latex/contrib/amsrefs (or browse the directory) +
    biblatex.sty
    macros/latex/exptl/biblatex (or browse the directory) +
    biblatex contributions
    macros/latex/exptl/biblatex-contrib/ +
    CrossTeX
    biblio/crosstex/

    diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibplain.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibplain.html index 6e2fc9e212b..3f9f106fd16 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibplain.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibplain.html @@ -8,8 +8,8 @@ Plain TeX, either directly or with Eplain. See the use of BibTeX for more information about BibTeX itself.

    -
    btxmac.tex
    macros/eplain/tex/eplain/btxmac.tex -
    eplain system
    macros/eplain (gzipped tar, browse) +
    btxmac.tex
    macros/eplain/tex/eplain/btxmac.tex +
    eplain system
    macros/eplain (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=bibplain diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibstrtl.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibstrtl.html index c8665ba7998..d9a5664bbf5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibstrtl.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-bibstrtl.html @@ -9,7 +9,7 @@ The diagnostic usually arises because of an infelicity in the coding of abstract.bst, or styles derived from it. (One doesn’t ordinarily output annotations in other styles.)

    The solution is to make a copy of the style file (or get a clean copy -from CTAN — biblio/bibtex/utils/bibtools/abstract.bst), and rename it (e.g., on a +from CTAN — biblio/bibtex/utils/bibtools/abstract.bst), and rename it (e.g., on a long file-name system, to abstract-long.bst). Now edit it: find function output.nonnull and

    -
    bids.to.bibtex
    biblio/bibtex/utils/bids/bids.to.bibtex -
    btOOL
    biblio/bibtex/utils/btOOL (gzipped tar, browse) -
    ebib
    biblio/bibtex/utils/ebib (gzipped tar, browse) -
    isi2bibtex
    biblio/bibtex/utils/isi2bibtex (gzipped tar, browse) -
    tex2bib
    biblio/bibtex/utils/tex2bib/tex2bib -
    tex2bib.readme
    biblio/bibtex/utils/tex2bib/README -
    xbibfile
    biblio/bibtex/utils/xbibfile (gzipped tar, browse) +
    bids.to.bibtex
    biblio/bibtex/utils/bids/bids.to.bibtex +
    btOOL
    biblio/bibtex/utils/btOOL (or browse the directory) +
    ebib
    biblio/bibtex/utils/ebib (or browse the directory) +
    isi2bibtex
    biblio/bibtex/utils/isi2bibtex (or browse the directory) +
    tex2bib
    biblio/bibtex/utils/tex2bib/tex2bib +
    tex2bib.readme
    biblio/bibtex/utils/tex2bib/README +
    xbibfile
    biblio/bibtex/utils/xbibfile (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=buildbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cancellation.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cancellation.html index 68d98f6654e..21eeacbd2fd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cancellation.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cancellation.html @@ -9,7 +9,7 @@ package provides several variants of cancellation marks a means of cancelling ‘to’ a particular value.

    Documentation of cancel is in the package file.

    -
    cancel.sty
    macros/latex/contrib/misc/cancel.sty +
    cancel.sty
    macros/latex/contrib/misc/cancel.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=cancellation diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-captsty.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-captsty.html index d9dfeb65092..98bbc9f1834 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-captsty.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-captsty.html @@ -40,12 +40,12 @@ file manual.tex, which is created when you unpack now been overtaken again by caption; however, caption2 remains available for use in older documents.

    -
    caption.sty
    macros/latex/contrib/caption (gzipped tar, browse) -
    capt-of.sty
    macros/latex/contrib/misc/capt-of.sty -
    ccaption.sty
    macros/latex/contrib/ccaption (gzipped tar, browse) -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    caption.sty
    macros/latex/contrib/caption (or browse the directory) +
    capt-of.sty
    macros/latex/contrib/misc/capt-of.sty +
    ccaption.sty
    macros/latex/contrib/ccaption (or browse the directory) +
    float.sty
    macros/latex/contrib/float (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=captsty diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-casechange.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-casechange.html index 147a29f6e65..2b51f342ba4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-casechange.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-casechange.html @@ -59,7 +59,7 @@ commands (not the TeX primitive commands \uppercase< \lowercase), so that section headings and the like don’t produce broken page headings.

    -
    textcase.sty
    macros/latex/contrib/textcase (gzipped tar, browse) +
    textcase.sty
    macros/latex/contrib/textcase (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=casechange diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changebars.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changebars.html index c7a89b8a53a..719a51a6840 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changebars.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changebars.html @@ -70,14 +70,14 @@ A rudimentary revision facility is provided by another all changes. Manual editing of the difference file can be used to accept or reject selected changes only.

    -
    backgrnd.tex
    macros/generic/misc/backgrnd.tex -
    changebar.sty
    macros/latex/contrib/changebar (gzipped tar, browse) -
    changes.sty
    macros/latex/contrib/changes (gzipped tar, browse) -
    framed.sty
    macros/latex/contrib/misc/framed.sty -
    latexdiff, latexrevise
    support/latexdiff (gzipped tar, browse) -
    lineno.sty
    macros/latex/contrib/lineno (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    vertbars.sty
    macros/latex/contrib/misc/vertbars.sty +
    backgrnd.tex
    macros/generic/misc/backgrnd.tex +
    changebar.sty
    macros/latex/contrib/changebar (or browse the directory) +
    changes.sty
    macros/latex/contrib/changes (or browse the directory) +
    framed.sty
    macros/latex/contrib/misc/framed.sty +
    latexdiff, latexrevise
    support/latexdiff (or browse the directory) +
    lineno.sty
    macros/latex/contrib/lineno (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    vertbars.sty
    macros/latex/contrib/misc/vertbars.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=changebars diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changemargin.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changemargin.html index 8de6cff6081..0ec0fd07080 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changemargin.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-changemargin.html @@ -21,8 +21,10 @@ per line (though the constraints change for two-column text). Style’ — “don’t do it” — should not lightly be ignored.

    This set of FAQs recommends that you use a package to establish consistent settings of the parameters: the interrelationships are -taken care of in the established packages, without you needing to -think about them, but +taken care of in the established packages, without you needing +to think about them, but remember — the packages only provide +consistent, working, mechanisms: they don’t analyse the quality of +what you propose to do.

    The following answers deal with the ways one may choose to proceed:

    • Choose which package to use. diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chapbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chapbib.html index 550ae8aeb80..dacbbb004b7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chapbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chapbib.html @@ -14,8 +14,8 @@ within the document: the package will deal with chapters and sections (as defined by LaTeX itself) and also defines a bibunit environment so that users can select their own structuring.
      -
      chapterbib.sty
      macros/latex/contrib/cite (gzipped tar, browse) -
      bibunits.sty
      macros/latex/contrib/bibunits (gzipped tar, browse) +
      chapterbib.sty
      macros/latex/contrib/cite (or browse the directory) +
      bibunits.sty
      macros/latex/contrib/bibunits (or browse the directory)

      This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=chapbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chngmargonfly.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chngmargonfly.html index 18c0bec481d..8b35339f452 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chngmargonfly.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-chngmargonfly.html @@ -36,10 +36,12 @@ environment (which is a close relation of the LaTeX quote environment) doesn’t change the text width as far as TeX is concerned: it merely moves text around inside the width that TeX believes in. -

      The changepage package provides ready-built commands to do the -above; it includes provision for changing the shifts applied to your -text according to whether you’re on an odd (recto) or an even -(verso) page of a two-sided document. +

      The changepage package provides ready-built commands to do +the above; it includes provision for changing the shifts applied to +your text according to whether you’re on an odd (recto) or an +even (verso) page of a two-sided document. +Changepage’s structure matches that of the memoir +class.

      The (earlier) package chngpage provides the same facilities, but it uses rather different syntax. Changepage’s structure matches that of the memoir class, and it should be used for @@ -58,10 +60,15 @@ to make the page one line longer, or \enlargethispage{-\baselineskip}

  • -to make the page one line shorter. +to make the page one line shorter. The process is (to an extent) +simplified by the addlines package: its \addlines +command takes as argument the number of lines to add to the +page (rather than a length): the package documentation also provides a +useful analysis of when the command may (or may not) be expected to +work.

    -
    changepage.sty
    macros/latex/contrib/misc/changepage.sty -
    chngpage.sty
    macros/latex/contrib/misc/chngpage.sty +
    addlines.sty
    macros/latex/contrib/addlines (or browse the directory) +
    changepage.sty
    macros/latex/contrib/misc/changepage.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=chngmargonfly diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citeURL.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citeURL.html index ebe82a177d8..590e0c14874 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citeURL.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citeURL.html @@ -77,13 +77,13 @@ is an acceptable character in an URL. Any current version of the “%–end-of-line” structure in its argument, and removes it.

    -
    babelbib bundle
    biblio/bibtex/contrib/babelbib (gzipped tar, browse) -
    custom-bib bundle
    macros/latex/contrib/custom-bib (gzipped tar, browse) -
    harvard.sty
    macros/latex/contrib/harvard (gzipped tar, browse) -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    natbib styles
    macros/latex/contrib/natbib (gzipped tar, browse) -
    url.sty
    macros/latex/contrib/misc/url.sty -
    urlbst
    biblio/bibtex/contrib/urlbst (gzipped tar, browse) +
    babelbib bundle
    biblio/bibtex/contrib/babelbib (or browse the directory) +
    custom-bib bundle
    macros/latex/contrib/custom-bib (or browse the directory) +
    harvard.sty
    macros/latex/contrib/harvard (or browse the directory) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    natbib styles
    macros/latex/contrib/natbib (or browse the directory) +
    url.sty
    macros/latex/contrib/misc/url.sty +
    urlbst
    biblio/bibtex/contrib/urlbst (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=citeURL diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citesort.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citesort.html index 2fbf74de819..613c7754485 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citesort.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-citesort.html @@ -25,11 +25,11 @@ package: the natbib and hyperref packages will interwork.

    -
    cite.sty
    macros/latex/contrib/cite (gzipped tar, browse) -
    hypernat.sty
    macros/latex/contrib/misc/hypernat.sty -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    plainnat.bst
    Distributed with macros/latex/contrib/natbib (gzipped tar, browse) -
    unsrtnat.bst
    Distributed with macros/latex/contrib/natbib (gzipped tar, browse) +
    cite.sty
    macros/latex/contrib/cite (or browse the directory) +
    hypernat.sty
    macros/latex/contrib/misc/hypernat.sty +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    plainnat.bst
    Distributed with macros/latex/contrib/natbib (or browse the directory) +
    unsrtnat.bst
    Distributed with macros/latex/contrib/natbib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=citesort diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cmdstar.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cmdstar.html index cd2b68610d8..d25ad304643 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cmdstar.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cmdstar.html @@ -62,7 +62,7 @@ definition like:

    ifthen.sty
    Part of the LaTeX distribution -
    suffix.sty
    Distributed as part of macros/latex/contrib/bigfoot (gzipped tar, browse) +
    suffix.sty
    Distributed as part of macros/latex/contrib/bigfoot (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=cmdstar diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-codelist.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-codelist.html index 4ec9f46961d..3c949593ab1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-codelist.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-codelist.html @@ -72,13 +72,13 @@ LaTeX source in your C program comments. The program then converts your program into a LaTeX document for processing. The program (implicitly) claims to be “self-documenting”.

    -
    c2latex
    support/c2latex (gzipped tar, browse) -
    C++2LaTeX
    support/C++2LaTeX-1_1pl1 (gzipped tar, browse) -
    highlight
    support/highlight (gzipped tar, browse) -
    lgrind
    support/lgrind (gzipped tar, browse) -
    listings.sty
    macros/latex/contrib/listings (gzipped tar, browse) -
    tgrind
    support/tgrind (gzipped tar, browse) -
    tiny_c2l
    support/tiny_c2l (gzipped tar, browse) +
    c2latex
    support/c2latex (or browse the directory) +
    C++2LaTeX
    support/C++2LaTeX-1_1pl1 (or browse the directory) +
    highlight
    support/highlight (or browse the directory) +
    lgrind
    support/lgrind (or browse the directory) +
    listings.sty
    macros/latex/contrib/listings (or browse the directory) +
    tgrind
    support/tgrind (or browse the directory) +
    tiny_c2l
    support/tiny_c2l (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=codelist diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-commercial.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-commercial.html index 195e7d938ee..d4e9b28961a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-commercial.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-commercial.html @@ -100,7 +100,7 @@ also have email, and normal telephone and fax support. Source: Mail from Christopher Mabb, August 2007

    Macintosh; Textures
    “A TeX system ‘for the rest of us’ ”. A beta release of Textures for MacOS/X is - available http://www.bluesky.com/news/220b.html + available~— see http://www.bluesky.com/news/news_frames.html

    (Blue Sky also gives away a Metafont implementation and some font manipulation tools for Macs.)

    diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-compactbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-compactbib.html index 8675cc55670..83cdbab4994 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-compactbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-compactbib.html @@ -15,6 +15,10 @@ simple — add

    to the preamble of your document. +

    The compactbib package has a similar effect. Its primary +purpose is to produce two bibliographies, and it seems to preclude use +of BibTeX (though the package documentation, in the package file +itself, isn’t particularly clear).

    Otherwise, one is into unseemly hacking of something or other. The mdwlist package actually does the job, but it doesn’t work here, because it makes a different-named list, while the name @@ -35,9 +39,10 @@ plethora of space-saving measures: you can, in principle, suppress all its other actions, and have it provide you a compressed bibliography only.

    -
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) -
    natbib.sty
    macros/latex/contrib/natbib (gzipped tar, browse) -
    savetrees.sty
    macros/latex/contrib/savetrees (gzipped tar, browse) +
    compactbib.sty
    macros/latex/contrib/compactbib/compactbib.sty +
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory) +
    natbib.sty
    macros/latex/contrib/natbib (or browse the directory) +
    savetrees.sty
    macros/latex/contrib/savetrees (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=compactbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-complist.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-complist.html index 81365892835..af99daac92e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-complist.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-complist.html @@ -98,14 +98,14 @@ to set spacing between items and between paragraphs within items. more “basic” (and therefore more flexible) manner than the enumerate package does.

    -
    enumerate.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    enumitem.sty
    macros/latex/contrib/enumitem (gzipped tar, browse) -
    expdlist.sty
    macros/latex/contrib/expdlist (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) -
    multenum.sty
    macros/latex/contrib/multenum (gzipped tar, browse) -
    paralist.sty
    macros/latex/contrib/paralist (gzipped tar, browse) -
    savetrees.sty
    macros/latex/contrib/savetrees (gzipped tar, browse) +
    enumerate.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    enumitem.sty
    macros/latex/contrib/enumitem (or browse the directory) +
    expdlist.sty
    macros/latex/contrib/expdlist (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory) +
    multenum.sty
    macros/latex/contrib/multenum (or browse the directory) +
    paralist.sty
    macros/latex/contrib/paralist (or browse the directory) +
    savetrees.sty
    macros/latex/contrib/savetrees (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=complist diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-concrete.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-concrete.html index 388fc0299e8..86bfe9f8dd4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-concrete.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-concrete.html @@ -48,15 +48,15 @@ they are available from MicroPress. The CM-Super fonts contain Type 1 versions of the Concrete fonts in T1 encoding.

    -
    beton.sty
    macros/latex/contrib/beton (gzipped tar, browse) -
    ccfonts.sty
    macros/latex/contrib/ccfonts (gzipped tar, browse) -
    CM-Super fonts
    fonts/ps-type1/cm-super (gzipped tar, browse) -
    concmath.sty
    macros/latex/contrib/concmath (gzipped tar, browse) -
    Concmath fonts
    fonts/concmath (gzipped tar, browse) -
    Concrete fonts
    fonts/concrete (gzipped tar, browse) -
    euler.sty
    macros/latex/contrib/euler (gzipped tar, browse) -
    eulervm bundle
    fonts/eulervm (gzipped tar, browse) -
    gkpmac.tex
    systems/knuth/local/lib/gkpmac.tex +
    beton.sty
    macros/latex/contrib/beton (or browse the directory) +
    ccfonts.sty
    macros/latex/contrib/ccfonts (or browse the directory) +
    CM-Super fonts
    fonts/ps-type1/cm-super (or browse the directory) +
    concmath.sty
    macros/latex/contrib/concmath (or browse the directory) +
    Concmath fonts
    fonts/concmath (or browse the directory) +
    Concrete fonts
    fonts/concrete (or browse the directory) +
    euler.sty
    macros/latex/contrib/euler (or browse the directory) +
    eulervm bundle
    fonts/eulervm (or browse the directory) +
    gkpmac.tex
    systems/knuth/local/lib/gkpmac.tex

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=concrete diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html index cba1c195363..b6aa1b47a08 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-conditional.html @@ -150,20 +150,20 @@ an extract environment which you can use to create complete ready-to-run LaTeX documents with stuff you’ve extracted.

    askinclude.sty
    Distributed with Heiko Oberdiek’s packages — - macros/latex/contrib/oberdiek (gzipped tar, browse) -
    comment.sty
    macros/latex/contrib/comment (gzipped tar, browse) -
    excludeonly.sty
    macros/latex/contrib/misc/excludeonly.sty -
    extract.sty
    macros/latex/contrib/extract (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    optional.sty
    macros/latex/contrib/misc/optional.sty + macros/latex/contrib/oberdiek (or browse the directory) +
    comment.sty
    macros/latex/contrib/comment (or browse the directory) +
    excludeonly.sty
    macros/latex/contrib/misc/excludeonly.sty +
    extract.sty
    macros/latex/contrib/extract (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    optional.sty
    macros/latex/contrib/misc/optional.sty
    pagesel.sty
    Distributed with Heiko Oberdiek’s packages — - macros/latex/contrib/oberdiek (gzipped tar, browse) -
    pdfpages.sty
    macros/latex/contrib/pdfpages (gzipped tar, browse) -
    selectp.sty
    macros/latex/contrib/misc/selectp.sty -
    verbatim.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    version.sty
    macros/latex/contrib/misc/version.sty -
    versions.sty
    macros/latex/contrib/versions/versions.sty -
    xcomment.sty
    Distributed as part of macros/latex/contrib/seminar (gzipped tar, browse) + macros/latex/contrib/oberdiek (or browse the directory) +
    pdfpages.sty
    macros/latex/contrib/pdfpages (or browse the directory) +
    selectp.sty
    macros/latex/contrib/misc/selectp.sty +
    verbatim.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    version.sty
    macros/latex/contrib/misc/version.sty +
    versions.sty
    macros/latex/contrib/versions/versions.sty +
    xcomment.sty
    Distributed as part of macros/latex/contrib/seminar (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=conditional diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-context.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-context.html index c3f57b68c60..7af37da0271 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-context.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-context.html @@ -43,8 +43,7 @@ prodigious energy. Support is available via a WIKI site and via the mailing list.

    -
    ConTeXt distribution
    macros/context (gzipped tar, browse) +
    ConTeXt distribution
    macros/context (or browse the directory)
    -

    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=context +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=context diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-crop.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-crop.html index 2c86ecce729..d7562f3743f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-crop.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-crop.html @@ -13,8 +13,8 @@ facilities to satisfy any conceivable production house. Users of the memoir class don’t need the package, since memoir has its own facilities for programming crop marks.

    -
    crop.sty
    macros/latex/contrib/crop (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    crop.sty
    macros/latex/contrib/crop (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=crop diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-custbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-custbib.html index 69209eed9eb..d3e34e49a8b 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-custbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-custbib.html @@ -19,8 +19,8 @@ own .bst file. This technique doesn’t offer entirely new sty of document, but the system’s “master BibTeX styles” already offer significantly more than the BibTeX standard set.

    -
    BibTeX documentation
    biblio/bibtex/distribs/doc (gzipped tar, browse) -
    makebst.tex
    Distributed with macros/latex/contrib/custom-bib (gzipped tar, browse) +
    BibTeX documentation
    biblio/bibtex/contrib/doc (or browse the directory) +
    makebst.tex
    Distributed with macros/latex/contrib/custom-bib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=custbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cv.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cv.html index caa9ad674ba..41648d41839 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cv.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-cv.html @@ -31,12 +31,12 @@ FAQ team. Its output certainly looks good.

    There is also a LaTeX 2.09 package resume, which comes with little but advice against trying to use it.

    -
    currvita.sty
    macros/latex/contrib/currvita (gzipped tar, browse) -
    curve.cls
    macros/latex/contrib/curve (gzipped tar, browse) -
    europecv.cls
    macros/latex/contrib/europecv (gzipped tar, browse) -
    moderncv.cls
    macros/latex/contrib/moderncv (gzipped tar, browse) -
    resume.sty
    obsolete/macros/latex209/contrib/resume/resume.sty -
    vita.cls
    macros/latex/contrib/vita (gzipped tar, browse) +
    currvita.sty
    macros/latex/contrib/currvita (or browse the directory) +
    curve.cls
    macros/latex/contrib/curve (or browse the directory) +
    europecv.cls
    macros/latex/contrib/europecv (or browse the directory) +
    moderncv.cls
    macros/latex/contrib/moderncv (or browse the directory) +
    resume.sty
    obsolete/macros/latex209/contrib/resume/resume.sty +
    vita.cls
    macros/latex/contrib/vita (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=cv diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dec_comma.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dec_comma.html index 8c4bc8f9ae9..c1cde44104c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dec_comma.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dec_comma.html @@ -33,9 +33,9 @@ group the digits of very ‘long’ numbers), but is inevitably less convenient than icomma or ziffer if you are typing a lot of numbers.

    -
    icomma.sty
    Distributed as part of macros/latex/contrib/was (gzipped tar, browse) -
    numprint.sty
    macros/latex/contrib/numprint (gzipped tar, browse) -
    ziffer.sty
    macros/latex/contrib/ziffer (gzipped tar, browse) +
    icomma.sty
    Distributed as part of macros/latex/contrib/was (or browse the directory) +
    numprint.sty
    macros/latex/contrib/numprint (or browse the directory) +
    ziffer.sty
    macros/latex/contrib/ziffer (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dec_comma diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-destable.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-destable.html index 53ed96568b7..3f135df12c2 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-destable.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-destable.html @@ -35,7 +35,7 @@ position wrong (by 10pt) if you simply write: The topcapt package solves this problem:

    -\usepackage{topcaption}
    +\usepackage{topcapt}
     ...
     \begin{table}
       \topcaption{Example table}
    @@ -74,10 +74,10 @@ value 10pt) and \belowcaptionskip (defaul
     

    does the job. (The package itself is very slightly more elaborate...)

    -
    booktabs.sty
    macros/latex/contrib/booktabs (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    topcapt.sty
    macros/latex/contrib/misc/topcapt.sty +
    booktabs.sty
    macros/latex/contrib/booktabs (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    topcapt.sty
    macros/latex/contrib/misc/topcapt.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=destable diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-divzero.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-divzero.html index 675a02de27b..9c75637cdad 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-divzero.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-divzero.html @@ -48,7 +48,7 @@ will resolve the error, and will behave as you might hope.

    -
    graphics.sty,graphicx.sty
    Both parts of the macros/latex/required/graphics (gzipped tar, browse) bundle +
    graphics.sty,graphicx.sty
    Both parts of the macros/latex/required/graphics (or browse the directory) bundle

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=divzero diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-doc-wiki.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-doc-wiki.html index 14f72dc46ec..9d5d4cf3dba 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-doc-wiki.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-doc-wiki.html @@ -8,14 +8,11 @@ stuff that someone else has added: while there is obvious potential for chaos, there is evidence that a strong user community can keep a WIKI under control.

    Following the encouraging performance of the -ConTeXt WIKI, both a -(Plain) TeX WIKI and a -LaTeX WIKI have been -established. Both seem rather sparse, as yet, and the LaTeX WIKI -contains some suggestions that go counter to established advice (e.g., -the LaTeX WIKI has details on the -use of the eqnarray environment); -however one may hope that both will become useful resources in the -longer term. +ConTeXt WIKI, valiant efforts +have been made generating “WIKI books” for (La)TeX users. Thus we +have (Plain) TeX WIKI and +LaTeX WIKI are well +established. Neither would seem yet to be of publication quality, but +they both seem useful reference sources.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=doc-wiki diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docotherdir.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docotherdir.html index aa6074b7fed..336f6561392 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docotherdir.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docotherdir.html @@ -58,8 +58,8 @@ provide a path to the file. (There are also

    Documentation of chapterfolder is in French, but the README in the directory is in English.

    -
    chapterfolder.sty
    macros/latex/contrib/chapterfolder (gzipped tar, browse) -
    import.sty
    macros/latex/contrib/misc/import.sty +
    chapterfolder.sty
    macros/latex/contrib/chapterfolder (or browse the directory) +
    import.sty
    macros/latex/contrib/misc/import.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=docotherdir diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docpictex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docpictex.html index 2040e88b3ac..8d9776c5cf6 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docpictex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-docpictex.html @@ -14,8 +14,8 @@ manual is not available electronically. CTAN, which is a great aide-memoire for those who basically know the package to start with.

    -
    pictex
    graphics/pictex (gzipped tar, browse) -
    PiCTeX summary
    info/pictex/summary (gzipped tar, browse) +
    pictex
    graphics/pictex (or browse the directory) +
    PiCTeX summary
    info/pictex/summary (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=docpictex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dpfloat.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dpfloat.html index 56c65cbb3c2..38a140ed293 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dpfloat.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dpfloat.html @@ -25,7 +25,7 @@ The construction has no effect unless the standard class option

    Full documentation of the package (such as it is) is to be found in README.dpfloat

    -
    dpfloat.sty
    macros/latex/contrib/dpfloat (gzipped tar, browse) +
    dpfloat.sty
    macros/latex/contrib/dpfloat (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dpfloat diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawFeyn.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawFeyn.html index 08a3f88af38..5b36261fa5e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawFeyn.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawFeyn.html @@ -25,10 +25,10 @@ fragments, which you can compose to produce complete diagrams. It offers fairly simple diagrams which look good in equations, rather than complicated ones more suitable for display in figures.

    -
    axodraw
    graphics/axodraw (gzipped tar, browse) -
    feyn font bundle
    fonts/feyn (gzipped tar, browse) -
    feynman bundle
    macros/latex209/contrib/feynman (gzipped tar, browse) -
    feynmf/feynmp bundle
    macros/latex/contrib/feynmf (gzipped tar, browse) +
    axodraw
    graphics/axodraw (or browse the directory) +
    feyn font bundle
    fonts/feyn (or browse the directory) +
    feynman bundle
    macros/latex209/contrib/feynman (or browse the directory) +
    feynmf/feynmp bundle
    macros/latex/contrib/feynmf (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=drawFeyn diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawing.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawing.html index 5cd801f9013..a541f5b6bfb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawing.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-drawing.html @@ -5,14 +5,25 @@

    There are many packages to do pictures in (La)TeX itself (rather than importing graphics created externally), ranging from simple use of LaTeX picture environment, through enhancements like -epic, to +eepic, to sophisticated (but slow) drawing with PicTeX. Depending on your type of drawing, and setup, here are a few systems you may consider:

      +
    • PicTeX is a venerable, and very powerful, system, that draws + by placing dots on the page to give the effect of a line or curve. While + this has the potential of great power, it is (of course) much slower + than any of the other established packages. What’s more, there + are problems with its documentation. +
    • epic was designed to make use of the LaTeX + picture environment somewhat less agonising; + eepic extends it, and is capable of using tpic + \special commands to improve printing performance. (If the + \specials aren’t available, the eepicemu will do the + business, far less efficiently.
    • pict2e; this was advertised in the LaTeX manual, but didn’t appear for nearly ten years after publication of the book! It removes all the petty - niggles that surround the use of the picture + restrictions that surround the use of the picture environment. It therefore suffers only from the rather eccentric drawing language of the environment, and is a far more useful tool than the original environment has ever been. (Note that @@ -21,9 +32,11 @@ of drawing, and setup, here are a few systems you may consider:
    • PSTricks; this gives you access to all the power of PostScript from TeX itself, by sophisticated use of \special commands. Since PostScript is itself a - pretty powerful programming language, many astounding things can in - principle be achieved using PSTricks. - pstricks\specials are + pretty powerful programming language, many astounding things can in + principle be achieved using PSTricks (a wide range of + contributed packages, ranging from world mapping to lens design + diagrams, is available). + Pstricks\specials are by default specific to dvips, but VTeX (both in its commercial and in its free versions) understands them. PDFTeX users may use pst-pdf, which (like @@ -63,15 +76,19 @@ of drawing, and setup, here are a few systems you may consider: readable (and is fully documented).
    -
    dratex.sty
    graphics/dratex (gzipped tar, browse) -
    mfpic
    graphics/mfpic (gzipped tar, browse) -
    preview.sty
    macros/latex/contrib/preview (gzipped tar, browse) -
    pspicture.sty
    macros/latex/contrib/pspicture (gzipped tar, browse) -
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (gzipped tar, browse) -
    pgf.sty
    graphics/pgf (gzipped tar, browse) -
    pict2e.sty
    macros/latex/contrib/pict2e (gzipped tar, browse) -
    pstricks
    graphics/pstricks (gzipped tar, browse) -
    tikz.sty
    Distributed with graphics/pgf (gzipped tar, browse) +
    dratex.sty
    graphics/dratex (or browse the directory) +
    epic.sty
    macros/latex/contrib/epic (or browse the directory) +
    eepic.sty
    macros/latex/contrib/eepic (or browse the directory) +
    eepicemu.sty
    macros/latex/contrib/eepic (or browse the directory) +
    mfpic
    graphics/mfpic (or browse the directory) +
    preview.sty
    macros/latex/contrib/preview (or browse the directory) +
    pspicture.sty
    macros/latex/contrib/pspicture (or browse the directory) +
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (or browse the directory) +
    pgf.sty
    graphics/pgf (or browse the directory) +
    pict2e.sty
    macros/latex/contrib/pict2e (or browse the directory) +
    pictex.sty
    graphics/pictex (or browse the directory) +
    pstricks
    graphics/pstricks (or browse the directory) +
    tikz.sty
    Distributed with graphics/pgf (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=drawing diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dropping.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dropping.html index 32a0256fd41..f58f8b286fd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dropping.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dropping.html @@ -6,25 +6,25 @@ is to start a paragraph (in books, usually the first of a chapter) with its first letter set large enough to span several lines.

    This style is known as “dropped capitals”, or (in French) -«lettrines», and TeX’s primitive -facilities for hanging indentation make its (simple) implementation -pretty straightforward. +«lettrines», +and TeX’s primitive facilities for hanging indentation make its +(simple) implementation pretty straightforward.

    The dropping package does the job simply, but has a curious attitude to the calculation of the size of the font to be used for the big letters. Examples appear in the package documentation, so before -you process the .dtx, the package itself must already be installed. -Unfortunately, dropping has an intimate relation to the set -of device drivers available in an early version of the LaTeX -graphics package, and it cannot be trusted to work with recent -offerings like PDFTeX, VTeX or DVIpdfm. -

    On such occasions, the more recent lettrine package is more -likely to succeed. It has a well-constructed array of options, and -the examples (a pretty impressive set) come as a separate file in the -distribution (also available in PostScript, so that they can be viewed -without installing the package itself). +you process the .dtx, the package itself must already be +installed. Unfortunately, dropping has an intimate relation +to the set of device drivers available in an early version of the +LaTeX graphics package, and it cannot be trusted to work with +modern offerings such as PDFTeX, VTeX or DVIpdfm, let +alone such modernisms as XeTeX. As a result, the package is widely +deprecated, nowadays. +

    The more recent lettrine package is generally more reliable. +It has a well-constructed array of options, and an impressive set of +examples adds to the package’s document.

    -
    dropping
    macros/latex/contrib/dropping (gzipped tar, browse) -
    lettrine
    macros/latex/contrib/lettrine (gzipped tar, browse) +
    dropping
    macros/latex/contrib/dropping (or browse the directory) +
    lettrine
    macros/latex/contrib/lettrine (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dropping diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dtx.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dtx.html index cbbed32fbb1..ff2da9b05b3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dtx.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dtx.html @@ -43,11 +43,11 @@ package to thus permitting documented distribution of bundles containing code for Metafont and MetaPost together with related LaTeX code.

    -
    clsguide.pdf
    macros/latex/doc/clsguide.pdf -
    docmfp.sty
    macros/latex/contrib/docmfp (gzipped tar, browse) +
    clsguide.pdf
    macros/latex/doc/clsguide.pdf +
    docmfp.sty
    macros/latex/contrib/docmfp (or browse the directory)
    docstrip.tex
    Part of the LaTeX distribution -
    DTX tutorial
    info/dtxtut (gzipped tar, browse) -
    makedtx
    support/makedtx (gzipped tar, browse) +
    DTX tutorial
    info/dtxtut (or browse the directory) +
    makedtx
    support/makedtx (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dtx diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi-bmp.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi-bmp.html index 11ea878604c..682f5bf0660 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi-bmp.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi-bmp.html @@ -14,9 +14,10 @@ source — not everything that you can write in (La)TeX can be translated to HTML (at least, portable HTML that may be viewed in ‘most’ browsers), so the commonest avoiding action is to generate a bitmap of the missing bit. Examples are maths (a maths -extension to the *ML family is available but not widely -used), and ‘exotic’ typescripts (ones that you cannot guarantee your -readers will have available). Other common examples are generation of +extension to the ‘*ML’ family is available but not +universally supported by browsers), and ‘exotic’ typescripts (ones +that you cannot guarantee your readers will have available). Other +common examples are generation of sample bitmaps, and generation for insertion into some other application’s display — to insert equations into Microsoft PowerPoint, or to support the enhanced-emacs setup called @@ -41,8 +42,8 @@ web-oriented environments. Note that dvipng gives high-quality output even though its internal operations are optimised for speed.

    -
    dvi2bitmap
    dviware/dvi2bitmap (gzipped tar, browse) -
    dvipng
    dviware/dvipng (gzipped tar, browse) +
    dvi2bitmap
    dviware/dvi2bitmap (or browse the directory) +
    dvipng
    dviware/dvipng (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvi-bmp diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi.html index 7539268ba10..743f414dcce 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvi.html @@ -22,7 +22,7 @@ possibly material to be introduced by means of source of Knuth’s program dvitype (whose original purpose, as its name implies, was to view the content of a DVI file).

    -
    dvitype
    systems/knuth/dist/texware/dvitype.web +
    dvitype
    systems/knuth/dist/texware/dvitype.web

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvi diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipdfmgraphics.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipdfmgraphics.html index e0e0c376c90..e962230257b 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipdfmgraphics.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipdfmgraphics.html @@ -2,16 +2,16 @@ UK TeX FAQ -- question label dvipdfmgraphics

    Imported graphics in dvipdfm

    -

    Dvipdfm translates direct from DVI to PDF -(all other available routes produce PostScript output using -dvips and then convert that to PDF with +

    Dvipdfm (and dvipdfmx) translates direct from +DVI to PDF (all other available routes produce PostScript +output using dvips and then convert that to PDF with ghostscript or Acrobat Distiller). -

    Dvipdfm is a particularly flexible application. It will -permit the inclusion of bitmap and PDF graphics, as does -PDFTeX, but is also capable of employing -ghostscript “on the fly” so as to be able to permit the -inclusion of encapsulated PostScript (.eps) files by translating -them to PDF. In this way, dvipdfm combines the good +

    Dvipdfm/Dvipdfmx are particularly flexible +applications. They permit the inclusion of bitmap and PDF +graphics, as does PDFTeX, but are also +capable of employing ghostscript “on the fly” so as to be +able to permit the inclusion of encapsulated PostScript (.eps) +files by translating them to PDF. In this way, they combine the good qualities of dvips and of PDFTeX as a means of processing illustrated documents.

    Unfortunately, “ordinary” LaTeX can’t deduce the bounding box of @@ -37,7 +37,7 @@ containing the information; the above numbers came from an %%CreationDate: Mon Mar 8 15:17:47 2004

    -However, if such a file is available, you may abbreviate the inclusion +If such a file is available, you may abbreviate the inclusion code, above, to read:

    @@ -58,8 +58,9 @@ don’t ordinarily need to specify the fact, since the default graphics
     configuration file (of most distributions) “guesses” the
     dvips option if you’re using TeX.
     
    -
    dvipdfm
    dviware/dvipdfm (gzipped tar, browse) -
    ebb
    Distributed as part of dviware/dvipdfm (gzipped tar, browse) +
    dvipdfm
    dviware/dvipdfm (or browse the directory) +
    dvipdfmx
    dviware/dvipdfmx (or browse the directory) +
    ebb
    Distributed as part of dviware/dvipdfm (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvipdfmgraphics diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips-pdf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips-pdf.html index 9da7380561b..3ad634b39ac 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips-pdf.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips-pdf.html @@ -40,7 +40,7 @@ come. Shell’s testflow package, which these FAQs recommend as a “specialised tutorial.

    -
    testflow
    macros/latex/contrib/IEEEtran/testflow/ +
    testflow
    macros/latex/contrib/IEEEtran/testflow/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvips-pdf diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips.html index b64722780eb..10f7e879ecd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvips.html @@ -14,8 +14,8 @@ distribution of TeX for VMS.

    A precompiled version to work with emTeX is available on CTAN.

    MSDOS and OS/2
    - systems/msdos/dviware/dvips (gzipped tar, browse) -
    VMS distribution
    systems/OpenVMS/TEX97_CTAN.ZIP + systems/msdos/dviware/dvips (or browse the directory) +
    VMS distribution
    systems/OpenVMS/TEX97_CTAN.ZIP

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvips diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipsgraphics.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipsgraphics.html index 19140f647be..7f68af65f8c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipsgraphics.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-dvipsgraphics.html @@ -32,10 +32,10 @@ assuming that capability destroys portability, and is only recommendable if you are sure you will never want to share your document.

    -
    a2ping
    graphics/a2ping (gzipped tar, browse) -
    bmeps
    support/bmeps (gzipped tar, browse) -
    jpeg2ps
    nonfree/support/jpeg2ps (gzipped tar, browse) -
    sam2p
    graphics/sam2p (gzipped tar, browse) +
    a2ping
    graphics/a2ping (or browse the directory) +
    bmeps
    support/bmeps (or browse the directory) +
    jpeg2ps
    support/jpeg2ps (or browse the directory) +
    sam2p
    graphics/sam2p (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=dvipsgraphics diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-editors.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-editors.html index e9e01c97566..4173da13c93 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-editors.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-editors.html @@ -6,19 +6,19 @@ operating systems; some are described below, but this is only a personal selection:

    -
    Unix
    Try - GNU emacs - or XEmacs, and - the AUC-TeX +
    Unix
    The commonest choices are [X]Emacs or + vim, though several others are available. +

    GNU emacs + and XEmacs are supported + by the AUC-TeX bundle (available from CTAN). AUC-TeX provides menu items and control sequences for common constructs, checks syntax, lays out markup nicely, lets you call TeX and drivers from within the editor, and everything else like this that you can think of. Complex, but very powerful. -

    Many who consider the versions of emacs spawn of the devil, prefer - vim, a highly configurable - editor (also available for Windows and Macintosh systems). Many - plugins are available to support the needs of the (La)TeX user, +

    Vim is also highly + configurable (also available for Windows and Macintosh systems). + Many plugins are available to support the needs of the (La)TeX user, including syntax highlighting, calling TeX programs, auto-insertion and -completion of common (La)TeX structures, and browsing LaTeX help. The scripts auctex.vim and @@ -66,12 +66,19 @@ personal selection: works well with OzTeX. From release 2.2.0 (at least), Textures works with MacOS X.

    For MacOS X users, the free tool of choice appears to be - TeXShop, which + TeXshop, which combines an editor and a shell with a coherent philosophy of dealing with (La)TeX in the OS X environment. TeXShop is distributed as part of the MacTeX system, and will therefore be available out of the box on machines on which MacTeX has been installed.

    Vim is also available for use on Macintosh systems. +

    Wildcard
    TUG is sponsoring the development of a + cross-platform editor and shell, modelled on the excellent + TeXshop for the Macintosh. While this program, + TeXworks, is still under + development, it is already quite usable: if you’re looking for a + (La)TeX development environment, and are willing to step beyond + the boundaries, it may be for you.
    Atari, Amiga and NeXT users also have nice environments. LaTeX users looking for make-like @@ -83,15 +90,15 @@ access to your BibTeX files — see “creating a bibliography file”.
    -
    alpha
    nonfree/systems/mac/support/alpha (gzipped tar, browse) -
    auctex
    support/auctex (gzipped tar, browse) -
    epmtex
    systems/os2/epmtex (gzipped tar, browse) -
    LaTeX4Jed
    support/jed (gzipped tar, browse) -
    Nedit LaTeX support
    support/NEdit-LaTeX-Extensions (gzipped tar, browse) -
    TeXnicCenter
    systems/win32/TeXnicCenter/ -
    TeXshell
    systems/msdos/texshell (gzipped tar, browse) -
    TeXtelmExtel
    systems/msdos/emtex-contrib/TeXtelmExtel (gzipped tar, browse) -
    winedt
    systems/win32/winedt/ +
    alpha
    nonfree/systems/mac/support/alpha/ +
    auctex
    support/auctex/ +
    epmtex
    systems/os2/epmtex (or browse the directory) +
    LaTeX4Jed
    support/jed (or browse the directory) +
    Nedit LaTeX support
    support/NEdit-LaTeX-Extensions (or browse the directory) +
    TeXnicCenter
    systems/win32/TeXnicCenter/ +
    TeXshell
    systems/msdos/texshell (or browse the directory) +
    TeXtelmExtel
    systems/msdos/emtex-contrib/TeXtelmExtel/ +
    winedt
    systems/win32/winedt/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=editors diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-empty.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-empty.html index 0d37b2b6658..ead243c365e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-empty.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-empty.html @@ -29,9 +29,9 @@ third argument. The package’s code also appears in the LaTeX issue in number two of the “around the bend” articles by the late lamented Mike Downes.

    -
    Around the bend series
    info/aro-bend (gzipped tar, browse) -
    ifmtarg.sty
    macros/latex/contrib/misc/ifmtarg.sty -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    Around the bend series
    info/challenges/aro-bend (or browse the directory) +
    ifmtarg.sty
    macros/latex/contrib/misc/ifmtarg.sty +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=empty diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-endingroup.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-endingroup.html index 4bbeb620fe9..5f8eb472976 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-endingroup.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-endingroup.html @@ -63,7 +63,7 @@ The diagnostic not only tells us where the group started, but also the \bgroup, and the two are not distinguishable at the TeX-engine level).

    -
    checkend.sty
    Distributed as part of macros/latex/contrib/bezos (gzipped tar, browse) +
    checkend.sty
    Distributed as part of macros/latex/contrib/bezos (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=endingroup diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-enumerate.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-enumerate.html index 0804dc1c7ea..d6a2196f96f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-enumerate.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-enumerate.html @@ -80,10 +80,10 @@ to make references to the list items format appear as (i), (ii),

    -
    enumerate.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    enumitem.sty
    macros/latex/contrib/enumitem (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    paralist.sty
    macros/latex/contrib/paralist (gzipped tar, browse) +
    enumerate.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    enumitem.sty
    macros/latex/contrib/enumitem (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    paralist.sty
    macros/latex/contrib/paralist (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=enumerate diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-epigraph.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-epigraph.html index 30224225c79..eec51dad4d0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-epigraph.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-epigraph.html @@ -63,10 +63,35 @@ as those of epigraph, but it’s probably easier to use. commands \setchapterpreamble and \dictum to provide these facilities.

    -
    epigraph.sty
    macros/latex/contrib/epigraph (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    quotchap.sty
    macros/latex/contrib/quotchap (gzipped tar, browse) +
    epigraph.sty
    macros/latex/contrib/epigraph (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    quotchap.sty
    macros/latex/contrib/quotchap (or browse the directory)
    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=epigraph +

    +

    + + + + + + + +

    + + + + + + + + + + + + + + + +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=epigraph diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eplain.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eplain.html index de3f766ac42..f7ffebe97fc 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eplain.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eplain.html @@ -5,9 +5,10 @@

    The Eplain macro package expands on and extends the definitions in Plain TeX. Eplain is not intended to provide “generic typesetting -capabilities”, as do LaTeX or Texinfo. Instead, it -defines macro tools that should be useful whatever commands you choose -to use when you prepare your manuscript. +capabilities”, as do ConTeXt, LaTeX or +Texinfo. Instead, it defines macro tools that +should be useful whatever commands you choose to use when you prepare +your manuscript.

    For example, Eplain does not have a command \section, which would format section headings in an “appropriate” way, as LaTeX’s \section does. The philosophy of Eplain is that @@ -18,9 +19,9 @@ results, or if you are trying to match a different format, you are out of luck.

    On the other hand, almost everyone would like capabilities such as cross-referencing by labels, so that you don’t have to put actual page -numbers in the manuscript. The authors of Eplain are not aware of -any generally available macro packages that do not force their -typographic style on an author, and yet provide such capabilities. +numbers in the manuscript. The authors of Eplain believe it is the +only generally available macro package that does not force its +typographic style on an author, and yet provides these such capabilities.

    Another useful feature of Eplain is the ability to create PDF files with hyperlinks. The cross-referencing macros can implicitly generate hyperlinks for the cross-references, but you can also create explicit @@ -44,7 +45,7 @@ available online, and there’s also a mailing list — sign up, or browse the list archives, via http://tug.org/mailman/listinfo/tex-eplain

    -
    Eplain distribution
    macros/eplain (gzipped tar, browse) +
    Eplain distribution
    macros/eplain (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=eplain diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eps.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eps.html index ae5d45c197a..53fc6588cf1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eps.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eps.html @@ -1,9 +1,9 @@ UK TeX FAQ -- question label eps -

    What is “Encapsulated PostScript” (“EPS”)

    +

    What is “Encapsulated PostScript” (“EPS”)?

    PostScript has been for many years a lingua franca of powerful -printers (modern high-quality printers now tend to require some +printers (though modern high-quality printers now tend to require some constrained form of Adobe Acrobat, instead); since PostScript is also a powerful graphical programming language, it is commonly used as an output medium for drawing (and other) packages. diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eqnarray.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eqnarray.html index 8e023a4e0e0..289e2d3bc6a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eqnarray.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-eqnarray.html @@ -32,7 +32,7 @@ greater things), code as:

    -
    AMSLaTeX
    macros/latex/required/amslatex (gzipped tar, browse) +
    AMSLaTeX
    macros/latex/required/amslatex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=eqnarray diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-erroradvice.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-erroradvice.html index 52223c34168..8bef190c72e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-erroradvice.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-erroradvice.html @@ -65,7 +65,7 @@ appeal to the wider public for assistance, but if you do, be sure to report full backtraces (see errorcontextlines above) and so on.

    -
    trace.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    trace.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=erroradvice diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-euro.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-euro.html index 353ecc6f12f..76a752be089 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-euro.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-euro.html @@ -71,13 +71,13 @@ good things. china2e (whose primary aim is Chinese dates and suchlike matters) and the eurosym fonts.

    -
    china2e bundle
    macros/latex/contrib/china2e (gzipped tar, browse) -
    EC fonts
    fonts/ec (gzipped tar, browse) -
    euro fonts
    fonts/euro (gzipped tar, browse) -
    euro-ce fonts
    fonts/euro-ce (gzipped tar, browse) -
    eurofont.sty
    macros/latex/contrib/eurofont (gzipped tar, browse) -
    eurosym fonts
    fonts/eurosym (gzipped tar, browse) -
    marvosym fonts
    fonts/psfonts/marvosym (gzipped tar, browse) +
    china2e bundle
    macros/latex/contrib/china2e (or browse the directory) +
    EC fonts
    fonts/ec (or browse the directory) +
    euro fonts
    fonts/euro (or browse the directory) +
    euro-ce fonts
    fonts/euro-ce (or browse the directory) +
    eurofont.sty
    macros/latex/contrib/eurofont (or browse the directory) +
    eurosym fonts
    fonts/eurosym (or browse the directory) +
    marvosym fonts
    fonts/psfonts/marvosym (or browse the directory)
    textcomp.sty
    Part of the LaTeX distribution.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=euro diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extref.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extref.html index c38d4bf0af9..21d5af5a421 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extref.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extref.html @@ -63,9 +63,26 @@ have the .aux file, write:

    +Heiko Oberdiek’s experimental zref bundle includes a +hyper-crossreferencing mechanism using its zref-xr module. +Usage is closely modelled on xr and xr-hyper; a +trivial example (from a comp.text.tex posting) is +

    +
    +\usepackage{zref-xr,zref-user}
    +\zexternaldocument*{xr02}
    +...
    +\zref{foo}
    +
    +

    +The module provides all the facilities of the older packages, and can +deal both with “traditional” LaTeX labels and with +zref’s style of labels.

    -
    xr.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    xr-hyper.sty
    Distributed with macros/latex/contrib/hyperref (gzipped tar, browse) +
    xr.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    xr-hyper.sty
    Distributed with macros/latex/contrib/hyperref (or browse the directory) +
    zref bundle
    Distributed as part of + macros/latex/contrib/oberdiek (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=extref diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extsizes.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extsizes.html index 20f9d86dafe..8ee78f010fd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extsizes.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-extsizes.html @@ -19,11 +19,12 @@ may not be optimal — but they’re certainly practical.

    More satisfactory are the KOMA-script classes, which are designed to work properly with the class option files that come with extsizes, and the memoir class that has its own -options for document font sizes 9pt, 14pt and 17pt. +options for document font sizes 9pt–12pt, 14pt, 17pt, 20pt, 25pt, +30pt, 36pt, 48pt and 60pt.

    -
    extsizes bundle
    macros/latex/contrib/extsizes (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    extsizes bundle
    macros/latex/contrib/extsizes (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=extsizes diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fancyhdr.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fancyhdr.html index a07ae879e1d..886edefe28b 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fancyhdr.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fancyhdr.html @@ -30,9 +30,9 @@ in a separate file; documentation of scrpage2 is integrated with the scrgui* documentation files that are distributed with the KOMA-script classes.

    -
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fancyhdr diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fig.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fig.html deleted file mode 100644 index 8573b218546..00000000000 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fig.html +++ /dev/null @@ -1,21 +0,0 @@ - -UK TeX FAQ -- question label fig - -

    Fig, a (La)TeX-friendly drawing package

    -

    (X)Fig is a menu driven tool that allows you to -draw objects on the screen of an X workstation; transfig -is a set of tools which translate the code fig. The list -of export formats is very long, and includes Metafont and MetaPost, -Encapsulated PostScript and PDF, as well as combinations that wrap -a graphics format in a LaTeX import file. -

    There’s no explicit port of xfig to windows (although it is -believed to work under cygwin with their X-windows system). -However, the program -jfig -is thought by many to be an acceptable substitute, written in Java. -

    -
    xfig
    graphics/xfig (gzipped tar, browse) -
    transfig
    graphics/transfig (gzipped tar, browse) -
    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fig - diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figetc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figetc.html new file mode 100644 index 00000000000..ba201ccb0f1 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figetc.html @@ -0,0 +1,28 @@ + +UK TeX FAQ -- question label figetc + +

    (La)TeX-friendly drawing packages

    +

    (X)Fig is a menu driven tool that allows you to +draw objects on the screen of an X workstation; transfig +is a set of tools which translate the code fig. The list +of export formats is very long, and includes Metafont and MetaPost, +Encapsulated PostScript and PDF, as well as combinations that wrap +a graphics format in a LaTeX import file, which may include +LaTeX commands to place text (compiled by LaTeX itself) as +labels, etc., in the figures. +

    There’s no explicit port of xfig to windows (although it is +believed to work under cygwin with their X-windows system). +However, the program +jfig +is thought by many to be an acceptable substitute, written in Java. +

    Asymptote is a widely-praised development of the MetaPost +language, which can draw 2D or 3D diagrams, and can also label +diagrams with LaTeX text; copious documentation is available via +asymptote’s web site. +

    +
    asymptote
    graphics/asymptote (or browse the directory) +
    xfig
    graphics/xfig/ +
    transfig
    graphics/transfig (or browse the directory) +
    +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=figetc + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figurehere.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figurehere.html index e5b38703e2e..6b2393bbe92 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figurehere.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-figurehere.html @@ -48,10 +48,25 @@ overtake “real floats”, so that the numbers of figures will be out of order: figure 6 could be on page 12, while figure 5 had floated to page 13. It’s best, therefore, either to stay with floating figures throughout a document, or to use fixed figures throughout. +

    If it’s really impossible to follow that counsel of perfection, you +can use the perpage package’s command \MakeSorted +command: +

    +
    +...
    +\usepackage{float}
    +\usepackage{perpage}
    +\MakeSorted{figure}
    +\MakeSorted{table}
    +...
    +
    +

    +and the sequence of float numbers is all correct.

    -
    capt-of.sty
    macros/latex/contrib/misc/capt-of.sty -
    caption.sty
    macros/latex/contrib/caption (gzipped tar, browse) -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) +
    capt-of.sty
    macros/latex/contrib/misc/capt-of.sty +
    caption.sty
    macros/latex/contrib/caption (or browse the directory) +
    float.sty
    macros/latex/contrib/float (or browse the directory) +
    perpage.sty
    Distributed as part macros/latex/contrib/bigfoot (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=figurehere diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filename.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filename.html index 3937df6fbcc..6947b5a95bb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filename.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filename.html @@ -88,7 +88,7 @@ name (without its ‘.tex’), use the commands: The FiNK bundle includes a fink.el that provides support under emacs with AUC-TeX.

    -
    fink.sty
    macros/latex/contrib/fink (gzipped tar, browse) +
    fink.sty
    macros/latex/contrib/fink (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=filename diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filesused.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filesused.html index 9a10f936df3..48a43e2f463 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filesused.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-filesused.html @@ -35,8 +35,8 @@ document; it comes with configuration files for use with teTeX and MiKTeX. It’s plainly useful when you’re sending the first copy of a document.

    -
    bundledoc
    support/bundledoc (gzipped tar, browse) -
    snapshot.sty
    macros/latex/contrib/snapshot (gzipped tar, browse) +
    bundledoc
    support/bundledoc (or browse the directory) +
    snapshot.sty
    macros/latex/contrib/snapshot (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=filesused diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfiles.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfiles.html index 929facbf9f2..7e6bbc10c58 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfiles.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfiles.html @@ -54,8 +54,8 @@ keep an eye on the changes on the archive. Since these files are updated only once a day, a nightly automatic download (perhaps using rsync) makes good sense.

    -
    FILES.byname
    FILES.byname -
    FILES.last07days
    FILES.last07days +
    FILES.byname
    FILES.byname +
    FILES.last07days
    FILES.last07days

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=findfiles diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfont.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfont.html index 240ad8b393d..07e87699760 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfont.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-findfont.html @@ -21,7 +21,7 @@ fonts that are configured for general (both textual and mathematical) use with (La)TeX. The list of such fonts is sufficiently short that they can all be discussed in one answer here.

    -
    Metafont font list
    info/metafont-list +
    Metafont font list
    info/metafont-list

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=findfont diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fixwidtab.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fixwidtab.html index f72016b2eb1..6a781cf4208 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fixwidtab.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fixwidtab.html @@ -45,9 +45,9 @@ should process using LaTeX. Processing will give you a .sty file as well as the .dvi or .pdf output containing the documentation.

    -
    ltxtable.sty
    Distributed as part of macros/latex/contrib/carlisle (gzipped tar, browse) -
    tabularx.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    tabulary.sty
    macros/latex/contrib/tabulary (gzipped tar, browse) +
    ltxtable.sty
    Distributed as part of macros/latex/contrib/carlisle (or browse the directory) +
    tabularx.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    tabulary.sty
    macros/latex/contrib/tabulary (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fixwidtab diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-floats.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-floats.html index 118069a5b39..2883465ec02 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-floats.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-floats.html @@ -80,12 +80,12 @@ equally well to tables, or to “non-standard” floats defined by the the job for you.

    -
    afterpage.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    endfloat.sty
    macros/latex/contrib/endfloat (gzipped tar, browse) +
    afterpage.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    endfloat.sty
    macros/latex/contrib/endfloat (or browse the directory)
    flafter.sty
    Part of the LaTeX distribution -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) -
    morefloats.sty
    macros/latex/contrib/misc/morefloats.sty -
    placeins.sty
    macros/latex/contrib/placeins (gzipped tar, browse) +
    float.sty
    macros/latex/contrib/float (or browse the directory) +
    morefloats.sty
    macros/latex/contrib/misc/morefloats.sty +
    placeins.sty
    macros/latex/contrib/placeins (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=floats diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-flushboth.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-flushboth.html index 9627e742196..1cbd16ad8e0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-flushboth.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-flushboth.html @@ -29,7 +29,7 @@ package has a \justifying command to match its package also provides a justify environment, which permits areas of justified text in a larger area which is ragged.

    -
    ragged2e.sty
    Distributed as part of macros/latex/contrib/ms (gzipped tar, browse) +
    ragged2e.sty
    Distributed as part of macros/latex/contrib/ms (or browse the directory)
    diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fmtconv.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fmtconv.html index 347f62ff2ff..f75dad32b2d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fmtconv.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fmtconv.html @@ -25,8 +25,8 @@ converting Microsoft’s Rich Text Format to TeX. There is also a converter to LaTeX by Erwin Wechtl, called rtf2latex. The latest converter, by Ujwal Sathyam and Scott Prahl, is - rtf2latex2e; this system seems rather good already, and - is still being improved. + rtf2latex2e which seems rather good, though development + of it seems to have stalled.

    Translation to RTF may be done (for a somewhat constrained set of LaTeX documents) by TeX2RTF, which can produce ordinary RTF, Windows Help RTF (as well as @@ -78,19 +78,19 @@ translated to or from this one. FrameMaker provides “import filters” to aid translation from alien formats (presumably including TeX) to FrameMaker’s own.

    -
    excel2latex
    support/excel2latex (gzipped tar, browse) -
    pcwritex.arc
    support/pcwritex (gzipped tar, browse) -
    refer and tib tools
    biblio/bibtex/utils/refer-tools (gzipped tar, browse) -
    rnototex
    support/rnototex (gzipped tar, browse) -
    rtf2latex
    support/rtf2latex (gzipped tar, browse) -
    rtf2latex2e
    support/rtf2latex2e (gzipped tar, browse) -
    rtf2tex
    support/rtf2tex (gzipped tar, browse) -
    tex2rtf
    support/tex2rtf (gzipped tar, browse) -
    tr2latex
    support/tr2latex (gzipped tar, browse) -
    wd2latex
    support/wd2latex (gzipped tar, browse) -
    wp2latex
    support/wp2latex (gzipped tar, browse) +
    excel2latex
    support/excel2latex (or browse the directory) +
    pcwritex.arc
    support/pcwritex (or browse the directory) +
    refer and tib tools
    biblio/bibtex/utils/refer-tools (or browse the directory) +
    rnototex
    support/rnototex (or browse the directory) +
    rtf2latex
    support/rtf2latex (or browse the directory) +
    rtf2latex2e
    support/rtf2latex2e (or browse the directory) +
    rtf2tex
    support/rtf2tex (or browse the directory) +
    tex2rtf
    support/tex2rtf (or browse the directory) +
    tr2latex
    support/tr2latex (or browse the directory) +
    wd2latex
    support/wd2latex (or browse the directory) +
    wp2latex
    support/wp2latex (or browse the directory)
    Word processor FAQ (source)
    - help/wp-conv (gzipped tar, browse) + help/wp-conv (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fmtconv diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontname.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontname.html index 0b6f33c0f47..9180524dba7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontname.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontname.html @@ -1,7 +1,7 @@ UK TeX FAQ -- question label fontname -

    What is the “Berry naming scheme”

    +

    What is the “Berry naming scheme”?

    In the olden days, (La)TeX distributions were limited by the feebleness of file systems’ ability to represent long names. (The MSDOS file system was a particular bugbear: fortunately any current @@ -27,7 +27,7 @@ outlined in the fontname distribution, which includes extensive documentation and a set of tables of fonts whose names have been systematised.

    -
    fontname distribution
    info/fontname (gzipped tar, browse) +
    fontname distribution
    info/fontname (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fontname diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fonts-pln.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fonts-pln.html index da8f8a82f2b..f0d23969a8d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fonts-pln.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fonts-pln.html @@ -27,7 +27,7 @@ The name you use (nonstdfont, above) is the name of the Text set using nonstdfont italic...

    -

    This is all very elementary stuff, and serves for simple use of fonts. +This is all very elementary stuff, and serves for simple use of fonts. However, there are wrinkles, the most important of which is the matter of font encodings. Unfortunately, many fonts that have appeared recently simply don’t come in versions using Knuth’s @@ -84,13 +84,21 @@ document is going to use, and the package provides commands to select fonts as they’re needed. The distribution includes a configuration to use Adobe ‘standard’ fonts for typesetting text. (Eplain itself seems not to offer a font selection scheme.) +

    Simply to change font size in a document (i.e., not changing +the default font itself), may be done using the rather straightforward +varisize, which offers font sizes ranging from 7 points to +20 points (nominal sizes, all). Font size commands are generated when +any of the package files is loaded, so the 11pt.tex defines a +command \elevenpoint; each of the files ensures there’s a “way +back”, by defining a \tenpoint command.

    -
    ec-plain
    macros/ec-plain (gzipped tar, browse) -
    fontch
    macros/plain/contrib/fontch (gzipped tar, browse) -
    font_selection
    macros/plain/contrib/font_selection (gzipped tar, browse) -
    ofs
    macros/generic/ofs (gzipped tar, browse) -
    pdcmac
    macros/plain/contrib/pdcmac (gzipped tar, browse) -
    plnfss
    macros/plain/contrib/plnfss/ +
    ec-plain
    macros/ec-plain (or browse the directory) +
    fontch
    macros/plain/contrib/fontch (or browse the directory) +
    font_selection
    macros/plain/contrib/font_selection (or browse the directory) +
    ofs
    macros/generic/ofs (or browse the directory) +
    pdcmac
    macros/plain/contrib/pdcmac (or browse the directory) +
    plnfss
    macros/plain/plnfss (or browse the directory) +
    varisize
    macros/plain/contrib/varisize (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fonts-pln diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontsize.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontsize.html index 73a6e47094e..ccddaafadeb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontsize.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontsize.html @@ -41,11 +41,11 @@ December 2003 edition of LaTeX; if you have an older distribution, the packages type1cm (for CM fonts) and type1ec (for EC fonts) are available.

    -
    fix-cm.sty
    Distributed as part of macros/latex/base (gzipped tar, browse) (an unpacked - version is available at macros/latex/unpacked/fix-cm.sty) -
    type1cm.sty
    macros/latex/contrib/type1cm (gzipped tar, browse) -
    type1ec.sty
    fonts/ps-type1/cm-super/type1ec.sty (the package is actually part of - the fonts/ps-type1/cm-super (gzipped tar, browse) distribution, but it works happily in +
    fix-cm.sty
    Distributed as part of macros/latex/base (or browse the directory) (an unpacked + version is available at macros/latex/unpacked/fix-cm.sty) +
    type1cm.sty
    macros/latex/contrib/type1cm (or browse the directory) +
    type1ec.sty
    fonts/ps-type1/cm-super/type1ec.sty (the package is actually part of + the fonts/ps-type1/cm-super (or browse the directory) distribution, but it works happily in the absence of the scaled fonts)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fontsize diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontunavail.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontunavail.html index b14b1e7e089..a5e197ab006 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontunavail.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-fontunavail.html @@ -60,8 +60,8 @@ information messages, that tell you what LaTeX has made of your text. You should check what the messages say, but you will ordinarily not be surprised at their content.

    -
    type1cm.sty
    macros/latex/contrib/type1cm (gzipped tar, browse) -
    type1ec.sty
    fonts/ps-type1/cm-super/type1ec.sty +
    type1cm.sty
    macros/latex/contrib/type1cm (or browse the directory) +
    type1ec.sty
    fonts/ps-type1/cm-super/type1ec.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=fontunavail diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footintab.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footintab.html index b5cf890a453..c0822d221e9 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footintab.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footintab.html @@ -51,12 +51,12 @@ things you can do to fix the problem. file itself; that of ctable is distributed as a PDF file (for convenience’s sake).

    -
    ctable.sty
    macros/latex/contrib/ctable (gzipped tar, browse) -
    footnote.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) -
    longtable.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    mdwtab.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) -
    threeparttable.sty
    macros/latex/contrib/misc/threeparttable.sty -
    tabularx.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    ctable.sty
    macros/latex/contrib/ctable (or browse the directory) +
    footnote.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory) +
    longtable.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    mdwtab.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory) +
    threeparttable.sty
    macros/latex/contrib/misc/threeparttable.sty +
    tabularx.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=footintab diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footnpp.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footnpp.html index 160a51f0534..ed513725555 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footnpp.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-footnpp.html @@ -6,12 +6,12 @@ page number is stepped, using the LaTeX internal mechanism. Sadly, the place in the document where the page number is stepped is unpredictable, not -(“tidily”) at the end of the printed page; so the link only ever -works by luck. +(“tidily”) at the end of the printed page; so changing the footnote +number only ever works by ‘luck’.

    As a result, resetting footnotes is inevitably a complicated process, using labels of some sort. It’s nevertheless important, given the common requirement for footnotes marked by symbols (with painfully -small symbol sets). There are three packages that manage it, one way +small symbol sets). There are four packages that manage it, one way or another.

    The perpage package provides a general mechanism for resetting counters per page, so can obviously be used for this task. @@ -19,7 +19,13 @@ The interface is pretty simple: \MakePerPage{footnote} do the job. If you want to restart the counter at something other than 1 (for example to avoid something in the LaTeX footnote symbol list), you can use: \MakePerPage[2]{footnote}. It’s a -first-rate package, small and efficient +first-rate package, small and efficient. +

    The zref package provides the same facilities with its +perpage module, which defines a command \zmakeperpage +whose syntax is identical to that of perpage, above. You can +load the module by \usepackage[perpage]{zref} (or as +\usepackage{zref-perpage}, if your needs so require — +look at zref’s documentation for details).

    The footmisc package provides a variety of means of controlling footnote appearance, among them a package option perpage that adjusts the numbering per page; if you’re @@ -30,9 +36,12 @@ nothing else). With the competition from perpage, it’s probably not particularly useful any more. (Documentation is footnpag-user.pdf in the distribution.)

    -
    footmisc.sty
    macros/latex/contrib/footmisc (gzipped tar, browse) -
    footnpag.sty
    macros/latex/contrib/footnpag (gzipped tar, browse) -
    perpage.sty
    Distributed as part macros/latex/contrib/bigfoot (gzipped tar, browse) +
    footmisc.sty
    macros/latex/contrib/footmisc (or browse the directory) +
    footnpag.sty
    macros/latex/contrib/footnpag (or browse the directory) +
    perpage.sty
    Distributed as part macros/latex/contrib/bigfoot (or browse the directory) +
    zref.sty
    Distributed as a collection member in macros/latex/contrib/oberdiek (or browse the directory) +
    zref-perpage.sty
    Distributed as a collection member in + macros/latex/contrib/oberdiek (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=footnpp diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-formbiblabel.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-formbiblabel.html index aa9b41b0c40..bdfd3545bd0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-formbiblabel.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-formbiblabel.html @@ -29,7 +29,7 @@ LaTeX commands, in the preamble of your document, will do the job:

    -
    natbib.sty
    macros/latex/contrib/natbib (gzipped tar, browse) +
    natbib.sty
    macros/latex/contrib/natbib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=formbiblabel diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftncapt.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftncapt.html index f02c5ebd728..878f094aa45 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftncapt.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftncapt.html @@ -4,12 +4,17 @@

    Footnotes in captions

    Footnotes in captions are especially tricky: they present problems of their own, on top of the problems one experiences with -footnotes in section titles and with -footnotes in tables. Fortunately, the -requirement for footnotes in captions is extremely rare: if you are -experiencing problems, it is worth reviewing what you are trying to -say by placing this footnote. Note that the threeparttable -scheme (see, again, +footnotes in section titles (footnotes migrating to +to the list of figures or tables, or +apparently random errors because +\footnote is a fragile command), and with +footnotes in tables (typically, the footnote +simply disappears). Fortunately, the requirement for footnotes in +captions is extremely rare: if you are experiencing problems, it is +worth reviewing what you are trying to say by placing this footnote: +other options are to place text at the bottom of the float, or to +place a footnote at the point where you refer to the float. +

    Note that the threeparttable scheme (see, again, footnotes in tables) also applies to notes in captions, and may very well be preferable to whatever you were thinking of. @@ -42,12 +47,12 @@ command in a minipage environment within a float (as in the example above) can produce two copies of the footnote body “blah”. (In fact, the effect only occurs with captions that are long enough to require two lines to be typeset, and so wouldn’t appear -with such a short caption.) +with such a short caption as that in the example above.)

    The documentation of the ccaption package describes a really -rather awful work-around. +rather awful work-around for this problem.

    -
    ccaption.sty
    macros/latex/contrib/ccaption (gzipped tar, browse) -
    threeparttable.sty
    macros/latex/contrib/misc/threeparttable.sty +
    ccaption.sty
    macros/latex/contrib/ccaption (or browse the directory) +
    threeparttable.sty
    macros/latex/contrib/misc/threeparttable.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ftncapt diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftnsect.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftnsect.html index 5461d389a4b..4b11f9fe6ed 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftnsect.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ftnsect.html @@ -31,7 +31,7 @@ of contents, so the footnote may only appear in the section heading itself.

    -
    footmisc.sty
    macros/latex/contrib/footmisc (gzipped tar, browse) +
    footmisc.sty
    macros/latex/contrib/footmisc (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ftnsect diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-getbitmap.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-getbitmap.html index dac8d715163..129669ce9c1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-getbitmap.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-getbitmap.html @@ -45,12 +45,12 @@ if even then. Latin Modern fonts are both close relatives of Computer Modern with wider ranges of glyphs to offer.

    -
    BaKoMa fonts
    fonts/cm/ps-type1/bakoma (gzipped tar, browse) -
    Bluesky fonts
    Browse fonts/cm/ps-type1/bluesky/ -
    CM fonts (write-black printers)
    fonts/cm/pk/pk300.zip -
    CM fonts (write-white printers)
    fonts/cm/pk/pk300w.zip -
    EC fonts (Type 1 format)
    fonts/ps-type1/cm-super (gzipped tar, browse) -
    Latin Modern fonts
    fonts/lm (gzipped tar, browse) +
    BaKoMa fonts
    fonts/cm/ps-type1/bakoma (or browse the directory) +
    Bluesky fonts
    Browse fonts/cm/ps-type1/bluesky/ +
    CM fonts (write-black printers)
    fonts/cm/pk/pk300.zip +
    CM fonts (write-white printers)
    fonts/cm/pk/pk300w.zip +
    EC fonts (Type 1 format)
    fonts/ps-type1/cm-super (or browse the directory) +
    Latin Modern fonts
    fonts/lm (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=getbitmap diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-gethelp.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-gethelp.html index eaa0377987e..112b14ca90a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-gethelp.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-gethelp.html @@ -9,8 +9,8 @@ don’t know what to do.

    If you are seeking a particular package or program, look on your own system first: you might already have it — the better TeX distributions contain a wide range of supporting material. The -CTAN Catalogue can also help: you can -search it, or you can browse it +CTAN Catalogue can also identify packages that might help: you +can search it, or you can browse it “by topic”. A catalogue entry has a brief description of the package, and links to diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-graphicspath.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-graphicspath.html index b0f03e19b76..b6ab0dad344 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-graphicspath.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-graphicspath.html @@ -56,8 +56,8 @@ in the question “ bits of document in other directories ”.

    -
    graphics bundle
    macros/latex/required/graphics (gzipped tar, browse) -
    import.sty
    macros/latex/contrib/misc/import.sty +
    graphics bundle
    macros/latex/required/graphics (or browse the directory) +
    import.sty
    macros/latex/contrib/misc/import.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=graphicspath diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-grffilenames.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-grffilenames.html new file mode 100644 index 00000000000..b7f2c80ced2 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-grffilenames.html @@ -0,0 +1,50 @@ + +UK TeX FAQ -- question label grffilenames + +

    “Modern” graphics file names

    +

    TeX was designed in a world where file names were very simple +indeed, typically strictly limited both in character set and length. +In modern systems, such restrictions have largely disappeared, which +leaves TeX rather at odds with its environment. Particular +problems arise with spaces in file names, but things like multiple +period characters can seriously confuse the graphics +package. +

    The specification of TeX leaves some leeway for distributions to +adopt file access appropriate to their operating system, but this +hasn’t got us very far. Many modern distributions allow you to +specify a file name as "file name.tex" (for example), which +helps somewhat, but while this allows us to say +

    +
    +\input "foo bar.tex"
    +
    +

    +the analogous usage +

    +
    +\includegraphics{"gappy graphics.eps"}
    +
    +

    +using “ordinary” LaTeX causes confusion in xdvi and +dvips, even though it works at compilation time. Sadly, +even within such quotes, multiple dots give \includegraphics +difficulties. Note that +

    +
    +\includegraphics{"gappy graphics.pdf"}
    +
    +

    +works in a similar version of PDFTeX. +

    If you’re using the graphics package, the grffile +package will help. The package offers several options, the simplest +of which are multidot (allowing more than one dot in a +file name) and space (allowing space in a file name). The +space option requires that you’re running on a +sufficiently recent version of PDFTeX, in PDF mode — and +even then it won’t work for MetaPost files, which are read as TeX +input, and therefore use the standard input mechanism). +

    +
    grffile.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory) +
    +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=grffilenames + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-howmanypp.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-howmanypp.html index 1ebcaea92f0..010e0711c2e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-howmanypp.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-howmanypp.html @@ -26,10 +26,10 @@ to the equivalent of the LastPage label and the the everyshi package.

    count1to.sty and everyshi.sty
    - Distributed in macros/latex/contrib/ms (gzipped tar, browse) -
    lastpage.sty
    macros/latex/contrib/lastpage (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    totpages.sty
    macros/latex/contrib/totpages (gzipped tar, browse) + Distributed in macros/latex/contrib/ms (or browse the directory) +
    lastpage.sty
    macros/latex/contrib/lastpage (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    totpages.sty
    macros/latex/contrib/totpages (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=howmanypp diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-htmlbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-htmlbib.html index 1ea5aaf2e27..a6e059153f5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-htmlbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-htmlbib.html @@ -18,9 +18,9 @@ styles, and post-process the output so produced using a a sample of the script’s output may be viewed on the web, at http://rikblok.cjb.net/lib/refs.html

    -
    bbl2html.awk
    biblio/bibtex/utils/misc/bbl2html.awk -
    bib2xhtml
    biblio/bibtex/utils/bib2xhtml (gzipped tar, browse) -
    noTeX.bst
    biblio/bibtex/utils/misc/noTeX.bst +
    bbl2html.awk
    biblio/bibtex/utils/misc/bbl2html.awk +
    bib2xhtml
    biblio/bibtex/utils/bib2xhtml (or browse the directory) +
    noTeX.bst
    biblio/bibtex/utils/misc/noTeX.bst

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=htmlbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphen.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphen.html index a7bf8f25ab3..56cff3ca9dc 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphen.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphen.html @@ -12,8 +12,10 @@ different. As a result, a typesetting system that is not restricted to a single language at a single locale needs to be able to change its hyphenation rules from time to time.

    TeX uses a pretty good system for hyphenation (originally designed -by Frank Liang), and while it’s capable of missing “sensible” -hyphenation points, it seldom selects grossly wrong ones. The +by Frank Liang — you may view his +Ph.D. thesis online), and while +it’s capable of missing “sensible” hyphenation points, it seldom +selects grossly wrong ones. The algorithm matches candidates for hyphenation against a set of “hyphenation patterns”. The candidates for hyphenation must be sequences of letters (or other single characters that TeX may be diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphoff.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphoff.html index a2da4df0c21..1a3a813f310 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphoff.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-hyphoff.html @@ -72,7 +72,7 @@ appeal to the specifiers of eccentric document layouts (such as those for dissertations), but for once their sense conforms with typographic style. (Or at least, style constrained in this curious way.)

    -
    hyphenat.sty
    macros/latex/contrib/hyphenat (gzipped tar, browse) +
    hyphenat.sty
    macros/latex/contrib/hyphenat (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=hyphoff diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-i18nbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-i18nbib.html index 7376c7dfe99..55b31c2e079 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-i18nbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-i18nbib.html @@ -40,14 +40,14 @@ language, you are asked whether you want the style to interact with worlds — formatting freedom from custom-bib and linguistic freedom via the extensibility of babelbib

    -
    babelbib.sty
    biblio/bibtex/contrib/babelbib (gzipped tar, browse) -
    bib-fr bundle
    biblio/bibtex/contrib/bib-fr (gzipped tar, browse) -
    bibgerm bundle
    biblio/bibtex/contrib/germbib (gzipped tar, browse) -
    custom-bib bundle
    macros/latex/contrib/custom-bib (gzipped tar, browse) -
    finplain.bst
    biblio/bibtex/contrib/misc/finplain.bst -
    norbib bundle
    biblio/bibtex/contrib/norbib (gzipped tar, browse) -
    spain
    biblio/bibtex/contrib/spain (gzipped tar, browse) -
    swebib bundle
    biblio/bibtex/contrib/swebib (gzipped tar, browse) +
    babelbib.sty
    biblio/bibtex/contrib/babelbib (or browse the directory) +
    bib-fr bundle
    biblio/bibtex/contrib/bib-fr (or browse the directory) +
    bibgerm bundle
    biblio/bibtex/contrib/germbib (or browse the directory) +
    custom-bib bundle
    macros/latex/contrib/custom-bib (or browse the directory) +
    finplain.bst
    biblio/bibtex/contrib/misc/finplain.bst +
    norbib bundle
    biblio/bibtex/contrib/norbib (or browse the directory) +
    spain
    biblio/bibtex/contrib/spain (or browse the directory) +
    swebib bundle
    biblio/bibtex/contrib/swebib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=i18nbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ifpdf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ifpdf.html index 7f26397e5c5..8c175c4600a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ifpdf.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ifpdf.html @@ -13,9 +13,9 @@ was present in the very first releases of PDFTeX) is

     \ifx\pdfoutput\undefined
    -  <not running PDFTeX>
    +  ... % not running PDFTeX
     \else
    -  <running PDFTeX>
    +  ... % running PDFTeX
     \fi
     

    @@ -37,12 +37,12 @@ test may need to be elaborated:

     \ifx\pdfoutput\undefined
    -  <not running PDFTeX>
    +  ... % not running PDFTeX
     \else
       \ifx\pdfoutput\relax
    -    <not running PDFTeX>
    +    ... % not running PDFTeX
       \else
    -    <running PDFTeX>
    +    ... % running PDFTeX
       \fi
     \fi
     
    @@ -55,16 +55,16 @@ output, you also need to know about the value of \pdfoutput
     \ifx\pdfoutput\undefined
    -  <not running PDFTeX>
    +  ... % not running PDFTeX
     \else
       \ifx\pdfoutput\relax
    -    <not running PDFTeX>
    +    ... % not running PDFTeX
       \else
    -    <running PDFTeX, with...>
    +    % running PDFTeX, with...
         \ifnum\pdfoutput>0
    -      <...PDF output>
    +      ... % PDF output
         \else
    -      <...DVI output>
    +      ... % DVI output
         \fi
       \fi
     \fi
    @@ -73,8 +73,16 @@ output, you also need to know about the value of \pdfoutputifpdf
     package does; the reasoning is the FAQ’s interpretation of
     Heiko’s explanation.
    +

    As an aside: there are now analogous packages ifxetex and +ifluatex, for the two up-and-coming TeX-like engines (see +the “TeX project” answers covering +XeTeX, and +LuaTeX).

    -
    ifpdf.sty
    Distributed with Heiko Oberdiek’s packages macros/latex/contrib/oberdiek (gzipped tar, browse) +
    ifpdf.sty
    Distributed with Heiko Oberdiek’s packages macros/latex/contrib/oberdiek (or browse the directory) +
    ifluatex.sty
    Distributed with Heiko Oberdiek’s packages + macros/latex/contrib/oberdiek (or browse the directory) +
    ifxetex.sty
    macros/generic/ifxetex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ifpdf diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-impgraph.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-impgraph.html index 2f7959add31..4d8e300ccba 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-impgraph.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-impgraph.html @@ -29,10 +29,12 @@ tied to a particular DVI driver (dvips, in the above two cases), but their code could be configured for others.

    The obvious next step was to make the code configurable dynamically. The LaTeX standard graphics package and its derivatives -made this step: it is strongly preferred for all current work. It can -also be used (with the help of the miniltx “LaTeX -emulator” and the graphicx.tex front-end) in documents -written in Plain TeX. +made this step: it is strongly preferred for all current work. +

    Users of Plain TeX have two options allowing them to use +graphicx: the miniltx “LaTeX emulator” and +the graphicx.tex front-end allow you to load +graphicx, and \Eplain allows you to load +it (using the full LaTeX syntax) direct.

    The graphics package takes a variety of “driver options” — package options that select code to generate the commands appropriate to the DVI driver in use. In most cases, @@ -83,14 +85,14 @@ but may also be browsed on the Web.

    -
    epsf.tex
    macros/generic/epsf/epsf.tex -
    epsfig.sty
    Part of the macros/latex/required/graphics (gzipped tar, browse) bundle -
    epslatex.pdf
    info/epslatex/english/epslatex.pdf; the document is also available - in PostScript format as info/epslatex/english/epslatex.ps -
    graphics.sty
    macros/latex/required/graphics (gzipped tar, browse) -
    graphicx.sty
    Part of the macros/latex/required/graphics (gzipped tar, browse) bundle -
    miniltx.tex
    macros/plain/graphics (gzipped tar, browse) -
    psfig.sty
    nonfree/graphics/psfig (gzipped tar, browse) +
    epsf.tex
    macros/generic/epsf/epsf.tex +
    epsfig.sty
    Part of the macros/latex/required/graphics (or browse the directory) bundle +
    epslatex.pdf
    info/epslatex/english/epslatex.pdf; the document is also available + in PostScript format as info/epslatex/english/epslatex.ps +
    graphics.sty
    macros/latex/required/graphics (or browse the directory) +
    graphicx.sty
    Part of the macros/latex/required/graphics (or browse the directory) bundle +
    miniltx.tex
    macros/plain/graphics (or browse the directory) +
    psfig.sty
    graphics/psfig (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=impgraph diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inclplain.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inclplain.html index 2cccad6434f..21ccf5980ae 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inclplain.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inclplain.html @@ -25,7 +25,7 @@ AMSTeX; no doubt it would also fail if asked to load Eplain. All these things can be overcome (although it’s not often easy), but the environment saves a lot of work on many occasions.

    -
    plain.sty
    Distributed as part of macros/latex/contrib/carlisle (gzipped tar, browse) +
    plain.sty
    Distributed as part of macros/latex/contrib/carlisle (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inclplain diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst-tds-zip.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst-tds-zip.html index b5317c52051..986973f8542 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst-tds-zip.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst-tds-zip.html @@ -1,7 +1,7 @@ UK TeX FAQ -- question label inst-tds-zip -

    Installing using preformatted ZIP files

    +

    Installing using ready-built ZIP files

    Installing packages, as they (“traditionally”) appear on CTAN, involves:

      @@ -12,14 +12,14 @@ CTAN, involves:
    Most people, for most packages, find the first two steps onerous, the last being easy (unless it is forgotten!). -

    Preformatted ZIP files (also known as -TDS ZIP files) are designed to lighten +

    Ready-built ZIP files — also known as +TDS-ZIP files — are designed to lighten the load of performing the first two steps of installation: they contain all the files that are that’s to be installed for a given package, in their “correct” locations in a TDS tree.

    To install such a file on a Unix system (we assume that you’ll install -into the local TEXMF tree): +into the local TEXMF tree, at $TEXMFLOCAL):

     cd $TEXMFLOCAL
    @@ -37,10 +37,5 @@ remaining chore is to update the file indexes — as in
     the package provides a font, you also need to enable the font’s map,
     which is discussed in 
     “Installing a Type 1 font”
    -

    At the time of writing, there are rather few .tds.zip -files (by comparison with the huge number of packages that are -available). As packages are updated, the number of files is -steadily increasing, but it will be a long time before the whole set -is covered.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst-tds-zip diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst1cm.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst1cm.html index 468e2e503e7..164577980c1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst1cm.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-inst1cm.html @@ -64,9 +64,9 @@ loaded by the command

    Remember, after all such changes, the file-name database must be refreshed.

    -
    AMS fonts
    Browse fonts/amsfonts/ps-type1/ -
    CM fonts
    Browse fonts/cm/ps-type1/bluesky/ -
    CM font maps
    fonts/cm/ps-type1/bluesky-contrib/dvips (gzipped tar, browse) +
    AMS fonts
    Browse fonts/amsfonts/ps-type1/ +
    CM fonts
    Browse fonts/cm/ps-type1/bluesky/ +
    CM font maps
    fonts/cm/ps-type1/bluesky-contrib/dvips (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=inst1cm diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-find.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-find.html index cf04c651947..b264f5bf18c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-find.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-install-find.html @@ -6,8 +6,9 @@

    If the information came from these FAQs, you should already have a link to the file (there are lists at the end of each answer): - click on that link, -and you can get the file, one way or another. + click on one of the links associated with the package, and you can + get the package (which may be one file or several). +

    If you heard about the file somewhere else, it’s possible that the source told you where to look; if not, try the CTAN searching facilities, such as http://www.tex.ac.uk/search/. That (rather diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instprinterfont.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instprinterfont.html index 34d170f7891..a2e204a0b99 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instprinterfont.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instprinterfont.html @@ -36,7 +36,7 @@ TDS, so in principle, installation consists simply of

    mathpazo.sty
    Part of the psnfss bundle
    mathptmx.sty
    Part of the psnfss bundle -
    psnfss bundle
    macros/latex/required/psnfss (gzipped tar, browse) +
    psnfss bundle
    macros/latex/required/psnfss (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instprinterfont diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instt1font.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instt1font.html index 06e84384215..b114ce432fb 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instt1font.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-instt1font.html @@ -67,8 +67,8 @@ Both processes (preparing and installing a font) are very well (and thoroughly) described in Philipp Lehman’s guide to font installation, which may be found on CTAN.

    -
    fontinst.sty
    fonts/utilities/fontinst (gzipped tar, browse) -
    Type 1 installation guide
    info/Type1fonts/fontinstallationguide/fontinstallationguide.pdf +
    fontinst.sty
    fonts/utilities/fontinst (or browse the directory) +
    Type 1 installation guide
    info/Type1fonts/fontinstallationguide/fontinstallationguide.pdf

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=instt1font diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-interruptlist.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-interruptlist.html index 419d3f8d472..27d26d315f1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-interruptlist.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-interruptlist.html @@ -132,10 +132,10 @@ However, the ‘nested comment’ interpolated in the nested enumeration appears as if it were a second paragraph to “outer item 2”, which is hardly satisfactory.

    -
    enumerate.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    enumitem.sty
    macros/latex/contrib/enumitem (gzipped tar, browse) -
    expdlist.sty
    macros/latex/contrib/expdlist (gzipped tar, browse) -
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) +
    enumerate.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    enumitem.sty
    macros/latex/contrib/enumitem (or browse the directory) +
    expdlist.sty
    macros/latex/contrib/expdlist (or browse the directory) +
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=interruptlist diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html index b45422f401c..4cd7934b701 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-isitanum.html @@ -132,7 +132,7 @@ thus using TeX’s own integer-parsing code to do the check. It’s a pity that such a mechanism was never defined (it could be that it’s impossible to program within TeX!).

    -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=isitanum diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-journalpaper.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-journalpaper.html index b3da3be3629..7d2786c5114 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-journalpaper.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-journalpaper.html @@ -8,8 +8,8 @@ submissions in (La)TeX, they don’t often submit recommended macros to public archives.

    Nevertheless, there are considerable numbers of macros of one sort or another available on CTAN; searching for your journal name in -the CTAN catalogue (see -searching CTAN) +the CTAN catalogue — see +searching CTAN) — may well turn up what you’re seeking.

    Failing that, you may be well advised to contact the prospective publisher of your paper; many publishers have macros on their own web diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-keyval.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-keyval.html new file mode 100644 index 00000000000..6ca8497270c --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-keyval.html @@ -0,0 +1,157 @@ + +UK TeX FAQ -- question label keyval + +

    Key-value input for macros and package options

    +

    When we discussed +extending the number of arguments to a macro, we +suggested that large numbers of arguments, distinguished only by their +position, aren’t very kind to the user, and that a package such as +keyval offers a more attractive user interface. We now +consider the packages that the macro programmer might use, to create +such a user interface. +

    The simplest key-value processor remains keyval; it has a +command \define@key to declare a key and a handler to +process it, and a macro \setkeys to offer values to the handler +of one or more keys. Thus: +

    +
    +\define@key{my}{foo}{Foo is #1\par}
    +\define@key{my}{bar}[99]{Bar is #1\par}
    +...
    +\setkeys{my}{foo=3,bar}
    +
    +

    +will produce output saying: +

    + Foo is 3
    + Bar is 99 +

    +This has defined two keys ‘foo’ and ‘bar’ in family +‘my’, and then executed them, the first with argument +‘3’ and the second with no argument, so that the default +value of ‘99’ is picked up. In effect, the two calls to +\define@key are simply defining commands, as (for example): +

    +
    +\newcommand{\KV@my@foo}[1]{Foo is #1}
    +
    +

    +(the definition of \KV@my@bar is similar, but trickier). The +command \setkeys knows how to find those commands when it needs to +process each key — it is easy to regurgitate the structure of the +command name, with family name (‘my’, here) after the first +‘@’, and the key name after the second ‘@’. (The +‘KV’ part is fixed, in keyval.) +

    These simple commands are enough, in fact, to process the botanical +example offered as replacement for multi-argument commands in +the question mentioned above, or the +optional arguments of the \includegraphics command of the +graphicx package. (The last is, in fact, what +keyval was designed to do.) +

    However, we need more if we’re to to have package options in +‘key-value’ form. Packages like hyperref have enormously +complicated package options which need key-value processing at +\ProcessOptions time: keyval can’t do that on its own. +

    Heiko Oberdiek’s kvoptions package comes to our help: it +enables the programmer to declare class or package options that +operate as key and value pairs. The package defines commands +\DeclareBoolOption for options whose value should be either +true or false, and \DeclareStringOption for all +other options that have a value. Keys are declared using +keyval and may remain available for use within the document, +or may be ‘cancelled’ to avoid confusion. If you have loaded +kvoptions, the LaTeX kernel’s \DeclareOption becomes +\DeclareVoidOption (it’s an option with no value), and +\DeclareOption* becomes \DeclareDefaultOption. +

    Heiko also provides kvsetkeys which is a more robust version +of setkeys, with some of the rough edges made smoother. +

    Hendri Adriaens’ xkeyval offers more flexibility than +the original keyval and is more robust than the original, +too. Like kvoptions, the package also has mechanisms to +allow class and package options in key-value form (macros +\DeclareOptionX, \ExecuteOptionsX and \ProcessOptionsX. +Pstricks bundle packages use a xkeyval derivative +called pst-xkey for their own key-value manipulation. + +

    The (widely-respected) pgf graphics package has its own +key-value package called pgfkeys. The documentation of the +package (part of the huge pgf manual, in part 5, +“utilities”) contains a useful comparison with other key-value +systems; some notable differences are: +

      +
    • key organisation: pgfkeys uses a tree structure, while + keyval and xkeyval both associate keys with a family; +
    • pgfkeys supports multi-argument key code; and +
    • pgfkeys can support call-backs when an unknown key + appears (these things are called handlers. +
    +Keys are organized in a tree that is reminiscent of the Unix fille +tree. A typical key might be, /tikz/coordinate system/x or +just /x. When you specify keys you can provide the complete +path of the key, but you usually just provide the name of the key +(corresponding to the file name without any path) and the path is +added automatically. So a \pgfkeys command might be: +
    +
    +\pgfkeys{/my key=hello,/your keys/main key=something\strange,
    +  key name without path=something else}
    +
    +

    + +and for each key mentioned, the associated code will be executed. +... and that code is also set up using \pgfkeys: +

    +
    +\pgfkeys{/my key/.code=The value is '#1'.}
    +
    +

    +after which +

    +
    +\pgfkeys{/my key=hi!}
    +
    +

    +will produce just +

    + The value is ’hi!’. +

    +The manual goes on, showing how to define a key with two arguments, +how to provide default value for a key, and how to define aliases for +particular key sequences (which are called “styles”). All in all, +it seems a well thought-out system, offering a lot of flexibility that +isn’t available with the other keys packages. However, there seems to +be no mechanism for using pgfkeys keys as part of the +options of another package, in the way that kvoptions does. +

    Another key-value system that’s part of larger set of macros is +scrbase, which uses the facilities of keyval to +build a larger set of facilities, originally for use within the +KOMA-script bundle. For English-speaking authors, there are +difficulties from the German-only documentation; however, from a +partial translation available to the author of this answer, a summary +is possible. The package may build on the facilities either of +kyeval or of xkeyval, and builds its functionality +on the structure of the ‘key family’. The user may define family +‘members’ and keys are defined relative to the members. (For example, +the package scrbase is part of the KOMA-script +bundle; so its keys are all members of the scrbase.sty +family within the KOMA family. The function +\FamilyProcessOptions allows the programmer to decode the options +of the package in terms of the package’s key family. Note that there +is no special provision made for “traditional” package options, as +in the kvoptions package. +

    This brief summary was guided by input from two sources: a draft article +for TUGboat by Joseph Wright, and the partial translation of the +documentation of package scrbase prepared by Philipp +Stephani. At Joseph’s suggestion, discussion of his keys3 +package, which is designed for use with the experimental LaTeX3, +has been omitted. +

    +
    keyval.sty
    Distributed as part of macros/latex/required/graphics (or browse the directory) +
    kvoptions.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory) +
    kvsetkeys.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory) +
    pgfkeys.sty
    Distributed as part of graphics/pgf (or browse the directory) +
    scrbase.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory) +
    xkeyval.sty
    macros/latex/contrib/xkeyval (or browse the directory) +
    +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=keyval + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelfig.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelfig.html index 2c0757af447..123112b3383 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelfig.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelfig.html @@ -60,14 +60,14 @@ environment which itself includes the graphic. I would recommend are plainly little more than a convenience over what is achievable with the do-it-yourself approach.

    -
    auto-pst-pdf.sty
    macros/latex/contrib/auto-pst-pdf (gzipped tar, browse) -
    iTe
    support/ite (gzipped tar, browse) -
    laprint
    Distributed with macros/latex/contrib/psfragx (gzipped tar, browse) -
    overpic.sty
    macros/latex/contrib/overpic (gzipped tar, browse) -
    psfrag.sty
    macros/latex/contrib/psfrag (gzipped tar, browse) -
    psfragx.sty
    macros/latex/contrib/psfragx (gzipped tar, browse) -
    pstricks.sty
    graphics/pstricks (gzipped tar, browse) -
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (gzipped tar, browse) +
    auto-pst-pdf.sty
    macros/latex/contrib/auto-pst-pdf (or browse the directory) +
    iTe
    support/ite (or browse the directory) +
    laprint
    Distributed with macros/latex/contrib/psfragx (or browse the directory) +
    overpic.sty
    macros/latex/contrib/overpic (or browse the directory) +
    psfrag.sty
    macros/latex/contrib/psfrag (or browse the directory) +
    psfragx.sty
    macros/latex/contrib/psfragx (or browse the directory) +
    pstricks.sty
    graphics/pstricks (or browse the directory) +
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=labelfig diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelformat.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelformat.html index 1a34c99d57e..707c10f802d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelformat.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labelformat.html @@ -67,8 +67,8 @@ has been rendered obsolete by the appearance of the enumitem package, which is discussed in the answer about decorating enumeration lists.

    -
    enumitem.sty
    macros/latex/contrib/enumitem (gzipped tar, browse) -
    fncylab.sty
    macros/latex/contrib/misc/fncylab.sty +
    enumitem.sty
    macros/latex/contrib/enumitem (or browse the directory) +
    fncylab.sty
    macros/latex/contrib/misc/fncylab.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=labelformat diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labundef.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labundef.html index ba3c6c803b8..45066f0d621 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labundef.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-labundef.html @@ -33,7 +33,7 @@ of a single label, or the states of a list of labels. The package’s definition is a bit complicated, but the package itself is pretty powerful.

    -
    labelcas.sty
    macros/latex/contrib/labelcas (gzipped tar, browse) +
    labelcas.sty
    macros/latex/contrib/labelcas (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=labundef diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-landscape.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-landscape.html index f2b910ffd23..d74fadd2f12 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-landscape.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-landscape.html @@ -68,16 +68,16 @@ rotation requests in DVI files. Your best bet is to convert your output to PostScript or to PDF, and to view these ‘final’ forms with an appropriate viewer.

    -
    geometry.sty
    macros/latex/contrib/geometry (gzipped tar, browse) -
    graphics.sty
    Distributed as part of macros/latex/required/graphics (gzipped tar, browse) -
    longtable.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    lscape.sty
    Distributed as part of macros/latex/required/graphics (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    geometry.sty
    macros/latex/contrib/geometry (or browse the directory) +
    graphics.sty
    Distributed as part of macros/latex/required/graphics (or browse the directory) +
    longtable.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    lscape.sty
    Distributed as part of macros/latex/required/graphics (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)
    pdflscape.sty
    Distributed with Heiko Oberdiek’s packages - macros/latex/contrib/oberdiek (gzipped tar, browse) -
    rotating.sty
    macros/latex/contrib/rotating (gzipped tar, browse) -
    rotfloat.sty
    macros/latex/contrib/rotfloat (gzipped tar, browse) -
    supertabular.sty
    macros/latex/contrib/supertabular (gzipped tar, browse) + macros/latex/contrib/oberdiek (or browse the directory) +
    rotating.sty
    macros/latex/contrib/rotating (or browse the directory) +
    rotfloat.sty
    macros/latex/contrib/rotfloat (or browse the directory) +
    supertabular.sty
    macros/latex/contrib/supertabular (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=landscape diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latex2e.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latex2e.html index 52101cdbfe6..1eff11d50a3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latex2e.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latex2e.html @@ -7,20 +7,25 @@ was superseded in 1994 by a new version (LaTeX2e) provided by the LaTeX team. LaTeX2e is now the only readily-available version of LaTeX, and draws together several threads of LaTeX development -from the later days of LaTeX 2.09. +from the later days of LaTeX 2.09. The “e” of the name is (in the + +official logo) + +a single-stroke epsilon +(ε, supposedly +indicative of no more than a small change.

    LaTeX2e has several enhancements over LaTeX 2.09, but they were all rather minor, with a view to continuity and stability rather than the “big push” that some had expected from the team. LaTeX2e continues to this day to offer a compatibility mode in which most files prepared for use with LaTeX 2.09 will run (albeit with somewhat -reduced performance, and subject to bitter complaints in the log +reduced performance, and subject to voluminous complaints in the log file). Differences between LaTeX2e and LaTeX 2.09 are outlined in a series of ‘guide’ files that are available in every LaTeX distribution (the same directory also contains “news” about each new release of LaTeX2e).

    -
    LaTeX guides and news
    macros/latex/doc (gzipped tar, browse) +
    LaTeX guides and news
    macros/latex/doc (or browse the directory)
    -

    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=latex2e +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=latex2e diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexpronounce.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexpronounce.html index d06cf474cee..a2496a1705f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexpronounce.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexpronounce.html @@ -2,14 +2,14 @@ UK TeX FAQ -- question label latexpronounce

    How should I pronounce “LaTeX(2e)”?

    -

    Lamport never recommended how one should pronounce LaTeX, but a lot of people pronounce it ‘Lay TeX’ or perhaps ‘Lah TeX’ (with TeX pronounced as the program itself; see the rules for TeX). It is definitely -not to be pronounced in the same way as the rubber-tree gum. -

    The ‘epsilon’ in ‘LaTeX2e’ is supposed to be suggestive of a small -improvement over the old LaTeX 2.09. Nevertheless, most people -pronounce the name as ‘LaTeX-two-ee’. +not to be pronounced in the same way as the rubber-tree gum +(which would be ‘lay teks’). +

    The LaTeX2e logo is supposed to end with an +ε; nevertheless, most +people pronounce the name as ‘LaTeX-two-ee’.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=latexpronounce diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexqual.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexqual.html index a13f693fe96..880d273f99e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexqual.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-latexqual.html @@ -29,9 +29,9 @@ doesn’t seem as comprehensive as nag, but it allows you to download its script, which you can then juggle with to make it more draconian.

    -
    l2tabu
    Browse info/l2tabu/ for a copy in a language that’s +
    l2tabu
    Browse info/l2tabu/ for a copy in a language that’s convenient for you -
    nag.sty
    macros/latex/contrib/nag (gzipped tar, browse) +
    nag.sty
    macros/latex/contrib/nag (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=latexqual diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterclass.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterclass.html index 3daf4d5a2fa..b2051c36aa4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterclass.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterclass.html @@ -34,11 +34,11 @@ only) bundles. While these are probably good (since the bundles themselves inspire trust) they’ve not been specifically recommended by any users.

    -
    akletter.cls
    macros/latex/contrib/akletter (gzipped tar, browse) -
    brief.cls
    Distributed as part of macros/latex/contrib/ntgclass (gzipped tar, browse) -
    dinbrief.cls
    macros/latex/contrib/dinbrief (gzipped tar, browse) -
    newlfm.cls
    macros/latex/contrib/newlfm (gzipped tar, browse) -
    scrlttr2.cls
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    akletter.cls
    macros/latex/contrib/akletter (or browse the directory) +
    brief.cls
    Distributed as part of macros/latex/contrib/ntgclass (or browse the directory) +
    dinbrief.cls
    macros/latex/contrib/dinbrief (or browse the directory) +
    newlfm.cls
    macros/latex/contrib/newlfm (or browse the directory) +
    scrlttr2.cls
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=letterclass diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterspace.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterspace.html index d20e191d767..4d1670c468e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterspace.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-letterspace.html @@ -36,9 +36,9 @@ will destroy ligatures; however, this is wrong if the font is of a fraktur style, and the package provides a means of protecting the ligatures in a letter-spaced text.

    -
    letterspacing.tex
    macros/generic/misc/letterspacing.tex -
    microtype.sty
    macros/latex/contrib/microtype (gzipped tar, browse) -
    soul.sty
    macros/latex/contrib/soul (gzipped tar, browse) +
    letterspacing.tex
    macros/generic/misc/letterspacing.tex +
    microtype.sty
    macros/latex/contrib/microtype (or browse the directory) +
    soul.sty
    macros/latex/contrib/soul (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=letterspace diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linenos.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linenos.html index ac06276ba38..866a3e6fd94 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linenos.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linenos.html @@ -5,11 +5,14 @@

    For general numbering of lines, there are two packages for use with LaTeX, lineno (which permits labels attached to individual lines of typeset output) and numline. +(Numline is considered obsolete, but remains available from +the archive.)

    Both of these packages play fast and loose with the LaTeX output routine, which can cause problems: the user should beware...

    If the requirement is for numbering verbatim text, moreverb, -memoir or fancyvrb (see +or fancyvrb (see including files verbatim) may be used. +Class memoir also provides the necessary facilities.

    One common use of line numbers is in critical editions of texts, and for this the edmac package offers comprehensive support; ledmac is a LaTeX port of edmac. @@ -21,14 +24,14 @@ interpolated mathematics or figures. Documentation of the package, in the package itself, is pretty tough going, though there is an example (also inside the package file).

    -
    edmac
    macros/plain/contrib/edmac (gzipped tar, browse) -
    fancyvrb.sty
    macros/latex/contrib/fancyvrb (gzipped tar, browse) -
    ledmac.sty
    macros/latex/contrib/ledmac (gzipped tar, browse) -
    lineno.sty
    macros/latex/contrib/lineno (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    moreverb.sty
    macros/latex/contrib/moreverb (gzipped tar, browse) -
    numline.sty
    macros/latex/contrib/numline/numline.sty -
    vruler.sty
    macros/latex/contrib/misc/vruler.sty +
    edmac
    macros/plain/contrib/edmac (or browse the directory) +
    fancyvrb.sty
    macros/latex/contrib/fancyvrb (or browse the directory) +
    ledmac.sty
    macros/latex/contrib/ledmac (or browse the directory) +
    lineno.sty
    macros/latex/contrib/lineno (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    moreverb.sty
    macros/latex/contrib/moreverb (or browse the directory) +
    numline.sty
    obsolete/macros/latex/contrib/numline/numline.sty +
    vruler.sty
    macros/latex/contrib/misc/vruler.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linenos diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespace.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespace.html index 459a395ed47..ad76a5fba16 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespace.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespace.html @@ -35,7 +35,7 @@ becoming less common.

    Documentation of setspace appears as TeX comments in the package file itself.

    -
    setspace.sty
    macros/latex/contrib/setspace/setspace.sty +
    setspace.sty
    macros/latex/contrib/setspace/setspace.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespace diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespread.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespread.html index 79c57fffa0e..d08a9a6717f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespread.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linespread.html @@ -33,7 +33,7 @@ you want to avoid setspace, beware the behaviour of linespread changes within a paragraph: read “\baselineskip is a paragraph parameter”.

    -
    setspace.sty
    macros/latex/contrib/setspace/setspace.sty +
    setspace.sty
    macros/latex/contrib/setspace/setspace.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linespread diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linmacnames.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linmacnames.html new file mode 100644 index 00000000000..af245d94c84 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-linmacnames.html @@ -0,0 +1,147 @@ + +UK TeX FAQ -- question label linmacnames + +

    Non-letters in macro names

    +

    New LaTeX users are often suprised that macro definitions +containing non-letters, such as +

    +
    +\newcommand{\cul8r}{Goodbye!}
    +
    +

    +fail to compile. The reason is that the TeX macro language, unlike +most programming languages, allows +nothing but letters in macro names. +

    There are a number of techniques for defining a macro with a name like +\cul8r. Unfortunately, none of the techniques is particularly +good: +

      +
    1. Use \csname\dots\endcsname to define and invoke the + macro: +
      + +
      +\expandafter\newcommand\csname cul8r\endcsname{Goodbye!}
      +I said, ``\csname cul8r\endcsname''.
      +
      +

      +

      +
      Pro:
      No unexpected side effects +
      Con:
      So verbose as to be unusable +
      +
    2. Define a “special-command generator”, and use the resulting + commands: +
      + +
      +\newcommand{\DefineRemark}[2]{%
      +  \expandafter\newcommand\csname rmk-#1\endcsname{#2}%
      +}
      +\newcommand{\Remark}[1]{\csname rmk-#1\endcsname}
      +...
      +\DefineRemark{cul8r}{Goodbye!}
      +...
      +\Remark{cul8r}
      +
      +

      +

      +
      Pro:
      Straightforward to use, not too untidy +
      Con:
      It’s hardly doing what we set out to do (experts will + see that you are defining a macro, but others likely won’t) +
      +
    3. Convince TeX that “8” is a letter: +
      +
      +\catcode`8 = 11 
      +\newcommand{\cul8r}{Goodbye!}
      +I said, ``\cul8r''.
      +
      +

      +

      +
      Pro:
      \cul8r can be used directly +
      Con:
      Likely to break other uses of “8” (such as + numbers or dimensions; so + \setlength{\paperwidth}{8in} tells us: +
      +
      +! Missing number, treated as zero.
      +<to be read again> 
      +                   8
      +
      +

      +

      + As a general rule, changing category codes is something to use + in extremis, after detailed examination of options. It is + conceivable that such drastic action could be useful for you, but + most ordinary users are well advised not even to try such a + technique. +
    4. Define a macro \cul which must always be followed by + “8r”: +
      +
      +\def\cul8r{Goodbye!}
      +I said, ``\cul8r''.
      +
      +

      +

      +
      Pro:
      \cul8r can be used directly +
      Con #1:
      Breaks if \cul is followed by anything other + than “8r”, with a confusing diagnostic — + \cul99 produces: +
      +
      +! Use of \cul doesn't match its definition.
      +<*> \cul9
      +         9
      +
      + +

      + (which would confuse someone who hadn’t even realised there + was a definition of \cul in the document). +

      Con #2:
      Silently redefines existing \cul, if any; + as a result, the technique cannot be used to define both a + \cul8r and, say, a \cul123 macro in the same + document. +
      +
    +Technique 3 is in fact commonly used — in a limited form — within +most LaTeX packages and within LaTeX itself. The convention is to +use “@” within the names of internal macros to hide them +from the user and thereby prevent naming conflicts. To this end, +LaTeX automatically treats “@” as a letter while +processing classes and packages and as a non-letter while processing +the user’s document. The key to this technique is the separation: +internally a non-letter is used for macro names, and the user doesn’t +see anything of it, while the status remains “frozen” in all the +definitions created within the class or package. See +\@ and @ in macro names for +more information. +

    Note that analogous use of technique 3 in this example would give us +

    +
    +\begingroup
    +  \catcode`8 = 11 
    +  \gdef\cul8r{Goodbye!}
    +  \gdef\later{\cul8r}
    +\endgroup
    +I said, ``\later''.
    +
    +

    +which works, but rather defeats the object of the exercise. +(\later has the “frozen” catcode for ‘8’, even though the value +has reverted to normal by the time it’s used; note, also, the use of +the primitive command \gdef, since \newcommand can’t make a +macro that’s available outside the group.) +

    Recommendation: Either choose another mechanism (such as +\DefineRemark above), or choose another name for your macro, one +that contains only ordinary letters. A common approach is to use +roman numerals in place of arabic ones: +

    +
    +\newcommand{\culVIIIr}{Goodbye!}
    +
    +

    +which rather spoils the intent of the joke implicit in the example +\cul8r! +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=linmacnames + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lit.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lit.html index 539033c4fd6..4a0fddf3502 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lit.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lit.html @@ -19,7 +19,7 @@ CTAN. Another good source of information is http://www.literateprogramming.com/

    Literate Programming FAQ
    - help/comp.programming.literate_FAQ + help/comp.programming.literate_FAQ

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=lit diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-logos.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-logos.html index f0e08fac9cc..5a3df91fe7d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-logos.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-logos.html @@ -5,17 +5,14 @@

    Knuth was making a particular point about the capabilities of TeX when he defined the logo. Unfortunately, many believe, he thereby opened floodgates to give the world a whole range of rather silly -‘bumpy road’ logos such as AMSTeX, PicTeX, BibTeX, and so on, -produced in a flurry of different fonts, sizes, and baselines — indeed, -everything one might hope to cause them to obstruct the reading process. -In particular, Lamport invented LaTeX - - (silly enough in itself, with a raised small ‘A’ and a lowered ‘E’) -and marketing input from Addison-Wesley led to the even -stranger current logo - - LaTeX2e, which appends a lowered single-stroke Greek letter - epsilon. +‘bumpy road’ logos for TeX entities such as AMSTeX, PicTeX, +BibTeX, and so on, produced in a flurry of different fonts, sizes, +and baselines — indeed, everything one might hope to cause them to +obstruct the reading process. In particular, Lamport invented +LaTeX (silly enough in itself, with a raised small ‘A’ and a +lowered ‘E’) and marketing input from Addison-Wesley led to the even +stranger current logo for LaTeX2e, which appends a lowered +single-stroke Greek letter ε.

    Sensible users don’t have to follow this stuff wherever it goes, but, for those who insist, a large collection of logos is defined in the texnames package (but note that this set of macros isn’t @@ -28,19 +25,18 @@ use of the Knuthian font for MetaPost (you might get - something like ‘META O T’). -You needn’t despair, however — the author himself uses just ‘MetaPost’. + something like ‘META&nbsp;&nbsp;O&nbsp;&nbsp;T’). +You needn’t despair, however — most versions of the logo font +distributed nowadays contain the missing letters, and the author +himself uses just ‘MetaPost’.

    For those who don’t wish to acquire the ‘proper’ logos, the canonical thing to do is to say AMS-\TeX - for AMSTeX, Pic\TeX - for PicTeX, Bib\TeX - for BibTeX, and so on.

    -
    mflogo.sty
    macros/latex/contrib/mflogo (gzipped tar, browse) -
    texnames.sty
    info/biblio/texnames.sty +
    mflogo.sty
    macros/latex/contrib/mflogo (or browse the directory) +
    texnames.sty
    info/biblio/texnames.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=logos diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lollipop.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lollipop.html index ec9d1b7a1a8..224689ca94d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lollipop.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-lollipop.html @@ -25,7 +25,7 @@ LaTeX market share”; it’s a very witty package, but little sign of it taking over from LaTeX is detectable... An article about Lollipop appeared in TUGboat 13(3).

    -
    Lollipop distribution
    macros/lollipop (gzipped tar, browse) +
    Lollipop distribution
    macros/lollipop (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=lollipop diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-longtab.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-longtab.html index a749efd9b5c..294c0fc71c8 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-longtab.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-longtab.html @@ -56,12 +56,12 @@ the end of a page; it also has usability extensions, but doesn’t have the head- and footline capabilities of the major packages.

    Documentation of ltablex is to be found in the package file.

    -
    longtable.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    ltablex.sty
    macros/latex/contrib/ltablex/ltablex.sty -
    ltxtable.sty
    Generate by running macros/latex/contrib/carlisle/ltxtable.tex -
    stabular.sty
    Distributed as part of macros/latex/contrib/sttools (gzipped tar, browse) -
    supertabular.sty
    macros/latex/contrib/supertabular (gzipped tar, browse) -
    xtab.sty
    macros/latex/contrib/xtab (gzipped tar, browse) +
    longtable.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    ltablex.sty
    macros/latex/contrib/ltablex/ltablex.sty +
    ltxtable.sty
    Generate by running macros/latex/contrib/carlisle/ltxtable.tex +
    stabular.sty
    Distributed as part of macros/latex/contrib/sttools (or browse the directory) +
    supertabular.sty
    macros/latex/contrib/supertabular (or browse the directory) +
    xtab.sty
    macros/latex/contrib/xtab (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=longtab diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ltxcmds.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ltxcmds.html index af41f3f0733..7f51a835ea0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ltxcmds.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ltxcmds.html @@ -116,7 +116,7 @@ context.

    All these .dtx files are on CTAN as part of the main LaTeX distribution.

    -
    LaTeX distribution
    macros/latex/base (gzipped tar, browse) +
    LaTeX distribution
    macros/latex/base (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ltxcmds diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-luatex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-luatex.html index bd8af31be3b..117d75553b7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-luatex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-luatex.html @@ -1,28 +1,38 @@ UK TeX FAQ -- question label luatex -

    PDFTeX becomes LuaTeX

    +

    PDFTeX and LuaTeX

    As is said elsewhere in these FAQs, development of PDFTeX is “in essence” complete — -development of new facilities continues, but the limitations of the -present structure impose a strong limit on what facilities are -possible. (The PDFTeX team has announced that no further +no new facilities are being developed, since the limitations of the +present structure mean that the returns on effort invested are +diminishing. The PDFTeX team has announced that no further developments will be added after the release of PDFTeX 1.50.0, -which will be the next major release.) -

    In this context, the idea of LuaTeX arose. +which will be the next major release. +

    In parallel with the running-down of PDFTeX development, +development of a new system, LuaTeX is under way. Lua is a script -language, designed to offer an interpreter with a very small -“footprint”, so it is rather easy to build it into other -applications. So LuaTeX was launched as a PDFTeX -executable with a Lua interpreter built into it. -

    A LuaTeX project is now proceeding -(with monetary support from various sources) and is pursuing avenues -that many of the other +language, designed to offer an interpreter that may be incorporated +into other applications. LuaTeX consists of a TeX-like engine +with a lua interpreter built into it; the lua +interpreter has access to many of the data structures used for +typesetting, and the user may also interpolate chunks of +lua code into their (La)TeX macros, or as ‘call-backs’ +for use when the TeX-like engine does certain operations. +

    This arrangement offers the prospect of a “semi-soft” typesetting +engine: it will have its basic behaviour, but the user gets to +redefine functionality if an idea occurs — there will be no need to +persuade the world first, and then find a willing developer to work on +the sources of of the distribution. +

    The LuaTeX project is (with monetary +support from various sources) pursuing avenues that many of the other current projects have in their sights, notably Unicode character -representations and support for OpenType fonts. Work is also in hand +representations and support for OpenType fonts. The intention is to integrate the extensions pioneered by Aleph. -

    The next release of TeX Live (due in July 2008) and MiKTeX -version 2.8 (no current release date) will incorporate LuaTeX. -ConTeXt distributions can already make use of it. +

    A release of LuaTeX whose functionality is declared (version 0.50) +has recently appeared. TeX Live 2008 incorporates an early release +of LuaTeX, and the upcoming MiKTeX version 2.8 (no current +release date) will probably incorporate LuaTeX. ConTeXt +distributions can already make use of LuaTeX.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=luatex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-make.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-make.html index 18971011cad..c70e2f5d5f3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-make.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-make.html @@ -40,11 +40,11 @@ as necessary. FAQ through LaTeX: we don’t present them as a complete solution, but some of the tricks employed are surely re-usable.

    -
    AutoLaTeX
    support/autolatex (gzipped tar, browse) -
    FAQ distribution
    help/uk-tex-faq (gzipped tar, browse) -
    latexmake
    support/latexmake (gzipped tar, browse) -
    latexmk
    support/latexmk (gzipped tar, browse) -
    texi2dvi
    Distributed as part of macros/texinfo/texinfo (gzipped tar, browse) +
    AutoLaTeX
    support/autolatex (or browse the directory) +
    FAQ distribution
    help/uk-tex-faq (or browse the directory) +
    latexmake
    support/latexmake (or browse the directory) +
    latexmk
    support/latexmk (or browse the directory) +
    texi2dvi
    Distributed as part of macros/texinfo/texinfo (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=make diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makebib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makebib.html index 80fafa4181e..22370d51f09 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makebib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makebib.html @@ -15,8 +15,8 @@ styles. not usually destroy information, it can quite reasonably mislabel it.

    Documentation of the script is to be found in the file tex2bib.readme

    -
    tex2bib
    biblio/bibtex/utils/tex2bib/tex2bib -
    tex2bib.readme
    biblio/bibtex/utils/tex2bib/README +
    tex2bib
    biblio/bibtex/utils/tex2bib/tex2bib +
    tex2bib.readme
    biblio/bibtex/utils/tex2bib/README

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makebib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html index f0a1f6ca76d..e9acda63103 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-makeindex.html @@ -38,16 +38,16 @@ to be included into the document at the next run. highly flexible. Sadly, its take-up is proving rather slow.

    -
    idxtex
    indexing/glo+idxtex (gzipped tar, browse) -
    ltxindex.sty
    macros/latex/contrib/ltxindex (gzipped tar, browse) -
    makeindex
    indexing/makeindex (gzipped tar, browse) -
    makeindex (Macintosh)
    systems/mac/macmakeindex2.12.sea.hqx -
    texindex (the script)
    indexing/texindex (gzipped tar, browse) +
    idxtex
    indexing/glo+idxtex (or browse the directory) +
    ltxindex.sty
    macros/latex/contrib/ltxindex (or browse the directory) +
    makeindex
    indexing/makeindex (or browse the directory) +
    makeindex (Macintosh)
    systems/mac/macmakeindex2.12.sea.hqx +
    texindex (the script)
    indexing/texindex (or browse the directory)
    texindex (the program)
    Distributed - with macros/texinfo/texinfo (gzipped tar, browse) -
    texsis (system)
    macros/texsis (gzipped tar, browse) -
    texsis (makeindex support)
    macros/texsis/index/index.tex -
    xindy
    support/xindy/ + with macros/texinfo/texinfo (or browse the directory) +
    texsis (system)
    macros/texsis (or browse the directory) +
    texsis (makeindex support)
    macros/texsis/index/index.tex +
    xindy
    indexing/xindy/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=makeindex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-latex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-latex.html index 2840ad9104c..bab58558eec 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-latex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-latex.html @@ -2,11 +2,15 @@ UK TeX FAQ -- question label man-latex

    Online introductions: LaTeX

    +

    A pleasing little document, “Getting something out of LaTeX” is +designed to give a feel of LaTeX to someone who’s never used it at +all. It’s not a tutorial, merely helps the user to decide whether to +go on to a tutorial, and to ‘real’ use of LaTeX.

    Tobias Oetiker’s ‘(Not so) Short Introduction to LaTeX2e’, is regularly updated, as people suggest better ways of explaining things, etc. The introduction is available on CTAN, together with translations into a rather large set of languages. -

    Peter Flynn’s “Beginner’s LaTeX” (which also started as course +

    Peter Flynn’s “Beginner’s LaTeX” (which started life as course material) is a pleasing read. A complete copy may be found on CTAN, but it may also be browsed over the web (http://www.tex.ac.uk/tex-archive/info/beginlatex/html/). @@ -46,15 +50,16 @@ Trettin, translated into English by Jürgen Fenn. The tutorial is available from CTAN as a PDF file (though the source is also available).

    -
    Beginner’s LaTeX
    info/beginlatex/beginlatex-3.6.pdf -
    Not so Short Introduction
    info/lshort/english/lshort.pdf +
    Beginner’s LaTeX
    info/beginlatex/beginlatex-3.6.pdf +
    First LaTeX document
    info/first-latex-doc (or browse the directory) +
    Not so Short Introduction
    info/lshort/english/lshort.pdf (in English, you may browse for sources and other language versions at - info/lshort/) -
    Simplified LaTeX
    info/simplified-latex/simplified-intro.ps -
    Short Course in LaTeX
    info/Math_into_LaTeX-4/Short_Course.pdf + info/lshort/) +
    Simplified LaTeX
    info/simplified-latex/simplified-intro.ps +
    Short Course in LaTeX
    info/Math_into_LaTeX-4/Short_Course.pdf -
    The sins of LaTeX users
    info/l2tabu/english/l2tabuen.pdf; - source also available: info/l2tabu/english/l2tabuen.tex +
    The sins of LaTeX users
    info/l2tabu/english/l2tabuen.pdf; + source also available: info/l2tabu/english/l2tabuen.tex

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=man-latex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-tex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-tex.html index 7b021ea561e..457aee3f638 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-tex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-man-tex.html @@ -7,7 +7,7 @@

    Another recommendable document is D. R. Wilkins ‘Getting started with TeX’, available on the web at http://www.ntg.nl/doc/wilkins/pllong.pdf

    -
    Gentle Introduction
    info/gentle/gentle.pdf +
    Gentle Introduction
    info/gentle/gentle.pdf

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=man-tex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-manymathalph.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-manymathalph.html index 349ad41cd8d..f35a28a3247 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-manymathalph.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-manymathalph.html @@ -35,7 +35,7 @@ and then steadily reduce the bold families, starting with

    until (with a bit of luck) the error goes away.

    -
    bm.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    bm.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=manymathalph diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginparside.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginparside.html index 2746486f12f..fd4f38b0dd7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginparside.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginparside.html @@ -24,8 +24,8 @@ of the page each \marginpar should be on. Th mparhack package does this, using label-like marks stored in the .aux file; the memoir class does likewise.

    -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    mparhack.sty
    macros/latex/contrib/mparhack (gzipped tar, browse) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    mparhack.sty
    macros/latex/contrib/mparhack (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=marginparside diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginpkgs.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginpkgs.html index a8a81d47fe4..1a5fca7b229 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginpkgs.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-marginpkgs.html @@ -19,12 +19,12 @@ canned set of paper sizes (a superset of that provided in LaTeX2e), provision for custom paper, margin adjustments and provision for two-sided printing.

    -
    geometry.sty
    macros/latex/contrib/geometry (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    layout.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    typearea.sty
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) -
    vmargin.sty
    macros/latex/contrib/vmargin (gzipped tar, browse) +
    geometry.sty
    macros/latex/contrib/geometry (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    layout.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    typearea.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory) +
    vmargin.sty
    macros/latex/contrib/vmargin (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=marginpkgs diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-matchbrak.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-matchbrak.html index 1f7f5f25f3b..8f9d04cf2cd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-matchbrak.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-matchbrak.html @@ -53,5 +53,5 @@ argument is enclosed in parentheses, as in: parentheses, but the issue seldom arises since such arguments rarely contain text. If it were to arise, the same solution (enclosing the confused characters in braces) would solve the problem. -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=matchbrak +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=matchbrak diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathlips.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathlips.html index 6308b2a33a8..6c621cdea64 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathlips.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathlips.html @@ -35,11 +35,11 @@ distribution (thus saving you the bother of installing the package before being able to read the documentation). Documentation of mathdots appears at the end the package file itself.

    -
    amslatex
    macros/latex/required/amslatex (gzipped tar, browse) -
    graphics.sty
    Part of the macros/latex/required/graphics (gzipped tar, browse) bundle -
    mathdots.sty
    macros/generic/mathdots (gzipped tar, browse) -
    yhmath (fonts)
    fonts/yhmath (gzipped tar, browse) -
    yhmath (macros)
    macros/latex/contrib/yhmath (gzipped tar, browse) +
    amslatex
    macros/latex/required/amslatex (or browse the directory) +
    graphics.sty
    Part of the macros/latex/required/graphics (or browse the directory) bundle +
    mathdots.sty
    macros/generic/mathdots (or browse the directory) +
    yhmath (fonts)
    fonts/yhmath (or browse the directory) +
    yhmath (macros)
    macros/latex/contrib/yhmath (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mathlips diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathml.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathml.html index 39bdeb00df9..331b1c4109f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathml.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathml.html @@ -85,20 +85,22 @@ support for new Web standards. onus on the browser user; and however technically proficient you are, it’s never safe to assume too much of your readers. An interesting alternative is - MimeTeX, which sits + MathTeX, which sits on your server as a CGI script, and you use it to include your TeX, in your HTML, as if it were an image:

    -<img src="../cgi-bin/mimetex.cgi?f(x)=\int\limits_{-\infty}^xe^{-t^2}dt">
    +<img src="/cgi-bin/mimetex.cgi?f(x)=\int\limits_{-\infty}^xe^{-t^2}dt">
     

    +(Mathtex supersedes the author’s earlier mimetex.)

    -
    GELLMU
    support/gellmu (gzipped tar, browse) -
    MimeTeX
    support/mimetex (gzipped tar, browse) -
    TeX4HT
    support/TeX4ht/tex4ht-all.zip +
    GELLMU
    support/gellmu (or browse the directory) +
    MathTeX
    support/mimetex/ +
    MimeTeX
    support/mimetex/ +
    TeX4HT
    support/TeX4ht/tex4ht-all.zip

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mathml diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathonlyref.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathonlyref.html index 317eb2cd798..1f280e7c9d2 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathonlyref.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathonlyref.html @@ -19,7 +19,7 @@ operation, only those equations to which you make reference will be numbered in the final output. See the package’s documentation for details of how to make references when the switch is in effect.

    -
    mathtools.sty
    Distributed as part of macros/latex/contrib/mh (gzipped tar, browse) +
    mathtools.sty
    Distributed as part of macros/latex/contrib/mh (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mathonlyref diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathsize.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathsize.html index c24a7c06895..ed50a94dcdc 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathsize.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathsize.html @@ -51,8 +51,8 @@ Beware simply copying (parts of) the LaTeX definitions — since they contain those internal abbreviations, they need to be treated as internal commands.

    -
    fontdef.dtx
    macros/latex/base/fontdef.dtx -
    fontmath.ltx
    macros/latex/unpacked/fontmath.ltx +
    fontdef.dtx
    macros/latex/base/fontdef.dtx +
    fontmath.ltx
    macros/latex/unpacked/fontmath.ltx

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mathsize diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathstext.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathstext.html index 777930ef9f9..872da227970 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathstext.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mathstext.html @@ -112,13 +112,13 @@ signs): at ftp://ftp.ams.org/pub/tex/doc/amsmath/amsldoc.pdf

    amsldoc.tex
    Distributed as part of AMSLaTeX - macros/latex/required/amslatex (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory)
    amsmath.sty
    Distributed as part of AMSLaTeX - macros/latex/required/amslatex (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory)
    amstext.sty
    Distributed as part of AMSLaTeX - macros/latex/required/amslatex (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory)
    mathtools.sty
    Distributed as part of the mh bundle - macros/latex/contrib/mh (gzipped tar, browse) + macros/latex/contrib/mh (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mathstext diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcfloat.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcfloat.html index 8184f2d9ad3..7dae8d65509 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcfloat.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcfloat.html @@ -28,8 +28,8 @@ won’t ‘float’, and exhibit other strange behaviours (such as s running off the end of the column at the end of the multicols environment).

    -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) -
    multicol.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    float.sty
    macros/latex/contrib/float (or browse the directory) +
    multicol.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mcfloat diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcite.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcite.html index 4a577b1dabc..64504221f1d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcite.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mcite.html @@ -5,8 +5,8 @@

    A convention sometimes used in physics journals is to “collapse” a group of related citations into a single entry in the bibliography. BibTeX, by default, can’t cope with this arrangement, but the mcite -package deals with the problem. -

    The package overloads the \cite command to recognise a +and mciteplus packages deal with the problem. +

    mcite overloads the \cite command to recognise a “*” at the start of a key, so that citations of the form

    @@ -29,20 +29,31 @@ paper 3.
     

    You need to make a small change to the bibliography style (.bst) file you use; the mcite package documentation tells you how to do that. -

    Unfortunately, the revtex system doesn’t play with -mcite. As a result, for that (primarily physics-targeted -system) you need to play silly games like: +

    (Despite these multiple citations being primarily a physics-oriented +requirement, the RevTeX (Physics support) class doesn’t work +with mcite. +

    The mciteplus package adresses many of the infelicites of +mcite, and does work with RevTeX. Again, +‘ordinary’ .bst files will not work with +mciteplus, but the package documentation explains how to +patch an existing BibTeX style. +

    The collref package takes a rather different approach to the +problem, and will work with most (if not all) BibTeX packages. +Collref spots common subsets of the references, so if it +sees a sequence

    -\cite{paper0,paper1,paper3}
    -\nocite{paper2}
    +\cite{paper0,paper1,paper2,paper3}
    +...
    +\cite{some_other_paper,paper1,paper2,and_another}
     

    -and then edit the .bbl file to merge the two citations, to -achieve the effects of mcite. +it will collect paper1 and paper2 as a multiple reference.

    -
    mcite.sty
    macros/latex/contrib/mcite (gzipped tar, browse) -
    revtex bundle
    macros/latex/contrib/revtex (gzipped tar, browse) +
    collref.sty
    macros/latex/contrib/collref (or browse the directory) +
    mcite.sty
    macros/latex/contrib/mcite (or browse the directory) +
    mciteplus.sty
    macros/latex/contrib/mciteplus (or browse the directory) +
    revtex bundle
    macros/latex/contrib/revtex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mcite diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-metrics.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-metrics.html index 06dd0d2de82..402bf048b4d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-metrics.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-metrics.html @@ -48,10 +48,10 @@ software, and is available on CTAN.

    -
    dvips
    dviware/dvips (gzipped tar, browse) -
    EdMetrics
    systems/mac/textures/utilities/EdMetrics.sea.hqx -
    fontinst
    fonts/utilities/fontinst (gzipped tar, browse) -
    LY1 support
    macros/latex/contrib/psnfssx/ly1 (gzipped tar, browse) +
    dvips
    dviware/dvips (or browse the directory) +
    EdMetrics
    systems/mac/textures/utilities/EdMetrics.sea.hqx +
    fontinst
    fonts/utilities/fontinst (or browse the directory) +
    LY1 support
    macros/latex/contrib/psnfssx/ly1 (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=metrics diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mfptutorials.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mfptutorials.html index a43366b900e..5e527618748 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mfptutorials.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mfptutorials.html @@ -40,10 +40,9 @@ most certainly valuable learning material. Urs Oswald presents a similar document, written more as a document, and presented in PDF.

    -
    Beginners’ guide
    info/metafont/beginners/metafont-for-beginners.pdf -
    Peter Wilson’s “experiences”
    info/metafont/metafp/metafp.pdf - (PDF format) -
    Vincent Zoonekynd’s examples
    info/metapost/examples (gzipped tar, browse) +
    Beginners’ guide
    info/metafont/beginners/metafont-for-beginners.pdf +
    Peter Wilson’s “experiences”
    info/metafont/metafp/metafp.pdf +
    Vincent Zoonekynd’s examples
    info/metapost/examples (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mfptutorials diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-minitoc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-minitoc.html index 75fec2d9e7a..4ab91c8f3b7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-minitoc.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-minitoc.html @@ -34,9 +34,9 @@ version of the hyperref package does know about minitoc and treats \minitoc tables in the same way as “real” tables of contents.

    -
    babel.sty
    macros/latex/required/babel (gzipped tar, browse) -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    minitoc.sty
    macros/latex/contrib/minitoc (gzipped tar, browse) +
    babel.sty
    macros/latex/required/babel (or browse the directory) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    minitoc.sty
    macros/latex/contrib/minitoc (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=minitoc diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-misssymb.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-misssymb.html index 24165ca886b..d9b2e197b70 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-misssymb.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-misssymb.html @@ -10,8 +10,8 @@ the LaTeX distribution), and in the amsfonts package (which is part of the AMS distribution, and requires AMS symbol fonts).

    -
    amsfonts.sty
    fonts/amsfonts/latex (gzipped tar, browse) -
    AMS symbol fonts
    fonts/amsfonts/sources/symbols (gzipped tar, browse) +
    amsfonts.sty
    fonts/amsfonts/latex (or browse the directory) +
    AMS symbol fonts
    fonts/amsfonts/sources/symbols (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=misssymb diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-moren9.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-moren9.html index 20669160583..03732af2bad 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-moren9.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-moren9.html @@ -58,7 +58,7 @@ doesn’t have to remember that argument twelve is soiltype, an on: the commands may be copied from field notes quickly and accurately.

    -
    keyval.sty
    Distributed as part of macros/latex/required/graphics (gzipped tar, browse) +
    keyval.sty
    Distributed as part of macros/latex/required/graphics (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=moren9 diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mpprologues.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mpprologues.html index 848e6932446..6ff755deea3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mpprologues.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-mpprologues.html @@ -76,9 +76,9 @@ set up to look like a proof sheet. PDF from MetaPost, so may reasonably be considered an answer to the question...

    -
    mps2eps
    support/mps2eps (gzipped tar, browse) -
    mpsproof.tex
    graphics/metapost/contrib/misc/mpsproof.tex -
    mptopdf
    Part of macros/pdftex/graphics (gzipped tar, browse) +
    mps2eps
    support/mps2eps (or browse the directory) +
    mpsproof.tex
    graphics/metapost/contrib/misc/mpsproof.tex +
    mptopdf
    Part of macros/pdftex/graphics (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=mpprologues diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-msxy.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-msxy.html index c6ab8fb6c7f..d163eb59b3a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-msxy.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-msxy.html @@ -22,8 +22,8 @@ letter in the font names).

    If you have a DVI file that requests the fonts, there is a package of virtual fonts to map the old to the new series.

    -
    msa and msb fonts
    fonts/amsfonts/sources/symbols (gzipped tar, browse) -
    virtual font set
    fonts/vf-files/msx2msa (gzipped tar, browse) +
    msa and msb fonts
    fonts/amsfonts/sources/symbols (or browse the directory) +
    virtual font set
    fonts/vf-files/msx2msa (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=msxy diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multbib.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multbib.html index 1105a43ecc9..01a09a98fc7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multbib.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multbib.html @@ -135,10 +135,10 @@ sorting process.) A code example appears in the package documentation which you can browse to, from the link, below).

    -
    bibtopic.sty
    macros/latex/contrib/bibtopic (gzipped tar, browse) -
    multibbl.sty
    macros/latex/contrib/multibbl (gzipped tar, browse) -
    multibib.sty
    macros/latex/contrib/multibib (gzipped tar, browse) -
    splitbib.sty
    macros/latex/contrib/splitbib (gzipped tar, browse) +
    bibtopic.sty
    macros/latex/contrib/bibtopic (or browse the directory) +
    multibbl.sty
    macros/latex/contrib/multibbl (or browse the directory) +
    multibib.sty
    macros/latex/contrib/multibib (or browse the directory) +
    splitbib.sty
    macros/latex/contrib/splitbib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multbib diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multfoot.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multfoot.html index 0d2441aa7df..cea1dcc0dbd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multfoot.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multfoot.html @@ -17,11 +17,11 @@ presentation options, as well. Another critical edition its highly sophisticated structure of footnote facilities, which was also designed to support typesetting critical editions.

    -
    bigfoot
    macros/latex/contrib/bigfoot (gzipped tar, browse) -
    edmac
    macros/plain/contrib/edmac (gzipped tar, browse) -
    ednotes
    macros/latex/contrib/ednotes (gzipped tar, browse) -
    ledmac
    macros/latex/contrib/ledmac (gzipped tar, browse) -
    manyfoot.sty
    Distributed as part of the macros/latex/contrib/ncctools (gzipped tar, browse) +
    bigfoot
    macros/latex/contrib/bigfoot (or browse the directory) +
    edmac
    macros/plain/contrib/edmac (or browse the directory) +
    ednotes
    macros/latex/contrib/ednotes (or browse the directory) +
    ledmac
    macros/latex/contrib/ledmac (or browse the directory) +
    manyfoot.sty
    Distributed as part of the macros/latex/contrib/ncctools (or browse the directory) bundle

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multfoot diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multidoc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multidoc.html index f5ee627147b..e729a4bbd0a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multidoc.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multidoc.html @@ -41,14 +41,14 @@ optional argument of the command, you can specify which pages you want to be included from the file named, and various details of the layout of the included pages.

    -
    combine.cls
    macros/latex/contrib/combine (gzipped tar, browse) -
    combinet.sty
    macros/latex/contrib/combine (gzipped tar, browse) +
    combine.cls
    macros/latex/contrib/combine (or browse the directory) +
    combinet.sty
    macros/latex/contrib/combine (or browse the directory)
    includex.sty
    Distributed in the “unsupported” part of - macros/latex/contrib/frankenstein (gzipped tar, browse) -
    moredefs.sty
    Distributed as part of macros/latex/contrib/frankenstein (gzipped tar, browse) -
    newclude.sty
    Distributed as part of macros/latex/contrib/frankenstein (gzipped tar, browse) -
    pdfpages.sty
    macros/latex/contrib/pdfpages (gzipped tar, browse) -
    subfiles.cls, etc.
    macros/latex/contrib/subfiles (gzipped tar, browse) + macros/latex/contrib/frankenstein (or browse the directory) +
    moredefs.sty
    Distributed as part of macros/latex/contrib/frankenstein (or browse the directory) +
    newclude.sty
    Distributed as part of macros/latex/contrib/frankenstein (or browse the directory) +
    pdfpages.sty
    macros/latex/contrib/pdfpages (or browse the directory) +
    subfiles.cls, etc.
    macros/latex/contrib/subfiles (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multidoc diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multind.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multind.html index 8dad6c9943a..1c5d7a50083 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multind.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multind.html @@ -114,12 +114,12 @@ the documentation. well as its own index layout options, which other packages delegate to the index style used by makeindex).

    -
    index.sty
    macros/latex/contrib/index (gzipped tar, browse) +
    index.sty
    macros/latex/contrib/index (or browse the directory)
    makeidx.sty
    Part of the LaTeX distribution -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    multind.sty
    macros/latex209/contrib/misc/multind.sty +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    multind.sty
    macros/latex209/contrib/misc/multind.sty
    splitidx.sty and splitindex
    - macros/latex/contrib/splitindex (gzipped tar, browse) + macros/latex/contrib/splitindex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multind diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multirow.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multirow.html index 4c651bfec35..a36fa952086 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multirow.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-multirow.html @@ -91,8 +91,8 @@ rows in the multi-row have been opened up with \bigstrutThe documentation of both multirow and bigstrut is to be found, as comments, in the package files themselves.

    -
    bigstrut.sty
    Distributed as part of macros/latex/contrib/multirow (gzipped tar, browse) -
    multirow.sty
    macros/latex/contrib/multirow (gzipped tar, browse) +
    bigstrut.sty
    Distributed as part of macros/latex/contrib/multirow (or browse the directory) +
    multirow.sty
    macros/latex/contrib/multirow (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=multirow diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-music.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-music.html index 5b29906117c..3c799ce6564 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-music.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-music.html @@ -47,15 +47,15 @@ less cryptic than is MusixTeX’s, and it handles much more stuff automatically, yielding the same or better quality with less effort. Lilypond can also produce basic MIDI output.

    -
    abc2mtex
    support/abc2mtex (gzipped tar, browse) -
    M-Tx
    support/mtx (gzipped tar, browse) -
    midi2tex
    support/midi2tex (gzipped tar, browse) -
    musictex
    macros/musictex (gzipped tar, browse) +
    abc2mtex
    support/abc2mtex/ +
    M-Tx
    support/mtx (or browse the directory) +
    midi2tex
    support/midi2tex (or browse the directory) +
    musictex
    macros/musictex (or browse the directory) -
    musixtex (Taupin’s version)
    macros/musixtex/taupin (gzipped tar, browse) -
    musixtex (Egler’s version)
    macros/musixtex/egler (gzipped tar, browse) -
    mutex
    macros/mtex (gzipped tar, browse) -
    pmx
    support/pmx (gzipped tar, browse) +
    musixtex (Taupin’s version)
    macros/musixtex/taupin (or browse the directory) +
    musixtex (Egler’s version)
    macros/musixtex/egler (or browse the directory) +
    mutex
    macros/mtex (or browse the directory) +
    pmx
    support/pmx (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=music diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nameref.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nameref.html index cc1f61d9071..4ac4c5e52fc 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nameref.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nameref.html @@ -54,13 +54,13 @@ optional ‘short’ title argument to the chapter and section commands. (Although it comes from the same author, zref doesn’t define a short-name variant.)

    -
    byname.sty
    Distributed with macros/latex/contrib/smartref (gzipped tar, browse) -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    nameref.sty
    Distributed with macros/latex/contrib/hyperref (gzipped tar, browse) -
    smartref.sty
    macros/latex/contrib/smartref (gzipped tar, browse) -
    titleref.sty
    macros/latex/contrib/misc/titleref.sty -
    zref.sty
    Distributed as part of macros/latex/contrib/oberdiek (gzipped tar, browse) +
    byname.sty
    Distributed with macros/latex/contrib/smartref (or browse the directory) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    nameref.sty
    Distributed with macros/latex/contrib/hyperref (or browse the directory) +
    smartref.sty
    macros/latex/contrib/smartref (or browse the directory) +
    titleref.sty
    macros/latex/contrib/misc/titleref.sty +
    zref.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nameref diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newans.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newans.html index 00b8df11947..ef30f7e75d9 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newans.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newans.html @@ -26,7 +26,7 @@ distribution: this isn’t the code actually used on the Web site, but it’s a close relation and is kept up to date for development purposes.

    -
    FAQ distribution
    help/uk-tex-faq (gzipped tar, browse) +
    FAQ distribution
    help/uk-tex-faq (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=newans diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newfunction.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newfunction.html index 3e6065fe3b8..10bc3a4b4a3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newfunction.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newfunction.html @@ -49,7 +49,7 @@ As with \DeclareMathOperator there’s a starred v

    (It should be noted that “log-like” was reportedly a joke on Lamport’s part; it is of course clear what was meant.)

    -
    amsopn.sty
    In the AMSLaTeX distribution macros/latex/required/amslatex (gzipped tar, browse) +
    amsopn.sty
    In the AMSLaTeX distribution macros/latex/required/amslatex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=newfunction diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newlang.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newlang.html index 035348f0359..02178b00a16 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newlang.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-newlang.html @@ -94,8 +94,8 @@ size is a fiddle. If you do find you’ve run out of memory, it may be worth scanning the list of languages in your language.dat to see whether any could reasonably be removed.

    -
    babel
    macros/latex/required/babel (gzipped tar, browse) -
    hyphenation patterns
    language/hyphenation (gzipped tar, browse) +
    babel
    macros/latex/required/babel (or browse the directory) +
    hyphenation patterns
    language/hyphenation (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=newlang diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nocitestar.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nocitestar.html index 3e0337627c9..edc1d6231d9 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nocitestar.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nocitestar.html @@ -24,8 +24,8 @@ was written for use under LaTeX 2.09, but seems to work well enough; in the old days of LaTeX systems with very little free memory; this problem is less significant now than it once was.)

    -
    biblist.sty
    macros/latex209/contrib/biblist (gzipped tar, browse) -
    listbib.sty
    macros/latex/contrib/listbib (gzipped tar, browse) +
    biblist.sty
    macros/latex209/contrib/biblist (or browse the directory) +
    listbib.sty
    macros/latex/contrib/listbib (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nocite* diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nofm.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nofm.html index 311acf2188a..c8f0a7a9736 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nofm.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nofm.html @@ -13,8 +13,8 @@ defines a “last page” label. how one might actually use this information to produce page numbering as suggested in the question.

    -
    fancyhdr documentation
    macros/latex/contrib/fancyhdr (gzipped tar, browse) -
    lastpage.sty
    macros/latex/contrib/lastpage (gzipped tar, browse) +
    fancyhdr documentation
    macros/latex/contrib/fancyhdr (or browse the directory) +
    lastpage.sty
    macros/latex/contrib/lastpage (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nofm diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nohyph.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nohyph.html index 793582fa4f6..5e2b57939c7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nohyph.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nohyph.html @@ -59,7 +59,7 @@ choice of hyphenation (ana-lysis is the British etymological hyphenation; some feel the American hyphenation feels ‘unfortunate’...).

    -
    hyphenat.sty
    macros/latex/contrib/hyphenat (gzipped tar, browse) +
    hyphenat.sty
    macros/latex/contrib/hyphenat (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nohyph diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noline.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noline.html index cd7e610c6c2..db215606036 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noline.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noline.html @@ -76,8 +76,8 @@ be had by saying:

    -
    expdlist.sty
    macros/latex/contrib/expdlist (gzipped tar, browse) -
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (gzipped tar, browse) +
    expdlist.sty
    macros/latex/contrib/expdlist (or browse the directory) +
    mdwlist.sty
    Distributed as part of macros/latex/contrib/mdwtools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=noline diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonfree.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonfree.html index 4c62ea60570..97507d39d63 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonfree.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonfree.html @@ -1,7 +1,7 @@ UK TeX FAQ -- question label nonfree -

    What’s the CTAN nonfree tree?

    +

    What is the CTAN nonfree tree?

    When CTAN was founded, in the 1990s, it was unusual to publish the terms under which a TeX-related package was distributed (or, at any rate, to publish those terms formally). @@ -18,7 +18,7 @@ were candidates for distribution, and those that were in some sense under which a package would be placed on the tree were hotly contested, and the CTAN team were only able slowly to populate the tree. It is now obvious to the team that the project would never -be completed. +have been completed.

    The CTAN catalogue now records the nature of the licences of a good proportion of the packages it describes (though there remain several for which the licence is unknown, which is as good, for the @@ -30,37 +30,21 @@ the general rule for distributors has become whether you should distribute; if the package is not listed in the catalogue, don’t think of distributing it”.

    -

    (The catalogue only has a modest -list of licences, but it covers the set used +(The catalogue only has a modest +list of licences, but it covers the set used by packages on CTAN, with a wild-card “other-free” which covers packages that the CTAN administrators believe to be free even though the authors haven’t used a standard licence.) +

    There is a corollary to the ‘general rule’: if you notice something +that ought to be in the distributions, for which there is no catalogue +entry, please let the CTAN team (ctan@dante.de) know. +It may well be that the package has simply been missed, but some aren’t +catalogued because there’s no documentation and the team just doesn’t +understand the package.

    In the light of the above, the nonfree tree is being -dismantled, and its contents moved to the main CTAN tree. So -the answer to the question is, now, “the nonfree tree is a part of -CTAN, and is now being merged with the main tree”. -

    - - - - - - - - - - - -

    - - - - -

    - - - - - +dismantled, and its contents moved (or moved back) to the main +CTAN tree. So the answer to the question is, now, “the +nonfree tree is a part of CTAN, and is now being merged with +the main tree”.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nonfree diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonpdfsp.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonpdfsp.html index aa63ddd54c5..9b284aedc42 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonpdfsp.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonpdfsp.html @@ -30,8 +30,8 @@ decide to try PDFLaTeX, you must remove the dvips or dvipdfm driver specification from the package options, and let the system recognise which driver is needed.

    -
    pdftricks.sty
    macros/latex/contrib/pdftricks (gzipped tar, browse) -
    pstricks.sty
    graphics/pstricks (gzipped tar, browse) +
    pdftricks.sty
    macros/latex/contrib/pdftricks (or browse the directory) +
    pstricks.sty
    graphics/pstricks (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nonpdfsp diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonum.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonum.html index 74783f3351c..22040acfee4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonum.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nonum.html @@ -40,9 +40,9 @@ incorporates Times-like mathematics, and a sans-serif face based on Helvetica, but scaled to match Times text rather better.

    -
    calc.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    Examples for LaTeX Companion
    info/examples/tlc2 (gzipped tar, browse) -
    The psnfss bundle
    macros/latex/required/psnfss (gzipped tar, browse) +
    calc.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    Examples for LaTeX Companion
    info/examples/tlc2 (or browse the directory) +
    The psnfss bundle
    macros/latex/required/psnfss (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nonum diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopagebrk.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopagebrk.html index 714fe06c855..69ca8a59ea2 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopagebrk.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopagebrk.html @@ -104,8 +104,8 @@ added to the page you’re typesetting. It depends on the document whether this looks impossibly awful or entirely acceptable, but the command remains a useful item in the armoury.

    -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    needspace.sty
    macros/latex/contrib/misc/needspace.sty +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    needspace.sty
    macros/latex/contrib/misc/needspace.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nopagebrk diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopageno.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopageno.html index b755174cb2b..91dfc3e326e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopageno.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-nopageno.html @@ -41,10 +41,10 @@ the resetting; so one can say to have the same effect as the gobble trick, without resetting the page number.

    -
    nopageno
    macros/latex/contrib/carlisle/nopageno.sty -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    scrpage2.sty
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    nopageno
    macros/latex/contrib/carlisle/nopageno.sty +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    scrpage2.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=nopageno diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noroom.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noroom.html index a1f154fd3c2..df07fef5dac 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noroom.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-noroom.html @@ -29,23 +29,48 @@ whose use is “hidden” in LaTeX; the limit on the number of

    There is nothing that can directly be done about this error, as you can’t extend the number of available registers without extending TeX itself. - Of course, e-TeX and Omega + Of course, e-TeX, Omega and + LuaTeX - both do this, as does MicroPress Inc’s VTeX. -

    The commonest way to encounter one of these error messages is to have +all do this, as does MicroPress Inc’s VTeX. +

    One common way to encounter one of these error messages is to have broken macros of some sort, or incorrect usage of macros (an example is discussed in epsf problems).

    However, sometimes one just needs more than TeX can offer, and when this happens, you’ve just got to work out a different way of doing things. An example is the difficulty of loading PicTeX with LaTeX. -In cases like PicTeX, it may be possible to use -e-TeX (all modern distributions provide it). The -LaTeX package etex modifies the register allocation -mechanism to make use of e-TeX’s extended register sets (it’s a +The more modern drawing package, pgf with its higher-level +interface TikZ is a common problem. +

    In such cases, it is usually possible to use the +e-TeX extensions (all modern distributions provide +them). The LaTeX package etex modifies the register allocation +mechanism to make use of e-TeX’s extended register sets. +Etex is a derivative of the Plain TeX macro file etex.src, which is used in building the e-TeX Plain format; both files are part of the -e-TeX distribution). Unfortunately, e-TeX doesn’t help with -\read or \write objects. +e-TeX distribution and are available in current distributions. +

    It is possible that, even with etex loaded, you still find +yourself running out of things. Problems could be caused by packages +that use large numbers of “inserts” (combinations of counter, box, +dimension and skip registers, used for storing floats and footnotes). +Morefloats does this, of course (naturally enough, +allocating new floats), and footnote packages such as +manyfoot and bigfoot (which uses manyfoot +can also give problems. The etex allows you to deal with +these things: the command \reserveinserts{n} ensures there +is room for <n> more inserts. (Hint: morefloats needs +18 inserts, and manyfoot seems to be happy with 10 +reserved.) Load etex before any others, and reserve the +inserts immediately: +

    +
    +\documentclass[...]{...}
    +\usepackage{etex}
    +\reserveinserts{28}
    +
    +

    +

    Unfortunately, e-TeX doesn’t help with \read or \write +objects (and neither will the etex package).

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=noroom diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-numbersets.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-numbersets.html index 57edaa32534..c49e8968f3d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-numbersets.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-numbersets.html @@ -2,21 +2,23 @@ UK TeX FAQ -- question label numbersets

    Symbols for the number sets

    -

    It is a good idea to have commands such as \R for the real numbers and +

    Mathematicians commonly use special lettering for the real numbers and other standard number sets. Traditionally these were typeset in bold. Because, in the ordinary course of events, mathematicians do not have -access to bold chalk, they invented the special symbols that are now -often used for \R, \C, etc. These symbols are known -as “blackboard bold”. Before insisting on using them, consider -whether going back to the old system of ordinary bold might not be -acceptable (it is certainly simpler). +access to bold chalk, they invented special symbols that are now +often used for the number sets; these symbols are known as +“blackboard bold” (or double-stroked fonts); in place of the heavier +strokes of a bold font, (some) strokes of the letters are doubled. +The minimum useful set is upper-case letters ‘I’, ‘N’, ‘R’, ‘Q’ and +‘Z’; some fonts offer a figure ‘1’ (for a unit matrix — not a number +set at all).

    A set of blackboard bold capitals is available in the AMS msbm fonts (msbm is available at a range of -design sizes, with names such as msbm10). The pair of font +design sizes, with names such as msbm10). The pair of font families (the other is called msam) have a large number of -mathematical symbols to supplement the ones in the standard TeX -distribution, and are available in Type 1 format with most modern -distributions. Support files for using the fonts, both under +mathematical symbols to supplement those provided in the Knuth’s +original TeX distribution, and are available in Type 1 format in +modern distributions. Support files for using the fonts, both under Plain TeX and LaTeX (packages amssymb and amsfonts), are available. The font shape is a rather austere sans, which many people don’t like (though it captures the @@ -34,6 +36,10 @@ comes from a package by Torsten Hilbrich. and sans shapes, at a single weight, and is available both as Metafont sources and as Type 1; the font covers the uppercase latin letters, lowercase ‘h’ and ’k’, and the digit ‘1’. +

    A document that shows the bbm, bbold, +doublestroke and msbm fonts, so that you can get +a feel for their appearance, is available (CTAN package +blackboard).

    An alternative source of Type 1 fonts with blackboard bold characters may be found in the steadily increasing set of complete families, both commercial and free, that have been prepared for use with (La)TeX @@ -49,36 +55,38 @@ the digit ‘1’, and lower-case ‘k’.

    The “lazy person’s” blackboard bold macros:

    -\newcommand{\R}{{\sf R\hspace*{-0.9ex}%
    +\newcommand{\R}{{\textsf{R}\hspace*{-0.9ex}%
       \rule{0.15ex}{1.5ex}\hspace*{0.9ex}}}
    -\newcommand{\N}{{\sf N\hspace*{-1.0ex}%
    +\newcommand{\N}{{\textsf{N}\hspace*{-1.0ex}%
       \rule{0.15ex}{1.3ex}\hspace*{1.0ex}}}
    -\newcommand{\Q}{{\sf Q\hspace*{-1.1ex}%
    +\newcommand{\Q}{{\textsf{Q}\hspace*{-1.1ex}%
       \rule{0.15ex}{1.5ex}\hspace*{1.1ex}}}
    -\newcommand{\C}{{\sf C\hspace*{-0.9ex}%
    +\newcommand{\C}{{\textsf{C}\hspace*{-0.9ex}%
       \rule{0.15ex}{1.3ex}\hspace*{0.9ex}}}
     

    are almost acceptable at normal size if the surrounding text is -cmr10. However, they are not part of a proper maths font, -and so do not work in sub- and superscripts. Moreover, the size and -position of the vertical bar can be affected by the font of the -surrounding text. As we’ve seen, there are plenty of alternatives: -don’t try the macros, or anything similar using capital ‘I’ (which -looks even worse!). +cmr10 (the position of the vertical bar can be affected by +the surrounding font). However, they are not part of a proper maths font, +and do not work in sub- and superscripts. As we’ve seen, there are +plenty of alternatives: that mythical “lazy” person can inevitably +do better than the macros, or anything similar using capital ‘I’ +(which looks even worse!). Voluntary (La)TeX effort has redefined +the meaning of laziness (in this respect!).

    -
    AMS support files (Plain)
    fonts/amsfonts/plaintex (gzipped tar, browse) -
    AMS support files (LaTeX)
    fonts/amsfonts/latex (gzipped tar, browse) -
    AMS symbol fonts
    fonts/amsfonts/sources/symbols (gzipped tar, browse) -
    AMS symbol fonts in Type 1 format
    Browse fonts/amsfonts/ps-type1/ -
    bbm fonts
    fonts/cm/bbm (gzipped tar, browse) -
    bbm macros
    macros/latex/contrib/bbm (gzipped tar, browse) -
    bbold fonts
    fonts/bbold (gzipped tar, browse) -
    doublestroke fonts
    fonts/doublestroke (gzipped tar, browse) -
    fourier fonts
    fonts/fourier-GUT (gzipped tar, browse) -
    mathpazo fonts
    fonts/mathpazo (gzipped tar, browse) -
    pxfonts
    fonts/pxfonts (gzipped tar, browse) -
    txfonts
    fonts/txfonts (gzipped tar, browse) +
    AMS support files (Plain)
    fonts/amsfonts/plaintex (or browse the directory) +
    AMS support files (LaTeX)
    fonts/amsfonts/latex (or browse the directory) +
    AMS symbol fonts
    fonts/amsfonts/sources/symbols (or browse the directory) +
    AMS symbol fonts in Type 1 format
    Browse fonts/amsfonts/ps-type1/ +
    bbm fonts
    fonts/cm/bbm (or browse the directory) +
    bbm macros
    macros/latex/contrib/bbm (or browse the directory) +
    bbold fonts
    fonts/bbold (or browse the directory) +
    blackboard evaluation set
    info/symbols/blackboard (or browse the directory) +
    doublestroke fonts
    fonts/doublestroke (or browse the directory) +
    fourier fonts
    fonts/fourier-GUT (or browse the directory) +
    mathpazo fonts
    fonts/mathpazo (or browse the directory) +
    pxfonts
    fonts/pxfonts (or browse the directory) +
    txfonts
    fonts/txfonts (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=numbersets diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddhyphen.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddhyphen.html index c7190c78a0a..0f63242f90a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddhyphen.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddhyphen.html @@ -15,7 +15,7 @@ found on CTAN (see “using a new language” for instructions on adding this new “language”).

    -
    UK patterns
    language/hyphenation/ukhyphen.tex +
    UK patterns
    language/hyphenation/ukhyphen.tex

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=oddhyphen diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddpage.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddpage.html index 2640db821fe..c282f3ac0b1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddpage.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-oddpage.html @@ -30,20 +30,15 @@ then examined (in a hyperref-safe way) to set a conditional memoir class has the same command setting a conditional \ifoddpage. Of course, the \label contributes to LaTeX’s “Rerun to get cross-references right” error messages... -

    The (older) chngpage provides the same facilities (though it -provides a \ifcpoddpage command; changepage (whose -functions are extracted from the author’s memoir class) is the -designated successor to chngpage.

    The Koma-Script classes have an addmargin* environment -that also provides the sorts of facilities that the chngpage +that also provides the sorts of facilities that the changepage offers. Koma-Script’s supporting command is \ifthispageodd{<true>}{<false>} executes different things depending on the page number.

    -
    changepage.sty
    macros/latex/contrib/misc/changepage.sty -
    chngpage.sty
    macros/latex/contrib/misc/chngpage.sty -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    changepage.sty
    macros/latex/contrib/misc/changepage.sty +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=oddpage diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ol-books.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ol-books.html index 84a65fde319..ed4aae119f5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ol-books.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ol-books.html @@ -7,7 +7,10 @@ the web, and until relatively recently this demand went un-answered.

    The first to appear was Victor Eijkhout’s excellent “TeX by Topic” in 2001 (it had been published by Addison-Wesley, but was long out of print). The book is now available on CTAN; it’s not a -beginner’s tutorial but it’s a fine reference. +beginner’s tutorial but it’s a fine reference. It’s also available, +as a printed copy, via the on-line publishers +Lulu (not quite free, of +course, but not a bad deal...).

    Addison-Wesley have also released the copyright of “TeX for the Impatient” by Paul W. Abrahams, Karl Berry and Kathryn A. Hargreaves, another book whose unavailability many have lamented. The authors @@ -21,9 +24,9 @@ its day, but while it is now somewhat dated, it still has its uses, and is a welcome addition to the list of on-line resources. A project to update it is believed to be under way.

    -
    Making TeX Work
    info/makingtexwork/mtw-1.0.1-html.tar.gz -
    TeX by Topic
    info/texbytopic (gzipped tar, browse) -
    TeX for the Impatient
    info/impatient (gzipped tar, browse) +
    Making TeX Work
    info/makingtexwork/mtw-1.0.1-html.tar.gz +
    TeX by Topic
    info/texbytopic (or browse the directory) +
    TeX for the Impatient
    info/impatient (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ol-books diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-omegaleph.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-omegaleph.html index f8a4d6d829f..95e0577fb15 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-omegaleph.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-omegaleph.html @@ -9,25 +9,26 @@ provides many innovative concepts, notably including the “translation process” that takes a character stream and transforms it according to various processes that may be internally specified, or be a separate program. -

    While Omega showed a lot of promise at its mid-1990s announcement, its -development was slow, and development was essentially dead by the time +

    While Omega showed a lot of promise at its mid-1990s announcement, +progress was slow, and development was essentially dead by the time that one of the original developers withdrew (taking with him a bunch of research students). -

    Before that distressing event, a separate thread of development was -started, to produce a program called Aleph -, which merged the facilities of +

    Before that distressing event, a separate thread of development had +started, to produce a program +called Aleph, which merged the facilities of e-TeX into a stable Omega codebase and added other extensions. Aleph also proved an attractive platform for many people; but its development, too, has dried up. -

    The latest news (from EuroTeX 2006) is that development of Omega is -picking up again, in parallel with research into what the (new) -authors consider a rational scheme for supporting TeX-style -typesetting. The new system is to be known as Omega-2 -(Omega subscript 2), and is being +

    A presentation at EuroTeX 2006 claimed that development of Omega +was picking up again, in parallel with research into what the (new) +developers consider a rational scheme for supporting TeX-style +typesetting. The new system was to be known as Omega-2 +(Omega subscript 2), and was to be designed in a modular fashion so that support of new facilities (such -as use of advanced OpenType fonts) can be added in a relatively -straightforward fashion. -

    The work done in the Aleph project is also being carried forward in -the LuaTeX project. +as use of advanced OpenType fonts) could be added in a relatively +straightforward fashion. A quick web search leads to a recommendation +that potential users consider LuaTeX instead. +Fortunately, lessons learned in Aleph project are being carried +forward in the LuaTeX project.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=omegaleph diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-onecolabs.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-onecolabs.html index 99f87bc3b2d..0ea836d3219 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-onecolabs.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-onecolabs.html @@ -56,8 +56,8 @@ footnoting. They can be used like this:

    The memoir class offers all the facilities of abstract.

    -
    abstract.sty
    macros/latex/contrib/abstract (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    abstract.sty
    macros/latex/contrib/abstract (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=onecolabs diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-osf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-osf.html new file mode 100644 index 00000000000..52ac82cbca5 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-osf.html @@ -0,0 +1,58 @@ + +UK TeX FAQ -- question label osf + +

    Using “old-style” figures

    +

    These numbers are also called medieval or lowercase figures and their +use is mostly font-specific. Terminology is confusing since the +lining figures (which are now the default) are a relatively recent +development (19th century) and before they arrived, oldstyle figures +were the norm, even when setting mathematics. (An example is Thomas +Harriot’s Artis Analyticae Praxis published in 1631). In a +typical old style 3, 4, 5, 7 and 9 have descenders and 6 and 8 ascend +above the x-height; sometimes 2 will also ascend (this last seems to +be a variation associated with French typography). +

    LaTeX provides a command \oldstylenums{digits}, which +by default uses an old-style set embedded in Knuth’s ‘math italic’ +font. The command isn’t sensitive to the font style of surrounding +text: the glyphs are only available to match the normal medium weight +Computer Modern Roman fonts. +

    The textcomp package changes \oldstylenums to use the +glyphs in the Text Companion fonts (LaTeX TS1 encoding) when +in text mode, and also makes them available using the macros of the +form \text<number>oldstyle, e.g., \textzerooldstyle. +(Of course, not all font families can provide this facility.) +

    Some font packages (e.g., mathpazo) make old-style figures +available and provide explicit support for making them the default: +\usepackage[osf]{mathpazo} selects a form where digits are +always old-style in text. The fontinst package will +automatically generate “old-style versions” of commercial Adobe Type +1 font families for which “expert” sets are available. +

    It’s also possible to make virtual fonts, that offer old-style digits, +from existing font packages. The cmolddig bundle provides +a such a virtual version of Knuth’s originals, and the eco +or hfoldsty bundles both provide versions of the EC +fonts. The lm family offers old-style figures to OpenType +users (see below), but we have no stable mapping for lm +with old-style digits from the Adobe Type 1 versions of the fonts. +

    Originally, oldstyle figures were only to be found the expert sets of +commercial fonts, but now they are increasingly widely available. An +example is Matthew Carter’s Georgia font, which has old-style figures +as its normal form (the font was created for inclusion with certain +Microsoft products and is intended for on-screen viewing). +

    OpenType fonts have a pair of axes for number variations — +proportional/tabular and lining/oldstyle selections are commonly +available. “Full feature access” to OpenType fonts, making such +options available to the (La)TeX user, is already supported by +XeTeX using, for example, the fontspec +package. Similar support is also in the works for +LuaTeX. +

    +
    cmolddig fonts
    fonts/cmolddig (or browse the directory) +
    eco fonts
    fonts/eco (or browse the directory) +
    fontinst
    fonts/utilities/fontinst (or browse the directory) +
    fontspec.sty
    macros/xetex/latex/fontspec (or browse the directory) +
    mathpazo fonts
    fonts/mathpazo (or browse the directory) +
    +

    +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=osf + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-otherprinters.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-otherprinters.html index 86dc97512a8..599e93559e0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-otherprinters.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-otherprinters.html @@ -16,7 +16,7 @@ for the printer you actually have. If you are using a Unix system of some sort, it’s generally quite easy to insert ghostscript into the print spooling process.

    -
    ghostscript
    Browse support/ghostscript/ +
    ghostscript
    Browse support/ghostscript/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=otherprinters diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-outszwrng.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-outszwrng.html deleted file mode 100644 index 9df037e476c..00000000000 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-outszwrng.html +++ /dev/null @@ -1,30 +0,0 @@ - -UK TeX FAQ -- question label outszwrng - -

    (La)TeX PDF output prints at wrong size

    -

    Having got everything else right, you should be aware that the -problem may have nothing to do with (La)TeX and everything to do -with the program you use for printing. A regular cause for such -problems lies with Acrobat Reader, which by default enables its option -to scale pages to fit on the printable area of the paper. Since a -printer can rarely print right to the edge, this means that pdf-files -will be shrunk by some (small) factor (even if the pdf-file is -formatted for A4, and your paper size is set to A4 as well). -

    Correcting this silliness is not very hard, but the exact details -depend on the version of Acrobat Reader (or "Adobe Reader" from -version 6.0 onwards) you have installed: -

      -
    • Mac OS X, Adobe Reader 6:
      - in the print dialogue, on the “copies & pages” pane, you’ll find a - popup menu titled “Page Scaling”. Make sure that the menu reads - “None”. -
    • Windows, Adobe Reader 6:
      - in the print dialogue, select “None” from the drop-down list - “Page Scaling”. -
    • Windows, Linux Acrobat (Reader) 5.0:
      - In the print dialog, make sure the “Shrink oversized pages to fit” - checkbox is unchecked. It may also be useful to uncheck the - “Expand small pages to fit paper size” checkbox as well. -
    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=outszwrng - diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overfull.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overfull.html index b518a27bc39..9ca948128bd 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overfull.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overfull.html @@ -127,7 +127,7 @@ and how much to scale each font ... for the fonts the package knows about; it’s a good tool, and users who can take on the specification of adjustments for yet more fonts are always welcome.

    -
    microtype.sty
    macros/latex/contrib/microtype (gzipped tar, browse) +
    microtype.sty
    macros/latex/contrib/microtype (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=overfull diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overstrike.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overstrike.html index a167ee447d5..74571c32b9d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overstrike.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-overstrike.html @@ -10,8 +10,8 @@ provide the necessary facilities. by a different mechanism.

    Documentation of ulem is in the package file.

    -
    soul.sty
    macros/latex/contrib/soul (gzipped tar, browse) -
    ulem.sty
    macros/latex/contrib/misc/ulem.sty +
    soul.sty
    macros/latex/contrib/soul (or browse the directory) +
    ulem.sty
    macros/latex/contrib/misc/ulem.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=overstrike diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pagebychap.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pagebychap.html index 6ab9fcfe881..802c17a1051 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pagebychap.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pagebychap.html @@ -18,9 +18,8 @@ was written: it does the obvious things, and more.

    Users have been known to ask for running page numbers within a section, but this really doesn’t make sense: you need to run page numbers within document objects that always start on a fresh page. -

    Documentation of chappg is to be found in the package file.

    -
    chappg.sty
    macros/latex/contrib/chappg (gzipped tar, browse) +
    chappg.sty
    macros/latex/contrib/chappg (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pagebychap diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papergeom.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papergeom.html index d02dc4cbce4..d9ec57144b7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papergeom.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papergeom.html @@ -82,9 +82,9 @@ length registers \stockheight and \ (for PDFLaTeX processing) then instruct the processor to produce output that specifies the necessary paper size.

    -
    geometry.sty
    macros/latex/contrib/geometry (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    typearea.sty
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    geometry.sty
    macros/latex/contrib/geometry (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    typearea.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=papergeom diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papersize.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papersize.html index ab1fcabda32..60b3cb24ba9 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papersize.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-papersize.html @@ -28,7 +28,7 @@ expectations... suite, that provides a detailed outline of the potential problems together with a sample document and prototype outputs.

    -
    testflow bundle
    macros/latex/contrib/IEEEtran/testflow/ +
    testflow bundle
    macros/latex/contrib/IEEEtran/testflow/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=papersize diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parallel.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parallel.html index b84159458b7..1c6f3a4255b 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parallel.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parallel.html @@ -50,10 +50,10 @@ setting carefully integrated with the needs of a scholarly text, permitting translation, or notes, or both, to be set in parallel with the ‘base’ text of the document.

    -
    ledpar.sty
    Distributed with macros/latex/contrib/ledmac (gzipped tar, browse) -
    parallel.sty
    macros/latex/contrib/parallel (gzipped tar, browse) -
    parcolumns.sty
    Distributed as part of macros/latex/contrib/sauerj (gzipped tar, browse) -
    pdfcolparallel.sty
    Distributed as part of macros/latex/contrib/oberdiek (gzipped tar, browse) +
    ledpar.sty
    Distributed with macros/latex/contrib/ledmac (or browse the directory) +
    parallel.sty
    macros/latex/contrib/parallel (or browse the directory) +
    parcolumns.sty
    Distributed as part of macros/latex/contrib/sauerj (or browse the directory) +
    pdfcolparallel.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=parallel diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parskip.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parskip.html index 2407453735b..61cf3c67f4c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parskip.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-parskip.html @@ -29,8 +29,8 @@ with most problems. equivalent (rapport3) whose design incorporates zero paragraph indent and non-zero paragraph skip.

    -
    NTG classes
    macros/latex/contrib/ntgclass (gzipped tar, browse) -
    parskip.sty
    macros/latex/contrib/misc/parskip.sty +
    NTG classes
    macros/latex/contrib/ntgclass (or browse the directory) +
    parskip.sty
    macros/latex/contrib/misc/parskip.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=parskip diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-patch.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-patch.html index 41ea39fc4c6..059f2bf68af 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-patch.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-patch.html @@ -15,7 +15,7 @@ would naturally write:

    However, this would not work: a call to \splat would execute \mumble, and the call the redefined \splat again; this is an -infinite recursive loop, that will quickly exhaust TeX’s memory. +unterminated recursion, that will quickly exhaust TeX’s memory.

    Fortunately, the TeX primitive \let command comes to our rescue; it allows us to take a “snapshot” of the current state of a command, which we can then use in the redefinition of the command. @@ -73,7 +73,12 @@ debugging tool. programming facilities) provides a command \patchcmd which will perform a “string substitution” in a macro’s definition. The package also provides commands that prepend (\pretocmd) or append -(\apptocmd) to the definition of a command. +(\apptocmd) to the definition of a command. Not all commands may +be patched in this way; the package provides a command +\ifpatchable which checks the prerequisites, and checks that the +target command’s body does indeed include the patch string you propose +to use. (The command \ifpatchable* omits the test on the patch +string.)

    Finally, we’ll briefly consider a package that is (just about) usable, but not really recommendable. Patch gives you an ingenious (and difficult to understand) mechanism, and comes as an @@ -86,12 +91,12 @@ Fortunately, the file (patch.doc) may be input directly, and Roughly speaking, one gives the command a set of instructions analogous to sed substitutions, and it regenerates the command thus amended. Unless you can’t do your job any other way, you -had probably best avoid Patch. +had probably best avoid patch.

    -
    etoolbox.sty
    macros/latex/contrib/etoolbox (gzipped tar, browse) -
    patch.doc
    macros/generic/misc/patch.doc -
    patchcommand.sty
    macros/latex/contrib/patchcmd (gzipped tar, browse) -
    ted.sty
    macros/latex/contrib/ted (gzipped tar, browse) +
    etoolbox.sty
    macros/latex/contrib/etoolbox (or browse the directory) +
    patch.doc
    macros/generic/misc/patch.doc +
    patchcommand.sty
    macros/latex/contrib/patchcmd (or browse the directory) +
    ted.sty
    macros/latex/contrib/ted (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=patch diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdf-fig-chars.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdf-fig-chars.html new file mode 100644 index 00000000000..8d7487ad871 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdf-fig-chars.html @@ -0,0 +1,41 @@ + +UK TeX FAQ -- question label pdf-fig-chars + +

    Characters disappear from figures in PDFTeX

    +

    You have a PDF figure, which you want to use in your +PDFLaTeX document. When you compile the document, PDFTeX +complains about “missing glyphs”, and some (or all) of the labelling +text or symbols in the original figure is no longer visible. +

    What has happened is: +

      +
    1. Your figure file (say fig.pdf) has a font font.pfb + embedded in it. +
    2. PDFTeX notes that it has font.pfb on disc, and loads + that in place of the copy in fig.pdf. +
    3. It turns out that the copy in fig.pdf has glyphs that + aren’t in font.pfb on disc, so that you get errors while + compiling and you see that characters are missing when you view the + output. (PDFTeX can’t know that the fonts are different, since + they have the same name.) +
    +Which is all very undesirable. +

    PDFTeX does this to keep file sizes down: suppose you have a +document that loads figures fig1.pdf and fig2.pdf; both +of those use font font.pfb. If PDFTeX takes no action, +there will be two copies of font.pfb in the output. +(If your document also uses the font, there could be three copies.) +

    A real case is the URW font NimbusRomNo9L-Regu (a clone +of Times Roman), which is available in a version with Cyrillic +letters, while the version in TeX distributions doesn’t have those +letters. Both versions, as distributed, have the same name. +

    The simple (“quick and dirty”) solution is to add the command +

    + \pdfinclusioncopyfonts=1 +

    +to the preamble of your document. +

    The “real” solution is that one or other font should be renamed. In +either case, this would require that you reconfigure some program’s +(TeX’s or your drawing package’s) font tables — inevitably a +tiresome job. +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pdf-fig-chars + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html index e217ac4db7f..afe786a8e73 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdfpagelabels.html @@ -30,7 +30,7 @@ an unnumbered title page, after which page numbers are reset: the PDFTeX warning of “duplicate destinations” will happen in this case, regardless of the options.

    -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pdfpagelabels diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdftexgraphics.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdftexgraphics.html index a82acae3585..69569e372a5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdftexgraphics.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pdftexgraphics.html @@ -47,13 +47,13 @@ which is targeted at the use of pstricks in PDFLaTeX, and also covers the pstricks-specific package pdftricks.

    -
    epstopdf
    Browse support/epstopdf/ +
    epstopdf
    Browse support/epstopdf/
    epstopdf.sty
    Distributed with Heiko Oberdiek’s packages - macros/latex/contrib/oberdiek (gzipped tar, browse) -
    pdftricks.sty
    macros/latex/contrib/pdftricks (gzipped tar, browse) -
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (gzipped tar, browse) -
    pstoedit
    support/pstoedit (gzipped tar, browse) -
    purifyeps
    support/purifyeps (gzipped tar, browse) + macros/latex/contrib/oberdiek (or browse the directory) +
    pdftricks.sty
    macros/latex/contrib/pdftricks (or browse the directory) +
    pst-pdf.sty
    macros/latex/contrib/pst-pdf (or browse the directory) +
    pstoedit
    support/pstoedit (or browse the directory) +
    purifyeps
    support/purifyeps (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pdftexgraphics diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkfix.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkfix.html index 71fcd491f40..5f92470c714 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkfix.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkfix.html @@ -30,8 +30,8 @@ a try. the PostScript it is distilling, and one option is to replace bitmap fonts in the file with Type 1 versions.

    -
    pkfix
    support/pkfix (gzipped tar, browse) -
    pkfix-helper
    support/pkfix-helper (gzipped tar, browse) +
    pkfix
    support/pkfix (or browse the directory) +
    pkfix-helper
    support/pkfix-helper (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=pkfix diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkgdoc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkgdoc.html index 31c10e1707f..ca4bdaa4a55 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkgdoc.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-pkgdoc.html @@ -16,9 +16,9 @@ distributions, the texdoc command often helps, as in: texdoc footmisc

    -which opens a DVI viewer window showing documentation of the +which opens a window showing documentation of the footmisc package. According to the type of file -texdoc finds, it will launch a DVI or PostScript viewer +texdoc finds, it will launch a DVI viewer or a PDF reader.

    If texdoc can’t find any documentation, it may launch a Web browser to look at its copy of the CTAN catalogue. The diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-plainvltx.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-plainvltx.html index ee2ed09f399..434e2c018a4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-plainvltx.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-plainvltx.html @@ -7,11 +7,12 @@ by Plain TeX, and produce highly respectable documents using it (Knuth is an example of this, of course). But equally, many people are happy to let someone else take the design decisions for them, accepting a small loss of flexibility in exchange for a saving of -brain power. +(mental) effort.

    The arguments around this topic can provoke huge amounts of noise and -heat, without offering much by way of light; your best bet is to find -out what those around you are using, and to go with the crowd. Later -on, you can always switch your allegiance; don’t bother about it. +heat, without offering much by way of light; your best bet may be to +find out what those around you are using, and to follow them in the +hope of some support. Later on, you can always switch your +allegiance; don’t bother about it.

    If you are preparing a manuscript for a publisher or journal, ask them what markup they want before you develop your own; many big publishers have developed their own diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-poster.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-poster.html index f94e4158f41..a7bce7e5a0f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-poster.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-poster.html @@ -52,11 +52,11 @@ route): but has hints which are generally useful.

    -
    a0poster.cls
    macros/latex/contrib/a0poster (gzipped tar, browse) -
    flowfram.sty
    macros/latex/contrib/flowfram (gzipped tar, browse) -
    multicol.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    sciposter.cls
    macros/latex/contrib/sciposter (gzipped tar, browse) -
    textpos.sty
    macros/latex/contrib/textpos (gzipped tar, browse) +
    a0poster.cls
    macros/latex/contrib/a0poster (or browse the directory) +
    flowfram.sty
    macros/latex/contrib/flowfram (or browse the directory) +
    multicol.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    sciposter.cls
    macros/latex/contrib/sciposter (or browse the directory) +
    textpos.sty
    macros/latex/contrib/textpos (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=poster diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-previewers.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-previewers.html index 85f53efa309..606aa9b70dc 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-previewers.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-previewers.html @@ -26,7 +26,7 @@ include a version of xdvik. Acrobat Reader or one of the substitutes for that.

    -
    xdvi
    dviware/xdvi (gzipped tar, browse) +
    xdvi
    dviware/xdvi/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=previewers diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-proof.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-proof.html index fcd2ef09876..aecf3b5318a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-proof.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-proof.html @@ -32,8 +32,8 @@ The \tag*{\qedhere} construc AMSLaTeX’s numbering environments.

    amsthm.sty
    Distributed as part of the AMSLaTeX bundle - macros/latex/required/amslatex (gzipped tar, browse) -
    ntheorem.sty
    macros/latex/contrib/ntheorem (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory) +
    ntheorem.sty
    macros/latex/contrib/ntheorem (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=proof diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-protect.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-protect.html index dd0389f9118..15ae9918a62 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-protect.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-protect.html @@ -79,7 +79,7 @@ current LaTeX mean that this is an expensive exercise. It remains a long-term aim of the team to remove all need for \protection.

    makerobust.sty
    Distributed with Heiko Oberdiek’s packages - macros/latex/contrib/oberdiek (gzipped tar, browse) + macros/latex/contrib/oberdiek (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=protect diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psatempty.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psatempty.html index 36d2b34284b..ec33fd35608 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psatempty.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psatempty.html @@ -32,11 +32,11 @@ behaviour if the surrounding page style is ‘empty’. “no page numbers”.

    -
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    nopageno.sty
    macros/latex/contrib/carlisle/nopageno.sty -
    scrpage2.sty
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    nopageno.sty
    macros/latex/contrib/carlisle/nopageno.sty +
    scrpage2.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ps@empty diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psfchoice.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psfchoice.html index 290f4b4e55c..493d67bb0aa 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psfchoice.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-psfchoice.html @@ -162,8 +162,9 @@ commercially, include: set of files for use with LaTeX. The CM Bright fonts are supplied in Type 1 format by MicroPress, Inc. The hfbright bundle offers free Type 1 fonts for text using - the OT1 encoding — the cm-super set for - use with T1 texts doesn’t (yet) offer support for mathematics. + the OT1 encoding — the cm-super fonts provide the + fonts in T1 text encoding but don’t support CM bright + mathematics.

    For further details of Micropress’ offering (including samples) see
    http://www.micropress-inc.com/fonts/brmath/brmain.htm @@ -245,7 +246,7 @@ commercially, include: The fonts are supported under both Plain TeX and LaTeX2e, and are exclusively available for purchase from Personal TeX Inc. - par +
    For further details and samples and fliers, see http://www.pctex.com/mtpro2.html @@ -378,33 +379,33 @@ Many service bureaus don’t care as long as you present them with a finishe print file (PostScript or PDF) for their output device.

    CM family collection
    - Browse fonts/cm/ps-type1/bluesky/ + Browse fonts/cm/ps-type1/bluesky/
    AMS font collection
    - Browse fonts/amsfonts/ps-type1/ + Browse fonts/amsfonts/ps-type1/
    Belleek fonts
    - fonts/belleek/belleek.zip -
    CM-super collection
    fonts/ps-type1/cm-super (gzipped tar, browse) + fonts/belleek/belleek.zip +
    CM-super collection
    fonts/ps-type1/cm-super (or browse the directory)
    eulervm.sty and supporting metrics
    - fonts/eulervm (gzipped tar, browse) + fonts/eulervm (or browse the directory)
    fourier (including metrics and other support for utopia
    - fonts/fourier-GUT (gzipped tar, browse) -
    fouriernc
    fonts/fouriernc (gzipped tar, browse) -
    hfbright collection
    fonts/ps-type1/hfbright (gzipped tar, browse) + fonts/fourier-GUT (or browse the directory) +
    fouriernc
    fonts/fouriernc (or browse the directory) +
    hfbright collection
    fonts/ps-type1/hfbright (or browse the directory)
    hvmath (free bitmapped version)
    - fonts/micropress/hvmath (gzipped tar, browse) -
    kpfonts family
    fonts/kpfonts (gzipped tar, browse) -
    Lucida Bright/Math metrics
    fonts/psfonts/bh/lucida (gzipped tar, browse) -
    Lucida PSNFSS support
    macros/latex/contrib/psnfssx/lucidabr (gzipped tar, browse) -
    MathDesign collection
    fonts/mathdesign/ -
    Maths Font Survey
    info/Free_Math_Font_Survey/en/survey.pdf - (PDF) or info/Free_Math_Font_Survey/en/survey.html (HTML) -
    Minion Pro support
    fonts/minionpro (gzipped tar, browse) -
    MnSymbol family
    fonts/mnsymbol (gzipped tar, browse) -
    pxfonts
    fonts/pxfonts (gzipped tar, browse) + fonts/micropress/hvmath (or browse the directory) +
    kpfonts family
    fonts/kpfonts (or browse the directory) +
    Lucida Bright/Math metrics
    fonts/psfonts/bh/lucida (or browse the directory) +
    Lucida PSNFSS support
    macros/latex/contrib/psnfssx/lucidabr (or browse the directory) +
    MathDesign collection
    fonts/mathdesign/ +
    Maths Font Survey
    info/Free_Math_Font_Survey/en/survey.pdf + (PDF) or info/Free_Math_Font_Survey/en/survey.html (HTML) +
    Minion Pro support
    fonts/minionpro (or browse the directory) +
    MnSymbol family
    fonts/mnsymbol (or browse the directory) +
    pxfonts
    fonts/pxfonts (or browse the directory)
    tmmath (free bitmapped version)
    - fonts/micropress/tmmath (gzipped tar, browse) -
    txfonts
    fonts/txfonts (gzipped tar, browse) -
    utopia fonts
    fonts/utopia (gzipped tar, browse) + fonts/micropress/tmmath (or browse the directory) +
    txfonts
    fonts/txfonts (or browse the directory) +
    utopia fonts
    fonts/utopia (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=psfchoice diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ragright.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ragright.html index bdfdc625eaa..1468c85c57a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ragright.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ragright.html @@ -22,7 +22,7 @@ transformations of the LaTeX kernel originals. The documentation discusses the issues and explains the significance of the various parameters of ragged2e’s operation.

    -
    ragged2e.sty
    Distributed as part of macros/latex/contrib/ms (gzipped tar, browse) +
    ragged2e.sty
    Distributed as part of macros/latex/contrib/ms (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ragright diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readML.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readML.html index eb8f31c7835..b690216648e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readML.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readML.html @@ -11,8 +11,8 @@ processor for XSL formatting objects, serialized as XML. Sebastian Rahtz’s PassiveTeX uses xmltex to achieve this end.

    -
    xmltex
    macros/xmltex/base (gzipped tar, browse) -
    passivetex
    macros/xmltex/contrib/passivetex (gzipped tar, browse) +
    xmltex
    macros/xmltex/base (or browse the directory) +
    passivetex
    macros/xmltex/contrib/passivetex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=readML diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readtex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readtex.html index 1968c6d11d9..1501bc21095 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readtex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-readtex.html @@ -12,7 +12,7 @@ systems are available, free, for most sorts of computer; the bad news is that you need a pretty complete TeX system even to read a single file, and complete TeX systems are pretty large.

    TeX is a typesetting system that arose from a publishing project (see -what is TeX), +“what is TeX”), and its basic source is available free from its author. However, at its root, it is just a typesetting engine: even to view or to print the typeset output, you will need ancillary programs. In short, @@ -27,7 +27,7 @@ or

    But beware — TeX makes no attempt to look like the sort of WYSIWYG system you’re probably used to (see -why is TeX not WYSIWYG): +“why is TeX not WYSIWYG”): while many modern versions of TeX have a compile–view cycle that rivals the best commercial word processors in its responsiveness, what you type is usually markup, which typically defines a logical diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reallyblank.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reallyblank.html index 47a0a9fe574..dc398f1dabe 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reallyblank.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reallyblank.html @@ -52,10 +52,10 @@ being an equivalent of \cleardoublepage). One can ach commands will also serve if you want the surreal effect of “This page intentionally left blank” in the centre of an otherwise empty page.

    -
    fancyhdr
    macros/latex/contrib/fancyhdr (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    nextpage.sty
    macros/latex/contrib/misc/nextpage.sty -
    scrbook.cls, scrrept.cls
    Part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    fancyhdr
    macros/latex/contrib/fancyhdr (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    nextpage.sty
    macros/latex/contrib/misc/nextpage.sty +
    scrbook.cls, scrrept.cls
    Part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=reallyblank diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-recovertex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-recovertex.html index 9d9ae11ad33..7cab595fe98 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-recovertex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-recovertex.html @@ -42,11 +42,11 @@ also arise from the oddity of typical TeX font encodings (notably those of the maths fonts), which Acrobat doesn’t know how to map to its standard Unicode representation.

    -
    catdvi
    dviware/catdvi (gzipped tar, browse) -
    crudetype
    dviware/crudetype (gzipped tar, browse) -
    dvi2tty
    dviware/dvi2tty (gzipped tar, browse) -
    ghostscript
    Browse support/ghostscript/ -
    xpdf
    Browse support/xpdf/ +
    catdvi
    dviware/catdvi (or browse the directory) +
    crudetype
    dviware/crudetype (or browse the directory) +
    dvi2tty
    dviware/dvi2tty (or browse the directory) +
    ghostscript
    Browse support/ghostscript/ +
    xpdf
    Browse support/xpdf/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=recovertex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ref-doc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ref-doc.html index 6b55c4319d0..1e1ae0d85b3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ref-doc.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-ref-doc.html @@ -12,12 +12,22 @@ link for each control sequence, that leads you to a detailed description, which includes page references to the TeXbook.

    There doesn’t seem to be a reference that takes in Plain TeX as well as the primitive commands. +

    An interesting LaTeX “cheat sheet” is available from CTAN: +it’s a list of (more or less) everything you ‘ought to’ remember, for +basic LaTeX use. (It’s laid out very compactly for printing on N.\ +American ‘letter’; printed on ISO A4, it strains aged eyes...)

    Similarly, there’s no completely reliable command-organised reference -to LaTeX, but the NASA +to LaTeX. The page (provided by NASA) Hypertext Help with LaTeX is recently much improved. It still talks in LaTeX 2.09-isms in places, -but it’s been updated for current LaTeX; there are a number of +but it’s been updated for current LaTeX. There are a number of mirrors of the site, and it may be worth choosing a “local” one if you’re going to use it a lot. +

    Another LaTeX2e reference (provided by the Emerson Center of Emory +University) is: +LaTeXe help +

    +
    Cheat sheet
    info/latexcheat/latexcheat/latexsheet.pdf +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=ref-doc diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repeatgrf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repeatgrf.html index 8689aa5a640..f63d981ebfa 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repeatgrf.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repeatgrf.html @@ -59,7 +59,7 @@ objects whether or not the PostScript has them amalgamated. PDFTeX does the same job with graphics, automatically converting multiple uses into references to graphics objects.

    -
    graphicx-psmin.sty
    macros/latex/contrib/graphicx-psmin (gzipped tar, browse) +
    graphicx-psmin.sty
    macros/latex/contrib/graphicx-psmin (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=repeatgrf diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repfootnote.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repfootnote.html index ae3ebeb8d5f..2ddf23e2dd4 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repfootnote.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-repfootnote.html @@ -77,9 +77,9 @@ The package ensures that the repeated text appears at most once per page: it will usually take more than one run of LaTeX to get rid of the repeats.

    -
    fixfoot.sty
    macros/latex/contrib/fixfoot (gzipped tar, browse) -
    footmisc.sty
    macros/latex/contrib/footmisc (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    fixfoot.sty
    macros/latex/contrib/fixfoot (or browse the directory) +
    footmisc.sty
    macros/latex/contrib/footmisc (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=repfootnote diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-replstdcls.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-replstdcls.html index 2588d3fcc3f..7bec8911b26 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-replstdcls.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-replstdcls.html @@ -28,10 +28,10 @@ and German (scrguien in the distribution for English, spoken of, and its lengthy introductory section is regularly recommended as a tutorial on typesetting.

    -
    KOMA-script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    NTGclass bundle
    macros/latex/contrib/ntgclass (gzipped tar, browse) -
    sober.sty
    macros/latex209/contrib/misc/sober.sty +
    KOMA-script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    NTGclass bundle
    macros/latex/contrib/ntgclass (or browse the directory) +
    sober.sty
    macros/latex209/contrib/misc/sober.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=replstdcls diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rerun.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rerun.html index 47c99b6788f..a4667839a70 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rerun.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rerun.html @@ -25,8 +25,8 @@ can obviously not terminate. document (something as small as adding or deleting a comma will often be enough).

    -
    footmisc.sty
    macros/latex/contrib/footmisc (gzipped tar, browse) -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) +
    footmisc.sty
    macros/latex/contrib/footmisc (or browse the directory) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=rerun diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-resolns.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-resolns.html index f4e5bcebd24..633c4c3bac0 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-resolns.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-resolns.html @@ -1,7 +1,7 @@ UK TeX FAQ -- question label resolns -

    What are “resolutions”

    +

    What are “resolutions”?

    “Resolution” is a word that is used with little concern for its multiple meanings, in computer equipment marketing. The word suggests a measure of what an observer (perhaps the human eye) can resolve; yet diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reuseq.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reuseq.html index 67f62f82ec1..46368c078b7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reuseq.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-reuseq.html @@ -29,9 +29,9 @@ first instance. at ftp://ftp.ams.org/pub/tex/doc/amsmath/amsldoc.pdf

    amsldoc.tex
    Distributed as part of AMSLaTeX - macros/latex/required/amslatex (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory)
    amsmath.sty
    Distributed as part of AMSLaTeX - macros/latex/required/amslatex (gzipped tar, browse) + macros/latex/required/amslatex (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=reuseq diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rulethk.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rulethk.html index 2f56abae1b7..469e996c22a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rulethk.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-rulethk.html @@ -45,8 +45,8 @@ horizontal rules, and if their lack of configurability makes them still less attractive, so much the better for the design of your document.

    -
    booktabs.sty
    macros/latex/contrib/booktabs (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) +
    booktabs.sty
    macros/latex/contrib/booktabs (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=rulethk diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-run-fn-nos.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-run-fn-nos.html index 452c465d1d5..535690ab9df 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-run-fn-nos.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-run-fn-nos.html @@ -19,7 +19,7 @@ variant; the code:

    is all you need

    -
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty +
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=run-fn-nos diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-runheadtoobig.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-runheadtoobig.html index dd45e61d98b..598c6c22cb2 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-runheadtoobig.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-runheadtoobig.html @@ -75,10 +75,10 @@ example: As a result, it is always possible for users of memoir to tailor the header text to fit, with very little trouble.

    -
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    titlesec.sty
    macros/latex/contrib/titlesec (gzipped tar, browse) +
    fancyhdr.sty
    macros/latex/contrib/fancyhdr (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    titlesec.sty
    macros/latex/contrib/titlesec (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=runheadtoobig diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-running-nos.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-running-nos.html index 35460003b8b..61fee569b15 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-running-nos.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-running-nos.html @@ -68,12 +68,12 @@ numbered per chapter, try:

    (the command \@addtoreset is a part of LaTeX itself).

    -
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    removefr.tex
    macros/latex/contrib/fragments/removefr.tex (note, this is constructed as a +
    chngcntr.sty
    macros/latex/contrib/misc/chngcntr.sty +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    removefr.tex
    macros/latex/contrib/fragments/removefr.tex (note, this is constructed as a “fragment” for use within other packages: load by \input{removefr}) -
    remreset.sty
    Distributed as part of macros/latex/contrib/carlisle (gzipped tar, browse) +
    remreset.sty
    Distributed as part of macros/latex/contrib/carlisle (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=running-nos diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-scriptfonts.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-scriptfonts.html index f0b21c4a397..8e5a7800b34 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-scriptfonts.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-scriptfonts.html @@ -14,10 +14,9 @@ modern TeX distributions. distribution.

    RSFS
    The mathrsfs package uses a really fancy script font (the name stands for “Ralph Smith’s Formal Script”) which is - already part of most modern TeX distributions. The package + already part of most modern TeX distributions (Type 1 versions of + the font are also provided, courtesy of Taco Hoekwater). The package creates a new command \mathscr. -

    Type 1 versions of the font have been made available by Taco - Hoekwater.

    Zapf Chancery
    is the standard PostScript calligraphic font. There is no package but you can easily make it available by means of the command @@ -37,19 +36,20 @@ modern TeX distributions.

    Adobe Zapf Chancery (which the above examples use) is distributed in any but the most basic PostScript printers. A substantially identical font (to the extent that the same metrics may be used) is - available from URW and is distributed with - ghostscript. + available from URW, called URW Chancery L: it is distributed + with Ghostscript, and as part of the “URW base35” bundle, which is + available in most distributions. Examples of the available styles are available on CTAN.

    -
    eucal.sty
    fonts/amsfonts/latex/eucal.sty -
    euler fonts
    fonts/amsfonts/sources/euler (gzipped tar, browse) -
    euler fonts, in Type 1 format
    fonts/amsfonts/ps-type1/ -
    ghostscript
    Browse support/ghostscript/ -
    mathrsfs.sty
    Distributed as part of macros/latex/contrib/jknappen (gzipped tar, browse) -
    rsfs fonts
    fonts/rsfs (gzipped tar, browse) -
    rsfs fonts, in Type 1 format
    fonts/rsfs/ps-type1/hoekwater (gzipped tar, browse) -
    Script font examples
    info/symbols/math/scriptfonts.pdf +
    eucal.sty
    fonts/amsfonts/latex/eucal.sty +
    euler fonts
    fonts/amsfonts/sources/euler (or browse the directory) +
    euler fonts, in Type 1 format
    fonts/amsfonts/ps-type1/ +
    ghostscript
    Browse support/ghostscript/ +
    mathrsfs.sty
    Distributed as part of macros/latex/contrib/jknappen (or browse the directory) +
    rsfs fonts
    fonts/rsfs (or browse the directory) +
    Script font examples
    info/symbols/math/scriptfonts.pdf +
    URW Chancery L
    Distributed as part of fonts/urw/base35 (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=scriptfonts diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-seccntfmt.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-seccntfmt.html index 76dcaabad19..22620f9e201 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-seccntfmt.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-seccntfmt.html @@ -65,7 +65,7 @@ changes to section number presentation: \partformat, \chapterformat and \othersectionlevelsformat, but otherwise their facilities are similar to those of “raw” LaTeX.

    -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=seccntfmt diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secindent.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secindent.html index ae503fd40c2..c8bd1d44fc1 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secindent.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secindent.html @@ -9,7 +9,7 @@ The indentfirst package suppresses the mechanism, so that the first paragraph is indented.

    -
    indentfirst.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    indentfirst.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=secindent diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secnumdep.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secnumdep.html index e708dbdc7ef..2e9acd39ec6 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secnumdep.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secnumdep.html @@ -49,11 +49,11 @@ aren’t numbered. The memoir class incorporates the facilities of all three of the abstract, tocbibind and tocvsec2 packages.

    -
    abstract.sty
    macros/latex/contrib/abstract (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    tocbibind.sty
    macros/latex/contrib/tocbibind (gzipped tar, browse) -
    tocvsec2.sty
    macros/latex/contrib/tocvsec2 (gzipped tar, browse) +
    abstract.sty
    macros/latex/contrib/abstract (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    tocbibind.sty
    macros/latex/contrib/tocbibind (or browse the directory) +
    tocvsec2.sty
    macros/latex/contrib/tocvsec2 (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=secnumdep diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secthead.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secthead.html index fd1d5e84288..eecfc7e25df 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secthead.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-secthead.html @@ -52,16 +52,16 @@ to program alternative chapter heading styles and section heading styles. -The web pages are not useful to users unless they are willing to do -their own LaTeX programming. +The web pages provide programming examples, and expect users to adapt +them to their own LaTeX use.

    -
    anonchap.sty
    macros/latex/contrib/misc/anonchap.sty -
    fncychap.sty
    macros/latex/contrib/fncychap (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    sectsty.sty
    macros/latex/contrib/sectsty (gzipped tar, browse) -
    titlesec.sty
    macros/latex/contrib/titlesec (gzipped tar, browse) -
    tocbibind.sty
    macros/latex/contrib/tocbibind (gzipped tar, browse) +
    anonchap.sty
    macros/latex/contrib/misc/anonchap.sty +
    fncychap.sty
    macros/latex/contrib/fncychap (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    sectsty.sty
    macros/latex/contrib/sectsty (or browse the directory) +
    titlesec.sty
    macros/latex/contrib/titlesec (or browse the directory) +
    tocbibind.sty
    macros/latex/contrib/tocbibind (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=secthead diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html index c9e444ad6a8..7c9dbac727d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-setURL.html @@ -27,9 +27,16 @@ representation is awful. maths mode. It can produce (LaTeX-style) ‘robust’ commands (see use of \protect) for use - within moving arguments. Note that, because the operation is - conducted in maths mode, spaces within the URL argument are - ignored unless special steps are taken. + within moving arguments. +

    The package ordinarily ignores spaces in the URL, but + unfortunately URLs that contain spaces do exist; to typeset + them, call the package with the obeyspaces option. Two + other useful options allow line breaks in the URL in places + where they are ordinarily suppressed to avoid confusion: + spaces to allow breaks at spaces (note, this requires + obeyspaces as well, and hyphens to allow + breaks after hyphens. (Note that the package never does + “ordinary” hyphenation of names inside an URL.)

    It is possible to use the url package in Plain TeX, with the assistance of the miniltx package (which was originally developed for using the LaTeX graphics package in @@ -63,10 +70,10 @@ after which, \faqhome is robust.

    Documentation of both package path and package url is in the package files.

    -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    miniltx.tex
    Distributed as part of macros/plain/graphics (gzipped tar, browse) -
    path.sty
    macros/latex/contrib/misc/path.sty -
    url.sty
    macros/latex/contrib/misc/url.sty +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    miniltx.tex
    Distributed as part of macros/plain/graphics (or browse the directory) +
    path.sty
    macros/latex/contrib/misc/path.sty +
    url.sty
    macros/latex/contrib/misc/url.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=setURL diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slashbox.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slashbox.html index a209eb2eb06..cd6c11f1b96 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slashbox.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slashbox.html @@ -46,7 +46,7 @@ go from corner to corner in the box: to correct this requires revision of slashboxpict2e alone doesn’t help in this regard.)

    -
    slashbox.sty
    macros/latex/contrib/slashbox (gzipped tar, browse) +
    slashbox.sty
    macros/latex/contrib/slashbox (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=slashbox diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slidecls.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slidecls.html index 2cec4a4dcc4..d4992bafcd8 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slidecls.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-slidecls.html @@ -68,20 +68,20 @@ available, with examples, in http://wiki.contextgarden.net/Presentation_Styles

    -
    beamer.cls
    Download all of macros/latex/contrib/beamer (gzipped tar, browse) -
    foils.cls
    macros/latex/contrib/foiltex (gzipped tar, browse) -
    greybars.sty
    distributed with macros/latex/contrib/talk (gzipped tar, browse) -
    HA-prosper.sty
    macros/latex/contrib/ha-prosper (gzipped tar, browse) +
    beamer.cls
    Download all of macros/latex/contrib/beamer (or browse the directory) +
    foils.cls
    macros/latex/contrib/foiltex (or browse the directory) +
    greybars.sty
    distributed with macros/latex/contrib/talk (or browse the directory) +
    HA-prosper.sty
    macros/latex/contrib/ha-prosper (or browse the directory) -
    seminar.cls
    macros/latex/contrib/seminar (gzipped tar, browse) -
    pgf.sty
    graphics/pgf (gzipped tar, browse) -
    powerdot.cls
    macros/latex/contrib/powerdot (gzipped tar, browse) -
    pp4
    support/ppower4 (gzipped tar, browse) -
    ppr-prv.sty
    macros/latex/contrib/ppr-prv (gzipped tar, browse) -
    prosper.cls
    macros/latex/contrib/prosper (gzipped tar, browse) -
    talk.cls
    macros/latex/contrib/talk (gzipped tar, browse) -
    texpower
    macros/latex/contrib/texpower (gzipped tar, browse) -
    xcolor.sty
    macros/latex/contrib/xcolor (gzipped tar, browse) +
    seminar.cls
    macros/latex/contrib/seminar (or browse the directory) +
    pgf.sty
    graphics/pgf (or browse the directory) +
    powerdot.cls
    macros/latex/contrib/powerdot (or browse the directory) +
    pp4
    support/ppower4 (or browse the directory) +
    ppr-prv.sty
    macros/latex/contrib/ppr-prv (or browse the directory) +
    prosper.cls
    macros/latex/contrib/prosper (or browse the directory) +
    talk.cls
    macros/latex/contrib/talk (or browse the directory) +
    texpower
    macros/latex/contrib/texpower (or browse the directory) +
    xcolor.sty
    macros/latex/contrib/xcolor (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=slidecls diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-spell.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-spell.html index ae6333b3514..f43c7c08ef7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-spell.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-spell.html @@ -21,16 +21,16 @@ some important features of LaTeX syntax. called from within an editor, and jspell is an extended version of ispell.

    -
    4spell
    support/4spell (gzipped tar, browse) -
    amspell
    support/amspell (gzipped tar, browse) -
    aspell
    Browse support/aspell/ — choose just those language +
    4spell
    support/4spell (or browse the directory) +
    amspell
    support/amspell (or browse the directory) +
    aspell
    Browse support/aspell/ — choose just those language dictionaries (under subdirectory dict/) that you need. -
    excalibur
    systems/mac/support/excalibur/Excalibur-4.0.2.sit.hqx -
    ispell
    support/ispell/ispell-3.2.06.tar.gz -
    jspell
    support/jspell (gzipped tar, browse) +
    excalibur
    systems/mac/support/excalibur/Excalibur-4.0.2.sit.hqx +
    ispell
    support/ispell/ispell-3.2.06.tar.gz +
    jspell
    support/jspell (or browse the directory)
    VMS spell
    - support/vmspell (gzipped tar, browse) -
    winedt
    systems/win32/winedt/ + support/vmspell (or browse the directory) +
    winedt
    systems/win32/winedt/

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=spell diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-splitfoot.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-splitfoot.html index a88f7736c8a..2abec7eed21 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-splitfoot.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-splitfoot.html @@ -38,7 +38,7 @@ one page.

    The fnbreak package detects (and generates warnings about) split footnotes.

    -
    fnbreak.sty
    macros/latex/contrib/fnbreak (gzipped tar, browse) +
    fnbreak.sty
    macros/latex/contrib/fnbreak (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=splitfoot diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-srchpdf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-srchpdf.html index 2ac60dbd765..f95bc5c506d 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-srchpdf.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-srchpdf.html @@ -27,8 +27,8 @@ encoded, such as the cm-super distribution. Fonts like Adobe Times Roman (which are encoded for (La)TeX use via virtual fonts) are not amenable to this treatment.

    -
    cmap.sty
    macros/latex/contrib/cmap (gzipped tar, browse) -
    cm-super fonts
    fonts/ps-type1/cm-super (gzipped tar, browse) +
    cmap.sty
    macros/latex/contrib/cmap (or browse the directory) +
    cm-super fonts
    fonts/ps-type1/cm-super (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=srchpdf diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-struttab.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-struttab.html index 670afd22834..0b327116ca7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-struttab.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-struttab.html @@ -69,11 +69,11 @@ packages such as longtable.

    Documentation of both bigstrut and tabls may be found as comments in the package files themselves.

    -
    array.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) -
    bigstrut.sty
    Distributed as part of macros/latex/contrib/multirow (gzipped tar, browse) -
    booktabs.sty
    macros/latex/contrib/booktabs (gzipped tar, browse) -
    cellspace.sty
    macros/latex/contrib/cellspace (gzipped tar, browse) -
    tabls.sty
    macros/latex/contrib/misc/tabls.sty +
    array.sty
    Distributed as part of macros/latex/required/tools (or browse the directory) +
    bigstrut.sty
    Distributed as part of macros/latex/contrib/multirow (or browse the directory) +
    booktabs.sty
    macros/latex/contrib/booktabs (or browse the directory) +
    cellspace.sty
    macros/latex/contrib/cellspace (or browse the directory) +
    tabls.sty
    macros/latex/contrib/misc/tabls.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=struttab diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-subsubsub.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-subsubsub.html index b93f11eb629..a8220a44101 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-subsubsub.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-subsubsub.html @@ -26,8 +26,8 @@ LaTeX distribution) and the source of the standard packages (classes.dtx). The LaTeX Companion discusses use of \@startsection for this sort of thing.

    -
    LaTeX source
    macros/latex/base (gzipped tar, browse) -
    titlesec.sty
    macros/latex/contrib/titlesec (gzipped tar, browse) +
    LaTeX source
    macros/latex/base (or browse the directory) +
    titlesec.sty
    macros/latex/contrib/titlesec (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=subsubsub diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-symbols.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-symbols.html index 455acf5f569..719785c5fe5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-symbols.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-symbols.html @@ -10,7 +10,7 @@ of which are not shown (or even mentioned) in (La)TeX books. The Comprehensive LaTeX Symbol List (by Scott Pakin et al.) illustrates over 2000 symbols, and details the -commands and packages needed to produce them. +commands and the LaTeX packages needed to produce them.

    Other questions in this FAQ offer specific help on kinds of symbols:

    -
    Symbol List
    Browse info/symbols/comprehensive/; there are processed +
    Symbol List
    Browse info/symbols/comprehensive/; there are processed versions in both PostScript and PDF forms for both A4 and letter paper.
    diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabacc.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabacc.html index 5b1e5fd09f1..fee3f89401c 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabacc.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabacc.html @@ -46,7 +46,7 @@ example would therefore become:

    -
    Tabbing.sty
    macros/latex/contrib/Tabbing (gzipped tar, browse) +
    Tabbing.sty
    macros/latex/contrib/Tabbing (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tabacc diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabcellalign.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabcellalign.html index 5687db12009..928e19b1a20 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabcellalign.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tabcellalign.html @@ -66,7 +66,7 @@ or in the preamble as:

    -
    array.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    array.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tabcellalign diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds-zip.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds-zip.html index bb2d5cbea86..20301b28e5f 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds-zip.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds-zip.html @@ -1,7 +1,7 @@ UK TeX FAQ -- question label tds-zip -

    Prebuilt installation files on the archive

    +

    Ready-built installation files on the archive

    The TDS is a simple structure, and almost all files can be installed simply by putting them in the “right” place, and updating a single index. (Note, this simple idea typically @@ -10,10 +10,15 @@ doesn’t work for fonts, unless they’re distributed as Metafont sourc which have a built-in directory structure that matches the TDS. These files have to be built, and the CTAN team has asked that package authors supply them (the team will advise, of course, if the -author has trouble). Everyone hopes that the extra work involved will -contrinute to happier lives for package users, which in turn must -surely help keep the TeX community lively and active. +author has trouble). The CTAN team hopes that the extra work +involved will contribute to happier lives for package users, which in +turn must surely help keep the TeX community lively and active. +

    At the time of writing, there are rather few .tds.zip +files (by comparison with the huge number of packages that are +available). As packages are updated, the number of files is +steadily increasing, but it will be a long time before the whole set +is covered.

    Use of the files is discussed in -“installing using preformatted ZIP files”. +“installing using ready-built ZIP files”.

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds-zip diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds.html index e02bfeab6fe..bcfcbc93c3a 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tds.html @@ -29,7 +29,7 @@ You may browse an on-line version of the standard, and copies in several other formats (including source) are available on CTAN.

    -
    TDS specification
    tds (gzipped tar, browse) +
    TDS specification
    tds (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tds diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texcad.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texcad.html index 2a000e3c3b6..23f50dced73 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texcad.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texcad.html @@ -13,8 +13,8 @@ the emTeX driver-family TeXCAD is part of the emTeX distribution.

    A Unix port of the program (xtexcad) has been made.

    -
    emtex
    systems/msdos/emtex (gzipped tar, browse) -
    xtexcad
    nonfree/graphics/xtexcad/xtexcad-2.4.1.tar.gz +
    emtex
    systems/msdos/emtex (or browse the directory) +
    xtexcad
    nonfree/graphics/xtexcad/xtexcad-2.4.1.tar.gz

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=texcad diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texinfo.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texinfo.html index d7149ff4db7..cff7f094121 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texinfo.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texinfo.html @@ -27,7 +27,7 @@ avoided.

    Finally, of course, you can also print the files, or convert them to PDF using PDFTeX.

    -
    Texinfo distribution
    macros/texinfo/texinfo (gzipped tar, browse) +
    Texinfo distribution
    macros/texinfo/texinfo (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=texinfo diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texorpdf.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texorpdf.html new file mode 100644 index 00000000000..a447959c26d --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texorpdf.html @@ -0,0 +1,45 @@ + +UK TeX FAQ -- question label texorpdf + +

    Token not allowed in PDFDocEncoded string

    +

    The package hyperref produces this error when it doesn’t +know how to make something into a “character” that will go into one +of its PDF entries. For example, the (unlikely) sequence +

    +
    +\newcommand{\filled}[2]{%
    +  #1%
    +  \hfil
    +  #2%
    +}
    +\section{\filled{foo}{bar}}
    +
    +

    +provokes the error. Hyperref goes on to tell you: +

    +
    +removing `\hfil' on input line ...
    +
    +

    +It’s not surprising: how would you put the +typesetting instruction \hfil into a PDF bookmark? +

    Hyperref allows you to define an alternative for such +things: the command \texorpdfstring, which takes two +arguments — the first is what is typeset, the second is what is put +into the bookmark. For example, what you would probably like in this +case is just a single space in the bookmark; if so, the erroneous +example above would become: +

    +
    +\newcommand{\filled}[2]{%
    +  #1%
    +  \texorpdfstring{\hfil}{\space}%
    +  #2%
    +}
    +\section{\filled{foo}{bar}}
    +
    +

    +and with that definition, the example will compile succesfully +(hyperref knows about the macro \space). +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=texorpdf + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textflow.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textflow.html index 625db53d66d..d97c88c01ca 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textflow.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textflow.html @@ -64,10 +64,10 @@ LaTeX document). a summary in English.

    -
    floatflt.sty
    macros/latex/contrib/floatflt (gzipped tar, browse) -
    picins.sty
    macros/latex209/contrib/picins (gzipped tar, browse) -
    picins documentation summary
    macros/latex209/contrib/picins/picins.txt -
    wrapfig.sty
    macros/latex/contrib/wrapfig (gzipped tar, browse) +
    floatflt.sty
    macros/latex/contrib/floatflt (or browse the directory) +
    picins.sty
    macros/latex209/contrib/picins (or browse the directory) +
    picins documentation summary
    macros/latex209/contrib/picins/picins.txt +
    wrapfig.sty
    macros/latex/contrib/wrapfig (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=textflow diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texthings.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texthings.html new file mode 100644 index 00000000000..4388082f856 --- /dev/null +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-texthings.html @@ -0,0 +1,169 @@ + +UK TeX FAQ -- question label texthings + +

    Things with “TeX” in the name

    +

    New TeX users are often baffled by the myriad terms with “TeX” +in the name. The goal of this answer is to clarify some of the more +common TeX terms. +

    TeX itself   +TeX proper is a typesetting system based on a set of low-level +control sequences that instruct TeX how to lay out text on the +page. For example, \hskip inserts a given amount of horizontal +space into the document, and \font makes a given font available +to TeX. TeX is fully programmable using an integrated macro +scripting language that supports variables, scoping, conditional +execution, control flow, and function (really, macro) definitions. +See +What is TeX? for some background +information on TeX and +Reference documents for pointers to +descriptions of TeX control sequences, data types, and other key +parts of TeX. +

    TeX macro packages (a.k.a. TeX formats)   +TeX’s control sequences are tedious to use directly; they are +intended primarily as building blocks for higher-level—and therefore +more user-friendly—abstractions. For example, there is no way in +base TeX to specify that a piece of text should be typeset in a +larger font. Instead, one must keep track of the current size and +typeface, load a new font with the same typeface but a (specified) +larger size, and tell TeX to use that new font until instructed +otherwise. Fortunately, because TeX is programmable, it is +possible to write a macro that hides this complexity behind a simple, +new control sequence. For example, + +\larger{my text} can be defined to typeset “my text” in +the next larger font). +

    While some users write their own, perfectly customized set of +macros—which they then typically reuse across many documents—it is +far more common to rely upon a macro package, a collection of +TeX macros written by experts. For the user’s convenience, these +macro packages are often combined with the base TeX engine into a +standalone executable. The following are some of that macro packages +that you are likely to encounter: +

    +
    Plain TeX (executable: tex)
    + See + Books on TeX and its relations, + Online introductions: TeX, + Should I use Plain TeX or LaTeX? and + Freely available (La)TeX books. + Note that the Plain TeX executable is called tex; the + base TeX engine is generally provided by a separate executable + such as initex or as a -ini flag to + tex. +

    LaTeX (executable: latex)
    + See + Books on TeX and its relations, + (La)TeX Tutorials, etc., + Online introductions: LaTeX, + Specialized (La)TeX tutorials and + Directories of (La)TeX information. + Note that there have been two major versions of LaTeX: LaTeX2e + refers to the current version of LaTeX while LaTeX 2.09 is the + long-since-obsolete (since 1994) version (cf. + What is LaTeX2e? for more information). +

    ConTeXt (executable: texexec)
    + See + What is ConTeXt?. +

    Texinfo (executables: tex, makeinfo)
    + See + What is Texinfo?. makeinfo + converts Texinfo documents to HTML, DocBook, Emacs info, + XML, and plain text. Tex (or wrappers such as + texi2pdf and texi2pdf) produce one of TeX’s + usual output formats such as DVI or PDF. Because + tex loads the Plain TeX macros, not the Texinfo ones, + a Texinfo document must begin with \input{texinfo} to + explicitly load the Texinfo macro package. +

    Eplain—Extended Plain TeX (executable: eplain)
    + See + What is Eplain?. +
    +

    Modified tex   executables +The original tex executable was produced in the late 1970s +(cf. What is TeX?) and consequently +lacked some features that users have come to expect from today’s +software. The following programs address these issues by augmenting +the TeX engine with some additional useful features: +

    +
    PDFTeX (executable: pdftex)
    + TeX, which predates the PDF file format by a decade, + outputs files in a TeX-specific format called DVI + (cf. What is a DVI file?). In + contrast, PDFTeX can output both DVI and PDF + files. In PDF mode, it lets documents exploit various + PDF features such as hyperlinks, bookmarks, and annotations, + PDFTeX additionally supports two sophisticated micro-typographic + features: character protrusion and font expansion. See + What is PDFTeX?. +

    XeTeX (executable: xetex)
    + TeX not only predates all major font technologies in use today + (e.g., TrueType, OpenType, and PostScript Type 1) but also predates + the notion that fonts be included with an operating system. + Consequently, TeX uses its own font formats, which are + incompatible with anything a user is likely to have preinstalled. + XeTeX addresses this issue by enhancing TeX’s \font + control sequence to support all of the fonts made available by the + operating system. See + What is XeTeX?. +

    LuaTeX (executable: luatex)
    + TeX is programmed in its own, integrated, macro-based programming + language. Many users have criticized this language for being + needlessly difficult to program. LuaTeX addresses that criticism + by integrating a modern scripting language, Lua, into the base + TeX engine. See + What is LuaTeX?. +

    e-TeX (executable: etex)
    + e-TeX provides a number of features that are only indirectly + useful to end users but that can be immensely useful to package + developers. Consequently, there is an increasing number of macro + packages that require the use of e-TeX. (Note: Be careful not to + confuse e-TeX, which enhances the TeX engine, with Eplain, + which enhances the Plain TeX macro package.) See + What is e-TeX?. +
    +

    Because each of the above modifies only the base TeX engine, it is +possible to combine any of those with any of the TeX macro packages +listed earlier to produce executables with both sets of features. For +example, the pdflatex, xelatex and +lualatex executables each combine +LaTeX with an enhanced TeX engine. Some executables combine the +features of multiple enhanced TeX engine: pdfetex +combines PDFTeX and e-TeX into a single executable. +

    As combining features is a generally desirable tendency, current +TeX distributions (see below) incorporate the features of PDFTeX +and e-TeX into a single executable. This executable may be +offered with a LaTeX format (as latex or +pdflatex) or with a Plain TeX format (as +pdftex). (Tex remains with an unadorned TeX +executable using Plain TeX, for people such as Knuth himself, who +want the certainty of the “original”.) +

    TeX distributions   +A TeX distribution is a collection of TeX-related +software. Generally, a TeX distribution includes a set of core +TeX executables such as tex and latex; +various fonts optimized for use with TeX; helper programs such as +the BibTeX bibliographic-database formatter, editors, integrated +development environments, file-format-conversion programs; numerous +LaTeX packages; configuration tools; and any other goodies the +distributor chooses to include. Commonly encountered TeX +distributions include TeX Live, MiKTeX and MacTeX; older ones +include ozTeX, CMacTeX and teTeX. Some TeX +distributions target a specific operating system and/or processor +architecture; others run on multiple platforms. Some TeX +distributions are free; others require payment. See +(La)TeX for different machines for a +list of free and shareware TeX distributions and +Commercial TeX implementations for a +list of commercial TeX distributions. +

    Summary   +If your document begins with \documentclass, you’re using some +form of the LaTeX macro package. Even if hidden behind a button in +a TeX-aware GUI, this document is getting compiled by a TeX +executable—probably latex or pdflatex—to +produce an output file. The executable came bundled as part of a +TeX distribution such as MiKTeX, which includes various other +TeX-related components. + +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=texthings + diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textrace.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textrace.html index 129c1fe5838..fc6be497d44 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textrace.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-textrace.html @@ -35,7 +35,7 @@ Type 1 fonts. The first results, the well-established, and a bunch of existing designs have been reworked in MetaType1 format.

    -
    MetaType1
    fonts/utilities/metatype1 (gzipped tar, browse) +
    MetaType1
    fonts/utilities/metatype1 (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=textrace diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-theoremfmt.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-theoremfmt.html index ec873f2af47..3a2c28ac8d2 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-theoremfmt.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-theoremfmt.html @@ -21,9 +21,9 @@ Alternatively, the following sets up an environment The ntheorem package provides control of the fonts used by theorems, directly.

    -
    amsthm.sty
    Distributed as part of macros/latex/required/amslatex (gzipped tar, browse) -
    ntheorem.sty
    macros/latex/contrib/ntheorem (gzipped tar, browse) -
    theorem.sty
    Distributed as part of macros/latex/required/tools (gzipped tar, browse) +
    amsthm.sty
    Distributed as part of macros/latex/required/amslatex (or browse the directory) +
    ntheorem.sty
    macros/latex/contrib/ntheorem (or browse the directory) +
    theorem.sty
    Distributed as part of macros/latex/required/tools (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=theoremfmt diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-thesis.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-thesis.html index fe7573cc45a..4cd505fddf5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-thesis.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-thesis.html @@ -5,14 +5,14 @@

    Thesis styles are usually very specific to your University, so it’s usually not profitable to ask around for a package outside your own University. Since many Universities (in their eccentric way) still -require double-spacing, you may care to refer to -the relevant question. -If you want to write your own, a good place to start is the University -of California style, but it’s not worth going to a lot of trouble. (If -officials won’t allow standard typographic conventions, you won’t be -able to produce an æsthetically pleasing document anyway!) +require double-spaced thesis text, you may also need separately to set +up double spacing. +

    If you want to write a new thesis class of your own, a good place to +start is the University of California style, but remember that it’s +often difficult to produce a thesis that both looks good and conforms +with the style that your Univeristy demands.

    -
    UC thesis style
    macros/latex/contrib/ucthesis (gzipped tar, browse) +
    UC thesis style
    macros/latex/contrib/ucthesis (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=thesis diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-time.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-time.html index 6617bca3e6e..20b45407be5 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-time.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-time.html @@ -24,8 +24,8 @@ words). command also takes an optional argument, the character to separate the hours and minutes: the default is of course :.

    -
    datetime.sty
    macros/latex/contrib/datetime (gzipped tar, browse) -
    scrtime.sty
    Distributed as part of macros/latex/contrib/koma-script (gzipped tar, browse) +
    datetime.sty
    macros/latex/contrib/datetime (or browse the directory) +
    scrtime.sty
    Distributed as part of macros/latex/contrib/koma-script (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=time diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-titlsty.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-titlsty.html index 8d30d1c7ef1..16510f85404 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-titlsty.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-titlsty.html @@ -17,9 +17,9 @@ to program alternative The web page is not useful to users unless they are willing to do their own LaTeX programming.

    -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    titling.sty
    macros/latex/contrib/titling (gzipped tar, browse) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    titling.sty
    macros/latex/contrib/titling (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=titlsty diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tmupfl.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tmupfl.html index 681de21a071..93228659a58 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tmupfl.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tmupfl.html @@ -44,7 +44,7 @@ more floats, leading to the error. float package’s [H] float qualifier, but you are unlikely to get away without using \clearpage from time to time.

    -
    float.sty
    macros/latex/contrib/float (gzipped tar, browse) +
    float.sty
    macros/latex/contrib/float (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tmupfl diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toascii.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toascii.html index 39104b0ba0b..81240cec872 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toascii.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-toascii.html @@ -45,14 +45,14 @@ beings than the flat-style TeX code. and then to use a browser such as lynx to dump the resulting HTML as plain text.

    -
    catdvi
    dviware/catdvi (gzipped tar, browse) -
    crudetype
    dviware/crudetype (gzipped tar, browse) -
    detex
    support/detex (gzipped tar, browse) -
    dvi2tty
    dviware/dvi2tty (gzipped tar, browse) -
    l2a
    support/l2a (gzipped tar, browse) -
    screen.sty
    macros/latex209/contrib/misc/screen.sty -
    tex2mail
    support/tex2mail (gzipped tar, browse) -
    txt
    support/txt (gzipped tar, browse) +
    catdvi
    dviware/catdvi (or browse the directory) +
    crudetype
    dviware/crudetype (or browse the directory) +
    detex
    support/detex (or browse the directory) +
    dvi2tty
    dviware/dvi2tty (or browse the directory) +
    l2a
    support/l2a (or browse the directory) +
    screen.sty
    macros/latex209/contrib/misc/screen.sty +
    tex2mail
    support/tex2mail (or browse the directory) +
    txt
    support/txt (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=toascii diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocbibind.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocbibind.html index 4e8fc66bf64..97548fe7cc3 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocbibind.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocbibind.html @@ -53,10 +53,10 @@ as a set of class options (e.g., bibtotoc to add the bibliography to the table of contents); the memoir class includes tocbibind itself.

    -
    hyperref.sty
    macros/latex/contrib/hyperref (gzipped tar, browse) -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    tocbibind.sty
    macros/latex/contrib/tocbibind (gzipped tar, browse) +
    hyperref.sty
    macros/latex/contrib/hyperref (or browse the directory) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    tocbibind.sty
    macros/latex/contrib/tocbibind (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tocbibind diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocloft.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocloft.html index c82806db738..a40ed9df058 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocloft.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tocloft.html @@ -24,9 +24,9 @@ for the table of contents, and calculates the space needed for the numbers automatically. The memoir class includes the functionality of tocloft.

    -
    KOMA script bundle
    macros/latex/contrib/koma-script (gzipped tar, browse) -
    memoir.cls
    macros/latex/contrib/memoir (gzipped tar, browse) -
    tocloft.sty
    macros/latex/contrib/tocloft (gzipped tar, browse) +
    KOMA script bundle
    macros/latex/contrib/koma-script (or browse the directory) +
    memoir.cls
    macros/latex/contrib/memoir (or browse the directory) +
    tocloft.sty
    macros/latex/contrib/tocloft (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tocloft diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tradesyms.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tradesyms.html index dfea790f4fb..954f6abefd8 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tradesyms.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tradesyms.html @@ -25,6 +25,5 @@ errors: you must use \textsuperscript{\textregistered}

    -

    -

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tradesyms +

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tradesyms diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tutbitslatex.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tutbitslatex.html index eacc105e158..ff55f5f2dc8 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tutbitslatex.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-tutbitslatex.html @@ -5,8 +5,9 @@

    The AMS publishes a “Short Math Guide for LaTeX”, which is available (in several formats) via http://www.ams.org/tex/short-math-guide.html -

    Herbert Voss is developing a parallel document, that is also very -useful; it’s part of his “tips and tricks” and +

    Herbert Voss has written an extensive guide to mathematics in +LaTeX (a German version of which is published as a book). The +guide is part of his “tips and tricks” and a copy is maintained on CTAN.

    Two documents written more than ten years apart about font usage in @@ -31,7 +32,7 @@ soon”).

    Kjell Magne Fauske offers a set of examples of the use of the drawing packages PGF and TikZ; the -examples catalogue +examples catalogue includes examples (with output) from the package documentation as well as code written by the author himself.

    Vincent Zoonekynd provides a set of excellent (and graphic) tutorials @@ -84,9 +85,9 @@ deparment’s pages at

    Graphics in LaTeX2e
    the document is available in PostScript and PDF formats as - info/epslatex/english/epslatex.ps and info/epslatex/english/epslatex.pdf respectively -
    testflow
    macros/latex/contrib/IEEEtran/testflow/ -
    Herbert Voss’s Maths tutorial
    info/math/voss/mathmode/Mathmode.pdf + info/epslatex/english/epslatex.ps and info/epslatex/english/epslatex.pdf respectively +
    testflow
    macros/latex/contrib/IEEEtran/testflow/ +
    Herbert Voss’s Maths tutorial
    info/math/voss/mathmode/Mathmode.pdf

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=tutbitslatex diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-twooptarg.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-twooptarg.html index bb7b1a8208c..1d148d6af2e 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-twooptarg.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-twooptarg.html @@ -68,11 +68,11 @@ readily-understood language), and emits (La)TeX macros which enable the command to be defined. The command requires that a Python interpreter (etc.) be installed on your computer.

    -
    newcommand.py
    support/newcommand (gzipped tar, browse) -
    optparams.sty
    Distributed as part of macros/latex/contrib/sauerj (gzipped tar, browse) -
    twoopt.sty
    Distributed as part of macros/latex/contrib/oberdiek (gzipped tar, browse) -
    xargs.sty
    macros/latex/contrib/xargs (gzipped tar, browse) -
    xkeyval.sty
    macros/latex/contrib/xkeyval (gzipped tar, browse) +
    newcommand.py
    support/newcommand (or browse the directory) +
    optparams.sty
    Distributed as part of macros/latex/contrib/sauerj (or browse the directory) +
    twoopt.sty
    Distributed as part of macros/latex/contrib/oberdiek (or browse the directory) +
    xargs.sty
    macros/latex/contrib/xargs (or browse the directory) +
    xkeyval.sty
    macros/latex/contrib/xkeyval (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=twooptarg diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-type1T1.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-type1T1.html index cf1e34853d4..7e119d8a2a6 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-type1T1.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-type1T1.html @@ -91,16 +91,16 @@ Adobe’s Times family) you have to find a matching family of mathematical fonts, which is a non-trivial undertaking — see “choice of scalable fonts”.

    -
    ae fonts
    fonts/ae (gzipped tar, browse) -
    aecompl.sty
    Distributed with fonts/ae (gzipped tar, browse) -
    aeguill.sty
    macros/latex/contrib/aeguill (gzipped tar, browse) -
    BaKoMa fonts
    Browse systems/win32/bakoma/fonts/ -
    CM-LGC fonts
    fonts/ps-type1/cm-lgc (gzipped tar, browse) -
    CM-super fonts
    fonts/ps-type1/cm-super (gzipped tar, browse) (beware: +
    ae fonts
    fonts/ae (or browse the directory) +
    aecompl.sty
    Distributed with fonts/ae (or browse the directory) +
    aeguill.sty
    macros/latex/contrib/aeguill (or browse the directory) +
    BaKoMa fonts
    Browse systems/win32/bakoma/fonts/ +
    CM-LGC fonts
    fonts/ps-type1/cm-lgc (or browse the directory) +
    CM-super fonts
    fonts/ps-type1/cm-super (or browse the directory) (beware: very large download) -
    Latin Modern fonts
    fonts/lm (gzipped tar, browse) -
    tt2001 fonts
    fonts/ps-type1/tt2001 (gzipped tar, browse) -
    zefonts
    fonts/zefonts (gzipped tar, browse) +
    Latin Modern fonts
    fonts/lm (or browse the directory) +
    tt2001 fonts
    fonts/ps-type1/tt2001 (or browse the directory) +
    zefonts
    fonts/zefonts (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=type1T1 diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-typo-style.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-typo-style.html index 37d738baf04..125eebf8ba7 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-typo-style.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-typo-style.html @@ -2,6 +2,10 @@ UK TeX FAQ -- question label typo-style

    Typography tutorials

    +

    Peter Wilson’s manual for his memoir class has a lengthy +introductory section on typographic considerations, which is a fine +tutorial, written by someone who is aware of the issues as they apply +to (La)TeX users.

    There’s also (at least one) typographic style tutorial available on the Web, the excellent “Guidelines for Typography in NBCS”. @@ -14,12 +18,8 @@ ambition to supplant such excellent books as Bringhurst’s, but the document (though it does contain its Rutgers-local matter) is a fine introduction to the issues of producing readable documents. -

    Peter Wilson’s manual for his memoir class has a lengthy -introductory section on typographic considerations, which is a fine -tutorial, written by someone who is aware of the issues as they apply -to (La)TeX users.

    -
    memoir distribution
    macros/latex/contrib/memoir (gzipped tar, browse) +
    memoir distribution
    macros/latex/contrib/memoir (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=typo-style diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underline.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underline.html index f3d4e83a58d..bed08505430 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underline.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underline.html @@ -32,8 +32,8 @@ loading the package with: Documentation of ulem is in the package itself.

    -
    ulem.sty
    macros/latex/contrib/misc/ulem.sty -
    soul.sty
    macros/latex/contrib/soul (gzipped tar, browse) +
    ulem.sty
    macros/latex/contrib/misc/ulem.sty +
    soul.sty
    macros/latex/contrib/soul (or browse the directory)

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=underline diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underscore.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underscore.html index 6008a15a443..6f429744203 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underscore.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-underscore.html @@ -36,7 +36,7 @@ sense of the word), but it is robust under expansion (i.e., the LaTeX sense of the word); so use it with care, but don’t worry about section headings and the like.

    -
    underscore.sty
    macros/latex/contrib/misc/underscore.sty +
    underscore.sty
    macros/latex/contrib/misc/underscore.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=underscore diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-unkgrfextn.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-unkgrfextn.html index e7a74af855f..243e9c862e8 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-unkgrfextn.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-unkgrfextn.html @@ -58,7 +58,7 @@ unsatisfactory alternatives:

    -
    grffile.sty
    Distributed as part of the macros/latex/contrib/oberdiek (gzipped tar, browse) collection +
    grffile.sty
    Distributed as part of the macros/latex/contrib/oberdiek (or browse the directory) collection

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=unkgrfextn diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uploads.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uploads.html index ecce4105cf8..a7c22ad08bf 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uploads.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uploads.html @@ -57,7 +57,7 @@ contribution direct into the archive. At present this may only be done if your contribution is available via ftp, and of course the directory structure on your repository must ‘fit’.

    -
    README.uploads
    README.uploads +
    README.uploads
    README.uploads

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=uploads diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-upquot.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-upquot.html index 2a664630d7e..25f3ee117ab 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-upquot.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-upquot.html @@ -12,7 +12,7 @@ particularly in those of Unix-like shell scripts. The verbatim environment so that the output is a clearer representation of what the user must type.

    -
    upquote.sty
    macros/latex/contrib/upquote/upquote.sty +
    upquote.sty
    macros/latex/contrib/upquote/upquote.sty

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=upquot diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-useMF.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-useMF.html index d3eb8137324..87d2f2d6d84 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-useMF.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-useMF.html @@ -3,105 +3,116 @@

    Getting Metafont to do what you want

    Metafont allows you to create your own fonts, and most TeX users -will never need to use it. Metafont, unlike TeX, requires some -customisation: each output device for which you will be generating -fonts needs a mode associated with it. Modes are defined using the -mode_def convention described on page 94 of The Metafontbook +will never need to use it — modern (La)TeX systems contain +rather few Metafont fonts of any significance, and when Metafont output is +needed the font generation is done, automatically, “on the fly”. +

    If you find you have some special requirement that the system doesn’t +satisfy, you need to know about Metafont in rather more detail. Metafont, +unlike TeX, requires customisation for each output device: such +customisation is conventionally held in a “mode” associated with the +device. Modes are commonly defined using the mode_def +convention described on page 94 of The Metafontbook (see TeX-related books). You will need -a file, which conventionally called local.mf, containing all the -mode_defs you will be using. If local.mf doesn’t already -exist, Karl Berry’s collection of modes (modes.mf) -is a good starting point -(it can be used as a ‘local.mf’ without modification in a ‘big -enough’ implementation of Metafont). Lists of +a file, conventionally called local.mf, containing all the +mode_defs you will be using. In the unlikely event that +local.mf doesn’t already exist, Karl Berry’s collection of +modes (modes.mf) is a good starting point +(it can be used as a ‘local.mf’ without modification in a +typical modern implementation of Metafont). Lists of settings for various output devices are also published periodically in TUGboat (see TUG). Now create -a plain base -file using inimf, plain.mf, and local.mf: +a plain base file using mf (in “initialisation” +mode), plain.mf, and local.mf: +

    -   % inimf
    -   This is METAFONT...
    -   **plain # you type plain
    -   (output)
    -   *input local # you type this
    -   (output)
    -   *dump # you type this
    -   Beginning to dump on file plain...
    -   (output)
    +% mf -ini
    +This is METAFONT...
    +**plain # you type plain
    +(output)
    +*input local # you type this
    +(output)
    +*dump # you type this
    +Beginning to dump on file plain...
    +(output)
     
    +

    -This will create a base file named plain.base (or something -similar; for example, it will be - - PLAIN.BAS -on MSDOS systems) which should be moved to the directory containing -the base files on your system (note that some systems have two or more -such directories, one for each ‘size’ of Metafont used). +This will create a base file named plain.base +(or something similar; for example, it will be PLAIN.BAS +on MSDOS systems). Move the file to the directory containing +the base files on your system.

    Now you need to make sure Metafont loads this new base when it starts up. If Metafont loads the plain base by default on your system, then you’re -ready to go. Under Unix (using the default web2c -distribution -) -this does indeed happen, but we could for instance define a command -mf which executes virmf &plain loading the -plain base file. -

    The usual way to create a font with plain Metafont is to start -it with the +ready to go. Under Unix (using the default TeX Live (and earlier) +distributions this does indeed happen, but we could for instance +define a command plainmf + +which executes ‘mf -base=plain’ (or, in more traditional +style ‘mf &plain’) which loads the plain base +file. +

    The usual way to create a font with Metafont (with an appropriate base +file loaded) is to start Metafont’s input with the line

     \mode=<mode name>; mag=<magnification>; input <font file name>
     
    in response to the ‘**’ prompt or on the Metafont command line. (If -<mode name> is unknown or omitted, the mode defaults to ‘proof’ and -Metafont will produce an output file called - +<mode name> is unknown or omitted, the mode defaults to +‘proof’ mode and Metafont will produce an output file called <font file name>.2602gf) The <magnification> is a floating point number or ‘magstep’ (magsteps are defined in The Metafontbook and The TeXbook). If mag=<magnification> is omitted, then the default -is 1 (magstep 0). For example, to generate cmr10 at 12pt for an epson -printer you would type +is 1 (magstep 0). For example, to generate cmr10 at 12pt for an Epson +printer you might type +
    -  mf \mode=epson; mag=magstep 1; input cmr10
    +mf \mode=epson; mag=magstep 1; input cmr10
     
    +

    Note that under Unix the \ and ; characters must usually be quoted or escaped, so this would typically look something like +

      mf '\mode=epson; mag=magstep 1; input cmr10'
     
    -

    If you don’t have inimf or need a special mode that isn’t -in the base, you can put its commands in a file (e.g., -ln03.mf) and invoke it on the fly with the \smode command. -For example, to create cmr10.300gf for an LN03 printer, using -the file +

    +If you need a special mode that isn’t in the base, you can put its +commands in a file (e.g., ln03.mf) and invoke it on the +fly with the \smode command. For example, to create +cmr10.300gf for an LN03 printer, using the file +

    -   % This is ln03.mf as of 1990/02/27
    -   % mode_def courtesy of John Sauter
    -   proofing:=0;
    -   fontmaking:=1;
    -   tracingtitles:=0;
    -   pixels_per_inch:=300;
    -   blacker:=0.65;
    -   fillin:=-0.1;
    -   o_correction:=.5;
    +% This is ln03.mf as of 1990/02/27
    +% mode_def courtesy of John Sauter
    +proofing:=0;
    +fontmaking:=1;
    +tracingtitles:=0;
    +pixels_per_inch:=300;
    +blacker:=0.65;
    +fillin:=-0.1;
    +o_correction:=.5;
     
    +

    (note the absence of the mode_def and enddef commands), you would type +

    -   mf \smode="ln03"; input cmr10
    +mf \smode="ln03"; input cmr10
     
    +

    This technique isn’t one you should regularly use, but it may prove useful if you acquire a new printer and want to experiment with parameters, or for some other reason are regularly editing the parameters you’re using. Once you’ve settled on an appropriate set of parameters, you should use them to rebuild the base file that you use. -

    Other sources of help are mentioned in +

    Other sources of help are discussed in our list of Metafont and MetaPost Tutorials.

    -
    modes.mf
    fonts/modes/modes.mf +
    modes.mf
    fonts/modes/modes.mf

    This question on the Web: http://www.tex.ac.uk/cgi-bin/texfaq2html?label=useMF diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uselmfonts.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uselmfonts.html index c9beec26f7f..3bafe92ef36 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uselmfonts.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-uselmfonts.html @@ -23,8 +23,8 @@ files), but copy the other three into your existing Local update the filename database.

    Now, incorporate the fonts in the set searched by PDFLaTeX, -dvips, dvipdfm, your previewers and -Type 1-to-PK conversion programs, by +dvips, dvipdfm/dvipdfmx, your +previewers and Type 1-to-PK conversion programs, by