stable 1999.12.30

1 files changed, 96 insertions, 38 deletions

diff --git a/tex/context/base/spec-ini.tex b/tex/context/base/spec-ini.tex
index aa54c63c0..8117cb8fc 100644
--- a/tex/context/base/spec-ini.tex
+++ b/tex/context/base/spec-ini.tex
@@ -1,3 +1,5 @@
+% \dogetfiguresize     will be a special !
+
 %D \module
 %D   [       file=spec-ini,
 %D        version=1996.01.25,
@@ -8,7 +10,7 @@
 %D      copyright={PRAGMA / Hans Hagen \& Ton Otten}]
 %C
 %C This module is part of the \CONTEXT\ macro||package and is
-%C therefore copyrighted by \PRAGMA. See licen-en.pdf for 
+%C therefore copyrighted by \PRAGMA. See mreadme.pdf for 
 %C details. 
 
 %D Specials are \TEX's channel to the outside world. They make
@@ -55,6 +57,17 @@
       7: unbekante Driver --
 \stopmessages
 
+\startmessages  czech  library: specials
+  title: speciality
+      1: -- nacteno
+      2: neni dovoleno hlubsi zanoreni --
+      3: -- je resetovano
+      4: prikaz -- neexistuje
+      5: nacita se definicni soubor --
+      6: zanoreni neni dovoleno
+      7: neznamy ovladac (driver) --
+\stopmessages
+
 \startmessages  dutch  library: interactions
      21: -- code tussengevoegd
 \stopmessages
@@ -67,6 +80,10 @@
      21: -- Code eingefuegt
 \stopmessages
 
+\startmessages  czech  library: interactions
+     21: -- kod vlozen
+\stopmessages
+
 %D \macros 
 %D   {everyresetspecials}
 %D
@@ -174,7 +191,6 @@
 
 %D \macros
 %D   {preloadspecials}
-%D   {}
 %D
 %D The following command can be used to show the loaded list
 %D of specials.
@@ -185,7 +201,6 @@
 
 %D \macros
 %D   {startspecials}
-%D   {}
 %D
 %D Every library has a unique name, which is given as the first
 %D argument to \type{\startspecials}. When another library is
@@ -230,7 +245,7 @@
      {\let\currentspecial\s!unknown}
      {\def\currentspecial{#1}}%
    \unprotect
-   \addtocommalist{\currentspecial}\preloadedspecials}
+   \addtocommalist\currentspecial\preloadedspecials}
 
 \def\startspecials%
   {\pushmacro\currentspecial
@@ -243,7 +258,6 @@
 %D \macros
 %D   {installspecial,
 %D    resetspecials}
-%D   {}
 %D
 %D We have to install specials before we can define and use
 %D them. The command itself is defined as a call to another
@@ -313,7 +327,6 @@
 
 %D \macros
 %D   {usespecials}
-%D   {}
 %D
 %D We use \type{\usespecials} to load a specific library.
 %D This command is only permitted outside de definition part.
@@ -338,7 +351,6 @@
 
 %D \macros
 %D   {executespecials}
-%D   {}
 %D
 %D The command \type{\executespecials} is used to execute the
 %D defined specials. Once a special is installed, the special
@@ -567,7 +579,6 @@
 %D \macros
 %D   {dostartgraymode,dostopgraymode,
 %D    dostartrgbcolormode,dostartcmykcolormode,dostartgraycolormode,dostopcolormode}
-%D   {}
 %D
 %D We start with the installation of color and grayscale
 %D specials. The values are in the range 0..1 (e.g. 0.25).
@@ -594,7 +605,6 @@
 
 %D \macros
 %D   {doinsertfile}
-%D   {}
 %D
 %D Probably the most problematic special is the following
 %D one. Because we want to be able to support different
@@ -611,7 +621,7 @@
 %D
 %D The special is implemented as \type{or}. Because
 %D \DVIPSONE\ understands them all, a chain of alternatives
-%D would generate multiple courrences of the same
+%D would generate multiple occurrences of the same
 %D illustration.
 %D
 %D When option 1 is passed, the viewers is asked to present a
@@ -620,9 +630,25 @@
 \installspecial [\doinsertfile] [or] [9]
 
 %D \macros
+%D   {dogetnofinsertpages}
+%D
+%D Some file formats support more than one page, like \PDF, 
+%D and for special applications, one may want to have access 
+%D to the total number of pages. 
+%D
+%D \starttyping
+%D \dogetnofinsertpages\nofinsertpages
+%D \stoptyping
+%D
+%D The number is available after the insert is placed, 
+%D since inclusion may take place immediate when an insert is 
+%D called upon. 
+
+\installspecial [\dogetnofinsertpages] [or] [1] 
+
+%D \macros
 %D   {dostartrotation,
 %D    dostoprotation}
-%D   {}
 %D
 %D We support rotation with the special:
 %D
@@ -639,7 +665,6 @@
 %D \macros
 %D   {dostartscaling,
 %D    dostopscaling}
-%D   {}
 %D
 %D Scaling is also supported:
 %D
@@ -656,7 +681,6 @@
 %D \macros
 %D   {dostartmirroring,
 %D    dostopmirroring}
-%D   {}
 %D
 %D And indeed, mirroring is there too:
 %D
@@ -672,7 +696,6 @@
 %D \macros
 %D   {dostartnegative,
 %D    dostopnegative}
-%D   {}
 %D
 %D When producing output for an image setter, negating the 
 %D page comes into view. Here are the tools:
@@ -683,7 +706,6 @@
 %D \macros
 %D   {doselectfirstpaperbin,
 %D    doselectsecondpaperbin}
-%D   {}
 %D
 %D Here are some very printer||specific ones. No further
 %D comment.
@@ -693,7 +715,6 @@
 
 %D \macros
 %D   {doovalbox}
-%D   {}
 %D
 %D When we look at the implementation, this is a complicated
 %D one. There are seven arguments.
@@ -709,9 +730,24 @@
 
 \installspecial [\doovalbox] [or] [7]
 
+%D \macros 
+%D   {dostartclipping,dostopclipping}
+%D 
+%D Clipping is implemented in such a way that an arbitrary 
+%D can be fed. 
+%D 
+%D \starttypen 
+%D \dostartclipping {pathname}{width} {height} 
+%D \dostopclipping 
+%D \stoptyping
+%D
+%D 
+
+\installspecial [\dostartclipping] [or] [3]
+\installspecial [\dostopclipping]  [or] [0]
+
 %D \macros
 %D   {dosetupidentity}
-%D   {}
 %D
 %D We can declare some characteristics of the document with
 %D
@@ -725,7 +761,6 @@
 
 %D \macros
 %D   {dosetuppaper}
-%D   {}
 %D
 %D This special can be used to tell the driver what page size
 %D to use. The special takes three arguments. 
@@ -741,7 +776,6 @@
 
 %D \macros
 %D   {dosetupprinter}
-%D   {}
 %D
 %D Some drivers enable the user to specify the paper type 
 %D used and/or page dimensions to be taken into account. 
@@ -759,10 +793,10 @@
 %D \macros
 %D   {% dosetuppage,
 %D    dosetupopenaction, dosetupclosaction,
+%D    dosetupopenpageaction, dosetupclospageaction,
 %D    dosetupinteraction,
 %D    dosetupscreen,
 %D    dosetupviewmode}
-%D   {}
 %D
 %D Here come some obscure interactive commands. Probably the
 %D specs will change with the development of the macros that
@@ -801,16 +835,17 @@
 %D
 %D For the moment we only support \type{fit}. 
 
-\installspecial [\dosetupinteraction] [and] [0]
-\installspecial [\dosetupopenaction]  [and] [0]
-\installspecial [\dosetupcloseaction] [and] [0]
-\installspecial [\dosetupscreen]      [and] [5]
-\installspecial [\dosetuppageview]    [and] [1]
+\installspecial [\dosetupinteraction]     [and] [0]
+\installspecial [\dosetupopenaction]      [and] [0]
+\installspecial [\dosetupcloseaction]     [and] [0]
+\installspecial [\dosetupopenpageaction]  [and] [0]
+\installspecial [\dosetupclosepageaction] [and] [0]
+\installspecial [\dosetupscreen]          [and] [5]
+\installspecial [\dosetuppageview]        [and] [1]
 
 %D \macros
 %D   {dostarthide,
 %D    dostophide}
-%D   {}
 %D
 %D Not every part of the screen is suitable for paper. Menus
 %D for instance have no meaning on an non||interactive medium.
@@ -821,13 +856,12 @@
 %D \dostophide
 %D \stoptypen
 
-\installspecial [\dostarthide]        [or]  [0]
-\installspecial [\dostophide]         [or]  [0]
+\installspecial [\dostarthide] [or] [0]
+\installspecial [\dostophide]  [or] [0]
 
 %D \macros
 %D   {dostartgotolocation, dostopgotolocation,
 %D    dostartgotorealpage, dostopgotorealpage}
-%D   {}
 %D
 %D The interactive real work is done by the following four
 %D specials. The reason for providing the first one with both
@@ -882,7 +916,6 @@
 %D \macros
 %D   {dostartthisislocation, dostopthisislocation,
 %D    dostartthisisrealpage, dostopthisisrealpage}
-%D   {}
 %D
 %D The opposite commands of \type{\dogotosomething} have only
 %D one argument:
@@ -907,7 +940,7 @@
 \installspecial [\dostartthisisrealpage] [and] [1]
 \installspecial [\dostopthisisrealpage]  [and] [0]
 
-%D \macro
+%D \macros
 %D   {doresetgotowhereever}
 %D 
 %D These and others need:
@@ -978,6 +1011,19 @@
 \installspecial [\dostopobject]   [or] [0]
 \installspecial [\doinsertobject] [or] [2]
 
+%D \macros
+%D   {doregisterfigure}
+%D 
+%D Images can be objects as well and it's up to the driver to
+%D handle this. Alternative images are also up to the driver,
+%D and the next macro tells the driver that the previous image
+%D is somehow followed by another and that both have to be
+%D handled together. This is a rather fuzzy model, but for the 
+%D moment it suits its purpose: low res screen versions combined
+%D with high res printable ones. 
+
+\installspecial [\doregisterfigure][or] [2]
+
 % %D \macros
 % %D   {dogetobjectreference} 
 % %D
@@ -994,7 +1040,6 @@
 %D    dostartgotoprofile, dostopgotoprofile,
 %D    dobeginofprofile,
 %D    doendofprofile}
-%D   {}
 %D
 %D These specials are still experimental. They are not yet
 %D supported by the programs the way they should be.
@@ -1034,13 +1079,14 @@
 %D previous one, this special is very \PDF. 
 %D
 %D \starttypen
-%D \dosetpagetransition{dissolve}
+%D \dosetpagetransition{dissolve}{0}
 %D \stoptypen
 %D
 %D Transitions have symbolic names, like dissolve, box, split,
-%D blinds, wipe and glitter.
+%D blinds, wipe and glitter. The second argument determines 
+%D the wait time (unless zero). 
 
-\installspecial [\dosetpagetransition] [or] [1]
+\installspecial [\dosetpagetransition] [or] [2]
 
 %D \macros
 %D   {dopresettextfield,dopresetlinefield,
@@ -1096,7 +1142,7 @@
 
 \installspecial [\dodefinefieldset] [or] [2]
 \installspecial [\dogetfieldset]    [or] [1]
-\installspecial [\doiffieldset]     [or] [1]
+\installspecial [\doiffieldset]     [or] [2]
 
 %D \macros 
 %D   {dosetfieldstatus}
@@ -1118,6 +1164,17 @@
 \def\fieldcopymode  {3} % no \chardef here
 
 %D \macros 
+%D   {doregistercalculationset}
+%D
+%D We can define a calculation order list with:
+%D
+%D \starttypen
+%D \doregistercalculationset {set identifier}
+%D \stoptypen
+
+\installspecial [\doregistercalculationset] [or] [1]
+
+%D \macros 
 %D   {doinsertcomment}
 %D
 %D Not so much out ot need, but to be complete, we also 
@@ -1125,10 +1182,10 @@
 %D 
 %D \starttypen
 %D \doinsertcomment
-%D   {title} {width} {height} {color} {open} {data} 
+%D   {title} {width} {height} {color} {open} {symbol} {data} 
 %D \stoptypen
 
-\installspecial[\doinsertcomment] [and] [6]
+\installspecial[\doinsertcomment] [and] [7]
 
 %D So far for the installation. For quite some time the 
 %D \CONTEXT\ way of specifying the output format has been: 
@@ -1183,6 +1240,7 @@
 \defineoutput [dviwindo] [dvi,ps,yy,win]
 \defineoutput [dvips]    [dvi,ps,tr]
 \defineoutput [dviview]  [dvi,ps,tr,dv]
+\defineoutput [dvipdfm]  [dpm]
 \defineoutput [pdftex]   [tpd]   
 \defineoutput [pdf]      [tpd]   
 \defineoutput [acrobat]  [pdf,ps,tr] % use: [acrobat,dvipsone]