doc/*.texi:
Use @copyright{} in the HTML version fo the copyright notices.
Use long dashes in date ranges as per the PDF version.
Put each copyright holder on their own line.
Fix the years in copyright messages so that they record move from The
University of Melbourne to The Mercury Team correctly.
I recall the time correctly because it's when i submitted my thesis :-)
.README.in:
bindist/bindist.README:
compiler/handle_options.m:
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
As above.
Branches: main, 11.07
.README.in:
bindist/bindist.README:
compiler/handle_options.m:
doc/*.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
Bump the year in the copyright messages.
Branches: main, 11.01
.README.in:
bindist/bindist.README:
compiler/handle_options.m:
doc/*.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
Bump the year in the usage messages.
.README.in:
bindist/bindist.README:
compiler/handle_options.m:
doc/*.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
Bump the year in the copyright message.
( if some [V] C then T else E )
then V will be quantified over both C and T. This was not
documented anywhere. The fix is to document it.
(There has been some discussion in the notes for bug #15 about
adding new syntax to explicitly support the situation where you
want to quantify over both the condition and then branch of
and if-then-else. The situation occurs so rarely that it's
probably not worth it - also, the current proposals don't work
with the ( C -> T ; E ) syntax for if-then-elses.)
doc/reference_manual.texi:
Document that the scope of an existential quantification that
occurs as the top-level goal of the condition of an if-then-else
extends over the then branch.
Add a couple of illustrative examples involving existential
quantifications in if-then-else conditions.
doc/faq.texi:
Delete part of an answer that is causing confusion.
This doesn't have any impact on the rest of the answer and avoids
the potential confusion.
doc/faq.texi:
Describe how to configure Mercury so that it does not require
any GCC extensions.
Mention a perforamance problem with ``make install'' on
Mac OS X.
.README.in:
bindist/bindist.README:
compiler/handle_options.m:
doc/faq.texi:
doc/library/texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
Bump the year in the usage messages.
Estimated hours taken: 0.5
Branches: main
Add a new FAQ section 'installation', and create two questions within it.
The first question describes a work-around for bugs 66 and 77.
The second question describes why the make install process takes a while and
directs the user to the Grades section in the User Guide.
doc/faq.texi:
As above.
Estimated hours taken: 0.1
Branches: main
Update copyright messages.
.README.in:
compiler/handle_options.m:
doc/faq.texi:
doc/library/texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
profiler/mercury_profile.m:
trace/mercury_trace_internal.c:
Bump the year in the copyright messages to 2008.
INSTALL_CVS:
Update a comment: we now require autoconf version 2.58 or greater.
Estimated hours taken: 1
Branches: main, release
Prepare for the 0.13 release and fix/update documentation.
NEWS:
HISTORY:
Update the NEWS and HISTORY files for the 0.13 release.
RELEASE_NOTES:
s/0.12/0.13/
Add Linux/x86_64 to the list of architectures supported by this
release.
Remove Solaris 8/x86 from the same list.
.README.in:
extras/README:
Remove references to the clp(r) binding. We no longer support it.
bindist/bindist.README:
Update the year in the copyright message.
Fix the gc version; 0.13 uses 6.5.
BUGS:
README.DotNet:
README.Java:
README.gcc-backend:
doc/faq.texi:
doc/make_manpage:
doc/mercury.html.in:
doc/mercury.info.in:
s/.cs.mu.oz.au/.csse.unimelb.edu.au/
library/array.m:
library/builtin.m:
library/eqvclass.m:
library/graph.m:
samples/README:
Fix typos.
Estimated hours taken: 0.5
Branches: main
Use `.' as a module qualification operator throughout
the compiler documentation.
Make sure that the documentation does not refer to syntax
that is now deprecated.
XXX The library reference still uses `__' in most places
but that will have to wait until those library modules are
changed over to use the new syntax.
doc/reference_manual.texi:
Remove the comment saying we should make this change.
s/is/=/ in a few spots.
doc/transition_guide.texi:
Replace an instance of the old-style lambda syntax.
doc/faq.texi:
doc/user_guide.texi:
As above.
Estimated hours taken: 0.1
Branches: main
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
Change some copyright dates from 2003 to 2004 in various
places.
Estimated hours taken: 3
Branches: main
doc/Mmakefile:
Use `makeinfo --html' rather than `perl texi2html' for creating
the HTML version of the documentation. Since makeinfo outputs
the HTML to different file names than texi2html, this also required
various other changes to handle the different file names.
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
Change @ifinfo to @ifnottex.
Uncomment the @dircategory commands, which were previously commented
out because they weren't supported by (our old version of) texi2html.
Update copyright dates.
Estimated hours taken: 2
Typographical changes for printed output.
Very little change made to the produced info files.
Also fix a C code example in reference_manual.texi.
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
Change en dashes to --, em dashes to ---, minus sign as @minus{}.
(Rendered as -,--,- respectively in info.)
Use @: after `e.g.', `i.e.', etc. to indicate word space rather than
sentence space.
Change `...' to `@dots{}'.
Change " to `` or '' (other than in code). (Rendered as " in info.)
doc/reference_manual.texi:
(Language specific bindings): Wrap `"C"', `"IL"' etc. in @code{}.
(Using pragma foreign_decl for C): Fix a C code example: append `;' to
struct definition.
Estimated hours taken: 1.5
Branches: main, release
Put version identifiers in the documentation.
doc/Mmakefile:
Preprocess the `.texi' files to produce `.texi_pp' files.
The `.texi_pp' files contain the contents of the `.texi'
files with the string <VERSION> replaced by the value
of $(VERSION), which is taken from the file VERSION
in the top-level `mercury' directory.
The rules to automatically generate the `.texi' files
for the library reference manual now generate `.texi_pp' files.
This makes it clearer that they are not to be edited.
Fix a bug which was causing the library documentation on the
web page to be out of date -- library_1.html needs to depend
on library-chapters.texi_pp.
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
Add version information.
Put a proper heading at the top of mercury_ref.info.
doc/mercury.html.in:
doc/mercury.info.in:
doc/mercury.html:
doc/mercury.info:
Add `.in' files which are preprocessed as for the `.texi' files.
Remove the old unpreprocessed versions.
doc/texi2html:
Allow `.texi_pp' as a suffix for the texinfo files to process.
w3/information/Makefile
Create the VERSION file, and include it in the generated
Mmake.common.
Estimated hours taken: 0.5
Branches: main
doc/texinfo.tex:
Update to the version from GNU TexInfo 4.0.
doc/*.texi:
Move the table of contents from the end of the document
to the start of the document (just after the title page).
The only reason that it was at the end was that previous
versions of TexInfo didn't support putting it at the start.
Estimated hours taken: 2
doc/reference_manual.texi:
Reorganise the reference manual to move the "C interface", "Impurity"
and "Implementation-dependent pragmas" sections out of the "Pragmas"
chapter. The rationale for this change is that it is interesting
to readers that the language supports these features, not that
there are pragmas to control them. Also, the nesting in the
"Pragmas" chapter was becoming excessive.
doc/user_guide.texi:
Refer to the "Implementation-dependent extensions" chapter
rather than the "Implemenentation-dependent pragmas" section
of the reference manual.
doc/*.texi:
Be consistent about the use of full stops at the end of
menu item descriptions. All menu item descriptions now
end with full stops (as in the texinfo info file).
Estimated hours taken: 0.1
doc/faq.texi:
doc/library.texi:
doc/reference_manual.texi:
doc/transition_guide.texi:
doc/user_guide.texi:
Comment out the @direntry and @dircategory commands.
They were not needed (since they weren't actually being used --
only the corresponding commands in mercury.info were being used),
and caused problems for the HTML version, because the current
version of texi2html that we have does not yet implement those
new TexInfo commands. They also caused some problems due to
many of our machines having older versions of `makeinfo' which
don't support the new commands yet either.
Estimated hours taken: 2
Add support for `install-info' and related TexInfo innovations.
configure.in:
Check for the `install-info' command.
doc/Mmakefile:
If we have `install-info', use it to install the entry
for mercury.info file in the .../info/dir file.
doc/mercury.info:
Add *INFO-DIR* commands, so that `install-info' works properly.
doc/*.texi:
Add @direntry and @dircategory commands, so that
`install-info' works properly.
(The initial version of this patch was provided by
Marko Schuetz <marko@ki.informatik.uni-frankfurt.de>.)
This replaces the old technique of hard-coding the *INFO-DIR*
info commands, inside `@ifinfo'.
Note that currently the Mmakefile does not actually invoke
install-info on all the info files; currently it only does that
for the menu file mercury.info, since it seems more polite to
just add a single entry in the top-level directory rather than
one for every single piece of Mercury-related documentation.
The change here to *.texi is just in case we should ever
decide to reverse that policy decision, or in case any other
tools that process info files start to make use of the
@direntry or @dircategory commands.
doc/texinfo.tex:
Update to the version from GNU texinfo 3.12, so that it
supports the @direntry and @dircategory commands.
Estimated hours taken: 2
Improve the documentation of the C interface.
Also various other minor improvements to the documentation.
doc/reference_manual.texi:
Document `pragma export'.
Also various other minor changes.
doc/user_guide.texi:
A few changes to avoid bad line breaks in the printed manual.
doc/faq.texi:
Fix a typo.
doc/*.texi:
Make sure each `.texi' file has only one `@finalout' command.
Some of them had this command in two different places.
Estimated hours taken: 0.0833
Addition to FAQ.
doc/texi.faq:
Simple addition to the FAQ for Mercury, regarding undefined symbol
errors from the compiler --> to get +, - etc you need to import int
or float. (Mark Brown asked this question once, so that makes it
pretty frequent :-)
faq.texi:
Add a new FAQ.
transition_guide.texi:
In the section on difference lists, add an example.
user_guide.texi:
Document the new MERCURY_NONSHARED_LIB_DIR environment
variable.
