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.
.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.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: 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: 0.1
doc/library.texi:
Delete some obsolete documentation about module qualifiers.
They are documented in the language reference manual anyway,
and there is little point saying the same thing again here,
so I simply deleted the obsolete documentation rather than
updating to reflect the current status quo.
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.
doc/*.texi:
Make the `Up' pointers on the top nodes point to mercury.info,
not to the main info directory.
doc/mercury.info:
Add a blank line before the ^_, since apparently Emacs requires this.
doc/*:
Add a Mercury Library Reference manual (automatically
generated from the interface parts of the library source code).
Add new top-level files mercury.html and mercury.info.