[PYTHON DOC-SIG] Re: [PYTHON MATRIX-SIG] Alpha release of new tutorial for 1.0a5

[Bill Janssen]

Excerpts from direct: 6-Nov-96 Re: [PYTHON DOC-SIG] Re: [P.. Guido van
Rossum@cnri.re (539)

> One short-term solution would be to use conditional inclusion.  I
> believe texinfo supports this -- you can have one version of a
> paragraph/sentence/word for one back-end (e.g. TeX), and another for
> the others.  I *think*...

Yes; here's the relevant section from the TeXinfo manual:

    Using Ordinary TeX Commands
    ===========================

       Inside a region delineated by `@iftex' and `@end iftex', you can
    embed some PlainTeX commands.  Info will ignore these commands since
    they are only in that part of the file which is seen by TeX.  You can
    write the TeX commands as you would write them in a normal TeX file,
    except that you must replace the `\' used by TeX with an `@'.  For
    example, in the `@titlepage' section of a Texinfo file, you can use the
    TeX command `@vskip' to format the copyright page.  (The `@titlepage'
    command causes Info to ignore the region automatically, as it does with
    the `@iftex' command.)

       However, many features of PlainTeX will not work, as they are
    overridden by features of Texinfo.

       You can enter PlainTeX completely, and use `\' in the TeX commands,
    by delineating a region with the `@tex' and `@end tex' commands.  (The
    `@tex' command also causes Info to ignore the region, like the `@iftex'
    command.)

       For example, here is a mathematical expression written in PlainTeX:

         @tex
         $$ \chi^2 = \sum_{i=1}^N
                   \left (y_i - (a + b x_i)
                   \over \sigma_i\right)^2 $$
         @end tex

    The output of this example will appear only in a printed manual.  If
    you are reading this in Info, you will not see anything after this
    paragraph.

=================
DOC-SIG  - SIG for the Python Documentation Project

send messages to: doc-sig@python.org
administrivia to: doc-sig-request@python.org
=================