summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/cstex/opmac-u-en.tex
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2014-08-16 21:43:28 +0000
committerKarl Berry <karl@freefriends.org>2014-08-16 21:43:28 +0000
commit9caacf53d7d2a1620a603aa644617293a60183e2 (patch)
tree231eaf764696a85098e37d8ec19045fbb72c0a77 /Master/texmf-dist/doc/cstex/opmac-u-en.tex
parent48523b6ca61cfc84ac2bbe578b12fed09cbd70eb (diff)
cstex (16aug14)
git-svn-id: svn://tug.org/texlive/trunk@34952 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/cstex/opmac-u-en.tex')
-rw-r--r--Master/texmf-dist/doc/cstex/opmac-u-en.tex69
1 files changed, 45 insertions, 24 deletions
diff --git a/Master/texmf-dist/doc/cstex/opmac-u-en.tex b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
index 95408df9a3e..82c65e45165 100644
--- a/Master/texmf-dist/doc/cstex/opmac-u-en.tex
+++ b/Master/texmf-dist/doc/cstex/opmac-u-en.tex
@@ -32,24 +32,25 @@
\nonum \sec Introduction
%%%%%%%%%%%%
-The OPmac package is simple additional macros to plain\TeX{}. It enables
-users to take advantage of basic \LaTeX{} functionality: the font size
-selection, automatic creation of table of contents and index, working with
-bibliography databases, tables, references including hyperlinks option,
-margins settings, etc.
-
-I have decided to publish my macros together with the new version of
-\csplain{}. I am using these macros long time for various purposes only in
-my own computer. Now, I have made them more clean and added the user and
-technical documentation and released them.
-
-The main reason is to give a set of macros which solves the common tasks to
-the plain\TeX{} users. The side effect is that the macros demonstrate
-that it is possible to do \TeX{} code simple and effective. Most of
-\LaTeX{} macro packages don't have this feature. All macros are in the single
-documented file "opmac.tex" with only 1700 lines. On the other hand the
-\LaTeX{} code which solves comparable tasks is placed in kernel and tens
-of \LaTeX{} packages with many tens of thousands lines in total.
+The OPmac package is a set of simple additional macros to plain\TeX{}. It
+enables users to take advantage of basic \LaTeX{} functionality: font size
+selection, the automatic creation of a table of contents and an index, working
+with bibliography databases, tables, references with optional hyperlinks, margin
+settings, etc.
+
+I had been using these macros personally for a long time, but now, after
+cleaning up the code a bit and providing both user and technical documentation,
+I'm releasing them to the general public along with the new version of
+\csplain{}.
+
+My main motivation in publishing OPmac is to provide a set of macros with
+solutions to common tasks for plain\TeX{} users. Additionally, I wanted to
+demonstrate that it is possible to write \TeX{} code in a simple and effective
+style, something that most \LaTeX{} macro packages lack. All of OPmac's macros
+are contained within the single file "opmac.tex" in only 1,700
+lines. By comparison, the \LaTeX{} code which solves comparable tasks is placed
+inside its ``kernel'' along with many \LaTeX{} packages all of which contain
+tens of thousands of lines.
The main principles which I followed when creating this macro package, are:
@@ -95,7 +96,7 @@ Here is a text.
\bye
\endtt
-You can use \TeX, pdf\TeX, Xe\TeX{} or lua\TeX{} with eplain or \csplain{}
+You can use \TeX, pdf\TeX, Xe\TeX{} or lua\TeX{} with "etex.src" or \csplain{}
preloaded. The \csplain{} is recommended but it is not explicitly requested if you
don't need to use Czech/Slovak specific features\fnote
{Warnings: ``falling back to ASCII sorting''
@@ -134,10 +135,26 @@ i.e. the value stays unchanged. Examples:
\typoscale[\magstep2/] % fonts bigger 1,44times
\endtt
-The sizes declared by these macros (for example in titles) are relative to
-the basic size selected for the font (this may be arbitrary size, not only
+The sizes declared by these macros (for example in titles) are relative to the
+basic size selected for the current font (this may be arbitrary size, not only
10pt).
+There are times however, when one would like to make a font change relative to
+the documents ``base'' font size instead of the current font (e.g. when
+typesetting footnotes). The macro "\typobase" provides an easy way to perform
+such changes. The ``base'' font size is set with the first use of either
+"\typosize" or "\typoscale" and this size is restored by "\typobase". Example:
+
+\begtt
+\typosize[12/14] % if first use of \typosize, then this sets the "base"
+...
+{\typoscale[16/18] % bigger size (for example title font)
+ ...
+ \typobase\typoscale[750/750] % reduced to 75% of [12/14] (i.e. [9/10.5])
+ ... % this is caculated from "base", no from actual title font
+}
+\endtt
+
The size of the current font can be changed by the command
"\thefontsize[<font-size>]" or can be rescaled by
"\thefontscale[<factor>]". These macros don't change math fonts sizes nor
@@ -290,6 +307,10 @@ If there are forward referenced objects then user have to run \TeX{} twice.
During each pass, the working "*.ref" file (with refereces data) is created
and this file is used (if it exists) at the begin of the document.
+You can create a reference to whatever else by commands
+"\label[<label>]\wlabel{<text>}". The connection between "<label>" and
+"<text>" is established. The "\ref[<label>]" will print "<text>".
+
\sec Lists
%%%%%%%%%%
@@ -501,7 +522,7 @@ instead "\localcolor". Example:
\begtt
\Red The text is red
-\hbox{\loacalcolor \Blue here is blue {\localcolor \Green and green}
+\hbox{\localcolor \Blue here is blue {\localcolor \Green and green}
restored blue \Brown and brown}
now the text is red.
\endtt
@@ -1023,7 +1044,7 @@ spaces and without extension) and the "<style>" is the part of the filename
"opmac-bib-<style>.tex" where the formatting of the references list is
defined. Possible styles are "simple" or "iso690". The behavior of
"opmac-bib.tex" and "opmac-bib-iso690.tex" is full documented in these files
-(after "\endpinput" command).
+(after "\endinput" command).
\medskip\noindent
{\bf Formatting of the references list} is controlled by the "\printb" macro.
@@ -1104,7 +1125,7 @@ You can change this behavior by following commands:
\begtt
\itvariables % variables typeset by text italics.
-\mitvariables % mariables typeset by math italics.
+\mitvariables % variables typeset by math italics.
\endtt