<div dir="ltr">Should the history.txt files get stuck into the end of the manuals for the time being?<div><br></div><div>Robby</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sun, Dec 8, 2013 at 8:37 AM, Matthew Flatt <span dir="ltr"><<a href="mailto:mflatt@cs.utah.edu" target="_blank">mflatt@cs.utah.edu</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div class="im">At Sun, 8 Dec 2013 11:09:39 +0100, Jens Axel Søgaard wrote:<br>
> In cases where the semantics of constructs are changed, should the<br>
> documentation have a margin note stating the version number of the<br>
> change?<br>
<br>
</div>Yes, it really should.<br>
<br>
Details like this get listed in "HISTORY.txt" (the `case` form<br>
apparently changed in v5.3.2), but no one ever reads "HISTORY.txt", and<br>
we frequently forget to update it. Putting change information in the<br>
documentation is clearly better.<br>
<br>
Unless someone has an even better idea, I'll add a suitable form to<br>
`scribble/manual` and start trying to record changes this way.<br>
<span class="HOEnZb"><font color="#888888"><br>
<br>
Matthew<br>
</font></span><div class="HOEnZb"><div class="h5"><br>
<br>
_________________________<br>
  Racket Developers list:<br>
  <a href="http://lists.racket-lang.org/dev" target="_blank">http://lists.racket-lang.org/dev</a><br>
</div></div></blockquote></div><br></div>