Mantis Bug Tracker

View Issue Details Jump to Notes ] Issue History ] Print ]
IDProjectCategoryView StatusDate SubmittedLast Update
0007599OCamldocumentationpublic2017-07-25 22:292017-10-13 20:49
Assigned To 
PrioritylowSeveritytextReproducibilityhave not tried
PlatformOSOS Version
Product Version 
Target Version4.07.0+dev/beta2Fixed in Version 
Summary0007599: Document why, when and how to update magic numbers
DescriptionCurrently external contributors may not know about magic numbers, when to update them, and what is the process to update them (in particular, I believe that a bootstrap is needed?).

This could be explained in comments in utils/config.mlp (I like having documentation close to the code) or maybe in utils/HACKING.adoc.
Attached Files

- Relationships
related to 0007598resolveddoligez Out-of-date camlp4 causes segfault in ocamlopt.opt 
related to 0007600acknowledged Document the commit process around bootstrapping 

-  Notes
frisch (developer)
2017-10-13 20:49

Cf discussion on [^] . In particular, Xavier suggested the following scheme:

> @damiendoligez and I were discussing an even more radical solution: just
> derive the magic numbers from the version number, e.g. CamlTMMmmpp, where T
> identifies the type of file, MM the major version number, mm the minor
> version number, and pp the patchlevel. No more bumping necessary!

- Issue History
Date Modified Username Field Change
2017-07-25 22:29 gasche New Issue
2017-07-25 22:30 gasche Relationship added related to 0007598
2017-07-25 22:30 gasche Tag Attached: junior_job
2017-07-25 22:34 gasche Relationship added related to 0007600
2017-07-25 22:34 gasche Product Version 4.06.0 +dev/beta1/beta2/rc1 =>
2017-07-25 22:34 gasche Target Version => 4.06.0 +dev/beta1/beta2/rc1
2017-09-21 10:32 xleroy Status new => acknowledged
2017-10-13 20:49 frisch Note Added: 0018560
2017-10-13 20:49 frisch Target Version 4.06.0 +dev/beta1/beta2/rc1 => 4.07.0+dev/beta2

Copyright © 2000 - 2011 MantisBT Group
Powered by Mantis Bugtracker