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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
|
.\" Copyright (C) 2001 Information-technology Promotion Agency (IPA)
.\" Copyright (C) 2001-2011
.\" National Institute of Advanced Industrial Science and Technology (AIST)
.\" This file is part of the m17n library documentation.
.\" Permission is granted to copy, distribute and/or modify this document
.\" under the terms of the GNU Free Documentation License, Version 1.2 or
.\" any later version published by the Free Software Foundation; with no
.\" Invariant Section, no Front-Cover Texts,
.\" and no Back-Cover Texts. A copy of the license is included in the
.\" appendix entitled "GNU Free Documentation License".
.TH "Debugging" 3m17n "12 Jan 2011" "Version 1.6.2" "The m17n Library" \" -*- nroff -*-
.ad l
.nh
.SH NAME
Debugging \- Support for m17n library users to debug their programs.
.SS "Functions"
.in +1c
.ti -1c
.RI "\fBMCharTable\fP * \fBmdebug_dump_chartab\fP (\fBMCharTable\fP *table, int indent)"
.br
.RI "\fIDump a chartable. \fP"
.ti -1c
.RI "\fBMFace\fP * \fBmdebug_dump_face\fP (\fBMFace\fP *face, int indent)"
.br
.RI "\fIDump a face. \fP"
.ti -1c
.RI "\fBMFont\fP * \fBmdebug_dump_font\fP (\fBMFont\fP *font)"
.br
.RI "\fIDump a font. \fP"
.ti -1c
.RI "\fBMFontset\fP * \fBmdebug_dump_fontset\fP (\fBMFontset\fP *fontset, int indent)"
.br
.RI "\fIDump a fontset. \fP"
.ti -1c
.RI "\fBMInputMethod\fP * \fBmdebug_dump_im\fP (\fBMInputMethod\fP *im, int indent)"
.br
.RI "\fIDump an input method. \fP"
.ti -1c
.RI "int \fBmdebug_hook\fP ()"
.br
.RI "\fIHook function called on an error. \fP"
.ti -1c
.RI "\fBMText\fP * \fBmdebug_dump_mtext\fP (\fBMText\fP *mt, int indent, int fullp)"
.br
.RI "\fIDump an M-text. \fP"
.ti -1c
.RI "\fBMPlist\fP * \fBmdebug_dump_plist\fP (\fBMPlist\fP *plist, int indent)"
.br
.RI "\fIDump a property list. \fP"
.ti -1c
.RI "\fBMSymbol\fP \fBmdebug_dump_symbol\fP (\fBMSymbol\fP symbol, int indent)"
.br
.RI "\fIDump a symbol. \fP"
.ti -1c
.RI "\fBMSymbol\fP \fBmdebug_dump_all_symbols\fP (int indent)"
.br
.RI "\fIDump all symbol names. \fP"
.in -1c
.SH "Detailed Description"
.PP
Support for m17n library users to debug their programs.
The m17n library provides the following facilities to support the library users to debug their programs.
.PP
.PD 0
.IP "\(bu" 2
Environment variables to control printing of various information to stderr.
.PP
.PD 0
.IP " \(bu" 4
MDEBUG_INIT \-\- If set to 1, print information about the library initialization on the call of \fBM17N_INIT()\fP.
.PP
.IP " \(bu" 4
MDEBUG_FINI \-\- If set to 1, print counts of objects that are not yet freed on the call of \fBM17N_FINI()\fP.
.PP
.IP " \(bu" 4
MDEBUG_CHARSET \-\- If set to 1, print information about charsets being loaded from the m17n database.
.PP
.IP " \(bu" 4
MDEBUG_CODING \-\- If set to 1, print information about coding systems being loaded from the m17n database.
.PP
.IP " \(bu" 4
MDEBUG_DATABASE \-\- If set to 1, print information about data being loaded from the m17n database.
.PP
.IP " \(bu" 4
MDEBUG_FONT \-\- If set to 1, print information about fonts being selected and opened.
.PP
.IP " \(bu" 4
MDEBUG_FLT \-\- If set to 1, 2, or 3, print information about which command of Font Layout Table are being executed. The bigger number prints the more detailed information.
.PP
.IP " \(bu" 4
MDEBUG_INPUT \-\- If set to 1, print information about how an input method is running.
.PP
.IP " \(bu" 4
MDEBUG_ALL \-\- Setting this variable to 1 is equivalent to setting all the above variables to 1.
.PP
.IP " \(bu" 4
MDEBUG_OUTPUT_FILE \-\- If set to a file name, the above debugging information is appended to the file. If set to 'stdout', the information is printed to stdout.
.PP
.PP
.PP
.IP "\(bu" 2
Functions to print various objects in a human readable way. See the documentation of mdebug_dump_XXXX() functions.
.PP
.IP "\(bu" 2
The hook function called on an error. See the documentation of \fBmdebug_hook()\fP.
.PP
.PP
.SH "Author"
.PP
Generated automatically by Doxygen for The m17n Library from the source code.
.SH COPYRIGHT
Copyright (C) 2001 Information\-technology Promotion Agency (IPA)
.br
Copyright (C) 2001\-2011 National Institute of Advanced Industrial Science and Technology (AIST)
.br
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License
<http://www.gnu.org/licenses/fdl.html>.
|
