From 4bd653572e321c0a03ec5d592861c60d56e9aaf2 Mon Sep 17 00:00:00 2001 From: Peter Breitenlohner Date: Wed, 22 Dec 2010 12:48:01 +0000 Subject: move context manpages to texlive WIN32: skip tetex and contex shell scripts git-svn-id: svn://tug.org/texlive/trunk@20827 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/tetex/ChangeLog | 6 + Build/source/texk/tetex/Makefile.am | 11 +- Build/source/texk/tetex/Makefile.in | 78 +-- Build/source/texk/tetex/aclocal.m4 | 1 + Build/source/texk/tetex/configure | 62 +++ Build/source/texk/tetex/configure.ac | 5 +- Build/source/texk/tetex/context/ctxtools.man | 89 --- Build/source/texk/tetex/context/mptopdf.man | 104 ---- Build/source/texk/tetex/context/pstopdf.man | 75 --- Build/source/texk/tetex/context/texexec.man | 602 --------------------- Build/source/texk/tetex/context/texmfstart.man | 362 ------------- Build/source/texk/texlive/ChangeLog | 8 + Build/source/texk/texlive/Makefile.in | 3 +- Build/source/texk/texlive/aclocal.m4 | 1 + Build/source/texk/texlive/configure | 62 +++ Build/source/texk/texlive/configure.ac | 3 + Build/source/texk/texlive/context/Makefile.am | 13 +- Build/source/texk/texlive/context/Makefile.in | 130 +++-- Build/source/texk/texlive/context/ctxtools.man | 89 +++ Build/source/texk/texlive/context/mptopdf.man | 104 ++++ Build/source/texk/texlive/context/pstopdf.man | 75 +++ Build/source/texk/texlive/context/texexec.man | 602 +++++++++++++++++++++ Build/source/texk/texlive/context/texmfstart.man | 362 +++++++++++++ .../source/texk/texlive/linked_scripts/Makefile.in | 3 +- 24 files changed, 1533 insertions(+), 1317 deletions(-) delete mode 100644 Build/source/texk/tetex/context/ctxtools.man delete mode 100644 Build/source/texk/tetex/context/mptopdf.man delete mode 100644 Build/source/texk/tetex/context/pstopdf.man delete mode 100644 Build/source/texk/tetex/context/texexec.man delete mode 100644 Build/source/texk/tetex/context/texmfstart.man create mode 100644 Build/source/texk/texlive/context/ctxtools.man create mode 100644 Build/source/texk/texlive/context/mptopdf.man create mode 100644 Build/source/texk/texlive/context/pstopdf.man create mode 100644 Build/source/texk/texlive/context/texexec.man create mode 100644 Build/source/texk/texlive/context/texmfstart.man (limited to 'Build') diff --git a/Build/source/texk/tetex/ChangeLog b/Build/source/texk/tetex/ChangeLog index 54005de9eca..922a71b0e92 100644 --- a/Build/source/texk/tetex/ChangeLog +++ b/Build/source/texk/tetex/ChangeLog @@ -1,3 +1,9 @@ +2010-12-22 Peter Breitenlohner + + * configure.ac: Added KPSE_CHECK_WIN32. + * context/ (removed): Files moved to ../texlive/context/. + * Makefile.am: Adapted. + 2010-12-19 Peter Breitenlohner * ps4pdf: Removed, replaced by newer version under ../texlive/. diff --git a/Build/source/texk/tetex/Makefile.am b/Build/source/texk/tetex/Makefile.am index b8670a60b3b..16e28de2108 100644 --- a/Build/source/texk/tetex/Makefile.am +++ b/Build/source/texk/tetex/Makefile.am @@ -5,6 +5,7 @@ ## ACLOCAL_AMFLAGS = -I ../../m4 +if !WIN32 dist_bin_SCRIPTS = \ allcm \ allneeded \ @@ -25,16 +26,12 @@ dist_bin_SCRIPTS = \ texlinks \ updmap \ updmap-sys +endif !WIN32 dist_man1_MANS = \ allcm.man \ allec.man \ allneeded.man \ - context/ctxtools.man \ - context/mptopdf.man \ - context/pstopdf.man \ - context/texexec.man \ - context/texmfstart.man \ dvi2fax.man \ dvired.man \ e2pall.man \ @@ -96,6 +93,7 @@ man1_links = $(bin_links) \ updmap:updmap-sys install-exec-hook: +if !WIN32 @cd $(DESTDIR)$(bindir) && \ for s in $(bin_links); do \ link=`echo $$s | sed 's,.*:,,'`; \ @@ -104,6 +102,7 @@ install-exec-hook: echo "creating link '$$link' -> '$$file'"; \ $(LN_S) $$file $$link; \ done +endif !WIN32 install-data-hook: @cd $(DESTDIR)$(man1dir) && \ @@ -116,10 +115,12 @@ install-data-hook: done uninstall-hook: +if !WIN32 @for s in $(bin_links); do \ link=`echo $$s | sed 's,.*:,,'`; \ rm -f $(DESTDIR)$(bindir)/$$link; \ done +endif !WIN32 @for s in $(man1_links); do \ link=`echo $$s | sed 's,.*:,,'`; \ rm -f $(DESTDIR)$(man1dir)/$$link.1; \ diff --git a/Build/source/texk/tetex/Makefile.in b/Build/source/texk/tetex/Makefile.in index 906d0b5aea6..e4588fb2b13 100644 --- a/Build/source/texk/tetex/Makefile.in +++ b/Build/source/texk/tetex/Makefile.in @@ -34,7 +34,7 @@ NORMAL_UNINSTALL = : PRE_UNINSTALL = : POST_UNINSTALL = : subdir = . -DIST_COMMON = $(am__configure_deps) $(dist_bin_SCRIPTS) \ +DIST_COMMON = $(am__configure_deps) $(am__dist_bin_SCRIPTS_DIST) \ $(dist_man1_MANS) $(dist_man5_MANS) $(dist_tetexdoc_DATA) \ $(dist_texconfig_DATA) $(dist_texconfig_SCRIPTS) \ $(dist_web2c_DATA) $(nobase_dist_texconf_DATA) \ @@ -46,7 +46,8 @@ DIST_COMMON = $(am__configure_deps) $(dist_bin_SCRIPTS) \ ../../build-aux/ltmain.sh ../../build-aux/missing \ ../../build-aux/texinfo.tex ../../build-aux/ylwrap ChangeLog ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__aclocal_m4_deps = $(top_srcdir)/../../m4/kpse-win32.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \ @@ -54,6 +55,10 @@ am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \ mkinstalldirs = $(install_sh) -d CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +am__dist_bin_SCRIPTS_DIST = allcm allneeded dvi2fax dvired fmtutil \ + fmtutil-sys fontinst kpsetool kpsewhere ps2frag pslatex \ + rubibtex rumakeindex texconfig texconfig-dialog texconfig-sys \ + texlinks updmap updmap-sys am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; am__vpath_adj = case $$p in \ $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ @@ -185,36 +190,31 @@ top_build_prefix = @top_build_prefix@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ ACLOCAL_AMFLAGS = -I ../../m4 -dist_bin_SCRIPTS = \ - allcm \ - allneeded \ - dvi2fax \ - dvired \ - fmtutil \ - fmtutil-sys \ - fontinst \ - kpsetool \ - kpsewhere \ - ps2frag \ - pslatex \ - rubibtex \ - rumakeindex \ - texconfig \ - texconfig-dialog \ - texconfig-sys \ - texlinks \ - updmap \ - updmap-sys +@WIN32_FALSE@dist_bin_SCRIPTS = \ +@WIN32_FALSE@ allcm \ +@WIN32_FALSE@ allneeded \ +@WIN32_FALSE@ dvi2fax \ +@WIN32_FALSE@ dvired \ +@WIN32_FALSE@ fmtutil \ +@WIN32_FALSE@ fmtutil-sys \ +@WIN32_FALSE@ fontinst \ +@WIN32_FALSE@ kpsetool \ +@WIN32_FALSE@ kpsewhere \ +@WIN32_FALSE@ ps2frag \ +@WIN32_FALSE@ pslatex \ +@WIN32_FALSE@ rubibtex \ +@WIN32_FALSE@ rumakeindex \ +@WIN32_FALSE@ texconfig \ +@WIN32_FALSE@ texconfig-dialog \ +@WIN32_FALSE@ texconfig-sys \ +@WIN32_FALSE@ texlinks \ +@WIN32_FALSE@ updmap \ +@WIN32_FALSE@ updmap-sys dist_man1_MANS = \ allcm.man \ allec.man \ allneeded.man \ - context/ctxtools.man \ - context/mptopdf.man \ - context/pstopdf.man \ - context/texexec.man \ - context/texmfstart.man \ dvi2fax.man \ dvired.man \ e2pall.man \ @@ -838,14 +838,14 @@ uninstall-man: uninstall-man1 uninstall-man5 install-exec-hook: - @cd $(DESTDIR)$(bindir) && \ - for s in $(bin_links); do \ - link=`echo $$s | sed 's,.*:,,'`; \ - file=`echo $$s | sed 's,:.*,,'`; \ - rm -f $$link; \ - echo "creating link '$$link' -> '$$file'"; \ - $(LN_S) $$file $$link; \ - done +@WIN32_FALSE@ @cd $(DESTDIR)$(bindir) && \ +@WIN32_FALSE@ for s in $(bin_links); do \ +@WIN32_FALSE@ link=`echo $$s | sed 's,.*:,,'`; \ +@WIN32_FALSE@ file=`echo $$s | sed 's,:.*,,'`; \ +@WIN32_FALSE@ rm -f $$link; \ +@WIN32_FALSE@ echo "creating link '$$link' -> '$$file'"; \ +@WIN32_FALSE@ $(LN_S) $$file $$link; \ +@WIN32_FALSE@ done install-data-hook: @cd $(DESTDIR)$(man1dir) && \ @@ -858,10 +858,10 @@ install-data-hook: done uninstall-hook: - @for s in $(bin_links); do \ - link=`echo $$s | sed 's,.*:,,'`; \ - rm -f $(DESTDIR)$(bindir)/$$link; \ - done +@WIN32_FALSE@ @for s in $(bin_links); do \ +@WIN32_FALSE@ link=`echo $$s | sed 's,.*:,,'`; \ +@WIN32_FALSE@ rm -f $(DESTDIR)$(bindir)/$$link; \ +@WIN32_FALSE@ done @for s in $(man1_links); do \ link=`echo $$s | sed 's,.*:,,'`; \ rm -f $(DESTDIR)$(man1dir)/$$link.1; \ diff --git a/Build/source/texk/tetex/aclocal.m4 b/Build/source/texk/tetex/aclocal.m4 index 76a153698ad..f2dd15ba72f 100644 --- a/Build/source/texk/tetex/aclocal.m4 +++ b/Build/source/texk/tetex/aclocal.m4 @@ -989,3 +989,4 @@ AC_SUBST([am__tar]) AC_SUBST([am__untar]) ]) # _AM_PROG_TAR +m4_include([../../m4/kpse-win32.m4]) diff --git a/Build/source/texk/tetex/configure b/Build/source/texk/tetex/configure index c2c6007cfaf..41b7e6a67f5 100755 --- a/Build/source/texk/tetex/configure +++ b/Build/source/texk/tetex/configure @@ -569,6 +569,8 @@ ac_subst_vars='am__EXEEXT_FALSE am__EXEEXT_TRUE LTLIBOBJS LIBOBJS +WIN32_FALSE +WIN32_TRUE LN_S am__fastdepCC_FALSE am__fastdepCC_TRUE @@ -3322,6 +3324,62 @@ $as_echo "no" >&6; } fi + +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for native WIN32 or MINGW32" >&5 +$as_echo_n "checking for native WIN32 or MINGW32... " >&6; } +if ${kpse_cv_have_win32+:} false; then : + $as_echo_n "(cached) " >&6 +else + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#ifndef WIN32 + choke me +#endif +int +main () +{ + + ; + return 0; +} +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#ifndef __MINGW32__ + choke me +#endif +int +main () +{ + + ; + return 0; +} +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + kpse_cv_have_win32=mingw32 +else + kpse_cv_have_win32=native +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext +else + kpse_cv_have_win32=no +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $kpse_cv_have_win32" >&5 +$as_echo "$kpse_cv_have_win32" >&6; } + + if test "x$kpse_cv_have_win32" != xno; then + WIN32_TRUE= + WIN32_FALSE='#' +else + WIN32_TRUE='#' + WIN32_FALSE= +fi + + ac_config_files="$ac_config_files Makefile" @@ -3490,6 +3548,10 @@ if test -z "${am__fastdepCC_TRUE}" && test -z "${am__fastdepCC_FALSE}"; then as_fn_error $? "conditional \"am__fastdepCC\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 fi +if test -z "${WIN32_TRUE}" && test -z "${WIN32_FALSE}"; then + as_fn_error $? "conditional \"WIN32\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi : "${CONFIG_STATUS=./config.status}" ac_write_fail=0 diff --git a/Build/source/texk/tetex/configure.ac b/Build/source/texk/tetex/configure.ac index 8b20c1c3aee..c2e6d993be6 100644 --- a/Build/source/texk/tetex/configure.ac +++ b/Build/source/texk/tetex/configure.ac @@ -1,6 +1,6 @@ dnl Process this file with autoconf to produce a configure script. dnl -dnl Copyright (C) 2009 Peter Breitenlohner +dnl Copyright (C) 2009, 2010 Peter Breitenlohner dnl dnl This file is free software; the copyright holder dnl gives unlimited permission to copy and/or distribute it, @@ -20,6 +20,9 @@ AC_PROG_INSTALL AC_PROG_LN_S AC_PROG_MAKE_SET +KPSE_CHECK_WIN32 +AM_CONDITIONAL([WIN32], [test "x$kpse_cv_have_win32" != xno]) + AC_CONFIG_FILES([Makefile]) AC_OUTPUT diff --git a/Build/source/texk/tetex/context/ctxtools.man b/Build/source/texk/tetex/context/ctxtools.man deleted file mode 100644 index c22263d4267..00000000000 --- a/Build/source/texk/tetex/context/ctxtools.man +++ /dev/null @@ -1,89 +0,0 @@ -.de URL -\\$2 \(laURL: \\$1 \(ra\\$3 -.. -.if \n[.g] .mso www.tmac -.de EX -.in +3 -.nf -.ft CW -.. -.de EE -.in -3 -.ft R -.fi -.. -.TH CTXTOOLS "1" "January 2007" "ctxtools 1.3.3" "ConTeXt" - -.SH NAME -ctxtools \- clean up temporary ConTeXt files, install latest ConTeXt - -.SH "SYNOPSIS" -\fBctxtools\fP [ \fIOPTION\fP ... ] - -.SH DESCRIPTION -\fBctxtools\fP is useful for dealing with ConTeXt source and generated -files and for installing new versions of ConTeXt. - -.SH "OPTIONS" -.TP -.B --help -Print the available options. -.TP -.B --purgefiles -Get rid of many temporary files generated by ConTeXt. You can give the -.B --all -option to remove a larger fraction of those files, -and the -.B --recurse -option to remove these files also in subdirectories. -.TP -.B --contextversion -Show the date of the ConTeXt macros and the format file. Useful after -upgrading ConTeXt (perhaps using \fB--updatecontext\fP) to check -whether the new formats and macros are visible to the TeX path -searches (see -.BR kpsewhich (1). -.TP -.B --updatecontext -Download the latest ConTeXt distribution and install it in the -TEXMFLOCAL tree (see -.BR kpsewhich (1) -for information on -TeX path searching). TEXMFLOCAL usually points to a system-wide -location. If you want to install the new ConTeXt in your home -directory (i.e. an install for one user), then set the TEXMFLOCAL -environment variable while running -.BR ctxtools . -For example, using the syntax of the Bourne shell -.BR sh (1): -.EX -TEXMFLOCAL=$HOME/texmf ctxtools --updatecontext -.EE -.TP -.B --documentation -Generate a \fI.ted\fP file from the source file. See also the -\fB--module\fP option to -.BR texexec (1). -.TP -\fB--patternfiles\fP [languagecode] -Generate pattern files. You can also give the -\fB--all\fP, \fB--xml\fP, and \fB--utf8\fP options. - -.SH "ENVIRONMENT" -.TP -TEXMFLOCAL -Used by \f(CW--updatecontext\fP to decide where to install the distribution. - -.SH "SEE ALSO" -.PP -.BR texexec (1), -.BR texmfstart (1). -.PP -.URL "http://www.contextgarden.net" "ConTeXt wiki" . - -.SH BUGS -This manual page is not complete. - -.SH "AUTHOR" -This manual page was written by Sanjoy Mahajan . It is in -the public domain. diff --git a/Build/source/texk/tetex/context/mptopdf.man b/Build/source/texk/tetex/context/mptopdf.man deleted file mode 100644 index 3c547f06aa8..00000000000 --- a/Build/source/texk/tetex/context/mptopdf.man +++ /dev/null @@ -1,104 +0,0 @@ -.TH "MPTOPDF" "1" "January 2007" "mptopdf 1.3.2" "ConTeXt" -.de URL -\\$2 \(laURL: \\$1 \(ra\\$3 -.. -.if \n[.g] .mso www.tmac -.de EX -.in +3 -.nf -.ft CW -.. -.de EE -.in -3 -.ft R -.fi -.. - -.SH "NAME" -mptopdf \- convert MetaPost to PDF - -.SH "SYNOPSIS" -\fBmptopdf\fP \fIFILE\fP [ ... ] - -.SH "DESCRIPTION" - -\fBmptopdf\fP can convert MetaPost-generated EPS files to PDF, or it -can process a MetaPost source file directly (see -.BR mpost (1)) -and convert the generated EPS files to PDF. - -.SH "OPTIONS" -All switches are specified in full here but can be abbreviated to the -shortest unique prefix. Thus, \fB--metaf\fP works the same as -\fB--metafun\fP. -.IP \fB--help\fP -Print a terse help message. -.IP "\fB--metafun\fP" -Use the metafun pre-compiled format to process the MetaPost source -file. You usually don't need this option, since metafun input is -usually produced and processed as part of a -.BR texexec (1) -run. Needs the \fB--rawmp\fP switch to take effect. -.IP \fB--rawmp\fP -Process the source file with -.BR mpost (1) -directly, rather than with -.BR texexec (1). -This option is needed if you want to specify \fB--metafun\fP. -.IP \fB--latex\fP -Typeseting labels using -.BR latex (1) -rather than plain -.BR tex (1). - -.SH "USAGE" - -To convert \fImanfig.20\fP to \fImanfig-20.pdf\fI: -.EX -mptopdf manfig.20 -.EE - -You can convert more than one EPS file at once: -.EX -mptopdf manfig.20 otherfig.17 finalfig.8 -.EE - -Or you can give -.BR mptopdf (1) -a pattern that it will expand: -.EX -mptopdf 'manfig.*' -.EE -Note the single quotes to protect the * from the shell. Of course, -usually you can let the shell do the wildcard expansion and therefore -leave off the quotes. - -To convert -.I figs.mp -to \fIfigs-1.pdf\fP, \fIfigs-2.pdf\fP, ... -.EX -mptopdf figs.mp -.EE - -If the labels are typeset with -.BR latex (1): -.EX -mptopdf --latex figs.mp -.EE - -.SH "SEE ALSO" -.PP -.BR tex (1), -.BR latex (1), -.BR mpost (1), -.BR pdftex (1), -.BR texexec (1). -.PP -.URL "http://www.contextgarden.net" "ConTeXt wiki" . - -.SH "AUTHOR" -.BR mptopdf (1) -is part of the ConTeXt system by Hans Hagen et al, which is available from -.URL "http://www.pragma-ade.com/" "PRAGMA ADE" . -This manpage was written by Sanjoy Mahajan and is in -the public domain. diff --git a/Build/source/texk/tetex/context/pstopdf.man b/Build/source/texk/tetex/context/pstopdf.man deleted file mode 100644 index 972f364cb19..00000000000 --- a/Build/source/texk/tetex/context/pstopdf.man +++ /dev/null @@ -1,75 +0,0 @@ -.TH "PSTOPDF" "1" "December 2006" "pstopdf 2.0" "ConTeXt" -.de URL -\\$2 \(laURL: \\$1 \(ra\\$3 -.. -.if \n[.g] .mso www.tmac -.de EX -.in +3 -.nf -.ft CW -.. -.de EE -.in -3 -.ft R -.fi -.. - -.SH "NAME" -pstopdf \- convert EPS to PDF - -.SH "SYNOPSIS" -\fBpstopdf\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] - -.SH "DESCRIPTION" - -\fBpstopdf\fP converts EPS (encapsulated PostScript) to PDF. - -.SH OPTIONS -.TP -.B --help -Print usage and version information. -.TP -.B --convert -Convert EPS to PDF. This option is assumed if none is given. -.TP -.BI --method=\fIstring\fP -What method to use for bounding boxes when converting to PDF. -Specify one of \fBcrop\fP, \fBbounded\fP (the default), or \fBraw\fP. -Older versions of ConTeXt used numerical methods (1, 2, or 3). -.TP -.BI --resolution=\fIstring\fP -The resolution to use when when converting to pdf. -Specify one of \fBlow\fP, \fBnormal\fP, \fBmedium\fP, \fBhigh\fP, -\fBprinter\fP, \fBprint\fP, \fBscreen\fP, \fBebook\fP, or -\fBdefault\fP. -.TP -.B --request -Handle exa request file. -.TP -.B --watch -Watch folders for conversions (\fIuntested\fP). - -.SH EXAMPLES - -To make \fIcow.pdf\fP: -.EX -pstopdf cow.eps -.EE -or (one of several equivalents): -.EX -pstopdf --convert cow.eps cow.pdf -.EE - - -.SH "SEE ALSO" -.PP -.BR epstopdf (1), -.BR mptopdf (1), -.BR ps2pdf (1), -.BR texexec (1). -.PP -.URL "http://www.contextgarden.net" "ConTeXt wiki" . - -.SH "AUTHOR" -This (incomplete) manual page was written by Sanjoy Mahajan -. It is in the public domain. diff --git a/Build/source/texk/tetex/context/texexec.man b/Build/source/texk/tetex/context/texexec.man deleted file mode 100644 index 19f56dab96b..00000000000 --- a/Build/source/texk/tetex/context/texexec.man +++ /dev/null @@ -1,602 +0,0 @@ -.TH "TEXEXEC" "1" "December 2006" "texexec 6.2" "ConTeXt" -.de URL -\\$2 \(laURL: \\$1 \(ra\\$3 -.. -.if \n[.g] .mso www.tmac -.de EX -.in +3 -.nf -.ft CW -.. -.de EE -.in -3 -.ft R -.fi -.. - -.SH "NAME" -texexec \- front end to the ConTeXt typesetting system - -.SH "SYNOPSIS" -\fBtexexec\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] - -.SH "DESCRIPTION" - -\fBtexexec\fP, a \fBruby\fP(1) script, -is the command-line front end to the ConTeXt typesetting -system, an extensive macro package -built on the \fBtex\fP(1) family of typesetting programs. -\fBtexexec\fP provides several facilties: -.IP \(bu -Process a ConTeXt source file, -performing as many runs as -necessary of \fBtex\fP(1), \fBtexutil\fP(1), and -MetaPost (\fBmpost\fP(1)). Options control the output -format, the pages to process, paper size, and so forth. -.IP \(bu -Create new ConTeXt formats, useful during installation. -.IP \(bu -Post-process existing PDF files, including merging multiple -files, and extracting and rearranging pages within a file, -similar to the facilities provided for PostScript files by -\fBpsnup\fP(1) or for PDF files by \fBpdftk\fP(1). -.IP \(bu -Extract or strip documentation from ConTeXt source files -using \fBtexutil\fP(1). -.IP \(bu -Run MetaPost (\fBmpost\fP(1)) to generate figures from MetaPost source. -.IP \(bu -Produce proof sheets of figures used in a ConTeXt source file. -.IP -.SH "OPTIONS" - -All switches are specified in full here but can be abbreviated to the -shortest unique prefix. Thus, \fB--env\fP works the same as -\fB--environment\fP. With no options, \fBtexexec\fP assumes that -the file on the command line is a ConTeXt source file, i.e. a TeX file -in the ConTeXt dialect, and produces a PDF file using the source file. - -.SS "General Options" - -.IP "\fB--alone\fP" -Avoid calling other programs when possible. For -example, \fB--alone\fP will prevent \fBtexexec\fP from -using \fBfmtutil\fP(1) to generate formats (this prevention can -be handy when tracing installation problems). -.IP "\fB--environments\fP\fI=\fP\fIfile[,file[,...]]\fP" -Specify ConTeXt environment file(s), separated by commas, to use when -processing the source file. This option is useful when converting -from non-ConTeXt file formats without environment or layout settings. -.IP "\fB--help\fP" -Produce a summary of switches -and arguments. A more detailed help is produced by including -\fB--all\fP. -.IP "\fB--interface=\fP\fIlanguage\fP" -Specify the language -ConTeXt should use to communicate with you. -Options are -.IP -.RS -.IP "\fBen\fP" -US English -.IP "\fBnl\fP" -Dutch -.IP "\fBde\fP" -German -.IP "\fBuk\fP" -British English -.IP "\fBcz\fP" -Czech -.IP "\fBit\fP" -Italian -.RE -.IP "\fB--keep\fP" -Preserve a few of the temporary files generated while processing by -appending \fI.keep\fP to their name. For example, after -.EX -texexec --keep document.tex -.EE -you will find (besides \fIdocument.pdf\fP) \fIdocument.log.keep\fP -and \fIdocument.top.keep\fP. The \fIdocument.top\fP file is where -\fBtexexec\fP wraps \fIdocument.tex\fP with the proper ConTeXt macro -commands to set the output format, etc. -.IP "\fB--once\fP" -Process a file exactly once. (By default, -\fBtexexec\fP processes the file as many times as -necessary to sort out all references, typeset -\fBMetaPost\fP code, and so forth.) -.IP "\fB--purge\fP" -Get rid of most temporary files generated while processing the source -file. For example, -.EX -texexec --purge somefile.tex -.EE -will generate \fIsomefile.pdf\fP, cleaning up after itself and leaving -only one extra file, \fIsomefile.tuo\fP. See also the \fB--purge\fP -option of -.BR ctxtools (1) -.IP "\fB--purgeall\fP" -Get rid of all temporary files generated while processing the source -file, including the \fIfilename.tuo\fP file. See also the \fB--purge ---all\fP option combination of -.BR ctxtools (1) -.IP "\fB--randomseed=\fP\fINNNN\fP" -Set the random seed. -.IP "\fB--result=\fP\fIFILENAME\fP" -Allows you to change the -basename of the output file. See -\fB--mode\fP for an example. -.IP "\fB--runs=\fP\fINUMBER\fP" -Specify the number of runs to -perform on a file. Overrides -\fBtexexec\fP's calculations. -.IP "\fB--separation\fP" -Perform color separations. -.IP "\fB--silent\fP" -Suppress a few diagnostic and progress messages. -.IP "\fB--timeout=\fP\fINNN\fP" -Abort the run if a subprocess waits for more than \fINNN\fP seconds; -e.g. while waiting for user input when \fBtex\fP reports an undefined -control sequence. Useful for automated testing scripts, to make sure -the runs finish. -.IP "\fB--usemodules=\fP\fImodule1[,module2,[...]]\fP -Use the comma-separated list of modules. For example, to typeset -\fIdocument.tex\fP using the \fIbib\fP and \fIunits\fP modules: -.EX -texexec --usemodules=bib,units document.tex -.EE -.IP "\fB--verbose\fP" -Output extra diagnostic information. -.IP "\fB--version\fP" -Print the version number. -.IP - -.SS "Processing ConTeXt Source Files" - -Including specifying paper sizes, formats, and so forth. - -.IP "\fB--arrange\fP" -Perform page rearrangements, which are used to produce booklets. This -option tells ConTeXt to the first \fIn\fP-1 runs without taking -account of arrangements, then on the last run to pay attention to -the arrangement commands in the source file. -.IP "\fB--batchmode\fP" -Process the file in batchmode, which means -to typeset the whole document even if there are errors. More -imformation about \f(CWbatchmode\fP can be found in Donald -E. Knuth's \fITeXbook\fP. -.IP "\fB--nonstopmode\fP" -Process the file in nonstopmode, which means -to typeset the document and report errors, but not to stop at any -error. It is similar to batchmode but more verbose. More -imformation about \f(CWnonstopmode\fP can be found in Donald -E. Knuth's \fITeXbook\fP. -.IP "\fB--bodyfont=\fP\fIfont\fP" -The name of a font to preload for use in -setting the body of the text (OBSOLETE). -.IP "\fB--centerpage\fP" -Center the document on the page. -.IP "\fB--color\fP" -Turn on color mode. Color mode can also be set by -commands embedded in the document. These commands -override the \fB--color\fP option. -.IP "\fB--convert=\fP\fIFORMAT\fP" -Convert the input file to -ConTeXt format from \fIFORMAT\fP before -processing. In most cases, this conversion will result -in a TeX file. Currently supported input -\fIFORMAT\fPs are \fBxml\fP and -\fBsgml\fP. -.IP "\fB--dvipdfmx, --dvipdfm, --dpx, --dpm\fP" -Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) -to make a DVI file and \fBdvipdfmx\fP(1) to turn it -into PDF. -.IP "\fB--dvi, --ps, --dvips\fP" -Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) -to make a DVI file and \fBdvips\fP(1) to turn it -into PostScript. It's counterintuitive that \fB--dvi\fP produces -a PostScript file in addition to the DVI file. But that's because -\fB--dvi\fP is shorthand for \fB--dvips\fP; adding the \fB--nobackend\fP -option prevents \fBtexexec\fP's running \fBdvips\fP(1). See also the -\fB--engine\fP option. -.IP "\fB--fast\fP" -Typeset the document(s) as fast as possible without -causing problems. -.IP "\fB--final\fP" -Perform a final run without skipping anything. -This option is typically used with \fB--fast\fP. -.IP "\fB--language=\fP\fILANGUAGE\fP" -Set the language for -hyphenation. Can be specified in your source file. -Options are the same as those for \fB--interface\fP. -.IP "\fB--mode=\fP\fIMODELIST\fP, \fB--modes=\fP\fIMODELIST\fP" -Allows you to change the mode used while typesetting the -source file. The \fIMODELIST\fP is a comma separated list of modes. -Modes are a conditional-compilation facility -like \f(CW#ifdef\fP in C. So one source file can be used to produce -several typeset documents: one for A4 paper, one for -screen display in full color, one for letter paper, etc. For -example: -.IP -.EX -\f(CWtexexec --pdf --mode=A4 --result=manual-a manual-t.tex\fP -\f(CWtexexec --pdf --mode=letter --result=manual-l manual-t.tex\fP -\f(CWtexexec --pdf --mode=screen --result=manual-s manual-t.tex\fP -.EE -.IP -Here the \fB--mode\fP tells ConTeXt which -mode directives to use when typesetting the source file. The -\fB--result\fP option tells ConTeXt -where to put the output file. -.IP "\fB--modefile=\fP\fIfile\fP" -Load this file before most of the usual processing; usually used for -mode-related material. -.IP "\fB--noarrange\fP" -Ignore arrangement commands in the source file. -.IP "\fB--nobackend\fP" -Do not run the backend, e.g. \fBdvips\fP(1) or \fBdvipdfmx\fP(1). See -the \fB--dvips\fP or \fB--dvipdfmx\fP options. Why would you give one -of those options to choose a backend, yet tell \fBtexexec\fP not to -run the backend? Because each backend has its own syntax for -\f(CW\\special\fP calls. Specifying the backend allows the ConTeXt -macros to use the correct syntax so that when you later run the -backend to produce PostScript or PDF, the specials will be interpreted -correctly. -.IP "\fB--pages=\fP\fIPAGENUMBERLIST\fP" -Specify the pages or page -range to appear in the output file. -\fIPAGENUMBERLIST\fP may be the keyword \fBodd\fP -or \fBeven\fP; or one or more pages or page ranges separated by commas. -For example, -.EX -\f(CWtexexec --pages=1,7,8-11,14 somefile.tex\fP -.EE -.IP "\fB--paperformat=\fP\fIKEY\fP" -For typesetting multiple pages on a -single piece of paper. \fIKEY\fP has the form \fBa4a3\fP -(for printing A4 pages on A3 paper), \fBa5a4\fP -(for printing A5 pages on A4 paper), or in general \fBaMaN\fP. -The actual layout of the pages is specified with the -\fB--printformat\fP option. -.IP "\fB--pdf, --pdftex\fP" -Use \fBpdftex\fP(1) to produce a pdf document (the default). -.IP "\fB--printformat=\fP\fIKEY\fP" -Specify the layout of the final -output. \fIKEY\fP can be \fBup\fP, resulting in 2 -pages per sheet, double sided; or \fBdown\fP, resulting -in 2 rotated pages per sheet, double sided. Use the -\fB--paperformat\fP option to specify the original page -and sheet size. -.IP "\fB--utfbom\fP" -Turn on UTF-8 encoding. -.IP "\fB--xetex, --xtx\fP" -Use \fBxetex\fP(1) to produce a pdf document. -.IP - -.SS "Creating ConTeXt Format Files" - -.IP "\fB--make\fP" -Generate a ConTeXt format file. For example, to make -\fIcont-en.fmt\fP and have it placed in a default format directory: -.EX -texexec --make de -.EE -The most common invocation, which is used by scripts that install a new version -of ConTeXt (see \fBctxtools\fP(1)), uses \fB--all\fP -so that \fBtexexec\fP makes the usual formats: -.EX -texexec --make --all -.EE -.IP "\fB--local\fP" -When searching for TeX or MetaPost formats, look in the current directory -rather than in the location set by the kpse library. See -.BR kpathsea (1) -for more information on path searching. -.IP "\fB--check\fP" -Check and report information about the ConTeXt version, the -distribution, the TeX engine, and the language interfaces/formats. - -.SS "Expert options" - -You should know what you're doing if you use these options! -.IP "\fB--alpha" -Use the TEXMFALPHA environment variable to find and -run an alpha release of ConTeXt. -.IP "\fB--beta" -Use the TEXMFBETA environment variable to find and -run a beta release of ConTeXt. -.IP "\fB--distribution\fP\fI=dist\fP" -Usually one of \fBstandard\fP, \fBweb2c\fP, or \fBmiktex\fP. -\fBtexexec\fP should figure it out automatically, and you shouldn't -need to use this option. -.IP "\fB--engine\fP\fI=texengine\fP" -Specify the program to do the hard work of typesetting. Currently -either \fBpdftex\fP (the default), \fBxetex\fP, or \fBaleph\fP. -The \fBluatex\fP value is experimental. The \fB--engine\fP -option is not usually needed. Instead, let -\fBtexexec\fP figure out the setting based on other command-line -information. See for example the \fB--xetex\fP or \fB--pdf\fP -switches. - -.SS "Postprocess PDF Files" - -.IP "\fB--combination=\fP\fIROWS\fP\fB*\fP\fICOLS\fP" -Specify the number of pages to show on a single page. Use with -\fB--pdfcombine\fP. -.IP "\fB--pdfarrange\fP" -For rearranging pages in PDF files. -.EX -\f(CWtexexec --pdfarrange --paperformat=a5a4 --printformat=up foo.pdf\fP -.EE -This command creates an A5 booklet from a PDF file -\fIfoo.pdf\fP. \fB--pdfarrange\fP is used in -conjunction with the following options. -.IP "\fB--pdfcopy\fP" -Copy and perhaps process pages from the pdf file. -The resulting file is \fItexexec.pdf\fP by default, but you can change -that using \fB--result\fP. Use the \fB--scale\fP option to magnify or -demagnify the original pages and the \fB--pages\fP option to select -the pages to copy. Here is an example using all these options: -.EX -texexec --pages=4-7 --pdfcopy --scale=750 --result=one images.pdf -.EE -It takes pages 4-7 from \fIimages.pdf\fP, scales them by 75%, -and copies them to \fIone.pdf\fP. -.IP "\fB--scale=\fP\fIinteger\fP" -If the integer is less than 10, then it is taken as an (integer) -magnification factor. Otherwise, it is taken as a magnification -factor in TeX terms, i.e. with 1000 meaning full scale. -.IP "\fB--paperoffset=\fP\fIdimen\fP" -Specify the space between the -edge of the pages and the beginning of the text block. -.IP "\fB--backspace=\fP\fIdimen\fP" -Specify the inside (gutter) margins. -.IP "\fB--topspace=\fP\fIdimen\fP" -Specify the top and bottom margin. -.IP "\fB--markings\fP" -Add crop marks. -.IP "\fB--addempty=\fP\fIPAGES\fP" -Add empty pages after the pages specified in \fIPAGES\fP. (Useful -for, among other things, adding blank pages after a table of -contents.) -.IP "\fB--textwidth=\fP\fIWIDTH\fP" -Set the width of -the original text. Specifying this parameter with a -single-sided original will allow ConTeXt to adjust -the page layout for double-sided output, producing much -more attractive results. - -With the \fB--pdfarrange\fP flag, specifying more -than one file will result in all of the files being -combined in the final result, allowing you to add title -pages, decorated part separators, and so forth. - -You can also do more complex manipulations, such as -adding additional text to the page by setting up a -small file with layout definitions and a simple figure -insertion loop. -.IP "\fB--pdfcombine\fP" -Combine multiple pages. Requires the \fB--combination\fP option. -.IP "\fB--pdfselect\fP" -Extract pages from a file. Use in combination with the -\fB--selection\fP switch, as in -.EX -\f(CWtexexec --pdfselect --paperformat=S6 ---selection=1,9,14 file-1\fP -.EE -which extracts pages 1, 9, and 14 from -\fIfile-1.pdf\fP, and places them in -\fItexexec.pdf\fP (the default output filename if -an output file isn't specified). - -See \fB--pdfarrange\fP for other -options. -.IP "\fB--selection=\fP\fIPAGES\fP" -Specify pages to be affected by -another option. See \fB--pdfarrange\fP and -\fB--pdfselect\fP for examples. - -.SS "XML handling" -.IP "\fB--filters=\fP\fIfilter1[,filter2[,...]]\fP -Specify XML filters to use. - -.SS "Extract or Strip Out Documentation" - -.IP "\fB--listing\fP" -Produce a typeset version of the source code in -\fIFILE\fP. You can specify the format of the output -file. For example, use -.EX -\f(CWtexexec --ps --listing readme.now\fP -.EE -to produce a PostScript file called -\fItexexec.ps\fP. - -See also \fB--backspace\fP, \fB--topspace\fP, and \fB--result\fP. -.IP "\fB--module\fP" -Create documentation for ConTeXt, -MetaPost (see \fBmpost\fP(1)), -.BR perl (1), -and -.BR ruby (1) -modules. -Converts the documentation to ConTeXt format and -then typesets a documentated version of the source file. - -Documentation lines in ConTeXt source files are -specified by beginning lines with these strings: - -\f(CW%C\fP : Copyright information - -\f(CW%D\fP : Documentation lines - -\f(CW%I\fP : TeXEdit information lines (mostly in Dutch) - -\f(CW%M\fP : Macro code needed to processs the documentation - -\f(CW%S\fP : Suppressed lines - -The same forms can be used for Perl or ruby scripts, except that the \f(CW%\fP -character (the TeX comment character) is replaced by \f(CW#\fP (the -Perl comment character). - -See also the \fB--documentation\fP option to -.BR ctxtools (1). - -.SS "Process MetaPost Figures" - -.IP "\fB--mpsformats=\fP\fIname\fP" -The name of a MetaPost format file, e.g. \fBmetafun\fP (the default). -.IP "\fB--mptex\fP" -Strips out and typesets TeX code embedded in a -MetaPost file. -.IP "\fB--nomp\fP" -Do not run \fBmpost\fP(1), even if needed. -.IP "\fB--nomprun\fP" -Do not run \fBmpost\fP(1) on embedded -MetaPost code. - -.SS "Producing Proof Sheets of Figures" - -Generate information and proof sheets of one or more (non-EPS) -graphics files. For example, -.EX -texexec --figures *.png *.jpg -.EE -scans the current directory for PNG and JPG files -and extracts useful information about their sizes and types. By -default, this information is stored in -.IR rlxtools.rli . -Then the given figures are made into a proof sheet (by default -\fItexexec.pdf\fP) according to the method specified by the -\fB--method\fP option. Note that newer versions of -.BR pdftex (1) -do not support TIFF inclusion. -.IP "\fB--method=\fP\fIALTERNATIVE\fP" -Specify one of three options to produce the document containing the images -used in the source file: - -\fBa\fP : A proof sheet with additional -information provided for each figure (the default) - -\fBb\fP : A proof sheet with the graphics only - -\fBc\fP : One figure per page, with the page -clipped to the bounding box of the -figure - -See also \fB--paperoffset\fP, -which allows you to specify an offset to be added to -the page, as in -.EX -texexec --figures --method=c --paperoffset=.5cm *.pdf *.png *.jpg -.EE - -.SH "USAGE" - -Each ConTeXt user interface (language) has its own format. The -following command generates two formats, one using the English -interface for typesetting in English, and one for Dutch: -.EX -\f(CWtexexec --make en nl\fP -.EE - -By default, the language used for typesetting matches the -user-interface language (set with -\fB--interface\fP. It is possible to use one -language for typesetting and another for messages by changing the -relevant settings in \fIcont-usr.tex\fP. These languages can -also be changed on the command line with a command such as -.IP -.RS -\f(CWtexexec --make --language=pl,cz,sk en\fP -.RE -.IP -That command generates a ConTeXt format file with an English user -interface, and the main language set to Polish (\fBpl\fP). Czech -and Slovak hyphenation patterns are also loaded -so that Czech and Slovak text included in a source file will be -typeset properly (\fBcz\fP and \fBsk\fP). -.IP o -When the appropriate formats are present, a file can be typeset -by typing -.EX -\f(CWtexexec test\fP -.EE -.IP -\fBtexexec\fP tries to determine what interface it should use to -typeset \fItest.tex\fP by looking for a line such as -.IP -.EX -\f(CW% interface=en tex=pdftex output=pdftex\fP -.EE -.IP -at the top of the file (i.e., on the very first line). This line is -equivalent to \fBTeX\fP's format line, ``&\fIFORMAT\fP''). -.IP -By default, \fBtexexec\fP will produce a PDF file using \fBpdftex\fP(1). The -\fB--dvips\fP flag tells \fBtexexec\fP to produce a PostScript -file instead. -.IP -After an error-free run, \fBtexexec\fP will run \fBtexutil\fP(1) to -determine whether additional runs of \fBtex\fP(1) (or -\fBpdftex\fP(1)) or any utility programs (e.g., \fBbibtex\fP(1), -\fBmakeindex\fP(1)) are necessary. You can suppress these -additional runs by specifying the \fB--once\fP or -\fB--runs\fP flags: -.IP -.EX -\f(CWtexexec --once test\fP -\f(CWtexexec --runs=2 test\fP -.EE -.IP - -.SH EXAMPLES -.TP -Produce PDF from ConTeXt source (the .tex extension is optional): -\f(CWtexexec file.tex\fP -.TP -Same as the above but without rerunning for crossreferences, etc.: -\f(CWtexexec --once file.tex\fP -.TP -Produce PostScript from ConTeXt source: -\f(CWtexexec --ps file.tex\fP -.TP -Produce file-a4.pdf using conditional compilation (modes): -\f(CWtexexec --mode=a4 --result=file-a4 file.tex\fP -.TP -Generate format (.fmt) files used by ConTeXt (used during installation): -\f(CWtexexec --make --all\fP - - -.SH "INITIALIZATION" -.IP -\fBtexexec\fP requires ruby. On Unix and Unix-like systems, no special -steps have to be taken to get \fBtexexec\fP to work beyond installing -ruby and having the \fBruby\fP(1) binary in your path. - -.SH "SEE ALSO" -.PP -\fBbibtex\fP(1), \fBctxtools\fP(1), \fBdvipdfmx\fP(1), \fBdvips\fP(1), -\fBfmtutil\fP(1), \fBmakeindex\fP(1), \fBmpost\fP(1), -\fBmptopdf\fP(1), \fBpdftex\fP(1), \fBpdftk\fP(1), \fBruby\fP(1), -\fBpsnup\fP(1), \fBtex\fP(1), \fBtexfont\fP(1), \fBtexmfstart\fP(1), -\fBtexshow\fP(1), -\fBtexutil\fP(1), \fBxetex\fP(1). -.PP -The texexec manual -.IR mtexexec.pdf , -available from -.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . -.PP -Donald E. Knuth's \fIThe TeXbook\fP. -.PP -.URL "http://www.contextgarden.net" "ConTeXt wiki" . - -.SH "AUTHOR" -This manpage was written by Tobias Burnus - and C.M. Connelly - and updated by Sanjoy Mahajan . -It is based on the -.I mtexexec.pdf -manual written by Hans Hagen . diff --git a/Build/source/texk/tetex/context/texmfstart.man b/Build/source/texk/tetex/context/texmfstart.man deleted file mode 100644 index e99ab230bd1..00000000000 --- a/Build/source/texk/tetex/context/texmfstart.man +++ /dev/null @@ -1,362 +0,0 @@ -.TH "TEXMFSTART" "1" "December 2006" "texmfstart 2.0" "ConTeXt" -.de URL -\\$2 \(laURL: \\$1 \(ra\\$3 -.. -.if \n[.g] .mso www.tmac -.de EX -.in +3 -.nf -.ft CW -.. -.de EE -.in -3 -.ft R -.fi -.. - -.SH "NAME" -texmfstart \- run ConTeXt scripts, make ConTeXt wrapper scripts, view documents - -.SH "SYNOPSIS" -\fB texmfstart\fP [ \fIoptions ...\fP ] [ \fIfilename\fP ] [ \fIarguments ...\fP ] - -.SH "DESCRIPTION" -ConTeXt is a typesetting system based on the -.BR tex (1) -family of programs. -.B texmfstart -is a ConTeXt meta-script that can run subordinate -scripts (subscripts?) such as -.BR texexec (1), -.BR ctxtools (1), -or -.BR pdftools (1). -It can also generate short wrapper scripts to simplify common uses. -These scripts are often called -.I stubs -in the ConTeXt documentation. The options control -.BR texmfstart 's -behaviour, and the arguments are passed -to the program identified by -.IR filename . - -If the filename is a document, then -.B texmfstart -will start a viewer for that document. For example: -.EX -texmfstart showcase.pdf -.EE -will start an appropriate viewer for -.IR showcase.pdf . -See the -.B EXAMPLES -section. - -.SH OPTIONS - -.SS General: -.TP -.B --help, --version -print version information, usage, and examples. -.TP -.B --verbose -print status and progress information, for example what commands are -being executed. -.TP -.B --clear -don't pass info about locations to child processes. - -.SS Running a program: -.TP -.B --arguments=\fIstr\fP -an alternative for providing the arguments to be passed. For example, -.EX -texmfstart --arguments=b.tex texexec -.EE -will pass -.I b.tex -as the argument to -.BR texexec . -.TP -.B --report -dry run: report what command would be run, but do not run it -.TP -.B --locate -dry run: like \f(CW--report\fP but doesn't print the trailing newline. -.TP -.B --browser -view the document in a web browser (for Windows). -.TP -.B --file=\fIfilename\fP -an alternative way to specify the file (the program to run or document -to open). -.TP -.B --direct -run a program without searching for its location (assumes that the -program is on the PATH). -.TP -.B --execute -use the -.BR ruby (1) -.I exec -function instead of its -.I system -function. -.TP -.B --program=\fIstr\fP -the program space where -.BR kpsewhich (1) -will search (default: context). This information is given to -.B kpsewhich -as its \f(CW-progname\fP option. Usually you don't need this option. - -.SS Creating startup scripts: -.TP -.B --make -create a wrapper script or batch file to run the given file. -The wrapper scripts are put in the current path, which usually means -the current directory. If -\fIall\fP is given as the file, e.g. -.EX -texmfstart --make all -.EE -then make all the ConTeXt wrapper scripts (the stubs). -.TP -.B --windows -when making a wrapper script (stub), create a Windows batch (.bat) file. -Usually you -do not need to specify this option, as -.B texmfstart -will figure out what operating system you are using. -.TP -.B --linux -when making a wrapper script, create a Unix shell script. Usually you -do not need to specify this option, as -.B texmfstart -will figure out what operating system you are using. -.TP -.B --stubpath=\fIpath\fP -specify where to put the wrapper scripts (stubs). -.TP -.B --indirect -always use -.I texmfstart -in the wrapper script (stub). - -.SS Document viewing: -.TP -.B --page=\fInumber\fP -open the document at this page. - -.SS Environments and paths: -.TP -.B --path=\fIstr\fP -change to the specified path. -.TP -.B --tree=\fIstr\fP -use the given TEXMF tree. -.TP -.B --autotree -automatically determine the TEXMF tree to use (the default). -.TP -.B --environment=\fIstr\fP -use the given environment file. Its syntax is given in the -.I mtexmfstart.pdf -manual. -.TP -.B --showenv -print the environment variables known at runtime - -.SS Conditional execution: -.TP -.B --iftouched=\fIfile1,file2\fP -run only when the given files have different timestamps. -.TP -.B --ifchanged=\fIstr\fP -run only when the given file has changed (based on its last-computed MD5 -checksum). - -.SS Special features: -.TP -.B --edit -open the given file in an editor. - -.SH "FILENAME PREFIXES" -.SS -Optional prefixes determine the method used to search for the specified file: -.TP -.I bin:filename -expanded name based on the PATH environment variable -.TP -.I kpse:filename -expanded name based on -.BR kpsewhich (1) -result -.TP -.I rel:filename -expanded name relative to the current directory -.TP -.I env:name -expanded pathname based on environment variable -.I name -.TP -.I path:filename -path part of filename as located by -.BR kpsewhich (1) - -.SH EXAMPLES -.TP -\f(CWtexmfstart texexec.rb file.tex\fP -Locate the -.I texexec.rb -script and run it with -.I file.tex -as its argument. In other words, make -.I file.pdf -from -.IR file.tex . -If -.BR texexec (1) -is properly installed on your system, -this common invocation can be shortened to -.EX -\f(CWtexexec file.tex\fP -.EE -.TP -\f(CWtexmfstart texexec file.tex\fP -Locate the -.BR texexec (1) -program (currently a -.BR ruby (1) -script, -.IR texexec.rb ) -and run it with -.I file.tex -as its argument, producing -.I file.pdf. -This invocation can be shortened to -.EX -texexec file.tex -.EE -.TP -\f(CWtexmfstart ctxtools --updatecontext\fP -Run the -.BR ctxtools (1) -script, updating the ConTeXt installation. This -invocation is equivalent to -.EX -ctxtools --updatecontext -.EE -.TP -\f(CWtexmfstart pstopdf --method=3 cow.eps\fP -Convert -.I cow.eps -to PDF using method 3 of -.BR pstopdf (1). -This invocation is equivalent to -.EX -pstopdf --method=3 cow.eps -.EE -.TP -\f(CWtexmfstart --make --stubpath=/usr/local/bin texexec\fP -Make a wrapper script (stub), either a shell script -.I /usr/local/bin/texexec -on Unix, or a batch file \fI\\usr\\local\\bin\\texexec.bat\fP -on Windows. On Unix (and maybe on Windows?), you need to make -the script executable; see -.BR chmod (1). -.TP -\f(CWtexmfstart --edit kpse:cont-sys.tex\fP -Locate and edit the \fIcont-sys.tex\fP configuration file. -.TP -\f(CWtexmfstart --ifchanged=whatever.mp texexec --mpgraphic whatever.mp\fP -Rerun -.B texexec -if -.I whatever.mp -has changed since the last use of -.IR --ifchanged . -.TP -\f(CWtexmfstart --ifchanged=whatever.mp bin:echo rerun MetaPost\fP -If the -.I whatever.mp -source file has changed since the last use of -.IR --ifchanged , -then use the -.BR echo (1) -command to tell the user to rerun MetaPost -.RB "(see " mpost (1)). -This example shows that -.B texmfstart -can be used to run any script, not just ConTeXt scripts. The -\f(CWbin:\fP prefix tells -.B texmfstart -not to search for -.I echo -in the TEXMF tree(s), but to assume that it's an executable somewhere -on the PATH. -.TP -\f(CWtexmfstart --ifchanged=whatever.mp --direct echo rerun MetaPost\fP -This invocation has the same effect as the preceding example, but -using \f(CW--direct\fP instead of the \f(CWbin:\fP prefix, again to tell -.B texmfstart -not to search for the -.I echo -command. - -.SH FILES -.TP -.I file.md5 -MD5 checksum file used for the \f(CW--ifchanged\fP option. - -.SH ENVIRONMENT -.TP -PATH -For expanding filenames given with a -.I bin -prefix. -.TP -TEXMFSTART_EDITOR, EDITOR, editor -Editor to use with -.IR --edit . -The environment variables are looked up in that order, with the first -setting found taking priority. - -.SH "SEE ALSO" -.PP -.BR ctxtools (1), -.BR kpsewhich (1), -.BR makempy (1), -.BR mpost (1), -.BR pdftools (1), -.BR pstopdf (1), -.BR texexec (1), -.BR texfont (1), -.BR texutil (1). -.PP -.URL "http://www.contextgarden.net" "ConTeXt wiki" . -.PP -The -.B texmfstart -manual, -.IR mtexmfstart.pdf , -available from -.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . - -.SH BUGS -On Unix, opening a PDF document first tries -.B pdfopen -then -.BR acroread , -neither of which may be present on your system. - -The \f(CW--report\fP option doesn't work if you specify a filename -prefix (i.e. it does a real run instead of a dry run). - -.SH "AUTHOR" -ConTeXt is written and maintained by -.URL "http://www.pragma-ade.com" "Hans Hagen" . -This man page, which is in the public domain, was written by Sanjoy -Mahajan based on the -.I mtexmfstart.pdf -manual. diff --git a/Build/source/texk/texlive/ChangeLog b/Build/source/texk/texlive/ChangeLog index 889fe04b7cc..1902caca3b8 100644 --- a/Build/source/texk/texlive/ChangeLog +++ b/Build/source/texk/texlive/ChangeLog @@ -1,3 +1,11 @@ +2010-12-22 Peter Breitenlohner + + * configure.ac: Added KPSE_CHECK_WIN32. + * context/{ctxtools,mptopdf,pstopdf,texexec,texmfstart}.man: + Moved from ../tetex/context/ to here. + * context/Makefile.am: Adapted. + For WIN32 skip the shell scripts. + 2010-05-30 Karl Berry * configure.ac: add context subdir, 2010. diff --git a/Build/source/texk/texlive/Makefile.in b/Build/source/texk/texlive/Makefile.in index b646b2d1333..b0dc2dedc13 100644 --- a/Build/source/texk/texlive/Makefile.in +++ b/Build/source/texk/texlive/Makefile.in @@ -41,7 +41,8 @@ DIST_COMMON = $(am__configure_deps) \ ../../build-aux/ltmain.sh ../../build-aux/missing \ ../../build-aux/texinfo.tex ../../build-aux/ylwrap ChangeLog ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__aclocal_m4_deps = $(top_srcdir)/../../m4/kpse-win32.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) am__CONFIG_DISTCLEAN_FILES = config.status config.cache config.log \ diff --git a/Build/source/texk/texlive/aclocal.m4 b/Build/source/texk/texlive/aclocal.m4 index 76a153698ad..f2dd15ba72f 100644 --- a/Build/source/texk/texlive/aclocal.m4 +++ b/Build/source/texk/texlive/aclocal.m4 @@ -989,3 +989,4 @@ AC_SUBST([am__tar]) AC_SUBST([am__untar]) ]) # _AM_PROG_TAR +m4_include([../../m4/kpse-win32.m4]) diff --git a/Build/source/texk/texlive/configure b/Build/source/texk/texlive/configure index 0b87a544c6b..f7854642805 100755 --- a/Build/source/texk/texlive/configure +++ b/Build/source/texk/texlive/configure @@ -569,6 +569,8 @@ ac_subst_vars='am__EXEEXT_FALSE am__EXEEXT_TRUE LTLIBOBJS LIBOBJS +WIN32_FALSE +WIN32_TRUE LN_S am__fastdepCC_FALSE am__fastdepCC_TRUE @@ -3321,6 +3323,62 @@ $as_echo "no" >&6; } fi + +{ $as_echo "$as_me:${as_lineno-$LINENO}: checking for native WIN32 or MINGW32" >&5 +$as_echo_n "checking for native WIN32 or MINGW32... " >&6; } +if ${kpse_cv_have_win32+:} false; then : + $as_echo_n "(cached) " >&6 +else + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#ifndef WIN32 + choke me +#endif +int +main () +{ + + ; + return 0; +} +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + cat confdefs.h - <<_ACEOF >conftest.$ac_ext +/* end confdefs.h. */ +#ifndef __MINGW32__ + choke me +#endif +int +main () +{ + + ; + return 0; +} +_ACEOF +if ac_fn_c_try_compile "$LINENO"; then : + kpse_cv_have_win32=mingw32 +else + kpse_cv_have_win32=native +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext +else + kpse_cv_have_win32=no +fi +rm -f core conftest.err conftest.$ac_objext conftest.$ac_ext +fi +{ $as_echo "$as_me:${as_lineno-$LINENO}: result: $kpse_cv_have_win32" >&5 +$as_echo "$kpse_cv_have_win32" >&6; } + + if test "x$kpse_cv_have_win32" != xno; then + WIN32_TRUE= + WIN32_FALSE='#' +else + WIN32_TRUE='#' + WIN32_FALSE= +fi + + ac_config_files="$ac_config_files Makefile context/Makefile linked_scripts/Makefile" @@ -3489,6 +3547,10 @@ if test -z "${am__fastdepCC_TRUE}" && test -z "${am__fastdepCC_FALSE}"; then as_fn_error $? "conditional \"am__fastdepCC\" was never defined. Usually this means the macro was only invoked conditionally." "$LINENO" 5 fi +if test -z "${WIN32_TRUE}" && test -z "${WIN32_FALSE}"; then + as_fn_error $? "conditional \"WIN32\" was never defined. +Usually this means the macro was only invoked conditionally." "$LINENO" 5 +fi : "${CONFIG_STATUS=./config.status}" ac_write_fail=0 diff --git a/Build/source/texk/texlive/configure.ac b/Build/source/texk/texlive/configure.ac index 1199ef9a359..afbca8f6ea2 100644 --- a/Build/source/texk/texlive/configure.ac +++ b/Build/source/texk/texlive/configure.ac @@ -20,6 +20,9 @@ AC_PROG_INSTALL AC_PROG_LN_S AC_PROG_MAKE_SET +KPSE_CHECK_WIN32 +AM_CONDITIONAL([WIN32], [test "x$kpse_cv_have_win32" != xno]) + AC_CONFIG_FILES([Makefile context/Makefile linked_scripts/Makefile]) AC_OUTPUT diff --git a/Build/source/texk/texlive/context/Makefile.am b/Build/source/texk/texlive/context/Makefile.am index 3867372185a..9c774badf4d 100644 --- a/Build/source/texk/texlive/context/Makefile.am +++ b/Build/source/texk/texlive/context/Makefile.am @@ -9,10 +9,9 @@ ## ## Because mptopdf.pl is not part of the context/stubs directory, it is ## handled through a symlink, see ../linked_scripts. -## -ACLOCAL_AMFLAGS = -I ../../m4 -bin_SCRIPTS = \ +if !WIN32 +dist_bin_SCRIPTS = \ context \ ctxtools \ luatools \ @@ -21,6 +20,12 @@ bin_SCRIPTS = \ rlxtools \ texexec \ texmfstart +endif !WIN32 -EXTRA_DIST = $(bin_SCRIPTS) +dist_man1_MANS = \ + ctxtools.man \ + mptopdf.man \ + pstopdf.man \ + texexec.man \ + texmfstart.man diff --git a/Build/source/texk/texlive/context/Makefile.in b/Build/source/texk/texlive/context/Makefile.in index 36bf15629ae..60c2ad627c0 100644 --- a/Build/source/texk/texlive/context/Makefile.in +++ b/Build/source/texk/texlive/context/Makefile.in @@ -33,14 +33,18 @@ NORMAL_UNINSTALL = : PRE_UNINSTALL = : POST_UNINSTALL = : subdir = context -DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +DIST_COMMON = $(am__dist_bin_SCRIPTS_DIST) $(dist_man1_MANS) \ + $(srcdir)/Makefile.am $(srcdir)/Makefile.in ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__aclocal_m4_deps = $(top_srcdir)/../../m4/kpse-win32.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) mkinstalldirs = $(install_sh) -d CONFIG_CLEAN_FILES = CONFIG_CLEAN_VPATH_FILES = +am__dist_bin_SCRIPTS_DIST = context ctxtools luatools mtxrun pstopdf \ + rlxtools texexec texmfstart am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; am__vpath_adj = case $$p in \ $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ @@ -62,10 +66,13 @@ am__nobase_list = $(am__nobase_strip_setup); \ am__base_list = \ sed '$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;$$!N;s/\n/ /g' | \ sed '$$!N;$$!N;$$!N;$$!N;s/\n/ /g' -am__installdirs = "$(DESTDIR)$(bindir)" -SCRIPTS = $(bin_SCRIPTS) +am__installdirs = "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)" +SCRIPTS = $(dist_bin_SCRIPTS) SOURCES = DIST_SOURCES = +man1dir = $(mandir)/man1 +NROFF = nroff +MANS = $(dist_man1_MANS) DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) ACLOCAL = @ACLOCAL@ AMTAR = @AMTAR@ @@ -152,18 +159,23 @@ target_alias = @target_alias@ top_build_prefix = @top_build_prefix@ top_builddir = @top_builddir@ top_srcdir = @top_srcdir@ -ACLOCAL_AMFLAGS = -I ../../m4 -bin_SCRIPTS = \ - context \ - ctxtools \ - luatools \ - mtxrun \ - pstopdf \ - rlxtools \ - texexec \ - texmfstart - -EXTRA_DIST = $(bin_SCRIPTS) +@WIN32_FALSE@dist_bin_SCRIPTS = \ +@WIN32_FALSE@ context \ +@WIN32_FALSE@ ctxtools \ +@WIN32_FALSE@ luatools \ +@WIN32_FALSE@ mtxrun \ +@WIN32_FALSE@ pstopdf \ +@WIN32_FALSE@ rlxtools \ +@WIN32_FALSE@ texexec \ +@WIN32_FALSE@ texmfstart + +dist_man1_MANS = \ + ctxtools.man \ + mptopdf.man \ + pstopdf.man \ + texexec.man \ + texmfstart.man + all: all-am .SUFFIXES: @@ -197,10 +209,10 @@ $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) $(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh $(am__aclocal_m4_deps): -install-binSCRIPTS: $(bin_SCRIPTS) +install-dist_binSCRIPTS: $(dist_bin_SCRIPTS) @$(NORMAL_INSTALL) test -z "$(bindir)" || $(MKDIR_P) "$(DESTDIR)$(bindir)" - @list='$(bin_SCRIPTS)'; test -n "$(bindir)" || list=; \ + @list='$(dist_bin_SCRIPTS)'; test -n "$(bindir)" || list=; \ for p in $$list; do \ if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ if test -f "$$d$$p"; then echo "$$d$$p"; echo "$$p"; else :; fi; \ @@ -223,14 +235,48 @@ install-binSCRIPTS: $(bin_SCRIPTS) } \ ; done -uninstall-binSCRIPTS: +uninstall-dist_binSCRIPTS: @$(NORMAL_UNINSTALL) - @list='$(bin_SCRIPTS)'; test -n "$(bindir)" || exit 0; \ + @list='$(dist_bin_SCRIPTS)'; test -n "$(bindir)" || exit 0; \ files=`for p in $$list; do echo "$$p"; done | \ sed -e 's,.*/,,;$(transform)'`; \ test -n "$$list" || exit 0; \ echo " ( cd '$(DESTDIR)$(bindir)' && rm -f" $$files ")"; \ cd "$(DESTDIR)$(bindir)" && rm -f $$files +install-man1: $(dist_man1_MANS) + @$(NORMAL_INSTALL) + test -z "$(man1dir)" || $(MKDIR_P) "$(DESTDIR)$(man1dir)" + @list='$(dist_man1_MANS)'; test -n "$(man1dir)" || exit 0; \ + { for i in $$list; do echo "$$i"; done; \ + } | while read p; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + echo "$$d$$p"; echo "$$p"; \ + done | \ + sed -e 'n;s,.*/,,;p;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,' | \ + sed 'N;N;s,\n, ,g' | { \ + list=; while read file base inst; do \ + if test "$$base" = "$$inst"; then list="$$list $$file"; else \ + echo " $(INSTALL_DATA) '$$file' '$(DESTDIR)$(man1dir)/$$inst'"; \ + $(INSTALL_DATA) "$$file" "$(DESTDIR)$(man1dir)/$$inst" || exit $$?; \ + fi; \ + done; \ + for i in $$list; do echo "$$i"; done | $(am__base_list) | \ + while read files; do \ + test -z "$$files" || { \ + echo " $(INSTALL_DATA) $$files '$(DESTDIR)$(man1dir)'"; \ + $(INSTALL_DATA) $$files "$(DESTDIR)$(man1dir)" || exit $$?; }; \ + done; } + +uninstall-man1: + @$(NORMAL_UNINSTALL) + @list='$(dist_man1_MANS)'; test -n "$(man1dir)" || exit 0; \ + files=`{ for i in $$list; do echo "$$i"; done; \ + } | sed -e 's,.*/,,;h;s,.*\.,,;s,^[^1][0-9a-z]*$$,1,;x' \ + -e 's,\.[0-9a-z]*$$,,;$(transform);G;s,\n,.,'`; \ + test -z "$$files" || { \ + echo " ( cd '$(DESTDIR)$(man1dir)' && rm -f" $$files ")"; \ + cd "$(DESTDIR)$(man1dir)" && rm -f $$files; } tags: TAGS TAGS: @@ -239,6 +285,19 @@ CTAGS: distdir: $(DISTFILES) + @list='$(MANS)'; if test -n "$$list"; then \ + list=`for p in $$list; do \ + if test -f $$p; then d=; else d="$(srcdir)/"; fi; \ + if test -f "$$d$$p"; then echo "$$d$$p"; else :; fi; done`; \ + if test -n "$$list" && \ + grep 'ab help2man is required to generate this page' $$list >/dev/null; then \ + echo "error: found man pages containing the \`missing help2man' replacement text:" >&2; \ + grep -l 'ab help2man is required to generate this page' $$list | sed 's/^/ /' >&2; \ + echo " to fix them, install help2man, remove and regenerate the man pages;" >&2; \ + echo " typically \`make maintainer-clean' will remove them" >&2; \ + exit 1; \ + else :; fi; \ + else :; fi @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \ list='$(DISTFILES)'; \ @@ -270,9 +329,9 @@ distdir: $(DISTFILES) done check-am: all-am check: check-am -all-am: Makefile $(SCRIPTS) +all-am: Makefile $(SCRIPTS) $(MANS) installdirs: - for dir in "$(DESTDIR)$(bindir)"; do \ + for dir in "$(DESTDIR)$(bindir)" "$(DESTDIR)$(man1dir)"; do \ test -z "$$dir" || $(MKDIR_P) "$$dir"; \ done install: install-am @@ -320,13 +379,13 @@ info: info-am info-am: -install-data-am: +install-data-am: install-man install-dvi: install-dvi-am install-dvi-am: -install-exec-am: install-binSCRIPTS +install-exec-am: install-dist_binSCRIPTS install-html: install-html-am @@ -336,7 +395,7 @@ install-info: install-info-am install-info-am: -install-man: +install-man: install-man1 install-pdf: install-pdf-am @@ -364,20 +423,23 @@ ps: ps-am ps-am: -uninstall-am: uninstall-binSCRIPTS +uninstall-am: uninstall-dist_binSCRIPTS uninstall-man + +uninstall-man: uninstall-man1 .MAKE: install-am install-strip .PHONY: all all-am check check-am clean clean-generic distclean \ distclean-generic distdir dvi dvi-am html html-am info info-am \ - install install-am install-binSCRIPTS install-data \ - install-data-am install-dvi install-dvi-am install-exec \ - install-exec-am install-html install-html-am install-info \ - install-info-am install-man install-pdf install-pdf-am \ - install-ps install-ps-am install-strip installcheck \ - installcheck-am installdirs maintainer-clean \ - maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ - pdf-am ps ps-am uninstall uninstall-am uninstall-binSCRIPTS + install install-am install-data install-data-am \ + install-dist_binSCRIPTS install-dvi install-dvi-am \ + install-exec install-exec-am install-html install-html-am \ + install-info install-info-am install-man install-man1 \ + install-pdf install-pdf-am install-ps install-ps-am \ + install-strip installcheck installcheck-am installdirs \ + maintainer-clean maintainer-clean-generic mostlyclean \ + mostlyclean-generic pdf pdf-am ps ps-am uninstall uninstall-am \ + uninstall-dist_binSCRIPTS uninstall-man uninstall-man1 # Tell versions [3.59,3.63) of GNU make to not export all variables. diff --git a/Build/source/texk/texlive/context/ctxtools.man b/Build/source/texk/texlive/context/ctxtools.man new file mode 100644 index 00000000000..c22263d4267 --- /dev/null +++ b/Build/source/texk/texlive/context/ctxtools.man @@ -0,0 +1,89 @@ +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac +.de EX +.in +3 +.nf +.ft CW +.. +.de EE +.in -3 +.ft R +.fi +.. +.TH CTXTOOLS "1" "January 2007" "ctxtools 1.3.3" "ConTeXt" + +.SH NAME +ctxtools \- clean up temporary ConTeXt files, install latest ConTeXt + +.SH "SYNOPSIS" +\fBctxtools\fP [ \fIOPTION\fP ... ] + +.SH DESCRIPTION +\fBctxtools\fP is useful for dealing with ConTeXt source and generated +files and for installing new versions of ConTeXt. + +.SH "OPTIONS" +.TP +.B --help +Print the available options. +.TP +.B --purgefiles +Get rid of many temporary files generated by ConTeXt. You can give the +.B --all +option to remove a larger fraction of those files, +and the +.B --recurse +option to remove these files also in subdirectories. +.TP +.B --contextversion +Show the date of the ConTeXt macros and the format file. Useful after +upgrading ConTeXt (perhaps using \fB--updatecontext\fP) to check +whether the new formats and macros are visible to the TeX path +searches (see +.BR kpsewhich (1). +.TP +.B --updatecontext +Download the latest ConTeXt distribution and install it in the +TEXMFLOCAL tree (see +.BR kpsewhich (1) +for information on +TeX path searching). TEXMFLOCAL usually points to a system-wide +location. If you want to install the new ConTeXt in your home +directory (i.e. an install for one user), then set the TEXMFLOCAL +environment variable while running +.BR ctxtools . +For example, using the syntax of the Bourne shell +.BR sh (1): +.EX +TEXMFLOCAL=$HOME/texmf ctxtools --updatecontext +.EE +.TP +.B --documentation +Generate a \fI.ted\fP file from the source file. See also the +\fB--module\fP option to +.BR texexec (1). +.TP +\fB--patternfiles\fP [languagecode] +Generate pattern files. You can also give the +\fB--all\fP, \fB--xml\fP, and \fB--utf8\fP options. + +.SH "ENVIRONMENT" +.TP +TEXMFLOCAL +Used by \f(CW--updatecontext\fP to decide where to install the distribution. + +.SH "SEE ALSO" +.PP +.BR texexec (1), +.BR texmfstart (1). +.PP +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH BUGS +This manual page is not complete. + +.SH "AUTHOR" +This manual page was written by Sanjoy Mahajan . It is in +the public domain. diff --git a/Build/source/texk/texlive/context/mptopdf.man b/Build/source/texk/texlive/context/mptopdf.man new file mode 100644 index 00000000000..3c547f06aa8 --- /dev/null +++ b/Build/source/texk/texlive/context/mptopdf.man @@ -0,0 +1,104 @@ +.TH "MPTOPDF" "1" "January 2007" "mptopdf 1.3.2" "ConTeXt" +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac +.de EX +.in +3 +.nf +.ft CW +.. +.de EE +.in -3 +.ft R +.fi +.. + +.SH "NAME" +mptopdf \- convert MetaPost to PDF + +.SH "SYNOPSIS" +\fBmptopdf\fP \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBmptopdf\fP can convert MetaPost-generated EPS files to PDF, or it +can process a MetaPost source file directly (see +.BR mpost (1)) +and convert the generated EPS files to PDF. + +.SH "OPTIONS" +All switches are specified in full here but can be abbreviated to the +shortest unique prefix. Thus, \fB--metaf\fP works the same as +\fB--metafun\fP. +.IP \fB--help\fP +Print a terse help message. +.IP "\fB--metafun\fP" +Use the metafun pre-compiled format to process the MetaPost source +file. You usually don't need this option, since metafun input is +usually produced and processed as part of a +.BR texexec (1) +run. Needs the \fB--rawmp\fP switch to take effect. +.IP \fB--rawmp\fP +Process the source file with +.BR mpost (1) +directly, rather than with +.BR texexec (1). +This option is needed if you want to specify \fB--metafun\fP. +.IP \fB--latex\fP +Typeseting labels using +.BR latex (1) +rather than plain +.BR tex (1). + +.SH "USAGE" + +To convert \fImanfig.20\fP to \fImanfig-20.pdf\fI: +.EX +mptopdf manfig.20 +.EE + +You can convert more than one EPS file at once: +.EX +mptopdf manfig.20 otherfig.17 finalfig.8 +.EE + +Or you can give +.BR mptopdf (1) +a pattern that it will expand: +.EX +mptopdf 'manfig.*' +.EE +Note the single quotes to protect the * from the shell. Of course, +usually you can let the shell do the wildcard expansion and therefore +leave off the quotes. + +To convert +.I figs.mp +to \fIfigs-1.pdf\fP, \fIfigs-2.pdf\fP, ... +.EX +mptopdf figs.mp +.EE + +If the labels are typeset with +.BR latex (1): +.EX +mptopdf --latex figs.mp +.EE + +.SH "SEE ALSO" +.PP +.BR tex (1), +.BR latex (1), +.BR mpost (1), +.BR pdftex (1), +.BR texexec (1). +.PP +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +.BR mptopdf (1) +is part of the ConTeXt system by Hans Hagen et al, which is available from +.URL "http://www.pragma-ade.com/" "PRAGMA ADE" . +This manpage was written by Sanjoy Mahajan and is in +the public domain. diff --git a/Build/source/texk/texlive/context/pstopdf.man b/Build/source/texk/texlive/context/pstopdf.man new file mode 100644 index 00000000000..972f364cb19 --- /dev/null +++ b/Build/source/texk/texlive/context/pstopdf.man @@ -0,0 +1,75 @@ +.TH "PSTOPDF" "1" "December 2006" "pstopdf 2.0" "ConTeXt" +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac +.de EX +.in +3 +.nf +.ft CW +.. +.de EE +.in -3 +.ft R +.fi +.. + +.SH "NAME" +pstopdf \- convert EPS to PDF + +.SH "SYNOPSIS" +\fBpstopdf\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBpstopdf\fP converts EPS (encapsulated PostScript) to PDF. + +.SH OPTIONS +.TP +.B --help +Print usage and version information. +.TP +.B --convert +Convert EPS to PDF. This option is assumed if none is given. +.TP +.BI --method=\fIstring\fP +What method to use for bounding boxes when converting to PDF. +Specify one of \fBcrop\fP, \fBbounded\fP (the default), or \fBraw\fP. +Older versions of ConTeXt used numerical methods (1, 2, or 3). +.TP +.BI --resolution=\fIstring\fP +The resolution to use when when converting to pdf. +Specify one of \fBlow\fP, \fBnormal\fP, \fBmedium\fP, \fBhigh\fP, +\fBprinter\fP, \fBprint\fP, \fBscreen\fP, \fBebook\fP, or +\fBdefault\fP. +.TP +.B --request +Handle exa request file. +.TP +.B --watch +Watch folders for conversions (\fIuntested\fP). + +.SH EXAMPLES + +To make \fIcow.pdf\fP: +.EX +pstopdf cow.eps +.EE +or (one of several equivalents): +.EX +pstopdf --convert cow.eps cow.pdf +.EE + + +.SH "SEE ALSO" +.PP +.BR epstopdf (1), +.BR mptopdf (1), +.BR ps2pdf (1), +.BR texexec (1). +.PP +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +This (incomplete) manual page was written by Sanjoy Mahajan +. It is in the public domain. diff --git a/Build/source/texk/texlive/context/texexec.man b/Build/source/texk/texlive/context/texexec.man new file mode 100644 index 00000000000..19f56dab96b --- /dev/null +++ b/Build/source/texk/texlive/context/texexec.man @@ -0,0 +1,602 @@ +.TH "TEXEXEC" "1" "December 2006" "texexec 6.2" "ConTeXt" +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac +.de EX +.in +3 +.nf +.ft CW +.. +.de EE +.in -3 +.ft R +.fi +.. + +.SH "NAME" +texexec \- front end to the ConTeXt typesetting system + +.SH "SYNOPSIS" +\fBtexexec\fP [ \fIOPTION\fP ... ] \fIFILE\fP [ ... ] + +.SH "DESCRIPTION" + +\fBtexexec\fP, a \fBruby\fP(1) script, +is the command-line front end to the ConTeXt typesetting +system, an extensive macro package +built on the \fBtex\fP(1) family of typesetting programs. +\fBtexexec\fP provides several facilties: +.IP \(bu +Process a ConTeXt source file, +performing as many runs as +necessary of \fBtex\fP(1), \fBtexutil\fP(1), and +MetaPost (\fBmpost\fP(1)). Options control the output +format, the pages to process, paper size, and so forth. +.IP \(bu +Create new ConTeXt formats, useful during installation. +.IP \(bu +Post-process existing PDF files, including merging multiple +files, and extracting and rearranging pages within a file, +similar to the facilities provided for PostScript files by +\fBpsnup\fP(1) or for PDF files by \fBpdftk\fP(1). +.IP \(bu +Extract or strip documentation from ConTeXt source files +using \fBtexutil\fP(1). +.IP \(bu +Run MetaPost (\fBmpost\fP(1)) to generate figures from MetaPost source. +.IP \(bu +Produce proof sheets of figures used in a ConTeXt source file. +.IP +.SH "OPTIONS" + +All switches are specified in full here but can be abbreviated to the +shortest unique prefix. Thus, \fB--env\fP works the same as +\fB--environment\fP. With no options, \fBtexexec\fP assumes that +the file on the command line is a ConTeXt source file, i.e. a TeX file +in the ConTeXt dialect, and produces a PDF file using the source file. + +.SS "General Options" + +.IP "\fB--alone\fP" +Avoid calling other programs when possible. For +example, \fB--alone\fP will prevent \fBtexexec\fP from +using \fBfmtutil\fP(1) to generate formats (this prevention can +be handy when tracing installation problems). +.IP "\fB--environments\fP\fI=\fP\fIfile[,file[,...]]\fP" +Specify ConTeXt environment file(s), separated by commas, to use when +processing the source file. This option is useful when converting +from non-ConTeXt file formats without environment or layout settings. +.IP "\fB--help\fP" +Produce a summary of switches +and arguments. A more detailed help is produced by including +\fB--all\fP. +.IP "\fB--interface=\fP\fIlanguage\fP" +Specify the language +ConTeXt should use to communicate with you. +Options are +.IP +.RS +.IP "\fBen\fP" +US English +.IP "\fBnl\fP" +Dutch +.IP "\fBde\fP" +German +.IP "\fBuk\fP" +British English +.IP "\fBcz\fP" +Czech +.IP "\fBit\fP" +Italian +.RE +.IP "\fB--keep\fP" +Preserve a few of the temporary files generated while processing by +appending \fI.keep\fP to their name. For example, after +.EX +texexec --keep document.tex +.EE +you will find (besides \fIdocument.pdf\fP) \fIdocument.log.keep\fP +and \fIdocument.top.keep\fP. The \fIdocument.top\fP file is where +\fBtexexec\fP wraps \fIdocument.tex\fP with the proper ConTeXt macro +commands to set the output format, etc. +.IP "\fB--once\fP" +Process a file exactly once. (By default, +\fBtexexec\fP processes the file as many times as +necessary to sort out all references, typeset +\fBMetaPost\fP code, and so forth.) +.IP "\fB--purge\fP" +Get rid of most temporary files generated while processing the source +file. For example, +.EX +texexec --purge somefile.tex +.EE +will generate \fIsomefile.pdf\fP, cleaning up after itself and leaving +only one extra file, \fIsomefile.tuo\fP. See also the \fB--purge\fP +option of +.BR ctxtools (1) +.IP "\fB--purgeall\fP" +Get rid of all temporary files generated while processing the source +file, including the \fIfilename.tuo\fP file. See also the \fB--purge +--all\fP option combination of +.BR ctxtools (1) +.IP "\fB--randomseed=\fP\fINNNN\fP" +Set the random seed. +.IP "\fB--result=\fP\fIFILENAME\fP" +Allows you to change the +basename of the output file. See +\fB--mode\fP for an example. +.IP "\fB--runs=\fP\fINUMBER\fP" +Specify the number of runs to +perform on a file. Overrides +\fBtexexec\fP's calculations. +.IP "\fB--separation\fP" +Perform color separations. +.IP "\fB--silent\fP" +Suppress a few diagnostic and progress messages. +.IP "\fB--timeout=\fP\fINNN\fP" +Abort the run if a subprocess waits for more than \fINNN\fP seconds; +e.g. while waiting for user input when \fBtex\fP reports an undefined +control sequence. Useful for automated testing scripts, to make sure +the runs finish. +.IP "\fB--usemodules=\fP\fImodule1[,module2,[...]]\fP +Use the comma-separated list of modules. For example, to typeset +\fIdocument.tex\fP using the \fIbib\fP and \fIunits\fP modules: +.EX +texexec --usemodules=bib,units document.tex +.EE +.IP "\fB--verbose\fP" +Output extra diagnostic information. +.IP "\fB--version\fP" +Print the version number. +.IP + +.SS "Processing ConTeXt Source Files" + +Including specifying paper sizes, formats, and so forth. + +.IP "\fB--arrange\fP" +Perform page rearrangements, which are used to produce booklets. This +option tells ConTeXt to the first \fIn\fP-1 runs without taking +account of arrangements, then on the last run to pay attention to +the arrangement commands in the source file. +.IP "\fB--batchmode\fP" +Process the file in batchmode, which means +to typeset the whole document even if there are errors. More +imformation about \f(CWbatchmode\fP can be found in Donald +E. Knuth's \fITeXbook\fP. +.IP "\fB--nonstopmode\fP" +Process the file in nonstopmode, which means +to typeset the document and report errors, but not to stop at any +error. It is similar to batchmode but more verbose. More +imformation about \f(CWnonstopmode\fP can be found in Donald +E. Knuth's \fITeXbook\fP. +.IP "\fB--bodyfont=\fP\fIfont\fP" +The name of a font to preload for use in +setting the body of the text (OBSOLETE). +.IP "\fB--centerpage\fP" +Center the document on the page. +.IP "\fB--color\fP" +Turn on color mode. Color mode can also be set by +commands embedded in the document. These commands +override the \fB--color\fP option. +.IP "\fB--convert=\fP\fIFORMAT\fP" +Convert the input file to +ConTeXt format from \fIFORMAT\fP before +processing. In most cases, this conversion will result +in a TeX file. Currently supported input +\fIFORMAT\fPs are \fBxml\fP and +\fBsgml\fP. +.IP "\fB--dvipdfmx, --dvipdfm, --dpx, --dpm\fP" +Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) +to make a DVI file and \fBdvipdfmx\fP(1) to turn it +into PDF. +.IP "\fB--dvi, --ps, --dvips\fP" +Use the TeX engine (e.g. \fBpdftex\fP or \fBpdfetex\fP) +to make a DVI file and \fBdvips\fP(1) to turn it +into PostScript. It's counterintuitive that \fB--dvi\fP produces +a PostScript file in addition to the DVI file. But that's because +\fB--dvi\fP is shorthand for \fB--dvips\fP; adding the \fB--nobackend\fP +option prevents \fBtexexec\fP's running \fBdvips\fP(1). See also the +\fB--engine\fP option. +.IP "\fB--fast\fP" +Typeset the document(s) as fast as possible without +causing problems. +.IP "\fB--final\fP" +Perform a final run without skipping anything. +This option is typically used with \fB--fast\fP. +.IP "\fB--language=\fP\fILANGUAGE\fP" +Set the language for +hyphenation. Can be specified in your source file. +Options are the same as those for \fB--interface\fP. +.IP "\fB--mode=\fP\fIMODELIST\fP, \fB--modes=\fP\fIMODELIST\fP" +Allows you to change the mode used while typesetting the +source file. The \fIMODELIST\fP is a comma separated list of modes. +Modes are a conditional-compilation facility +like \f(CW#ifdef\fP in C. So one source file can be used to produce +several typeset documents: one for A4 paper, one for +screen display in full color, one for letter paper, etc. For +example: +.IP +.EX +\f(CWtexexec --pdf --mode=A4 --result=manual-a manual-t.tex\fP +\f(CWtexexec --pdf --mode=letter --result=manual-l manual-t.tex\fP +\f(CWtexexec --pdf --mode=screen --result=manual-s manual-t.tex\fP +.EE +.IP +Here the \fB--mode\fP tells ConTeXt which +mode directives to use when typesetting the source file. The +\fB--result\fP option tells ConTeXt +where to put the output file. +.IP "\fB--modefile=\fP\fIfile\fP" +Load this file before most of the usual processing; usually used for +mode-related material. +.IP "\fB--noarrange\fP" +Ignore arrangement commands in the source file. +.IP "\fB--nobackend\fP" +Do not run the backend, e.g. \fBdvips\fP(1) or \fBdvipdfmx\fP(1). See +the \fB--dvips\fP or \fB--dvipdfmx\fP options. Why would you give one +of those options to choose a backend, yet tell \fBtexexec\fP not to +run the backend? Because each backend has its own syntax for +\f(CW\\special\fP calls. Specifying the backend allows the ConTeXt +macros to use the correct syntax so that when you later run the +backend to produce PostScript or PDF, the specials will be interpreted +correctly. +.IP "\fB--pages=\fP\fIPAGENUMBERLIST\fP" +Specify the pages or page +range to appear in the output file. +\fIPAGENUMBERLIST\fP may be the keyword \fBodd\fP +or \fBeven\fP; or one or more pages or page ranges separated by commas. +For example, +.EX +\f(CWtexexec --pages=1,7,8-11,14 somefile.tex\fP +.EE +.IP "\fB--paperformat=\fP\fIKEY\fP" +For typesetting multiple pages on a +single piece of paper. \fIKEY\fP has the form \fBa4a3\fP +(for printing A4 pages on A3 paper), \fBa5a4\fP +(for printing A5 pages on A4 paper), or in general \fBaMaN\fP. +The actual layout of the pages is specified with the +\fB--printformat\fP option. +.IP "\fB--pdf, --pdftex\fP" +Use \fBpdftex\fP(1) to produce a pdf document (the default). +.IP "\fB--printformat=\fP\fIKEY\fP" +Specify the layout of the final +output. \fIKEY\fP can be \fBup\fP, resulting in 2 +pages per sheet, double sided; or \fBdown\fP, resulting +in 2 rotated pages per sheet, double sided. Use the +\fB--paperformat\fP option to specify the original page +and sheet size. +.IP "\fB--utfbom\fP" +Turn on UTF-8 encoding. +.IP "\fB--xetex, --xtx\fP" +Use \fBxetex\fP(1) to produce a pdf document. +.IP + +.SS "Creating ConTeXt Format Files" + +.IP "\fB--make\fP" +Generate a ConTeXt format file. For example, to make +\fIcont-en.fmt\fP and have it placed in a default format directory: +.EX +texexec --make de +.EE +The most common invocation, which is used by scripts that install a new version +of ConTeXt (see \fBctxtools\fP(1)), uses \fB--all\fP +so that \fBtexexec\fP makes the usual formats: +.EX +texexec --make --all +.EE +.IP "\fB--local\fP" +When searching for TeX or MetaPost formats, look in the current directory +rather than in the location set by the kpse library. See +.BR kpathsea (1) +for more information on path searching. +.IP "\fB--check\fP" +Check and report information about the ConTeXt version, the +distribution, the TeX engine, and the language interfaces/formats. + +.SS "Expert options" + +You should know what you're doing if you use these options! +.IP "\fB--alpha" +Use the TEXMFALPHA environment variable to find and +run an alpha release of ConTeXt. +.IP "\fB--beta" +Use the TEXMFBETA environment variable to find and +run a beta release of ConTeXt. +.IP "\fB--distribution\fP\fI=dist\fP" +Usually one of \fBstandard\fP, \fBweb2c\fP, or \fBmiktex\fP. +\fBtexexec\fP should figure it out automatically, and you shouldn't +need to use this option. +.IP "\fB--engine\fP\fI=texengine\fP" +Specify the program to do the hard work of typesetting. Currently +either \fBpdftex\fP (the default), \fBxetex\fP, or \fBaleph\fP. +The \fBluatex\fP value is experimental. The \fB--engine\fP +option is not usually needed. Instead, let +\fBtexexec\fP figure out the setting based on other command-line +information. See for example the \fB--xetex\fP or \fB--pdf\fP +switches. + +.SS "Postprocess PDF Files" + +.IP "\fB--combination=\fP\fIROWS\fP\fB*\fP\fICOLS\fP" +Specify the number of pages to show on a single page. Use with +\fB--pdfcombine\fP. +.IP "\fB--pdfarrange\fP" +For rearranging pages in PDF files. +.EX +\f(CWtexexec --pdfarrange --paperformat=a5a4 --printformat=up foo.pdf\fP +.EE +This command creates an A5 booklet from a PDF file +\fIfoo.pdf\fP. \fB--pdfarrange\fP is used in +conjunction with the following options. +.IP "\fB--pdfcopy\fP" +Copy and perhaps process pages from the pdf file. +The resulting file is \fItexexec.pdf\fP by default, but you can change +that using \fB--result\fP. Use the \fB--scale\fP option to magnify or +demagnify the original pages and the \fB--pages\fP option to select +the pages to copy. Here is an example using all these options: +.EX +texexec --pages=4-7 --pdfcopy --scale=750 --result=one images.pdf +.EE +It takes pages 4-7 from \fIimages.pdf\fP, scales them by 75%, +and copies them to \fIone.pdf\fP. +.IP "\fB--scale=\fP\fIinteger\fP" +If the integer is less than 10, then it is taken as an (integer) +magnification factor. Otherwise, it is taken as a magnification +factor in TeX terms, i.e. with 1000 meaning full scale. +.IP "\fB--paperoffset=\fP\fIdimen\fP" +Specify the space between the +edge of the pages and the beginning of the text block. +.IP "\fB--backspace=\fP\fIdimen\fP" +Specify the inside (gutter) margins. +.IP "\fB--topspace=\fP\fIdimen\fP" +Specify the top and bottom margin. +.IP "\fB--markings\fP" +Add crop marks. +.IP "\fB--addempty=\fP\fIPAGES\fP" +Add empty pages after the pages specified in \fIPAGES\fP. (Useful +for, among other things, adding blank pages after a table of +contents.) +.IP "\fB--textwidth=\fP\fIWIDTH\fP" +Set the width of +the original text. Specifying this parameter with a +single-sided original will allow ConTeXt to adjust +the page layout for double-sided output, producing much +more attractive results. + +With the \fB--pdfarrange\fP flag, specifying more +than one file will result in all of the files being +combined in the final result, allowing you to add title +pages, decorated part separators, and so forth. + +You can also do more complex manipulations, such as +adding additional text to the page by setting up a +small file with layout definitions and a simple figure +insertion loop. +.IP "\fB--pdfcombine\fP" +Combine multiple pages. Requires the \fB--combination\fP option. +.IP "\fB--pdfselect\fP" +Extract pages from a file. Use in combination with the +\fB--selection\fP switch, as in +.EX +\f(CWtexexec --pdfselect --paperformat=S6 +--selection=1,9,14 file-1\fP +.EE +which extracts pages 1, 9, and 14 from +\fIfile-1.pdf\fP, and places them in +\fItexexec.pdf\fP (the default output filename if +an output file isn't specified). + +See \fB--pdfarrange\fP for other +options. +.IP "\fB--selection=\fP\fIPAGES\fP" +Specify pages to be affected by +another option. See \fB--pdfarrange\fP and +\fB--pdfselect\fP for examples. + +.SS "XML handling" +.IP "\fB--filters=\fP\fIfilter1[,filter2[,...]]\fP +Specify XML filters to use. + +.SS "Extract or Strip Out Documentation" + +.IP "\fB--listing\fP" +Produce a typeset version of the source code in +\fIFILE\fP. You can specify the format of the output +file. For example, use +.EX +\f(CWtexexec --ps --listing readme.now\fP +.EE +to produce a PostScript file called +\fItexexec.ps\fP. + +See also \fB--backspace\fP, \fB--topspace\fP, and \fB--result\fP. +.IP "\fB--module\fP" +Create documentation for ConTeXt, +MetaPost (see \fBmpost\fP(1)), +.BR perl (1), +and +.BR ruby (1) +modules. +Converts the documentation to ConTeXt format and +then typesets a documentated version of the source file. + +Documentation lines in ConTeXt source files are +specified by beginning lines with these strings: + +\f(CW%C\fP : Copyright information + +\f(CW%D\fP : Documentation lines + +\f(CW%I\fP : TeXEdit information lines (mostly in Dutch) + +\f(CW%M\fP : Macro code needed to processs the documentation + +\f(CW%S\fP : Suppressed lines + +The same forms can be used for Perl or ruby scripts, except that the \f(CW%\fP +character (the TeX comment character) is replaced by \f(CW#\fP (the +Perl comment character). + +See also the \fB--documentation\fP option to +.BR ctxtools (1). + +.SS "Process MetaPost Figures" + +.IP "\fB--mpsformats=\fP\fIname\fP" +The name of a MetaPost format file, e.g. \fBmetafun\fP (the default). +.IP "\fB--mptex\fP" +Strips out and typesets TeX code embedded in a +MetaPost file. +.IP "\fB--nomp\fP" +Do not run \fBmpost\fP(1), even if needed. +.IP "\fB--nomprun\fP" +Do not run \fBmpost\fP(1) on embedded +MetaPost code. + +.SS "Producing Proof Sheets of Figures" + +Generate information and proof sheets of one or more (non-EPS) +graphics files. For example, +.EX +texexec --figures *.png *.jpg +.EE +scans the current directory for PNG and JPG files +and extracts useful information about their sizes and types. By +default, this information is stored in +.IR rlxtools.rli . +Then the given figures are made into a proof sheet (by default +\fItexexec.pdf\fP) according to the method specified by the +\fB--method\fP option. Note that newer versions of +.BR pdftex (1) +do not support TIFF inclusion. +.IP "\fB--method=\fP\fIALTERNATIVE\fP" +Specify one of three options to produce the document containing the images +used in the source file: + +\fBa\fP : A proof sheet with additional +information provided for each figure (the default) + +\fBb\fP : A proof sheet with the graphics only + +\fBc\fP : One figure per page, with the page +clipped to the bounding box of the +figure + +See also \fB--paperoffset\fP, +which allows you to specify an offset to be added to +the page, as in +.EX +texexec --figures --method=c --paperoffset=.5cm *.pdf *.png *.jpg +.EE + +.SH "USAGE" + +Each ConTeXt user interface (language) has its own format. The +following command generates two formats, one using the English +interface for typesetting in English, and one for Dutch: +.EX +\f(CWtexexec --make en nl\fP +.EE + +By default, the language used for typesetting matches the +user-interface language (set with +\fB--interface\fP. It is possible to use one +language for typesetting and another for messages by changing the +relevant settings in \fIcont-usr.tex\fP. These languages can +also be changed on the command line with a command such as +.IP +.RS +\f(CWtexexec --make --language=pl,cz,sk en\fP +.RE +.IP +That command generates a ConTeXt format file with an English user +interface, and the main language set to Polish (\fBpl\fP). Czech +and Slovak hyphenation patterns are also loaded +so that Czech and Slovak text included in a source file will be +typeset properly (\fBcz\fP and \fBsk\fP). +.IP o +When the appropriate formats are present, a file can be typeset +by typing +.EX +\f(CWtexexec test\fP +.EE +.IP +\fBtexexec\fP tries to determine what interface it should use to +typeset \fItest.tex\fP by looking for a line such as +.IP +.EX +\f(CW% interface=en tex=pdftex output=pdftex\fP +.EE +.IP +at the top of the file (i.e., on the very first line). This line is +equivalent to \fBTeX\fP's format line, ``&\fIFORMAT\fP''). +.IP +By default, \fBtexexec\fP will produce a PDF file using \fBpdftex\fP(1). The +\fB--dvips\fP flag tells \fBtexexec\fP to produce a PostScript +file instead. +.IP +After an error-free run, \fBtexexec\fP will run \fBtexutil\fP(1) to +determine whether additional runs of \fBtex\fP(1) (or +\fBpdftex\fP(1)) or any utility programs (e.g., \fBbibtex\fP(1), +\fBmakeindex\fP(1)) are necessary. You can suppress these +additional runs by specifying the \fB--once\fP or +\fB--runs\fP flags: +.IP +.EX +\f(CWtexexec --once test\fP +\f(CWtexexec --runs=2 test\fP +.EE +.IP + +.SH EXAMPLES +.TP +Produce PDF from ConTeXt source (the .tex extension is optional): +\f(CWtexexec file.tex\fP +.TP +Same as the above but without rerunning for crossreferences, etc.: +\f(CWtexexec --once file.tex\fP +.TP +Produce PostScript from ConTeXt source: +\f(CWtexexec --ps file.tex\fP +.TP +Produce file-a4.pdf using conditional compilation (modes): +\f(CWtexexec --mode=a4 --result=file-a4 file.tex\fP +.TP +Generate format (.fmt) files used by ConTeXt (used during installation): +\f(CWtexexec --make --all\fP + + +.SH "INITIALIZATION" +.IP +\fBtexexec\fP requires ruby. On Unix and Unix-like systems, no special +steps have to be taken to get \fBtexexec\fP to work beyond installing +ruby and having the \fBruby\fP(1) binary in your path. + +.SH "SEE ALSO" +.PP +\fBbibtex\fP(1), \fBctxtools\fP(1), \fBdvipdfmx\fP(1), \fBdvips\fP(1), +\fBfmtutil\fP(1), \fBmakeindex\fP(1), \fBmpost\fP(1), +\fBmptopdf\fP(1), \fBpdftex\fP(1), \fBpdftk\fP(1), \fBruby\fP(1), +\fBpsnup\fP(1), \fBtex\fP(1), \fBtexfont\fP(1), \fBtexmfstart\fP(1), +\fBtexshow\fP(1), +\fBtexutil\fP(1), \fBxetex\fP(1). +.PP +The texexec manual +.IR mtexexec.pdf , +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . +.PP +Donald E. Knuth's \fIThe TeXbook\fP. +.PP +.URL "http://www.contextgarden.net" "ConTeXt wiki" . + +.SH "AUTHOR" +This manpage was written by Tobias Burnus + and C.M. Connelly + and updated by Sanjoy Mahajan . +It is based on the +.I mtexexec.pdf +manual written by Hans Hagen . diff --git a/Build/source/texk/texlive/context/texmfstart.man b/Build/source/texk/texlive/context/texmfstart.man new file mode 100644 index 00000000000..e99ab230bd1 --- /dev/null +++ b/Build/source/texk/texlive/context/texmfstart.man @@ -0,0 +1,362 @@ +.TH "TEXMFSTART" "1" "December 2006" "texmfstart 2.0" "ConTeXt" +.de URL +\\$2 \(laURL: \\$1 \(ra\\$3 +.. +.if \n[.g] .mso www.tmac +.de EX +.in +3 +.nf +.ft CW +.. +.de EE +.in -3 +.ft R +.fi +.. + +.SH "NAME" +texmfstart \- run ConTeXt scripts, make ConTeXt wrapper scripts, view documents + +.SH "SYNOPSIS" +\fB texmfstart\fP [ \fIoptions ...\fP ] [ \fIfilename\fP ] [ \fIarguments ...\fP ] + +.SH "DESCRIPTION" +ConTeXt is a typesetting system based on the +.BR tex (1) +family of programs. +.B texmfstart +is a ConTeXt meta-script that can run subordinate +scripts (subscripts?) such as +.BR texexec (1), +.BR ctxtools (1), +or +.BR pdftools (1). +It can also generate short wrapper scripts to simplify common uses. +These scripts are often called +.I stubs +in the ConTeXt documentation. The options control +.BR texmfstart 's +behaviour, and the arguments are passed +to the program identified by +.IR filename . + +If the filename is a document, then +.B texmfstart +will start a viewer for that document. For example: +.EX +texmfstart showcase.pdf +.EE +will start an appropriate viewer for +.IR showcase.pdf . +See the +.B EXAMPLES +section. + +.SH OPTIONS + +.SS General: +.TP +.B --help, --version +print version information, usage, and examples. +.TP +.B --verbose +print status and progress information, for example what commands are +being executed. +.TP +.B --clear +don't pass info about locations to child processes. + +.SS Running a program: +.TP +.B --arguments=\fIstr\fP +an alternative for providing the arguments to be passed. For example, +.EX +texmfstart --arguments=b.tex texexec +.EE +will pass +.I b.tex +as the argument to +.BR texexec . +.TP +.B --report +dry run: report what command would be run, but do not run it +.TP +.B --locate +dry run: like \f(CW--report\fP but doesn't print the trailing newline. +.TP +.B --browser +view the document in a web browser (for Windows). +.TP +.B --file=\fIfilename\fP +an alternative way to specify the file (the program to run or document +to open). +.TP +.B --direct +run a program without searching for its location (assumes that the +program is on the PATH). +.TP +.B --execute +use the +.BR ruby (1) +.I exec +function instead of its +.I system +function. +.TP +.B --program=\fIstr\fP +the program space where +.BR kpsewhich (1) +will search (default: context). This information is given to +.B kpsewhich +as its \f(CW-progname\fP option. Usually you don't need this option. + +.SS Creating startup scripts: +.TP +.B --make +create a wrapper script or batch file to run the given file. +The wrapper scripts are put in the current path, which usually means +the current directory. If +\fIall\fP is given as the file, e.g. +.EX +texmfstart --make all +.EE +then make all the ConTeXt wrapper scripts (the stubs). +.TP +.B --windows +when making a wrapper script (stub), create a Windows batch (.bat) file. +Usually you +do not need to specify this option, as +.B texmfstart +will figure out what operating system you are using. +.TP +.B --linux +when making a wrapper script, create a Unix shell script. Usually you +do not need to specify this option, as +.B texmfstart +will figure out what operating system you are using. +.TP +.B --stubpath=\fIpath\fP +specify where to put the wrapper scripts (stubs). +.TP +.B --indirect +always use +.I texmfstart +in the wrapper script (stub). + +.SS Document viewing: +.TP +.B --page=\fInumber\fP +open the document at this page. + +.SS Environments and paths: +.TP +.B --path=\fIstr\fP +change to the specified path. +.TP +.B --tree=\fIstr\fP +use the given TEXMF tree. +.TP +.B --autotree +automatically determine the TEXMF tree to use (the default). +.TP +.B --environment=\fIstr\fP +use the given environment file. Its syntax is given in the +.I mtexmfstart.pdf +manual. +.TP +.B --showenv +print the environment variables known at runtime + +.SS Conditional execution: +.TP +.B --iftouched=\fIfile1,file2\fP +run only when the given files have different timestamps. +.TP +.B --ifchanged=\fIstr\fP +run only when the given file has changed (based on its last-computed MD5 +checksum). + +.SS Special features: +.TP +.B --edit +open the given file in an editor. + +.SH "FILENAME PREFIXES" +.SS +Optional prefixes determine the method used to search for the specified file: +.TP +.I bin:filename +expanded name based on the PATH environment variable +.TP +.I kpse:filename +expanded name based on +.BR kpsewhich (1) +result +.TP +.I rel:filename +expanded name relative to the current directory +.TP +.I env:name +expanded pathname based on environment variable +.I name +.TP +.I path:filename +path part of filename as located by +.BR kpsewhich (1) + +.SH EXAMPLES +.TP +\f(CWtexmfstart texexec.rb file.tex\fP +Locate the +.I texexec.rb +script and run it with +.I file.tex +as its argument. In other words, make +.I file.pdf +from +.IR file.tex . +If +.BR texexec (1) +is properly installed on your system, +this common invocation can be shortened to +.EX +\f(CWtexexec file.tex\fP +.EE +.TP +\f(CWtexmfstart texexec file.tex\fP +Locate the +.BR texexec (1) +program (currently a +.BR ruby (1) +script, +.IR texexec.rb ) +and run it with +.I file.tex +as its argument, producing +.I file.pdf. +This invocation can be shortened to +.EX +texexec file.tex +.EE +.TP +\f(CWtexmfstart ctxtools --updatecontext\fP +Run the +.BR ctxtools (1) +script, updating the ConTeXt installation. This +invocation is equivalent to +.EX +ctxtools --updatecontext +.EE +.TP +\f(CWtexmfstart pstopdf --method=3 cow.eps\fP +Convert +.I cow.eps +to PDF using method 3 of +.BR pstopdf (1). +This invocation is equivalent to +.EX +pstopdf --method=3 cow.eps +.EE +.TP +\f(CWtexmfstart --make --stubpath=/usr/local/bin texexec\fP +Make a wrapper script (stub), either a shell script +.I /usr/local/bin/texexec +on Unix, or a batch file \fI\\usr\\local\\bin\\texexec.bat\fP +on Windows. On Unix (and maybe on Windows?), you need to make +the script executable; see +.BR chmod (1). +.TP +\f(CWtexmfstart --edit kpse:cont-sys.tex\fP +Locate and edit the \fIcont-sys.tex\fP configuration file. +.TP +\f(CWtexmfstart --ifchanged=whatever.mp texexec --mpgraphic whatever.mp\fP +Rerun +.B texexec +if +.I whatever.mp +has changed since the last use of +.IR --ifchanged . +.TP +\f(CWtexmfstart --ifchanged=whatever.mp bin:echo rerun MetaPost\fP +If the +.I whatever.mp +source file has changed since the last use of +.IR --ifchanged , +then use the +.BR echo (1) +command to tell the user to rerun MetaPost +.RB "(see " mpost (1)). +This example shows that +.B texmfstart +can be used to run any script, not just ConTeXt scripts. The +\f(CWbin:\fP prefix tells +.B texmfstart +not to search for +.I echo +in the TEXMF tree(s), but to assume that it's an executable somewhere +on the PATH. +.TP +\f(CWtexmfstart --ifchanged=whatever.mp --direct echo rerun MetaPost\fP +This invocation has the same effect as the preceding example, but +using \f(CW--direct\fP instead of the \f(CWbin:\fP prefix, again to tell +.B texmfstart +not to search for the +.I echo +command. + +.SH FILES +.TP +.I file.md5 +MD5 checksum file used for the \f(CW--ifchanged\fP option. + +.SH ENVIRONMENT +.TP +PATH +For expanding filenames given with a +.I bin +prefix. +.TP +TEXMFSTART_EDITOR, EDITOR, editor +Editor to use with +.IR --edit . +The environment variables are looked up in that order, with the first +setting found taking priority. + +.SH "SEE ALSO" +.PP +.BR ctxtools (1), +.BR kpsewhich (1), +.BR makempy (1), +.BR mpost (1), +.BR pdftools (1), +.BR pstopdf (1), +.BR texexec (1), +.BR texfont (1), +.BR texutil (1). +.PP +.URL "http://www.contextgarden.net" "ConTeXt wiki" . +.PP +The +.B texmfstart +manual, +.IR mtexmfstart.pdf , +available from +.URL "http://www.pragma-ade.com/dir/general/manuals/" "PRAGMA ADE" . + +.SH BUGS +On Unix, opening a PDF document first tries +.B pdfopen +then +.BR acroread , +neither of which may be present on your system. + +The \f(CW--report\fP option doesn't work if you specify a filename +prefix (i.e. it does a real run instead of a dry run). + +.SH "AUTHOR" +ConTeXt is written and maintained by +.URL "http://www.pragma-ade.com" "Hans Hagen" . +This man page, which is in the public domain, was written by Sanjoy +Mahajan based on the +.I mtexmfstart.pdf +manual. diff --git a/Build/source/texk/texlive/linked_scripts/Makefile.in b/Build/source/texk/texlive/linked_scripts/Makefile.in index 47215440536..14a47db7b24 100644 --- a/Build/source/texk/texlive/linked_scripts/Makefile.in +++ b/Build/source/texk/texlive/linked_scripts/Makefile.in @@ -37,7 +37,8 @@ DIST_COMMON = $(nobase_dist_script_SCRIPTS) \ $(nobase_dist_scriptx_SCRIPTS) $(srcdir)/Makefile.am \ $(srcdir)/Makefile.in ChangeLog ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 -am__aclocal_m4_deps = $(top_srcdir)/configure.ac +am__aclocal_m4_deps = $(top_srcdir)/../../m4/kpse-win32.m4 \ + $(top_srcdir)/configure.ac am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ $(ACLOCAL_M4) mkinstalldirs = $(install_sh) -d -- cgit v1.2.3