Welcome to ftp.nluug.nl Current directory: /ftp/pub/os/Linux/distr/CTAN/macros/plain/contrib/transparent-io/ |
|
Contents of README:This package provides macros to make the file I/O in plain TeX more transparent. That is, every \input, \openin, and \openout operation by TeX is presented to the user who must check carefully what's going on and then has to enter several inputs including the repetition of the file name if the file I/O is accepted. The application of the macros requires concentration; don't execute TeX with an instrumented source file hastily. Moreover, to use the macros successfully you must have a non-beginner's knowledge of TeX. The macros are installed in an non-trivial process. The process is described in the manual for a UNIX-like system. You must be able to run sed and bash. >>> PACKAGE MAINTAINERS: This package cannot and should not be used from the TDS without an __individual__ installation by the user. The installation procedure renames the files and relocates them. I use the words package, program, TrIO macros, or TrIO when I refer to the program statements in the twelve files named either TrIO*.org (see below) or TrIO*.tex (six files, see below), openin.tex, openout.tex, TrIO*.sed (three files, see below), and TrIO.sh after the installation. 1. TrIOmacros.org: main file to instrument a source file 2. TrIOsupport.org: common macros to TrIOmacros.tex and TrIOauto.tex 3. TrIOprivate.org: copies of control sequences and test routines 4. TrIOinput.org: called for every \input 5. TrIOopenin.org: entered by the user for every \openin 6. TrIOopenout.org: entered by the user for every \openout 7. TrIOextract.org: sed script to create TrIOnames.tex (see manual) 8. TrIOlineno.org: another sed script to create TrIOnames.tex 9. TrIOauto.org: replacement for TrIOmacros.tex in repeated executions 10. TrIOopen.org: called for every I/O command in TrIOnames.tex 11. TrIO.org: bash script to install the package 12. TrIOinstall.org: sed script to set passwords and private messages The last two files are only used for the installation. They must be renamed and edited, see the manual. During their execution they will change and rename the other ten files. The first six files are renamed during the installation so that all have the extension .tex instead of .org; in the names of files 5 and 6 the ``TrIO'' prefix is deleted too. Files 7--10 are also renamed: The first two become sed scripts the other two .tex files. This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 3 of the License. This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with this program. If not, see <http://www.gnu.org/licenses/>. The package consists of the following files: TrIO*.org -- 12 files (see above) that must be customized to become an installation Transparent-IO-doc.pdf -- a manual that describes the installation and the use of the TrIO macros Transparent-IO-doc.tex -- the source of the manual; it requires plain TeX Transparent-IO-example.tex -- an example from the documentation Transparent-IO-eccentric.tex -- another example from the documentation Transparent-IO-hello.tex -- used in the above two examples Transparent-IO-TUGboat-danger.tex -- see the TUGboat article referenced in the documentation for its relevance; rename the file to ``danger.tex'' if you want to run this example README -- this file Copyright (C) 2022 Udo Wermuth (author) u dot wermuth (at) icloud dot com |
Name Last modified Size
Parent Directory - README 13-Aug-2022 08:47 3.9K TrIO.org 13-Aug-2022 08:47 664 TrIOauto.org 13-Aug-2022 08:47 2.6K TrIOextract.org 13-Aug-2022 08:47 908 TrIOinput.org 13-Aug-2022 08:47 654 TrIOinstall.org 13-Aug-2022 08:47 583 TrIOlineno.org 13-Aug-2022 08:47 1.0K TrIOmacros.org 13-Aug-2022 08:47 5.8K TrIOopen.org 13-Aug-2022 08:47 594 TrIOopenin.org 13-Aug-2022 08:47 716 TrIOopenout.org 13-Aug-2022 08:47 717 TrIOprivate.org 13-Aug-2022 08:47 9.8K TrIOsupport.org 13-Aug-2022 08:47 7.2K Transparent-IO-TUGboat-danger.tex 13-Aug-2022 08:47 724 Transparent-IO-doc.pdf 13-Aug-2022 08:47 158K Transparent-IO-doc.tex 13-Aug-2022 08:47 35K Transparent-IO-eccentric.tex 13-Aug-2022 08:47 192 Transparent-IO-example.tex 13-Aug-2022 08:47 118 Transparent-IO-hello.tex 13-Aug-2022 08:47 12
NLUUG - Open Systems. Open Standards
Become a member
and get discounts on conferences and more, see the NLUUG website!