From 884a1d5cd40763780f0dba415b6c2d81aeeee04d Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Fri, 4 Feb 2011 16:59:13 +0000 Subject: standard name for file git-svn-id: svn://tug.org/texlive/trunk@21283 c570f23f-e606-0410-a88d-b1316a301751 --- Build/source/texk/dvidvi/README | 105 +++++++++++++++++++++++++++++++++++++++ Build/source/texk/dvidvi/read.me | 105 --------------------------------------- 2 files changed, 105 insertions(+), 105 deletions(-) create mode 100644 Build/source/texk/dvidvi/README delete mode 100644 Build/source/texk/dvidvi/read.me diff --git a/Build/source/texk/dvidvi/README b/Build/source/texk/dvidvi/README new file mode 100644 index 00000000000..0aee6b45ed7 --- /dev/null +++ b/Build/source/texk/dvidvi/README @@ -0,0 +1,105 @@ + dvidvi 1.0, Copyright (C) 1988-2011, Radical Eye Software +Anyone may freely use, modify, and/or distribute this file, without limitation. + +Here's a little hack I threw together for those doing pagination +tricks. Any improvements are appreciated. Enjoy! +The dvidvi program converts a dvi file into another dvi file, +with perhaps certain changes. Invocation is + + dvidvi param infile outfile + +What are the parameters? The 'easy' paramaters are the following: + + -f n page n is first page selected + -l n page n is last page selected + -n n select at most n pages. Notice that n is the number of pages + selected, independently of the number of pages actually + contained in a sheet + -i { n1..n2 | n1 }[,...] + include pages (ranges allowed). When this option is + used, ONLY the specified pages are selected. However, + we can exclude from these pages with the option -x + -x { n1..n2 | n1 }[,...] + exclude pages (ranges allowed) + -q work in quiet mode, that is do not print in the screen + messages of how the work is being done. + -r reverse the order of the pages. + +The page numbers for the above options -f -l -i and -x can be specified +in different ways. + +1) If a number n is given, it is interpreted as the n'th page from the +begining of the .dvi file. Of course, this number is independent of the +page number assigned by TeX. + +2) TeX page numbers are those who are actually written in the page; +these page numbers can be modified, for example, by using the TeX commands +\pagenumbering, \setcounter{page}{n}, and \addtocounter{page}{n}. +A TeX page number can be specified by preceding the number n with the +character @. Thus, if you specify -f @25 -l @30 you select the pages +between 25 and 30, these numbers being those assigned by TeX. + +3) However, several pages can have the same TeX page number in a .dvi file. +For example, the introductory pages in a book are numbered i, ii, and so on +until the first chapter begins and then, the pages are numbered 1, 2, etc. +In this case, the pages numbered i and 1 in the .dvi file have the same TeX +page number. If you want to select for example the second occurrence of the +page numbered 1, you can specify a page number as (@2)1. Thus @1 is equivalent +to (@1)1. For example, if you specify -f (@2)1 -l(@2)10 you select the pages +between 1 and 10 of the first chapter, not the introductory pages between +i and x. + +There is another parameter that tells dvidvi how you want to change page +layout and specifications. This is the -m parameter. + + The number preceding the colon is the modulo value. Everything +will be done in chunks of pages this big. If there is no colon, than the +default value is assumed to be one. The last chunk of pages is padded +with as many blank pages as necessary. + + Following the colon is a comma-separated list of page numbers. +These page numbers are with respect to the current chunk of pages, and +must lie in the range zero to the modulo value less one. If a negative +sign precedes the number, then the page is taken from the mirror chunk; +if there are m chunks, then the mirror chunk of chunk n is the chunk +numbered m-n-1. Put simply, it is the chunk numbered the same, only +from the end. This can be used to reverse pages. If no number is +given, the page number defaults to 1. + + Following each page number is an optional offset value in +parenthesis, which consists of a pair of comma-separated dimensions. +Each dimension is a decimal number with an optional unit of measure. +The default unit of measure is inches, or the last unit of measure +used. All units are in true dimensions. Allowable units of measure +are the same that TeX allows: in, mm, cm, pt, pc, dd, and cc. + + Simple enough, eh? Okay, let's do some simple things. + +-m - Reverses the order of the pages. This time, both the modulo and + the page number are defaulted. + +-m 2:0 Selects the first, third, fifth, etc. pages from the file. Print + this one after printing the next, taking the paper out of the + feed tray and reinserting it into the paper feed. + +-m 2:-1 Selects the second, fourth, etc. pages, and writes them in reverse + order. +-m 4:-1,2(4.25in,0in) +-m 4:-3,0(4.25in,0in) + Useful for printing a little booklet, four pages to a sheet, + double-sided, for stapling in the middle. Print the first one, + put the stack back into the printer upside down, and print the + second. The `in' specifications are superfluous. +-m ,(1pt,1) + Scare your system administrator! Actually, things are so + blurry with this option, you may want to send enemies letters + printed like this. *Long* letters. +-m 4:0(5.5in,4.25),3(0,4.25) +-m 4:1(0in,4.25),2(5.5,4.25) + Print a four-page card on one sheet. Print the first, rotate + the paper 180 degrees and feed it again. (PostScript people + can do funny tricks with PostScript so this isn't necessary.) + +Enjoy; this is an early release, so make suggestions, improvements, +and I'll get back to you with a better version later. + diff --git a/Build/source/texk/dvidvi/read.me b/Build/source/texk/dvidvi/read.me deleted file mode 100644 index 0aee6b45ed7..00000000000 --- a/Build/source/texk/dvidvi/read.me +++ /dev/null @@ -1,105 +0,0 @@ - dvidvi 1.0, Copyright (C) 1988-2011, Radical Eye Software -Anyone may freely use, modify, and/or distribute this file, without limitation. - -Here's a little hack I threw together for those doing pagination -tricks. Any improvements are appreciated. Enjoy! -The dvidvi program converts a dvi file into another dvi file, -with perhaps certain changes. Invocation is - - dvidvi param infile outfile - -What are the parameters? The 'easy' paramaters are the following: - - -f n page n is first page selected - -l n page n is last page selected - -n n select at most n pages. Notice that n is the number of pages - selected, independently of the number of pages actually - contained in a sheet - -i { n1..n2 | n1 }[,...] - include pages (ranges allowed). When this option is - used, ONLY the specified pages are selected. However, - we can exclude from these pages with the option -x - -x { n1..n2 | n1 }[,...] - exclude pages (ranges allowed) - -q work in quiet mode, that is do not print in the screen - messages of how the work is being done. - -r reverse the order of the pages. - -The page numbers for the above options -f -l -i and -x can be specified -in different ways. - -1) If a number n is given, it is interpreted as the n'th page from the -begining of the .dvi file. Of course, this number is independent of the -page number assigned by TeX. - -2) TeX page numbers are those who are actually written in the page; -these page numbers can be modified, for example, by using the TeX commands -\pagenumbering, \setcounter{page}{n}, and \addtocounter{page}{n}. -A TeX page number can be specified by preceding the number n with the -character @. Thus, if you specify -f @25 -l @30 you select the pages -between 25 and 30, these numbers being those assigned by TeX. - -3) However, several pages can have the same TeX page number in a .dvi file. -For example, the introductory pages in a book are numbered i, ii, and so on -until the first chapter begins and then, the pages are numbered 1, 2, etc. -In this case, the pages numbered i and 1 in the .dvi file have the same TeX -page number. If you want to select for example the second occurrence of the -page numbered 1, you can specify a page number as (@2)1. Thus @1 is equivalent -to (@1)1. For example, if you specify -f (@2)1 -l(@2)10 you select the pages -between 1 and 10 of the first chapter, not the introductory pages between -i and x. - -There is another parameter that tells dvidvi how you want to change page -layout and specifications. This is the -m parameter. - - The number preceding the colon is the modulo value. Everything -will be done in chunks of pages this big. If there is no colon, than the -default value is assumed to be one. The last chunk of pages is padded -with as many blank pages as necessary. - - Following the colon is a comma-separated list of page numbers. -These page numbers are with respect to the current chunk of pages, and -must lie in the range zero to the modulo value less one. If a negative -sign precedes the number, then the page is taken from the mirror chunk; -if there are m chunks, then the mirror chunk of chunk n is the chunk -numbered m-n-1. Put simply, it is the chunk numbered the same, only -from the end. This can be used to reverse pages. If no number is -given, the page number defaults to 1. - - Following each page number is an optional offset value in -parenthesis, which consists of a pair of comma-separated dimensions. -Each dimension is a decimal number with an optional unit of measure. -The default unit of measure is inches, or the last unit of measure -used. All units are in true dimensions. Allowable units of measure -are the same that TeX allows: in, mm, cm, pt, pc, dd, and cc. - - Simple enough, eh? Okay, let's do some simple things. - --m - Reverses the order of the pages. This time, both the modulo and - the page number are defaulted. - --m 2:0 Selects the first, third, fifth, etc. pages from the file. Print - this one after printing the next, taking the paper out of the - feed tray and reinserting it into the paper feed. - --m 2:-1 Selects the second, fourth, etc. pages, and writes them in reverse - order. --m 4:-1,2(4.25in,0in) --m 4:-3,0(4.25in,0in) - Useful for printing a little booklet, four pages to a sheet, - double-sided, for stapling in the middle. Print the first one, - put the stack back into the printer upside down, and print the - second. The `in' specifications are superfluous. --m ,(1pt,1) - Scare your system administrator! Actually, things are so - blurry with this option, you may want to send enemies letters - printed like this. *Long* letters. --m 4:0(5.5in,4.25),3(0,4.25) --m 4:1(0in,4.25),2(5.5,4.25) - Print a four-page card on one sheet. Print the first, rotate - the paper 180 degrees and feed it again. (PostScript people - can do funny tricks with PostScript so this isn't necessary.) - -Enjoy; this is an early release, so make suggestions, improvements, -and I'll get back to you with a better version later. - -- cgit v1.2.3