[kaffe] jit3 docs

[Helmer Krämer]

This is a multi-part message in MIME format.

--Multipart_Wed__12_Mar_2003_10:38:23_+0100_0953f9d8
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit



Hi all,

I've attached a patch that adds some small comments
to kaffe's jit3. I'd really appreciate it if you'd
have a look at it and send some feedback (especially
those that know more about the jitter than me).

Greetings,
Helmer  
--Multipart_Wed__12_Mar_2003_10:38:23_+0100_0953f9d8
Content-Type: application/octet-stream;
 name="jitter-docs"
Content-Disposition: attachment;
 filename="jitter-docs"
Content-Transfer-Encoding: base64

SW5kZXg6IGJhc2Vjb2RlLmgKPT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PQpSQ1MgZmlsZTogL2N2cy9rYWZmZS9rYWZmZS9r
YWZmZS9rYWZmZXZtL2ppdDMvYmFzZWNvZGUuaCx2CnJldHJpZXZpbmcgcmV2aXNpb24gMS42CmRp
ZmYgLXUgLXAgLXIxLjYgYmFzZWNvZGUuaAotLS0gYmFzZWNvZGUuaAkxMSBGZWIgMjAwMyAxNjo1
NDo0NSAtMDAwMAkxLjYKKysrIGJhc2Vjb2RlLmgJMTIgTWFyIDIwMDMgMDk6MjA6MDYgLTAwMDAK
QEAgLTkzLDcgKzkzLDEyIEBAIGVudW0gewogI2RlZmluZQltb25pdG9yX2V4aXQoKQkJbW9uX2V4
aXQoeG1ldGgsIGxvY2FsKDApKQogCiAvKiAtLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0t
LS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLS0tLSAqLwotLyogSW5zdHJ1Y3Rpb24g
Zm9ybWF0cyAqLworLyogSW5zdHJ1Y3Rpb24gZm9ybWF0cworICoKKyAqIFRoZXNlIGZ1bmN0aW9u
cyBhbmQgbWFjcm9zIHRha2UgY2FyZSBvZiBwcm9wZXJseSBjcmVhdGluZyBhbmQgaW5pdGlhbGl6
aW5nCisgKiBhIHN0cnVjdCBfc2VxdWVuY2UgZm9yIHRoZSBkaWZmZXJlbnQgaW5zdHJ1Y3Rpb25z
LiBUaGVyZSdzIG9uZSBmdW5jdGlvbgorICogcHJvdmlkZWQgZm9yIGV2ZXJ5IHBvc3NpYmxlIGlu
c3RydWN0aW9uIGZvcm1hdC4gCisgKi8KIAogI2RlZmluZQlzbG90X2NvbnN0X2NvbnN0KGRzdCwg
c3JjLCBzcmMyLCBmdW5jLCB0KQkJCVwKIAl7CQkJCQkJCQlcCkluZGV4OiByZWdpc3RlcnMuaAo9
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09ClJDUyBmaWxlOiAvY3ZzL2thZmZlL2thZmZlL2thZmZlL2thZmZldm0vaml0My9y
ZWdpc3RlcnMuaCx2CnJldHJpZXZpbmcgcmV2aXNpb24gMS42CmRpZmYgLXUgLXAgLXIxLjYgcmVn
aXN0ZXJzLmgKLS0tIHJlZ2lzdGVycy5oCTI3IERlYyAyMDAwIDA2OjIxOjA0IC0wMDAwCTEuNgor
KysgcmVnaXN0ZXJzLmgJMTIgTWFyIDIwMDMgMDk6MjA6MDYgLTAwMDAKQEAgLTI3LDE4ICsyNyw0
NSBAQAogCiAvKiBJbmZvcm1hdGlvbiBhYm91dCB0aGUgc3RhdGUgb2YgYSBwYXJ0aWN1bGFyIHJl
Z2lzdGVyLiAqLwogdHlwZWRlZiBzdHJ1Y3QgX2tyZWdzIHsKLQkvKiBUaGUgc2xvdCB3aG9zZSB2
YWx1ZSBpcyBpbiB0aGlzIHJlZ2lzdGVyLiAqLworCS8qIFRoZSBsaXN0IG9mIHNsb3RzIHdob3Nl
IHZhbHVlcyBhcmUgaW4gdGhpcyByZWdpc3Rlci4gKi8KIAlTbG90RGF0YSoJCXNsb3Q7CisKKyAg
ICAgICAgLyogY3VycmVudCB0eXBlIG9mIHRoZSByZWdpc3RlciAqLwogCXVpbnQ4CQkJY3R5cGU7
CisJCisJLyogdHlwZSBvZiB0aGUgcmVnaXN0ZXIgKi8KIAl1aW50OAkJCXR5cGU7CisKKwkvKiBm
bGFncyBvZiB0aGUgcmVnaXN0ZXIgKi8KIAl1aW50OAkJCWZsYWdzOworCisJLyogdGhlIGxhc3Qg
dGltZSB0aGlzIHJlZ2lzdGVyIHdhcyBhc3NpZ25lZCB0byBhIHNsb3QgKi8KIAl1aW50MzIJCQl1
c2VkOworCisJLyogaWQgb2YgdGhpcyByZWdpc3RlciAqLwogCXVpbnQ4CQkJcmVnbm87CisKKwkv
KiBudW1iZXIgb2Ygc2xvdHMgd2hvc2UgdmFsdWVzIGFyZSBpbiB0aGlzIHJlZ2lzdGVyICovCiAJ
dWludDgJCQlyZWZzOwogfSBrcmVnczsKIAorLyoKKyAqIGFycmF5IGNvbnRhaW5pbmcgaW5mb3Jt
YXRpb24gYWJvdXQgYWxsIHJlZ2lzdGVycyBvZiB0aGUgYXJjaGl0ZWN0dXJlIHRoZQorICogaml0
dGVyIHdhcyBjb21waWxlZCBmb3IuCisgKiAKKyAqIGluaXRpYWxpemVkIGJ5IHRoZSBSRUdJU1RF
Ul9TRVQgbWFjcm8gdG8gYmUgZGVmaW5lZCBieSB0aGUgYmFja2VuZC4KKyAqLyAKIGV4dGVybiBr
cmVncyByZWdpbmZvW107CisKKy8qCisgKiBudW1iZXIgb2YgcmVnaXN0ZXIgYXNzaWdubWVudHMg
ZG9uZSBzbyBmYXIuCisgKiAoRklYTUU6IHdoeSBpcyB0aGlzIG9uZSBleHBvcnRlZD8pCisgKi8K
IGV4dGVybiBpbnQgdXNlY250OworCisvKgorICogPz8/CisgKi8KIGV4dGVybiBpbnQgZW5hYmxl
X3JlYWRvbmNlOwogCiAjZGVmaW5lCU1BWFJFRwkJCU5SX1JFR0lTVEVSUwpJbmRleDogc2VxLmgK
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
PT09PT09PT09PQpSQ1MgZmlsZTogL2N2cy9rYWZmZS9rYWZmZS9rYWZmZS9rYWZmZXZtL2ppdDMv
c2VxLmgsdgpyZXRyaWV2aW5nIHJldmlzaW9uIDEuNgpkaWZmIC11IC1wIC1yMS42IHNlcS5oCi0t
LSBzZXEuaAkxMyBPY3QgMTk5OSAwMToyMzowMSAtMDAwMAkxLjYKKysrIHNlcS5oCTEyIE1hciAy
MDAzIDA5OjIwOjA2IC0wMDAwCkBAIC0xNiwxMCArMTYsMjMgQEAgc3RydWN0IF9sYWJlbF87CiAK
IHR5cGVkZWYgdm9pZCAoKmlmdW5jKShzdHJ1Y3QgX3NlcXVlbmNlKik7CiAKKy8qIG1heGltdW0g
bnVtYmVyIG9mIGFyZ3VtZW50cyBmb3Igb25lIHNlcXVlbmNlICovCiAjZGVmaW5lCVNFUVNMT1RT
CQk1CiAKKy8qIAorICogYSBzdHJ1Y3QgX3NlcXVlbmNlIGlzIG9uZSBpbnN0cnVjdGlvbiBvZiB0
aGUgaW50ZXJtZWRpYXRlIGxhbmd1YWdlIG9mIHRoZSBqaXR0ZXIuCisgKgorICogVGhlc2UgaW50
ZXJtZWRpYXRlIGluc3RydWN0aW9ucyBhcmUgZ2VuZXJhdGVkIHdoaWxlIHJlYWRpbmcgdGhlIGph
dmEgYnl0ZWNvZGUKKyAqIGFuZCBhcmUgdHJhbnNsYXRlZCBpbnRvIG5hdGl2ZSBjb2RlIGFmdGVy
d2FyZHMuIFRoaXMgdHJhbnNsYXRpb24gaXMgZG9uZQorICogcGVyIGJhc2ljIGJsb2NrIHJhdGhl
ciB0aGFuIHBlciBtZXRob2QuCisgKi8KIHR5cGVkZWYgc3RydWN0IF9zZXF1ZW5jZSB7CisJLyog
dGhlIGZ1bmN0aW9uIHRoYXQgaXMgYWJsZSB0byBlbWl0IG5hdGl2ZSBjb2RlIAorICAgICAgICAg
ICBjb3JyZXNwb25kaW5nIHRvIHRoaXMgaW5zdHJ1Y3Rpb24gKi8KIAlpZnVuYwkJCWZ1bmM7CisK
KwkvKiBwYXJhbWV0ZXJzIGZvciB0aGlzIGluc3RydWN0aW9uLAorICAgICAgICAgICB0aGVpciBt
ZWFuaW5nIGRlcGVuZHMgb24gdGhlIHZhbHVlIG9mIGZ1bmMgKi8KIAl1bmlvbiB7CiAJCWp2YWx1
ZQkJdmFsdWU7CiAJCXN0cnVjdCBfbGFiZWxfKiBsYWJjb25zdDsKQEAgLTI3LDE4ICs0MCw0NyBA
QCB0eXBlZGVmIHN0cnVjdCBfc2VxdWVuY2UgewogCQlzdHJ1Y3QgU2xvdERhdGEqKiBzbWFzazsK
IAkJc3RydWN0IFNsb3REYXRhKiBzbG90OwogCX0gdVtTRVFTTE9UU107CisKKwkvKiB0eXBlIG9m
IHRoZSBpbnN0cnVjdGlvbiwgb25lIG9mIHRoZSBUKiBjb25zdGFudHMgZGVmaW5lZCBpbiBzbG90
cy5oIAorICAgICAgICAgICAoRklYTUU6IHdoeSBhcmUgdGhleSAjZGVmaW5lZCB0aGVyZT8pICov
CiAJdWludDgJCQl0eXBlOworCisJLyogdHJ1ZSBpZmYgZ2VuZXJhdGlvbiBvZiBuYXRpdmUgY29k
ZSBmb3IgdGhpcyBpbnN0cnVjdGlvbgorICAgICAgICAgICBpcyBuZWNlc3NhcnksIG90aGVyd2lz
ZSBmYWxzZSAqLwogCXVpbnQ4CQkJcmVmZWQ7CisKKwkvKiBiaXRtYXNrIG9mIHRoZSBzbG90cyBu
b3QgYmVpbmcgYWNjZXNzZWQgYWZ0ZXIgdGhpcworICAgICAgICAgICBpbnN0cnVjdGlvbiAoRklY
TUU6IHdoeSBpcyB0aGlzIGEgMzJiaXQgaW50PyBJdAorICAgICAgICAgICBzZWVtcyB0byBiZSB1
c2VkIG9ubHkgYXMgYW4gaW5kZXggaW50byB1KSAqLwogCXVpbnQzMgkJCWxhc3R1c2U7CisKKwkv
KiBwb2ludGVyIHRvIHRoZSBpbnN0cnVjdGlvbiBmb2xsb3dpbmcgdGhpcyBvbmUgKi8KIAlzdHJ1
Y3QgX3NlcXVlbmNlKgluZXh0OwogfSBzZXF1ZW5jZTsKIAorLyoKKyAqIHJlc2V0cyB0aGUgcG9v
bCBvZiBzZXF1ZW5jZSBvYmplY3RzIGFsbG9jYXRlZCBieSB0aGUgaml0dGVyLgorICovCiB2b2lk
IGluaXRTZXEodm9pZCk7CisKKy8qCisgKiByZXR1cm5zIGEgbmV3IHNlcXVlbmNlIG9iamVjdAor
ICovCiBzZXF1ZW5jZSogbmV4dFNlcSh2b2lkKTsKIAorLyoKKyAqIFRoZXNlIHRyYWNrIHRoZSBw
b29sIG9mIHNlcXVlbmNlIG9iamVjdHMgYWxsY29hdGVkIGJ5IHRoZSBqaXR0ZXIuIAorICogVGhl
IHNldCBvZiB2YWxpZCBzZXF1ZW5jZSBvYmplY3RzIGlzIHRoZSBzdWJsaXN0IGJldHdlZW4gZmly
c3RTZXEKKyAqIGFuZCBjdXJyU2VxLCBleGNsdXNpdmUuCisgKi8KIGV4dGVybiBzZXF1ZW5jZSoJ
CWZpcnN0U2VxOwogZXh0ZXJuIHNlcXVlbmNlKgkJbGFzdFNlcTsKIGV4dGVybiBzZXF1ZW5jZSoJ
CWN1cnJTZXE7CisKKy8qCisgKiBzZXF1ZW5jZSBjdXJyZW50bHkgYmVpbmcgY3JlYXRlZCAocmV0
dXJuIHZhbHVlIG9mIGxhc3QgY2FsbCB0byBuZXh0U2VxKS4KKyAqIChGSVhNRTogd2h5IGlzIHRo
aXMgb25lIG5lY2Vzc2FyeT8pCisgKi8KIGV4dGVybiBzZXF1ZW5jZSogCQlhY3RpdmVTZXE7CiAK
ICNkZWZpbmUJQUxMT0NTRVFOUgkJMTAyNApJbmRleDogc2xvdHMuaAo9PT09PT09PT09PT09PT09
PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09ClJDUyBm
aWxlOiAvY3ZzL2thZmZlL2thZmZlL2thZmZlL2thZmZldm0vaml0My9zbG90cy5oLHYKcmV0cmll
dmluZyByZXZpc2lvbiAxLjMKZGlmZiAtdSAtcCAtcjEuMyBzbG90cy5oCi0tLSBzbG90cy5oCTE2
IE9jdCAxOTk5IDAzOjE2OjI2IC0wMDAwCTEuMworKysgc2xvdHMuaAkxMiBNYXIgMjAwMyAwOToy
MDowNiAtMDAwMApAQCAtMzgsMTQgKzM4LDQwIEBACiAjZGVmaW5lCVNSX1NUQVJUCQk0CiAjZGVm
aW5lCVNSX0VYQ0VQVElPTgkJNQogCisvKgorICogdXNlZCB0byB0cmFjayBhIGZ1bmN0aW9uJ3Mg
bG9jYWxzLCBhcmd1bWVudHMgYW5kIHRlbXBzLgorICoKKyAqIEEgU2xvdERhdGEgcmVwcmVzZW50
cyBib3RoLCBhIGxvY2FsIHZhcmlhYmxlIG9mIHRoZSBleGVjdXRpb24gZnJhbWUgYXMgZGVmaW5l
ZAorICogaW4gdGhlIEpWTSBTcGVjLCBzZWNvbmQgZWRpdGlvbiwgpzMuNi4xIGFuZCBhbiBlbnRy
eSBvZiB0aGUgb3BlcmFuZCBzdGFjaworICogYXMgaW4gpzMuNi4yLiBBcyBzdWNoLCBsb25ncyBh
bmQgZG91YmxlcyBvY2N1cHkgdHdvIFNsb3REYXRhcywgYWxsIG90aGVyCisgKiB0eXBlcyBvbmx5
IG9uZS4KKyAqLwogc3RydWN0IFNsb3REYXRhIHsKKyAgICAgICAgLyogaW5kZXggb2YgdGhlIHJl
Z2lzdGVyIGhvbGRpbmcgdGhlIHZhbHVlIG9mIHRoaXMgc2xvdCAqLwogCXVpbnQxNgkJCXJlZ25v
OworCisgICAgICAgIC8qIHN0YWNrIGZyYW1lIG9mZnNldCBvZiB0aGlzIHNsb3QgKi8KIAlpbnQJ
CQlvZmZzZXQ7CisKKyAgICAgICAgLyogdGhlIGxhc3Qgc2VxdWVuY2Ugd3JpdGluZyB0aGlzIHNs
b3QgKi8KIAlzdHJ1Y3QgX3NlcXVlbmNlKgl3c2VxOworCQorCS8qIHRoZSBsYXN0IHNlcXVlbmNl
IHJlYWRpbmcgdGhpcyBzbG90ICovCiAJc3RydWN0IF9zZXF1ZW5jZSoJcnNlcTsKKworCS8qIHNs
b3QgPT0gc2xvdC0+cnNlcS0+dVtzbG90LT5yc2Vxc2xvdF0uc2xvdCwKKyAgICAgICAgICAgaG93
ZXZlciB0aGlzIGlzIGV4cHJlc3NlZCBpbiBwbGFpbiBlbmdsaXNoICovCiAJdWludDgJCQlyc2Vx
c2xvdDsKKworCS8qIGZsYWcgaW5kaWNhdGluZyBob3cgdGhpcyBzbG90IGlzIG1vZGlmaWVkIChl
aXRoZXIgcnJlYWQsIHJ3cml0ZSBvciBybm9uZSkKKyAgICAgICAgICAgKEZJWE1FOiBhcmUgdGhl
c2UgZmxhZ3MgbmVjZXNzYXJ5PyB3aGF0IGFib3V0IGRldGVybWluaW5nCisgICAgICAgICAgIHRo
ZW0gb24gdGhlIGZseSB1c2luZyByc2VxIGFuZCB3c2VxPykgKi8KIAl1aW50OAkJCW1vZGlmaWVk
OworCisJLyogcG9pbnRlciB0byB0aGUgbmV4dCBzbG90IHdob3NlIHZhbHVlIGlzIHN0b3JlZCBp
biB0aGUgc2FtZSByZWdpc3RlciAqLwogCXN0cnVjdCBTbG90RGF0YSoJcm5leHQ7CisKKwkvKiBm
bGFnIGluZGljYXRpbmcgd2hldGhlciB0aGlzIHNsb3QgY29udGFpbnMgYSBnbG9iYWwgdmFsdWUg
Ki8KIAlpbnQJCQlnbG9iYWw7CiB9OwogdHlwZWRlZiBzdHJ1Y3QgU2xvdERhdGEgU2xvdERhdGE7
CkBAIC03MCwxMyArOTYsNTIgQEAgdHlwZWRlZiBzdHJ1Y3QgU2xvdEluZm8gU2xvdEluZm87CiAK
ICNkZWZpbmUJUkVHU0xPVAlTbG90RGF0YQogCisvKgorICogYXJyYXkgY29udGFpbmluZyBhbGwg
c2xvdHMgb2YgdGhlIG1ldGhvZCBiZWluZyB0cmFuc2xhdGVkLgorICovCiBleHRlcm4gU2xvdElu
Zm8qIGJhc2ljc2xvdHM7CisKKy8qCisgKiBzYW1lIGFzIGJhc2ljc2xvdHMgPz8/CisgKi8KIGV4
dGVybiBTbG90SW5mbyogc2xvdGluZm87CisKKy8qCisgKiBhcnJheSBvZiBsb2NhbHMgb2YgdGhl
IG1ldGhvZCBiZWluZyB0cmFuc2xhdGVkLgorICoKKyAqIHRoZSBmaXJzdCBsb2NhbHN6IGVudHJp
ZXMgY29ycmVzcG9uZCB0byB0aGUgbG9jYWwgdmFyaWFibGVzIGFzIHBlciB2bSBzcGVjLAorICog
dGhlIGxhc3Qgc3RhY2tzeiBlbnRyaWVzIGNvcnJlc3BvbmQgdG8gdGhlIGVudHJpZXMgb2YgdGhl
IG9wZXJhbmQgc3RhY2sKKyAqCisgKiBUaGUgYm90dG9tIG9mIHRoZSBvcGVyYW5kIHN0YWNrIGlz
IHRoZSBsYXN0IGVudHJ5IG9mIHRoaXMgYXJyYXkgYW5kIGl0CisgKiBncm93cyBkb3dud2FyZHMg
KHRvd2FyZHMgc21hbGxlciBpbmRpY2VzKS4KKyAqLwogZXh0ZXJuIFNsb3RJbmZvKiBsb2NhbGlu
Zm87CisKKy8qCisgKiBhcnJheSBvZiB0ZW1wIHNsb3RzIGJlaW5nIHVzZWQgYnkgdGhlIGdlbmVy
YXRlZCBuYXRpdmUgY29kZS4KKyAqLwogZXh0ZXJuIFNsb3RJbmZvKiB0ZW1waW5mbzsKKworLyoK
KyAqIHRoZSBzbG90IHRoYXQgY29udGFpbnMgdGhlIHN0YWNrIGxpbWl0LgorICoKKyAqIG9ubHkg
dXNlZCB3aGVuIFNUQUNLX0xJTUlUIGlzICNkZWZpbmVkIGJ5IHRoZSBiYWNrZW5kLiAKKyAqLwog
ZXh0ZXJuIFNsb3RJbmZvIHN0YWNrX2xpbWl0WzFdOworCisvKgorICogaW5kZXggb2YgZmlyc3Qg
dW51c2VkIGVsZW1lbnQgb2YgdGVtcGluZm8gKG5leHQgYXZhaWxhYmxlIHRlbXAgc2xvdCkKKyAq
LwogZXh0ZXJuIGludCB0bXBzbG90OworCisvKgorICogdG9wIG9mIHRoZSBvcGVyYW5kIHN0YWNr
LiBsb2NhbHN6IDw9IHN0YWNrbm8gPCBsb2NhbHN6K3N0YWNrc3oKKyAqLwogZXh0ZXJuIGludCBz
dGFja25vOworCisvKgorICogbnVtYmVyIG9mIGVsZW1lbnRzIGluIGJhc2ljc2xvdHMuCisgKi8K
IGV4dGVybiBpbnQgbWF4c2xvdDsKIAogdm9pZCBpbml0U2xvdHMoaW50KTsK

--Multipart_Wed__12_Mar_2003_10:38:23_+0100_0953f9d8--