summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/snapshot/README
blob: 4c50606d36cfcc7b63e16b4d19b7231a6c8f8d71 (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
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
README file for package snapshot 2.14 [2020/06/17]

Copyright 1999-2003, 2004, 2010, 2012, 2020 American Mathematical Society.

This work may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either version 1.3c
of this license or (at your option) any later version.
The latest version of this license is in
  http://www.latex-project.org/lppl.txt
and version 1.3c or later is part of all distributions of LaTeX
version 2005/12/01 or later.

This work has the LPPL maintenance status `maintained'.

The Current Maintainer of this work is the American Mathematical
Society.

American Mathematical Society
Technical Support
Publications Technical Group
201 Charles Street
Providence, RI 02904
USA
tel: (401) 455-4080
     (800) 321-4267 (USA and Canada only)
fax: (401) 331-3842
email: tech-support@ams.org

========================================================================
                               CONTENTS
I.   OVERVIEW
II.  REMARKS ON THIS RELEASE
II.  CHANGE LOG

========================================================================
I. OVERVIEW

Complete documentation of all package options is available in
snapshot.pdf.

Typical usage involves the following steps:

1. Add a \RequirePackage statement at the top of the document:

       \RequirePackage{snapshot}
       \documentclass{article}

       \usepackage{graphicx}

       \begin{document}

       hello, world

       \end{document}

   Note that snapshot should be the very first thing loaded, even
   before the \documentclass.  Otherwise snapshot will not be able to
   capture the information for the document class and any packages
   loaded inside it.

2. Run LaTeX on the document. This will produce a dependency list in a
   file \jobname.dep.

3. Insert the .dep file at the top of the document, before
   \documentclass. The following example shows what you would
   typically end up with for a document that used the article
   documentclass and the graphicx package:

       \RequirePackage{snapshot}

       \RequireVersions{
         *{application}{pdfTeX}  {0000/00/00 v1.40.21}
         *{format} {LaTeX2e}     {2020-02-02 v2.e}
         *{package}{snapshot}    {2020/06/17 v2.14}
         *{class}  {article}     {2019/12/20 v1.4l}
         *{file}   {size10.clo}  {2019/12/20 v1.4l}
         *{package}{graphicx}    {2019/11/30 v1.2a}
         *{package}{keyval}      {2014/10/28 v1.15}
         *{package}{graphics}    {2019/11/30 v1.4a}
         *{package}{trig}        {2016/01/03 v1.10}
         *{file}   {graphics.cfg}{2016/06/04 v1.11}
         *{file}   {dvips.def}   {2017/06/20 v3.1d}
         *{file}   {l3backend-dvips.def}{2020-05-05 v3}
       }

       \documentclass{article}
       [...]

   Now each time you recompile the document, snapshot will compare the
   list of files actually loaded against the list recorded in
   \RequireVersions and warn you of any changes.

========================================================================
II. REMARKS ON THIS RELEASE

Since the snapshot package was originally released, there has been a
tremendous amount of evolution among TeX engines (what snapshot calls
the "application").  In addition to the introduction of two major new
engines, three other engines that were once distinct have effectively
merged.  The algorithm for detecting the identify of the engine has
been updated to reflect the state of the TeX world as reflected in TeX
Live 2020.

COMPATIBILITY NOTE: As a result of these improvements, the
*{application} entry of your documents will almost certainly change.
The snapshot package does not warn of changes in this entry, but if
you have an external application that makes use of this information,
you will probably need to update it.

========================================================================
III. CHANGE LOG

2020-06-17 snapshot.dtx v2.14
    -- Added code to detect the aleph, ptex, eptex, uptex, euptex,
       luatex, and xetex engines in addition to etex, pdftex, and
       pdfetex.  Also distinguish between the various engines which
       incorporate the eTeX extensions.
    -- Made snapshot more tolerant of macros in the optional argument
       to \Provides... declarations.