summaryrefslogtreecommitdiff
path: root/doc/context/sources/general/manuals/publications/publications-tracing.tex
blob: 1c97c715d52a7effdf7a2117edc8e20076af6968 (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
\environment publications-style

\startcomponent publications-tracing

\startchapter
  [title=Tracing]

There are several tracing options. If you want to see where a citations refers to
and where a list entry point back to, you can say:

\startTEX
\enabletrackers[publications.crosslinks]
\stopTEX

This injects markers in both places. One list entry can point to multiple
citations. The other tracers a more for debugging and can generate lots of
messages.

\startTEX
publications
publications.authorhash
publications.cite
publications.cite.missing
publications.cite.references
publications.detail
publications.duplicates
publications.match
publications.setups
publications.sorters
publications.suffixes
\stopTEX

You can also trace the databases. Take this one:

\startbuffer
\startbuffer[phony]
@comment { warning :
    Hello Allan!
    How are you doing today?
}

@CoMMeNT { message :
    Hello Allan!
    How are you doing today?
}

@comment {
    all kind of crap
}

@Article{Myarticle,
  Title                    = {My title},
  Author                   = {Myself, Me},
  Journal                  = {My favorite journal},
  Year                     = {2014},
  Pages                    = {1},
}

@Foo{foo,
  Goo = goo,
}
\stopbuffer
\stopbuffer

\typeBTXbuffer \getbuffer

\startbuffer
\usebtxdataset [phony] [phony.buffer]
\stopbuffer

When we load this database (buffer) with:

\typeTEXbuffer \getbuffer

We get this on the console and in the log

\starttyping
publications > adding bib data to set 'phony' from source 'phony'
publications > phony > warning : Hello Allan!
publications > phony > warning : How are you doing today?
publications > phony > message : Hello Allan!
publications > phony > message : How are you doing today?
\stoptyping

You can use this feature to add warnings to your database for entries that you
need to check.

You can also use comment to hide entries:

\startBTX
@comment {

    @article{Hobby1999,
      author  = {Hobby, John D.},
      year    = {1999},
      title   = {Introduction to MetaPost},
      journal = {Eutupon},
      volume  = {2},
      month   = {April},
      pages   = {39-53},
    }

}
\stopBTX

\stopchapter

\stopcomponent