diff options
Diffstat (limited to 'Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex')
-rw-r--r-- | Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex | 39 |
1 files changed, 19 insertions, 20 deletions
diff --git a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex index 57bf5b7cd98..452690a36d0 100644 --- a/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex +++ b/Master/texmf-dist/doc/generic/pgf/text-en/pgfmanual-en-pages.tex @@ -10,7 +10,7 @@ \section{Page Management} -This section describes the |pgfpages| packages. Although this package +This section describes the |pgfpages| package. Although this package is not concerned with creating pictures, its implementation relies so heavily on \pgfname\ that it is documented here. Currently, |pgfpages| only works with \LaTeX, but if you are adventurous, feel free to hack @@ -39,7 +39,7 @@ future. The internals of |pgfpages| are complex since the package can do all sorts of interesting tricks. For this reason, so-called \emph{layouts} -are predefined that setup all option in appropriate ways. +are predefined that set up all option in appropriate ways. You use a layout as follows: \begin{codeexample}[code only] @@ -170,8 +170,7 @@ printing on letter paper: This section explains the predefined layouts in more detail. You select a layout using the following command: \begin{command}{\pgfpagesuselayout\marg{layout}\oarg{options}} - Installs the specified \meta{layout} with the given \meta{options} - set. The predefined layouts and their permissible options are + Installs the specified \meta{layout} with the given \meta{options}. The predefined layouts and their permissible options are explained below. If this function is called multiple times, only the last call @@ -232,7 +231,7 @@ select a layout using the following command: landscape mode). When using this layout, it is advisable to use the |\nofiles| command, but this is not done automatically. - The same \meta{options} as for the |resize to| layout an be used, + The same \meta{options} as for the |resize to| layout can be used, plus the following option: \begin{itemize} \item @@ -244,11 +243,11 @@ select a layout using the following command: \begin{pgflayout}{4 on 1} Puts four logical pages on a single physical page. - The same \meta{options} as for the |resize to| layout an be used. + The same \meta{options} as for the |resize to| layout can be used. \end{pgflayout} \begin{pgflayout}{8 on 1} - Puts eight logical pages on a single physical page. As for |2 on 1|, + Puts eight logical pages on a single physical page. As for |2 on 1| and |4 on 1|, the orientation depends on whether the logical pages are in landscape mode or in portrait mode. \end{pgflayout} @@ -265,13 +264,13 @@ select a layout using the following command: page to the physical page size. Then four black rectangles are drawn in each corner. Next, a clipping region is set up that contains all of the logical page except for little rounded - corners. Finally, the logical page is draw, clipped against the + corners. Finally, the logical page is drawn and clipped against the clipping region. Note that every logical page should fill its background for this to work. - In addition to the \meta{options} that can be given to |resize to| + In addition to the \meta{options} that can be given to |resize to|, the following options may be given. \begin{itemize} \item \declare{|corner width=|\meta{size}} specifies the size of @@ -292,7 +291,7 @@ select a layout using the following command: This layout puts two logical pages alongside each other. The second page always shows what the main page showed on the previous physical page. Thus, the second page - ``lags behind'' the main page. This can be useful when you have to + ``lags behind'' the main page. This can be useful when you have two projectors attached to your computer and can show different parts of a physical page on different projectors. @@ -302,7 +301,7 @@ select a layout using the following command: main page. This will make the physical pages twice as wide as the logical pages, but it will retain the height. \item \declare{|second left|} puts the second page left, - otherwise it behave the same as |second right|. + otherwise it behaves the same as |second right|. \item \declare{|second bottom|} puts the second page below the main page. This make the physical pages twice as high as the logical ones. @@ -335,7 +334,7 @@ command: When |\pgfpagesuselayout|\marg{layout}\oarg{options} is called, the following happens: First, the \meta{before actions} are - executed. They can be used, for example, to setup default values for + executed. They can be used, for example, to set up default values for keys. Next, |\setkeys{pgfpagesuselayoutoption}|\marg{options} is executed. Finally, the \meta{after actions} are executed. @@ -392,7 +391,7 @@ send the physical page to the output file. In reality, things are slightly more complicated. First, once a physical page has been shipped out, the logical pages are usually voided, but this need not be the case. Instead, it is possible that -certain logical page just retain their contents after the physical +certain logical pages just retain their contents after the physical page has been shipped out and these pages need not be filled once more before a physical shipout can occur. However, the contents of these logical pages can still be changed using special commands. It is also @@ -404,7 +403,7 @@ physical page and which further modifications should be done. The following two commands are used to define the layout: \begin{command}{\pgfpagesphysicalpageoptions\marg{options}} - This command sets the characteristic of the ``physical'' page. For + This command sets the characteristics of the ``physical'' page. For example, it is used to specify how many logical pages there are and how many logical pages must be accumulated before a physical page is shipped out. How each individual logical page is typeset is @@ -469,7 +468,7 @@ following two commands are used to define the layout: \meta{current} has been filled, the internal counter is incremented normally as if the logical page \meta{current} had been ``reached'' normally. If you specify a \meta{current} larger - to \meta{last}, a physical shipout will occur after the logical + than \meta{last}, a physical shipout will occur after the logical page \meta{current} has been filled. \item \declare{|physical height=|\meta{height}} @@ -577,8 +576,8 @@ following two commands are used to define the layout: \end{codeexample} \item \declare{|border shrink|=\meta{size}} - specifies an addition reduction of the size to which the page is - page is scaled down. + specifies an additional reduction of the size to which the page is + page is scaled. \item \declare{|border code|=\meta{code}}. When this option is given, the \meta{code} is executed before the @@ -591,7 +590,7 @@ following two commands are used to define the layout: You can also call |\pgfdiscardpath| and add your own path construction code (for example to paint a rectangle with rounded - corners). The coordinate system is setup in such a way that a + corners). The coordinate system is set up in such a way that a rectangle starting at the origin and having the height and width of \TeX-box 0 will result in a rectangle filling exactly the logical page currently being put on the physical page. The logical @@ -614,13 +613,13 @@ following two commands are used to define the layout: \subsection{Creating Logical Pages} -Logical pages are created whenever a \TeX\ thinks that a page is full +Logical pages are created whenever \TeX\ thinks that a page is full and performs a |\shipout| command. This will cause |pgfpages| to store the box that was supposed to be shipped out internally until enough logical pages have been collected such that a physical shipout can occur. -Normally, whenever a logical shipout occurs that current page is +Normally, whenever a logical shipout occurs, that current page is stored in logical page number \meta{current logical page}. This counter is then incremented, until it is larger than \meta{last logical shipout}. You can, however, directly change the value of |