summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/pagerange/README
blob: a13f231a81be96034b5a653db3f7151e5ee9f8a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
% This is file 'pagerange.sty'.                                             %
%                                                                           %
% When a given page range xx-yy (simple/plain characters) or                %
% \pages (command token, eg, \def\pages{xx-yy}) is submitted to the macro   %
% \pagerange (eg, \pagerange{xx-yy} or \pagerange\pages), this package      %
% splits the range as xx in the macro \pagestart and yy in \pageend.        %
% The counter equivalents of these are \prg@cnta and \prg@cntb.             %
% The command token (eg, \pages) is fully expanded before the page          %
% range is split.                                                           %
%                                                                           %
% If you specify a range consisting of a hyphen (or any tie) but with       %
% one or two empty page numbers, the following will happen:                 %
%   1. a range of the form -34 is taken to mean pages 1 to 34;              %
%   2. a range of the form 12- is taken to mean page 12 to last page;       %
%   3. a range of the form - (only hyphen) is taken to mean page 1 to       %
%      last page;                                                           %
%                                                                           %
% An empty or blank page range (ie, containing no argument and no           %
% hyphen/tie) is taken to mean range 1-1 or it may prompt a fatal error,    %
% depending on whether the boolean 'acceptempty' is true or false           %
% (respectively).                                                           %
%                                                                           %
% Page ranges containing more than one hyphen/tie cause fatal error.        %
%                                                                           %
% If the upper limit of the page range is smaller than the lower            %
% limit, a fatal error is flagged.                                          %
%                                                                           %
% The tie between the pages in the pagerange can be any single              %
% non-active character; its default is the hyphen '-'. It can be            %
% changed in the call to the package (eg, \usepackage[tie=+]{pagerange})    %
% or at any moment through \pagerangeoptions{tie=+}. Of course, active      %
% characters can't be used as ties.                                         %
%                                                                           %
% Because of the need for the last page of the document, at leat 2          %
% runs/passes are needed to obtain the correct last page.                   %
%                                                                           %
% This package has been tested with the 'hyperref' package, which           %
% redefines the label used by the 'lastpage' package.                       %
%                                                                           %
% Copyright (c) 2009 Ahmed Musa (a.musa@rocketmail.com).                    %
%                                                                           %
% The LPPL maintenance status of this software is 'author-maintained'.      %
%                                                                           %
% This software is provided 'as it is', without warranty of any kind,       %
% either expressed or implied, including, but not limited to, the           %
% implied warranties of merchantability and fitness for a particular        %
% purpose.                                                                  %
%+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++%