Attached source. The PDF documentation on CTAN also includes the .dtx source file. It can be extracted by AcrobatReader 6 or higher. Another option is pdftk, e.g. unpack the file into the current directory:
pdftk zref.pdf unpack_files output .
Unpacking with LATEX. The.dtxchooses its action depending on the format:
plain TEX: Rundocstripand extract the files.
LATEX: Generate the documentation.
If you insist on using LATEX for docstrip (really, docstrip does not need LATEX), then inform the autodetect routine about your intention:
latex \let\install=y\input{zref.dtx}
Do not forget to quote the argument according to the demands of your shell.
Generating the documentation. You can use both the.dtx or the .drvto generate the documentation. The process can be configured by the configuration fileltxdoc.cfg. For instance, put this line into this file, if you want to have A4 as paper format:
\PassOptionsToClass{a4paper}{article}
An example follows how to generate the documentation with pdfLATEX:
pdflatex zref.dtx
makeindex -s gind.ist zref.idx pdflatex zref.dtx
makeindex -s gind.ist zref.idx pdflatex zref.dtx
9 References
[1] Packagefootmisc, Robin Fairbairns, 2004/01/23 v5.3a.CTAN:macros/latex/
contrib/footmisc/footmisc.dtx
[2] Packagehyperref, Sebastian Rahtz, Heiko Oberdiek, 2006/08/16 v6.75c.CTAN:
macros/latex/contrib/hyperref/
[3] Package lastpage, Jeff Goldberg, 1994/06/25 v0.1b.CTAN:macros/latex/
contrib/lastpage/
[4] Packagenameref, Sebastian Rahtz, Heiko Oberdiek, 2006/02/12 v2.24.CTAN:
macros/latex/contrib/hyperref/nameref.dtx
[5] Package perpage, David Kastrup, 2002/12/20 v1.0.CTAN:macros/latex/
contrib/bigfoot/perpage.dtx
[6] Package titleref, Donald Arsenau, 2001/04/05 v3.1.CTAN:macros/latex/
contrib/misc/titleref.sty
[7] Package totpages, Wilhelm M¨uller, 1999/07/14 v1.00.CTAN:macros/latex/
contrib/totpages/
[8] Package xr, David Carlisle, 1994/05/28 v5.02.CTAN:macros/latex/
required/tools/xr.pdf
[9] Package xr-hyper, David Carlisle, 2000/03/22 v6.00beta4.CTAN:macros/
latex/contrib/hyperref/xr-hyper.sty
10 History
[2006/02/20 v1.0]
• First version.
[2006/05/03 v1.1]
• Moduleperpageadded.
• Module redesign as packages.
[2006/05/25 v1.2]
• Moduledotfillminadded.
• Modulebase: macros\zref@require@uniqeand\thezref@uniqueadded (used by modules titleref anddotfillmin).
[2006/09/08 v1.3]
• Typo fixes and English cleanup by Per Starback.
[2007/01/23 v1.4]
• Typo in macro name fixed in documentation.
[2007/02/18 v1.5]
• \zref@getcurrentadded (suggestion of Igor Akkerman).
• Modulesaveposalso supports X E TEX.
[2007/04/06 v1.6]
• Fix in modulesabspageandbase: Now counter abspageandzref@unique are not remembered by \include.
• Beamer support for moduletitleref.
[2007/04/17 v1.7]
• Package atbegshireplaceseveryshi.
[2007/04/22 v1.8]
• \zref@wrapper@babeland \zref@refusedare now expandable if babel is not used or\if@safe@activesis already set to true. (Feature request of Josselin Noirel)
[2007/05/02 v1.9]
• Moduletitleref: Some support for\captionof packagelongtable, but only if \labelis given after \caption.
[2007/05/06 v2.0]
• Uses package etexcmdsfor accessingε-TEX’s\unexpanded.
[2007/05/28 v2.1]
• Moduletitleref supports caption of packagelistings.
• Fixes in module titleref for support of packagestitlesecandlongtable.
[2008/09/21 v2.2]
• Modulebase: \zref@iflistcontainsprop is documented, but a broken
\zref@listcontainspropimplemented. Name and implementation fixed (thanks Ohad Kammar).
[2008/10/01 v2.3]
• \zref@localaddprop added (feature request of Ohad Kammar).
• Modulelastpage: list ‘LastPage’ added. Label ‘LastPage’ will use the properties of this list (default is empty) along with the properties of the main list.
[2009/08/07 v2.4]
• Moduleruns added.
[2009/12/06 v2.5]
• Modulelastpage: Uses packageatveryend.
• Moduletitleref: Further commands are disabled during string expansion, imported from package nameref.
[2009/12/07 v2.6]
• Version date added for packageatveryend.
[2009/12/08 v2.7]
• Moduletitleref: Use of package gettitlestring.
[2010/03/26 v2.8]
• \zifrefundefinedadded.
• Modulelastpage: Macros\zref@iflastpageand\ziflastpageadded.
• Modulethepageadded.
• Modulenextpageadded.
[2010/03/29 v2.9]
• Modulemarksadded (without documentation).
• \zref@addpropnow adds expanded property to list.
• Useless \ZREF@ErrorNoLineremoved.
[2010/04/08 v2.10]
• Modulexr remembers the external document name in property
‘externaldocument’.
[2010/04/15 v2.11]
• Moduletitleref: Better support of classmemoir.
• Moduletitleref: Support of theorems.
[2010/04/17 v2.12]
• Modulebase: \zref@newpropensures global empty default.
• Modulexr: Setup optionstozreflabelandtoltxlabeladded.
[2010/04/19 v2.13]
• \zref@setcurrentthrows an error if the property does not exist (Florent Chervet).
• \zref@getcurrentthe documentation is fixed (Florent Chervet). Also it returns the empty string in case of errors.
• \zref@addpropand\zref@localaddprop now take a list of property names (feature request of Florent Chervet).
• Example for\zref@wrapper@unexpanded corrected (Florent Chervet).
[2010/04/22 v2.14]
• Bug fix for \zref@getcurrentsecond argument wasn’t eaten in case of unknown property.
• \zref@getcurrentsupports\zref@wrapper@unexpanded.
• \zref@wrapper@unexpanded added for\ZREF@xr@tolabel.
• \zref@extract, \zref@extractdefault, \zref@getcurrentare
expandable in exact two steps except inside \zref@wrapper@unexpanded.
[2010/04/23 v2.15]
• \zexternaldocument fixed for property ‘url’ when importing\new@label (bug found by Victor Ivrii).
• Two expansion steps also in\zref@wrapper@unexpanded.
• Nested calls of \zref@wrapper@unexpanded possible.
[2010/04/28 v2.16]
• More consequent use of package ‘ltxcmds’ and ‘hologo’.
• Modulepagelayout added.
• Modulepageattr added.
• Robustness introduced for non-expandable interface macros.
• Internal change of the data format of property lists (suggestion of Florent Chervet).
• Moduletitleref: Support of environmentdescription.
[2010/05/01 v2.17]
• \zref@newpropthrows an error if the property already exists.
• Modulexr: Bug fix for the case of several.aux files (bug found by Victor Ivrii).
• Modulexr: Property ‘urluse’ and optionurluse added.
[2010/05/13 v2.18]
• Moduleenv added.
• Modulesavepos: \zref@saveposadded.
[2010/10/22 v2.19]
• \zref@addpropand\zref@localaddprop are limited to one property only (incompatibility to versions v2.13 to v2.18).
• \zref@addpropsand\zref@localaddpropsadded.
• \zref@delpropand\zref@localdelprop added.
• \zref@labelbykvand\zkvlabel(moduleuser) with keysprop,list, delprop,immediate,valuesadded.
\ZREF@pl@ListEntry . . . 1287,1288, 1289, 1290, 1291, 1292, 1293, 1294, 1295, 1296, 1297, 1298, 1299, 1300, 1301, 1302, 1303, 1304,1305,1306,1307,1308,1319
\ZREF@pl@ListPage . . . 1272,1278
\ZREF@pl@listtrue . . . 1250
\zref@prop 323,331,332,336,627,631
\zref@propexists . . . . 6,343,361, 378, 396, 487, 547, 616, 637, 926
\ZREF@refname@next . . . . . . . 1105,1112,1121,1145
\ZREF@refname@this . . . . . . . 1097,1098,1100,1103
\ZREF@RefPrefix . 283,285,1260,1424
\ZREF@refused . . . 742,744
\zref@refused . . . 7, 738,741, 931,938, 1020, 1021, 1052,1167,1453,1483,1759,2620
\zref@require@unique . . . . . . . 10,856,1622,2424
\ZREF@Robust . . . 231,237,243,284, 287, 302, 309, 340, 359, 375, 394, 411, 414, 451, 454, 487, 494, 546, 566, 569, 579, 599, 671, 741, 814, 830, 856, 872, 878, 1051, 1452, 1482, 1706, 1719
\ZREF@SavedEscapechar . . . 460,467
\zref@savepos . . . 17,2374,2383
\ZREF@savepos@ok . . . 2395,2407
\zref@setcurrent . . . . . . . 6,81,540,546,666,976
\zref@setdefault . . . 8,872,875
\zref@setmainlist . . . 8,878
\ZREF@STAR . . . 1532,1556
\ZREF@stripperiod . . . 1730,1738
\ZREF@temp . . . 193,200,201, 202, 203, 204, 205, 206, 207, 208, 209, 210, 211, 212, 213, 214, 215, 216, 232, 233, 439, 440, 441, 689, 710, 711, 719, 1187, 1204, 1205, 1206, 1207, 1211, 1225, 1226, 1227, 1228, 1229, 1230, 1231, 1232, 1233, 1234, 1235, 1236, 1237, 1238, 1239, 1240, 1241, 1242, 1243, 1244, 1245, 1246, 1247, 1259, 1260, 1349, 1366, 1367, 1371, 1382, 1394, 1396, 1402, 1403, 1404, 1405, 1423, 1424, 1531, 1532,1960,1970,1973,1977,2444
\ZREF@TempName . . 1507,1519,1520, 1522,1548,1561,1565,1573,1584
\ZREF@TempNum . . . . 1508,1509,1513,1520,1562,1575
\zref@thepage . . . 13,1048,1057
\zref@thepage@name . . . . . . . 13,1043,1049,1052,1106
\zref@thepage@refused . . . 1051,1056
\ZREF@titleref . . . 1755,1757
\zref@titleref@cleanup . . 1706,1746
\zref@titleref@current . . . . . . . 892,1725,1729,1730,1749
\ZREF@titleref@hook . . . . . . . 1705,1709,1713,1736
\zref@titleref@setcurrent . . . . . . . 1719,1767,1773, 1779, 1785, 1791, 1797, 1803, 1809, 1817, 1820, 1824, 1828, 1830, 1841, 1843, 1853, 1859, 1865, 1873, 1882, 1891, 1901,1916
\zref@titleref@stripperiodtrue 1718
\ZREF@true . . . 643,657
\ZREF@u@getcurrent . . . 560
\zref@unhex . . . . 1407,1410,1448,1478
\ZREF@UpdatePdfTeX . . . 246,2352,2365
\ZREF@wrapper@babel . . . 847,853
\zref@wrapper@babel . . 9,140,734, 742,830,916,923,927,1017,1755
\zref@wrapper@immediate . . . . . . . . 10,87,605,671,1002,1039
\ZREF@wrapper@unexpanded . . . 814,828
\zref@wrapper@unexpanded . . . . . . . . 10,815,820,825,2196,2542
\ZREF@wu@extract . . . 788,818
\ZREF@wu@extractdefault . . . 808,817
\ZREF@wu@getcurrent . . . 560,816
\ZREF@X . . . 496,499,536
\zref@xr@ . . . 1950
\ZREF@xr@@AddUrl . . . 1962,1965
\ZREF@xr@@input . . . 2093,2188
\ZREF@xr@AddURL . . . . 1958,2011,2290
\ZREF@xr@checkfile . . 2015,2018,2068
\ZREF@xr@checkkey . . . 2246,2255
\ZREF@xr@checklist . . . 2116,2244
\zref@xr@ext . . . 19,1938,2006
\ZREF@xr@externaldocument . . . . . . . 1993,1996,2000
\ZREF@xr@externalfile . . . . . . . 2003,2004,2122,2164
\ZREF@xr@file . . . 2004,2019,2022, 2028, 2039, 2062, 2110, 2229,2238
\ZREF@xr@filelist . . . 2002, 2060, 2063, 2065, 2066, 2094,2095
\ZREF@xr@found . 2030,2040,2102,2147
\ZREF@xr@graburl . . . 2006,2008
\ZREF@xr@ignored@empty . . . . . . . . 2031,2043,2045,2112,2113
\ZREF@xr@ignored@ltx . . . . . . . . 2033,2052,2054,2240,2241
\ZREF@xr@ignored@zref . . . . . . . . 2032,2047,2049,2231,2232
\ZREF@xr@line . . 2072,2073,2085,2090
\ZREF@xr@list . . . 2106,2107
\ZREF@xr@ltx@ignorewarning . . . . 2235
\ZREF@xr@newlabel . . . 2088,2187
\ZREF@xr@prefix . . . 2001,2101, 2137, 2141, 2146, 2172, 2179,2183
\ZREF@xr@process@label . . 2090,2145
\ZREF@xr@process@zreflabel 2085,2100
\ZREF@xr@processfile . . . . 2018,2071
\ZREF@xr@processline . . . . 2073,2079