publications-tracing.tex /size: 2189 b    last modification: 2020-07-01 14:35
1\environment publications-style
2
3\startcomponent publications-tracing
4
5\startchapter
6  [title=Tracing]
7
8There are several tracing options. If you want to see where a citations refers to
9and where a list entry point back to, you can say:
10
11\startTEX
12\enabletrackers[publications.crosslinks]
13\stopTEX
14
15This injects markers in both places. One list entry can point to multiple
16citations. The other tracers a more for debugging and can generate lots of
17messages.
18
19\startTEX
20publications
21publications.authorhash
22publications.cite
23publications.cite.missing
24publications.cite.references
25publications.detail
26publications.duplicates
27publications.match
28publications.setups
29publications.sorters
30publications.suffixes
31\stopTEX
32
33You can also trace the databases. Take this one:
34
35\startbuffer
36\startbuffer[phony]
37@comment { warning :
38    Hello Allan!
39    How are you doing today?
40}
41
42@CoMMeNT { message :
43    Hello Allan!
44    How are you doing today?
45}
46
47@comment {
48    all kind of crap
49}
50
51@Article{Myarticle,
52  Title                    = {My title},
53  Author                   = {Myself, Me},
54  Journal                  = {My favorite journal},
55  Year                     = {2014},
56  Pages                    = {1},
57}
58
59@Foo{foo,
60  Goo = goo,
61}
62\stopbuffer
63\stopbuffer
64
65\typeBTXbuffer \getbuffer
66
67\startbuffer
68\usebtxdataset [phony] [phony.buffer]
69\stopbuffer
70
71When we load this database (buffer) with:
72
73\typeTEXbuffer \getbuffer
74
75We get this on the console and in the log
76
77\starttyping
78publications > adding bib data to set 'phony' from source 'phony'
79publications > phony > warning : Hello Allan!
80publications > phony > warning : How are you doing today?
81publications > phony > message : Hello Allan!
82publications > phony > message : How are you doing today?
83\stoptyping
84
85You can use this feature to add warnings to your database for entries that you
86need to check.
87
88You can also use comment to hide entries:
89
90\startBTX
91@comment {
92
93    @article{Hobby1999,
94      author  = {Hobby, John D.},
95      year    = {1999},
96      title   = {Introduction to MetaPost},
97      journal = {Eutupon},
98      volume  = {2},
99      month   = {April},
100      pages   = {39-53},
101    }
102
103}
104\stopBTX
105
106\stopchapter
107
108\stopcomponent
109