diff options
author | Karl Berry <karl@freefriends.org> | 2011-04-28 00:04:56 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2011-04-28 00:04:56 +0000 |
commit | c7e9f66df61c9c61c19ef41ad0c990215b01068a (patch) | |
tree | 22a19c3a01648a2d329500b12443b74abd69429e /Build/source/texk/web2c/doc | |
parent | 3693d1d9a9e0ea4daa929884ca237b14a8749a20 (diff) |
-recorder .fls name caveats
git-svn-id: svn://tug.org/texlive/trunk@22228 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Build/source/texk/web2c/doc')
-rw-r--r-- | Build/source/texk/web2c/doc/web2c.info | 177 | ||||
-rw-r--r-- | Build/source/texk/web2c/doc/web2c.texi | 26 |
2 files changed, 105 insertions, 98 deletions
diff --git a/Build/source/texk/web2c/doc/web2c.info b/Build/source/texk/web2c/doc/web2c.info index 3a90c4ee0d6..b93b9ea0c75 100644 --- a/Build/source/texk/web2c/doc/web2c.info +++ b/Build/source/texk/web2c/doc/web2c.info @@ -538,12 +538,7 @@ common: `-output-directory=DIRNAME' Specify the directory DIRNAME to which output files are written. Also look for input files in DIRNAME first, before looking along - the normal search path. This is useful when you are in some - read-only distribution directory, perhaps on a CD-ROM, and want to - TeX some documentation, for example. Note that for input files - the "search" in DIRNAME does not use the full generality of the - search mechanism. This means that some files are not found there - even though you might expect them to be. + the normal search path. *Note Output file location::. `-parse-first-line' `-no-parse-first-line' @@ -564,6 +559,13 @@ common: `.fls'. For Aleph, this option is always on, and the file has extension `.ofl'. + Ordinarily, the `.fls' file is written to the same location as the + `.log' file, for example, respecting `-output-directory' if it is + given (*note Output file location::). However, if TeX processing + is done on the command line (or in response to the `**' prompt), + the `.fls' might be written to the current directory, or include + an integer (the current pid), as in `texput1234.fls'. + `-translate-file=TCXFILE' Use TCXFILE to define which characters are printable and translations between the internal and external character sets. @@ -624,13 +626,14 @@ in the specified directory instead. *Note Common options::. If the current directory is not writable, and `-output-directory' is not specified, the main programs (TeX, Metafont, MetaPost, and BibTeX) -make an exception: if the config file value `TEXMFOUTPUT' is set (it is -not by default), output files are written to the directory specified. +make an exception: if the config file or environment variable value +`TEXMFOUTPUT' is set (it is not by default), output files are written +to the directory specified. `TEXMFOUTPUT' is also checked for input files, as TeX often generates files that need to be subsequently read; for input, no -suffixes (such as `.tex') are added by default, the input name is -simply checked as given. +suffixes (such as `.tex') are added by default and no exhaustive path +searching is done, the input name is simply checked as given. File: web2c.info, Node: Three programs, Prev: Output file location, Up: Commonalities @@ -3543,7 +3546,7 @@ Index (line 59) * --with-x: Online Metafont graphics. (line 57) -* -8bit: Common options. (line 103) +* -8bit: Common options. (line 105) * -base=BASE: Determining the memory dump to use. (line 15) * -base=DUMPNAME: Common options. (line 34) @@ -3591,9 +3594,9 @@ Index * -no-file-line-error: Common options. (line 26) * -no-mktex=FILETYPE <1>: mf invocation. (line 87) * -no-mktex=FILETYPE: tex invocation. (line 105) -* -no-parse-first-line: Common options. (line 78) +* -no-parse-first-line: Common options. (line 73) * -no-shell-escape: tex invocation. (line 123) -* -oem: Common options. (line 108) +* -oem: Common options. (line 110) * -output-comment=STRING: tex invocation. (line 115) * -output-directory <1>: Output file location. (line 15) @@ -3602,11 +3605,11 @@ Index * -overflow-label-offset=POINTS: gftodvi invocation. (line 59) * -page-start=PAGE-SPEC <1>: dvitype invocation. (line 50) * -page-start=PAGE-SPEC: dvicopy invocation. (line 28) -* -parse-first-line: Common options. (line 77) +* -parse-first-line: Common options. (line 72) * -progname=STRING <1>: Determining the memory dump to use. (line 18) -* -progname=STRING: Common options. (line 83) -* -recorder: Common options. (line 90) +* -progname=STRING: Common options. (line 78) +* -recorder: Common options. (line 85) * -shell-escape: tex invocation. (line 122) * -shell-restricted: tex invocation. (line 124) * -show-opcodes: dvitype invocation. (line 56) @@ -3615,7 +3618,7 @@ Index * -T: mpost invocation. (line 118) * -terse: bibtex invocation. (line 28) * -tex=TEXPROGRAM: mpost invocation. (line 121) -* -translate-file=TCXFILE: Common options. (line 96) +* -translate-file=TCXFILE: Common options. (line 98) * -troff: mpost invocation. (line 118) * -underline: tangle invocation. (line 41) * -uppercase: tangle invocation. (line 35) @@ -3636,7 +3639,7 @@ Index * .NNN PostScript figures: mpost invocation. (line 37) * .NNNgf generic fonts: mf invocation. (line 34) * .tcx character translation files <1>: TCX files. (line 6) -* .tcx character translation files: Common options. (line 96) +* .tcx character translation files: Common options. (line 98) * .tex: tex invocation. (line 20) * .tfm output <1>: mpost invocation. (line 37) * .tfm output: mf invocation. (line 43) @@ -3645,8 +3648,8 @@ Index * .Xresources: Online Metafont graphics. (line 69) * 2602gf: mf invocation. (line 48) -* 8 bit clean: Common options. (line 103) -* 8 bit clean output, specifying: Common options. (line 103) +* 8 bit clean: Common options. (line 105) +* 8 bit clean output, specifying: Common options. (line 105) * 8-bit characters: TCX files. (line 6) * \bibliography: bibtex invocation. (line 18) * \bibliographystyle: bibtex invocation. (line 18) @@ -3730,7 +3733,7 @@ Index (line 6) * BigEndian machines: Hardware and memory dumps. (line 6) -* binaries, linking: Common options. (line 83) +* binaries, linking: Common options. (line 78) * blank lines, in TCX files: TCX files. (line 67) * boxes, memory for: Runtime options. (line 20) * breakpoints, memory for: Runtime options. (line 20) @@ -3875,10 +3878,10 @@ Index * FAMILY property: tftopl invocation. (line 96) * Ferguson, Michael: MLTeX. (line 6) * file formats for fonts: Font file formats. (line 6) -* file recorder: Common options. (line 90) +* file recorder: Common options. (line 85) * filename conventions, in input files: \input filenames. (line 6) * filenames starting with -: Option conventions. (line 19) -* first line of the main input file: Common options. (line 96) +* first line of the main input file: Common options. (line 98) * fixed-point arithmetic: Compile-time options. (line 22) * FIXPT: Compile-time options. @@ -4027,7 +4030,7 @@ Index * LIG property: tftopl invocation. (line 102) * ligature table, in TFM files: tftopl invocation. (line 102) * LIGTABLE property: tftopl invocation. (line 102) -* linking binaries: Common options. (line 83) +* linking binaries: Common options. (line 78) * links to binaries: Determining the memory dump to use. (line 32) * literate programming: WEB. (line 6) @@ -4163,7 +4166,7 @@ Index * packet length: pktype invocation. (line 50) * page, starting <1>: dvitype invocation. (line 50) * page, starting: dvicopy invocation. (line 28) -* parsing the first line: Common options. (line 78) +* parsing the first line: Common options. (line 73) * Pascal, creating from WEB: tangle invocation. (line 6) * patgen: patgen invocation. (line 6) * path searching: Path searching. (line 6) @@ -4357,7 +4360,7 @@ Index * texmfmp.c: Online Metafont graphics. (line 80) * TEXMFOUTPUT, used for reading: Output file location. - (line 24) + (line 25) * TEXMFOUTPUT, used if . unwritable: Output file location. (line 19) * texput: tex invocation. (line 35) @@ -4376,7 +4379,7 @@ Index * toolkits, X: Online Metafont graphics. (line 59) * torture tests: Triptrap. (line 6) -* translation file for TeX, specifying: Common options. (line 96) +* translation file for TeX, specifying: Common options. (line 98) * translation from WEB to C: Introduction. (line 17) * trap Make target: Additional targets. (line 41) * trap test: Triptrap. (line 6) @@ -4407,7 +4410,7 @@ Index (line 50) * unsrt.bst: Basic BibTeX style files. (line 39) -* using local codepage to display messages: Common options. (line 108) +* using local codepage to display messages: Common options. (line 110) * UTF-8 input: tex invocation. (line 89) * validation, of DVI files: dvitype invocation. (line 6) * validation, of GF files: gftype invocation. (line 6) @@ -4489,64 +4492,64 @@ Node: Runtime options15162 Node: Commonalities16934 Node: Option conventions17539 Node: Common options18763 -Node: Path searching23275 -Node: Output file location24297 -Node: Three programs25557 -Node: Initial and virgin26316 -Node: Memory dumps27416 -Node: Creating memory dumps27883 -Node: Determining the memory dump to use29144 -Node: Hardware and memory dumps30768 -Node: Editor invocation33237 -Node: \input filenames33967 -Node: TeX36960 -Node: tex invocation38106 -Node: Initial TeX45076 -Node: Formats46565 -Node: Languages and hyphenation49504 -Node: MLTeX49934 -Node: \charsubdef51429 -Node: \tracingcharsubdef53755 -Node: TCX files54330 -Node: patgen invocation59754 -Node: Shell escapes60471 -Node: IPC and TeX64035 -Node: TeX extensions64605 -Node: Metafont65737 -Node: mf invocation67025 -Node: Initial Metafont70908 -Node: Modes72661 -Node: Online Metafont graphics74917 -Node: gftodvi invocation78332 -Node: mft invocation81165 -Node: MetaPost85220 -Node: mpost invocation85982 -Node: Initial MetaPost91240 -Node: dvitomp invocation93051 -Node: BibTeX93716 -Node: bibtex invocation94077 -Node: Basic BibTeX style files96402 -Node: WEB97744 -Node: tangle invocation98952 -Node: weave invocation101075 -Node: pooltype invocation102483 -Node: DVI utilities103613 -Node: dvicopy invocation104557 -Node: dvitype invocation105855 -Node: dvitype output example108210 -Node: Font utilities111261 -Node: Font file formats112441 -Node: gftopk invocation115740 -Node: pktogf invocation116944 -Node: pktype invocation118123 -Node: gftype invocation120958 -Node: tftopl invocation125474 -Node: pltotf invocation130108 -Node: vftovp invocation131173 -Node: vptovf invocation133457 -Node: Font utilities available elsewhere134511 -Node: Legalisms136919 -Node: References139090 -Node: Index143662 +Node: Path searching23356 +Node: Output file location24378 +Node: Three programs25703 +Node: Initial and virgin26462 +Node: Memory dumps27562 +Node: Creating memory dumps28029 +Node: Determining the memory dump to use29290 +Node: Hardware and memory dumps30914 +Node: Editor invocation33383 +Node: \input filenames34113 +Node: TeX37106 +Node: tex invocation38252 +Node: Initial TeX45222 +Node: Formats46711 +Node: Languages and hyphenation49650 +Node: MLTeX50080 +Node: \charsubdef51575 +Node: \tracingcharsubdef53901 +Node: TCX files54476 +Node: patgen invocation59900 +Node: Shell escapes60617 +Node: IPC and TeX64181 +Node: TeX extensions64751 +Node: Metafont65883 +Node: mf invocation67171 +Node: Initial Metafont71054 +Node: Modes72807 +Node: Online Metafont graphics75063 +Node: gftodvi invocation78478 +Node: mft invocation81311 +Node: MetaPost85366 +Node: mpost invocation86128 +Node: Initial MetaPost91386 +Node: dvitomp invocation93197 +Node: BibTeX93862 +Node: bibtex invocation94223 +Node: Basic BibTeX style files96548 +Node: WEB97890 +Node: tangle invocation99098 +Node: weave invocation101221 +Node: pooltype invocation102629 +Node: DVI utilities103759 +Node: dvicopy invocation104703 +Node: dvitype invocation106001 +Node: dvitype output example108356 +Node: Font utilities111407 +Node: Font file formats112587 +Node: gftopk invocation115886 +Node: pktogf invocation117090 +Node: pktype invocation118269 +Node: gftype invocation121104 +Node: tftopl invocation125620 +Node: pltotf invocation130254 +Node: vftovp invocation131319 +Node: vptovf invocation133603 +Node: Font utilities available elsewhere134657 +Node: Legalisms137065 +Node: References139236 +Node: Index143808 End Tag Table diff --git a/Build/source/texk/web2c/doc/web2c.texi b/Build/source/texk/web2c/doc/web2c.texi index 64c4be49372..ed8d2921756 100644 --- a/Build/source/texk/web2c/doc/web2c.texi +++ b/Build/source/texk/web2c/doc/web2c.texi @@ -382,13 +382,7 @@ to get all available output. @cindex output directory, specifying Specify the directory @var{dirname} to which output files are written. Also look for input files in @var{dirname} first, before looking along -the normal search path. This is useful when you are in some read-only -distribution directory, perhaps on a CD-ROM, and want to @TeX{} some -documentation, for example. -@c FIXME: caveat to -output-directory -Note that for input files the ``search'' in @var{dirname} does -not use the full generality of the search mechanism. This means that -some files are not found there even though you might expect them to be. +the normal search path. @xref{Output file location}. @item -parse-first-line @opindex -parse-first-line @@ -417,6 +411,14 @@ Enable the filename recorder. This makes the program save a list of the opened files into a file with (by default) extension @samp{.fls}. For Aleph, this option is always on, and the file has extension @samp{.ofl}. +Ordinarily, the @samp{.fls} file is written to the same location as +the @samp{.log} file, for example, respecting +@option{-output-directory} if it is given (@pxref{Output file +location}). However, if @TeX{} processing is done on the command line +(or in response to the @samp{**} prompt), the @samp{.fls} might be +written to the current directory, or include an integer (the current +pid), as in @file{texput1234.fls}. + @item -translate-file=@var{tcxfile} @opindex -translate-file=@var{tcxfile} @cindex translation file for @TeX{}, specifying @@ -499,16 +501,18 @@ written in the specified directory instead. @xref{Common options}. @cindex readonly directory, running @TeX{} in If the current directory is not writable, and @samp{-output-directory} is not specified, the main programs (@TeX{}, Metafont, MetaPost, and -Bib@TeX{}) make an exception: if the config file value -@code{TEXMFOUTPUT} is set (it is not by default), output files are -written to the directory specified. +Bib@TeX{}) make an exception: if the config file or environment +variable value @code{TEXMFOUTPUT} is set (it is not by default), +output files are written to the directory specified. @vindex TEXMFOUTPUT@r{, used for reading} @code{TEXMFOUTPUT} is also checked for input files, as @TeX{} often generates files that need to be subsequently read; for input, no -suffixes (such as @samp{.tex}) are added by default, the input name is +suffixes (such as @samp{.tex}) are added by default and no exhaustive +path searching is done, the input name is simply checked as given. + @node Three programs @section Three programs: Metafont, MetaPost, and @TeX{} |