mirror of
https://github.com/Mercury-Language/mercury.git
synced 2026-04-16 01:43:35 +00:00
0607c27543
The non-style changes include
- Replacing outdated information with up to date information.
- Deleting fully obsolete information, such as references to the IL backend.
- Replacing list entries that were just bare words or phrases
with full sentences, where this is useful.
- Improvements to make documents easier to read and understand.
However, the bulk of the diff consists of style changes. The initial main
of these changes are to eliminate, or at least reduce, inconsistencies
- between the styles of the different parts of each document, and
- between the styles of differents documents.
This applies both as they appear in a browser, and in the source .html file.
The main style changes are
- Add a vim mode line to each file.
- Do not specify a color for the page background; let the browser decide.
- Add a heading to the top of each page that echoes the title.
- Avoid SHOUTING in headings.
- Avoid the unneeded use of <hr>.
- Avoid the use of headings (e.g. h5) that are so low in the hierarchy that
browsers render them in a font that is *smaller* than the usual font.
- Replace definition lists with standard unordered lists
when the list items are not definitions.
- Replace ordered lists with standard unordered lists
when the list items have no meaningful order.
- Do not indent the contents of unordered lists, with the exception of
nested lists.
- Unless all entries in a list are extremely short,
do not try to put anything next to <li>.
- Fix violations reported by weblint.
compiler/notes/compiler_design.html:
The changes described above.
Explicitly introduce the notion of the middle end.
compiler/notes/bootstrapping.html:
Rewrite this almost from scratch.
compiler/notes/work_in_progress.html:
Rename the page to make it clear that these issues are NOT being
worked on.
compiler/notes/release_checklist.html:
compiler/notes/todo.html:
Note that these lists are quite out of date.
compiler/notes/allocation.html:
compiler/notes/analysis.html:
compiler/notes/bytecode.html:
compiler/notes/c_coding_standard.html:
compiler/notes/coding_standards.html:
compiler/notes/developer_intro.html:
compiler/notes/failure.html:
compiler/notes/gc_and_c_code.html:
compiler/notes/glossary.html:
compiler/notes/grade_library.html:
compiler/notes/index.html:
compiler/notes/interface_files.html:
compiler/notes/mlds_tail_recursion.html:
compiler/notes/overall_design.html:
compiler/notes/promise_ex.html:
compiler/notes/reviews.html:
compiler/notes/trailing.html:
compiler/notes/type_class_transformation.html:
compiler/notes/upgrade_boehm_gc.html:
compiler/notes/Mmakefile:
Add a target to run weblint on all the HTML files.
61 lines
1.5 KiB
HTML
61 lines
1.5 KiB
HTML
<!--
|
|
vim: ts=4 sw=4 expandtab ft=html
|
|
-->
|
|
|
|
<html>
|
|
<head>
|
|
<title>Information On LLDS Accurate Garbage Collection And C Code</title>
|
|
</head>
|
|
|
|
<body>
|
|
|
|
<h1>Information On LLDS Accurate Garbage Collection And C Code</h1>
|
|
|
|
When handwritten code is called from Mercury,
|
|
the garbage collection scheduler doesn't know anything about the code,
|
|
so it cannot replace the succip on the stack (if there is one)
|
|
with the collector's address.
|
|
<p>
|
|
If the handwritten code calls no other code, then this is fine,
|
|
the scheduler knows it can replace the succip variable
|
|
and when a proceed() occurs,
|
|
execution will return to mercury code which it knows about.
|
|
<p>
|
|
If handwritten code calls other handwritten code, we have a problem,
|
|
as succip will be saved on the stack
|
|
and we don't know where on the stack it is stored.
|
|
So we use a global variable 'saved_succip' which is succip is saved into.
|
|
Care must be taken to save saved_succip on the stack
|
|
so it doesn't get clobbered.
|
|
So
|
|
<pre>
|
|
detstackvar(1) = (int) succip;
|
|
</pre>
|
|
becomes
|
|
<pre>
|
|
detstackvar(1) = (int) saved_succip;
|
|
saved_succip = (int) succip;
|
|
</pre>
|
|
and, when restoring,
|
|
<pre>
|
|
succip = (int) detstackvar(1);
|
|
</pre>
|
|
becomes
|
|
<pre>
|
|
succip = saved_succip;
|
|
saved_succip = detstackvar(1);
|
|
</pre>
|
|
|
|
<p>
|
|
(With appropriate LVALUE_CASTs).
|
|
<p>
|
|
In this way, garbage collection
|
|
always knows where the succip is stored in handwritten code.
|
|
<p>
|
|
The garbage collection code must check that
|
|
the current execution is not still in a handwritten predicate --
|
|
if it is, it must re-schedule (essentially just the same as before).
|
|
|
|
</body>
|
|
</html>
|