diff options
author | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-10-10 10:25:39 +0000 |
---|---|---|
committer | Siep Kroonenberg <siepo@cybercomm.nl> | 2008-10-10 10:25:39 +0000 |
commit | ea89924c28117799fc8586c4aa9be0c2c51007a2 (patch) | |
tree | 0db8937e1fa415629bc3de8c4f170d72c39d4c36 /Master/tlpkg/dviout/dvispce.txt | |
parent | b9fe019c5bf5834ebee845b47654f6d6967cda28 (diff) |
dviout, .txt files in root: svn propset svn:eol-style CRLF
git-svn-id: svn://tug.org/texlive/trunk@10912 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/tlpkg/dviout/dvispce.txt')
-rw-r--r-- | Master/tlpkg/dviout/dvispce.txt | 456 |
1 files changed, 228 insertions, 228 deletions
diff --git a/Master/tlpkg/dviout/dvispce.txt b/Master/tlpkg/dviout/dvispce.txt index 7dfd3bc4697..965ec7e9630 100644 --- a/Master/tlpkg/dviout/dvispce.txt +++ b/Master/tlpkg/dviout/dvispce.txt @@ -1,228 +1,228 @@ -[2] Modify a DVI file to be page-independent in specials -[1] Translation between DVI file <-> Text file - Ver.0.2 written by SHIMA, Jan. 2003 - -Usage: dvispc [-c] [-bv] input_dvi_file [output_dvi_file] - dvispc -d input_dvi_file - dvispc -s [-p..] input_dvi_file [output_text_file] - dvispc -a [-jltv][-p..][-r..] input_dvi_file [output_text_file] - dvispc -x[..] [-dltv][-r..] [input_text_file] output_dvi_file - -c: make page-indepent DVI in specials for color push/pop, background, pn - -d: check page-independence - -b: backup original even if output_dvi_file is not given - -s: show specials - -a: translate DVI to Text - -x: translate Text to DVI (-x0:str0 1:chkfnt 2:variety) - -v: verbose -j: Japanese characters -l: location - -r: replace (-rorg_1=new_1/org_2=new_2... eg. -rxxx=special/fnt=font) - -p: T:preamble L:postamble pages with - (eg: -pT-L -pT2/4-8L -p-4 etc.) - -t: comaptible to DLT (the followings are suboptions if necessary eg. -t02) - 0:str 1:ch 2:ch2 3:cmd 4:c-sum 5:dir/name 6:err 7:page 8:oct 9:str0 - -color specials: color push/pop, background -tpic specials: pn - - - ***************************************************** -[1] ** Translation between DVI file <-> Text file ** - ***************************************************** - --a: transform DVI file into a text file (the option -v can be valid) - --x: transform a text to DVI file. - stack depth, page numbers and address are automatically corrected. - -x0 is equivalent to -x -t9 - The text should be the same format obtained by -a option. - The line which starts with an alphabetical character of the lower - case or the character [ or ] or \ has only been interpreted. - The valid line is of the following format with several blocks separated by - spaces. - -<key> <number><comment> ... <number><comment> '<string>' <any comment> - - <key>: key word - <number>: decimal, hexadecimal starting with 0x or 0X, octal starting with 0 - <comment>: void or a string without a space and not starting with a figure - indicate after <number> without a space. - This is ignored. - <any comment>: void or any string. This is ignored. - - The number of the blocks of <number><comment> and the existence of '<string>' - is determined by <key> as follows. - -List of <key> (X: 1 - 4 XX: 0 - 127 YY: 0 - 63) - <key> <number><comment> '<string>' - pre : 5 1 - bop : 11 0 - nop, eop, push, pop : 0 0 - setcharXX : 0 0 - fntnumYY : 0 0 - setX, putX, rightX, downX : 1 0 - setrule, writerule : 2 0 - w0, x0, y0, z0 : 0 0 - wX, xX, yX, zX : 1 0 - fntX : 1 0 - fntdefX : 6 1 - xxxX : 1 1 - dir : 1 0 - post_post : 6 - 9 0 - - The following is used in DTL for illegal code - opcode : 1 0 - - The following expression in DTL are also valid. - - push -> [ pop -> ] - fntnum -> fn set -> s put -> p right -> r down -> d - setrule -> sr putrule -> pr fnt -> f fntdef -> fd - -dvispc can read the format of the DVIware DTL (dt2dv/dv2dt) by Geoffrey Tobin. - -Transformations: [DVI file -> a text -> edit it -> DVI file] is possible -The following command makes foo2.dvi by extracting the pages 4,5,6,8 from -foo.dvi. - -dvispc -atpT4-6/8L foo1.dvi | dvispc -x foo2.dvi - -The following command is the same as the above. - -dvispc -atpT4-6/8L foo1.dvi | dvispc -x > foo2.dvi - --x : 0: toggle length follows from the given string - 1: toggle omit unnecessary definitions of fonts - 2: toggle igonore the first line "variety ..." - (If it is not ignored and it exists, then -t option is set). - --p : Output instruction for DVI -> Text - T: preambre - L: postambre - <n>: page <n> - <n1>-<n2>: from the page <n1> to the page <n2> - If <n1> is omitted, <n1> is assumed to be 1. - If <n2> is omitted, <n2> is assumed to be the last page number. - - There are indicated by separating by appropriate characters if necessary. - - -pT-L default (total as in the original order) - -pTL preambre and postambre - -p3-15/20L the pages 3,4,5,...,15 and 20 in this order and postambre - --r -rorg_1=new_1/org_2=new_2/... means org_i is replaced by new_i for i=1,2.. - Here org_i is the keyword omitting figures. For example - - -rxxx=special/setchar=set_char_ - - The first letter of orig_i should be an alphabet in the small case if the - option -x is indicated. - --t : Transformation is done according to the DTL(dt2dv/dv2dt) by Geoffrey Tobin. - The following suboptions (0-9: toggle switch) can be indicated such as -t02. - - The option -t with no suboption means that the following all suboptions - and the options corresponding to the switches -x0 -x1 -x2 are all On and -j - is Off and also the following line is inserted at the top in case of - DVI -> Text. - -variety sequences-6 - - If in case of Text -> dvi this line exists at the top, -t is automatically - set. - - 0: str - A string is indicated by '...' with the transformations ' -> \' and - \ -> \\. A character whose code is smaller that 32 or larger than 126 is - expressed by hexadecimal as in the following. - 1: ch - Characters with the code between 0 and 127 are indicated by (...). - Here the transformations ( -> \(, ) -> \) and \ -> \\ are used and the - character with the code between 0 and 31 or 127 is independently shown by - hexadecimal character starting with \ such as \12. - 2: ch2 - The code of a character larger than 128 is expressed in digits. - 3: cmd - The key word corresponding to a code is in the format as in DTL. - 4: c-sum - check sum in the font definition is expressed by octal. - 5: dir/name - The string of fontname is expressed by dividing into the directory and name. - 6: err - The illegal code is expressed by opcode x (x: code). - 7: page - The page number is not shown. - 8: oct - The octal number for the check sum of the font definition is expressed - without the top 0. - 9: str0 - The length of a string is determined by the given string in case of - Text -> DVI. - --l: The address of the code is shown at the top of line. - In this case - -0: pre 2 ... - - exists at the head. - In case of Text -> DVI, the option -l is set if this line exists. - - --j: toggle, If the code of the character is within JIS code, then the - corresponding character is shown. - - - ************************************************************ -[2] ** Modify a DVI file to be page-independent in specials ** - ************************************************************ -DVI file should be page-independent in principle. But some specials break this -principle. - -For example, color specials of graphics package of LaTeX2e for dvips break this. -Suppose there is a command to make letters red at page 2 of a document with the -total pages 100 and it continues up to page 99. Then there is no command to -make letters red at page 50. - -\usepackages[dvips]{graphicx, color} -... -{\color{red}% page 2 -... -... -...% page 99 -} -... - -dvips reads a DVI file from the first page and therefore it correctly interprets -color specials. But some other DVIwares such as dviout (previewer) cannot do so -because it may be requested only to display the page 50. The same problem -occurs for some DVI tools such as dvidvi. - -dvispc modifies such a DVI file to be page-independent. Supporting specials are - - color specials: color push/pop, background - tpic specials : sh, pn - - - --- specifications --- --c: the above modification will be done --s: show all specials in DVI file --d: check the necessity of the modification - -If none of the parameters -s -d -a -x is indicated, dvispc modifies DVI file as -described. - -color specials: dvispc inserts necessary specials "color pop" at the end of each - page so that the stack becomes empty there. Then it also inserts necessary - specials "color push" at the top of the following page. - dvispc checks the underflow and overflow (the limit is about 500 in dvispc) - of this stack. Usually the overflow of stack occurs by the wrong source of - TeX. In the case of the unerflow, dvispc writes specials "color push Black" - at the top of the corresponding page to recover the error. - -background : If the "background" color is defined in a page and the - definition is not written in another page where the definition should be - valid, then the definition is inserted at the top of the page. - -tpic specials : If tpic special "pn" is defined, then the same special will be - inserted at the top of the following pages. - -The order to be inserted at the top of each page is as follows - -color push -> background -> pn (tpic special) +[2] Modify a DVI file to be page-independent in specials
+[1] Translation between DVI file <-> Text file
+ Ver.0.2 written by SHIMA, Jan. 2003
+
+Usage: dvispc [-c] [-bv] input_dvi_file [output_dvi_file]
+ dvispc -d input_dvi_file
+ dvispc -s [-p..] input_dvi_file [output_text_file]
+ dvispc -a [-jltv][-p..][-r..] input_dvi_file [output_text_file]
+ dvispc -x[..] [-dltv][-r..] [input_text_file] output_dvi_file
+ -c: make page-indepent DVI in specials for color push/pop, background, pn
+ -d: check page-independence
+ -b: backup original even if output_dvi_file is not given
+ -s: show specials
+ -a: translate DVI to Text
+ -x: translate Text to DVI (-x0:str0 1:chkfnt 2:variety)
+ -v: verbose -j: Japanese characters -l: location
+ -r: replace (-rorg_1=new_1/org_2=new_2... eg. -rxxx=special/fnt=font)
+ -p: T:preamble L:postamble pages with - (eg: -pT-L -pT2/4-8L -p-4 etc.)
+ -t: comaptible to DLT (the followings are suboptions if necessary eg. -t02)
+ 0:str 1:ch 2:ch2 3:cmd 4:c-sum 5:dir/name 6:err 7:page 8:oct 9:str0
+
+color specials: color push/pop, background
+tpic specials: pn
+
+
+ *****************************************************
+[1] ** Translation between DVI file <-> Text file **
+ *****************************************************
+
+-a: transform DVI file into a text file (the option -v can be valid)
+
+-x: transform a text to DVI file.
+ stack depth, page numbers and address are automatically corrected.
+ -x0 is equivalent to -x -t9
+ The text should be the same format obtained by -a option.
+ The line which starts with an alphabetical character of the lower
+ case or the character [ or ] or \ has only been interpreted.
+ The valid line is of the following format with several blocks separated by
+ spaces.
+
+<key> <number><comment> ... <number><comment> '<string>' <any comment>
+
+ <key>: key word
+ <number>: decimal, hexadecimal starting with 0x or 0X, octal starting with 0
+ <comment>: void or a string without a space and not starting with a figure
+ indicate after <number> without a space.
+ This is ignored.
+ <any comment>: void or any string. This is ignored.
+
+ The number of the blocks of <number><comment> and the existence of '<string>'
+ is determined by <key> as follows.
+
+List of <key> (X: 1 - 4 XX: 0 - 127 YY: 0 - 63)
+ <key> <number><comment> '<string>'
+ pre : 5 1
+ bop : 11 0
+ nop, eop, push, pop : 0 0
+ setcharXX : 0 0
+ fntnumYY : 0 0
+ setX, putX, rightX, downX : 1 0
+ setrule, writerule : 2 0
+ w0, x0, y0, z0 : 0 0
+ wX, xX, yX, zX : 1 0
+ fntX : 1 0
+ fntdefX : 6 1
+ xxxX : 1 1
+ dir : 1 0
+ post_post : 6 - 9 0
+
+ The following is used in DTL for illegal code
+ opcode : 1 0
+
+ The following expression in DTL are also valid.
+
+ push -> [ pop -> ]
+ fntnum -> fn set -> s put -> p right -> r down -> d
+ setrule -> sr putrule -> pr fnt -> f fntdef -> fd
+
+dvispc can read the format of the DVIware DTL (dt2dv/dv2dt) by Geoffrey Tobin.
+
+Transformations: [DVI file -> a text -> edit it -> DVI file] is possible
+The following command makes foo2.dvi by extracting the pages 4,5,6,8 from
+foo.dvi.
+
+dvispc -atpT4-6/8L foo1.dvi | dvispc -x foo2.dvi
+
+The following command is the same as the above.
+
+dvispc -atpT4-6/8L foo1.dvi | dvispc -x > foo2.dvi
+
+-x : 0: toggle length follows from the given string
+ 1: toggle omit unnecessary definitions of fonts
+ 2: toggle igonore the first line "variety ..."
+ (If it is not ignored and it exists, then -t option is set).
+
+-p : Output instruction for DVI -> Text
+ T: preambre
+ L: postambre
+ <n>: page <n>
+ <n1>-<n2>: from the page <n1> to the page <n2>
+ If <n1> is omitted, <n1> is assumed to be 1.
+ If <n2> is omitted, <n2> is assumed to be the last page number.
+
+ There are indicated by separating by appropriate characters if necessary.
+
+ -pT-L default (total as in the original order)
+ -pTL preambre and postambre
+ -p3-15/20L the pages 3,4,5,...,15 and 20 in this order and postambre
+
+-r -rorg_1=new_1/org_2=new_2/... means org_i is replaced by new_i for i=1,2..
+ Here org_i is the keyword omitting figures. For example
+
+ -rxxx=special/setchar=set_char_
+
+ The first letter of orig_i should be an alphabet in the small case if the
+ option -x is indicated.
+
+-t : Transformation is done according to the DTL(dt2dv/dv2dt) by Geoffrey Tobin.
+ The following suboptions (0-9: toggle switch) can be indicated such as -t02.
+
+ The option -t with no suboption means that the following all suboptions
+ and the options corresponding to the switches -x0 -x1 -x2 are all On and -j
+ is Off and also the following line is inserted at the top in case of
+ DVI -> Text.
+
+variety sequences-6
+
+ If in case of Text -> dvi this line exists at the top, -t is automatically
+ set.
+
+ 0: str
+ A string is indicated by '...' with the transformations ' -> \' and
+ \ -> \\. A character whose code is smaller that 32 or larger than 126 is
+ expressed by hexadecimal as in the following.
+ 1: ch
+ Characters with the code between 0 and 127 are indicated by (...).
+ Here the transformations ( -> \(, ) -> \) and \ -> \\ are used and the
+ character with the code between 0 and 31 or 127 is independently shown by
+ hexadecimal character starting with \ such as \12.
+ 2: ch2
+ The code of a character larger than 128 is expressed in digits.
+ 3: cmd
+ The key word corresponding to a code is in the format as in DTL.
+ 4: c-sum
+ check sum in the font definition is expressed by octal.
+ 5: dir/name
+ The string of fontname is expressed by dividing into the directory and name.
+ 6: err
+ The illegal code is expressed by opcode x (x: code).
+ 7: page
+ The page number is not shown.
+ 8: oct
+ The octal number for the check sum of the font definition is expressed
+ without the top 0.
+ 9: str0
+ The length of a string is determined by the given string in case of
+ Text -> DVI.
+
+-l: The address of the code is shown at the top of line.
+ In this case
+
+0: pre 2 ...
+
+ exists at the head.
+ In case of Text -> DVI, the option -l is set if this line exists.
+
+
+-j: toggle, If the code of the character is within JIS code, then the
+ corresponding character is shown.
+
+
+ ************************************************************
+[2] ** Modify a DVI file to be page-independent in specials **
+ ************************************************************
+DVI file should be page-independent in principle. But some specials break this
+principle.
+
+For example, color specials of graphics package of LaTeX2e for dvips break this.
+Suppose there is a command to make letters red at page 2 of a document with the
+total pages 100 and it continues up to page 99. Then there is no command to
+make letters red at page 50.
+
+\usepackages[dvips]{graphicx, color}
+...
+{\color{red}% page 2
+...
+...
+...% page 99
+}
+...
+
+dvips reads a DVI file from the first page and therefore it correctly interprets
+color specials. But some other DVIwares such as dviout (previewer) cannot do so
+because it may be requested only to display the page 50. The same problem
+occurs for some DVI tools such as dvidvi.
+
+dvispc modifies such a DVI file to be page-independent. Supporting specials are
+
+ color specials: color push/pop, background
+ tpic specials : sh, pn
+
+
+ --- specifications ---
+-c: the above modification will be done
+-s: show all specials in DVI file
+-d: check the necessity of the modification
+
+If none of the parameters -s -d -a -x is indicated, dvispc modifies DVI file as
+described.
+
+color specials: dvispc inserts necessary specials "color pop" at the end of each
+ page so that the stack becomes empty there. Then it also inserts necessary
+ specials "color push" at the top of the following page.
+ dvispc checks the underflow and overflow (the limit is about 500 in dvispc)
+ of this stack. Usually the overflow of stack occurs by the wrong source of
+ TeX. In the case of the unerflow, dvispc writes specials "color push Black"
+ at the top of the corresponding page to recover the error.
+
+background : If the "background" color is defined in a page and the
+ definition is not written in another page where the definition should be
+ valid, then the definition is inserted at the top of the page.
+
+tpic specials : If tpic special "pn" is defined, then the same special will be
+ inserted at the top of the following pages.
+
+The order to be inserted at the top of each page is as follows
+
+color push -> background -> pn (tpic special)
|