doc/meta.tex: Delete stubs for obsolete `define-sod-class' local-macros.

doc/misc.tex: Clarify that `augment-options' is in `sod-frontend'.

doc/parsing.tex: Reorganize the parsing-syntax section.

Add some substructure and labels.  Promote `with-parser-context' to
first position.

I'm not sure this is completely right, but the previous situation was a
total mess.

doc/clang.tex: Clarify that `c-function-arguments' never gives you keywords.

doc/*.tex: Minor source-level reformatting.

No effect on the document.

doc/sod.sty: Provide explicit description labelling and indexing commands.

And a `\dhead*' which suppresses the usual labelling and indexing, for
the sake of special effects.  Use this new machinery to inhibit
the (possibly confusing) indexing on the example entries in
`lispintro.tex'.

doc/sod.sty: Rewrite `\descref' to support a [MOD] argument.

Take the opportunity to factor out an annoying part of the parsing,
which `might' come in handy later.

doc/sod.sty: Make the `modindex' and `modlabel' argument order less mad.

Now it's {MOD}{CAT}{...}...{NAME}, like (nearly) everything else.

doc/sod.sty: Keep `muffs' and `kwd' names decorated.

Have the `modindex' method strip off the decorations instead.

doc/sod.sty: Rename the default modifier to `plain'.

doc/sod.sty: Make `\fmtspecs' be external again.

Sadly, putting `\@...' control sequences in the index doesn't work.

doc/clang.tex, doc/layout.tex: Add labels and indexing for things in tables.

The simple C types, instruction types, and temporary names lacked
description entries.  Use the new `\desclabel' to arrange index entries
and labels.

src/codegen-impl.lisp: Remove the `setf' writer for `codegen-functions'.

It's not used for anything, and I don't think I want to export it.

src/parser/streams-impl.lisp: Use slot accessor rather than `with-slots'.

The code is a bit longer, but I think it's more comfortable to read.

src/method-proto.lisp: Use new `definst' private-slot-name feature.

I missed this when I was fixing up the codegen code.

src/codegen-proto.lisp: Delete obsolete `HACK' warning.

There's a principled(-ish) feature in `definst' nowadays.

src/*.lisp: Add missing exports.

All of these have documentation stubs (at least), but for some reason
didn't get exported.  In most cases, it's because they're slot accessors
for a class, rather than the headline name, but there are a few
exceptions.

doc/SYMBOLS: Distinguish c-type and parser (atomic) specifiers and forms.

doc/list-exports: Executables shouldn't have language-specific names.

Why did I tolerate this for so long?

doc/list-exports.lisp: Document and lightly reformat.

Much more pleasant.

doc/list-exports.lisp: Forbid bad slot names in private classes.

Previously we only worried about exported/foreign slot names in classes
whose names were exported symbols.  Also worry about classes whose names
are private symbols (in the home package).

doc/list-exports.lisp (pretty-symbol-name): Don't hide strange symbol names.

The old code just squashed the symbol name to lowercase and printed it.
This hides symbol names which already have lowercase letters in them, or
funny characters like colons.

We don't actually have any such names.

doc/list-exports.lisp (best-package-name: Don't sort the whole list.

Just pick the shortest one.

src/c-types-parse.lisp: Rename slots with public names.

Oops.  Hadn't noticed these before because `list-exports' wasn't clever
enough.

src/codegen-proto.lisp (definst): Name the argnames `public' and `private'.

The `cooked' name was no more cooked than the `raw' one, so that was a
daft convention.

doc/list-exports.lisp: Categorize `setf'-functions as generic or plain.

sod/doc.sty: Reorganize and improve documentation.

It's almost pleasant to work with now.

doc/sod.sty, etc.: Remove `type' category code.

It was a synonym for `ty', which I prefer, only you have to pick the
right one to get cross-references to work, which sucks.

doc/sod.sty: Unpublish `\fmtspecs'.

doc/sod.sty: Get `\@scripts' to cope if `_' isn't active.

doc/sod.sty: Debug `@;'.

OMG.

  * Don't eat the `\\' and then hope to find it.

  * Actually chew through the `;' characters rather than piling them up.

  * Don't eat spaces while looking for more `;'s.

doc/sod.sty: Get `@--...' to typeset a sequence of dashes properly.

Now we can replace the explicit `--\,--' bodge.

doc/sod.sty: Rewrite `@-' to cope with other things following.

Also, typesets as a dash, which is probably good.

doc/sod.sty: Hoist `\@ifnextchar@preserve' further up.

src/parser/streams-{proto,impl}.lisp: Publish classes and generic functions.

I bungled this somehow.  The exported classes should have ended up in
`streams-proto.lisp'.  I'm not, for now, exporting the proxy streams.

Because of this foolishness, I also failed to include documentation
stubs for any of these, so also add those.

doc/misc.tex: Mention that `int' is magically exported.

Someone might care.

doc/misc.tex: Include missing return values in synopses.

doc/Makefile.am, doc/sod.tex: Include package version on title page.

Maybe this should be in the running header or footer, but I'm not quite
sure where.

NOTES: New file of things to think about.

Makefile.am: Distribute the `STYLE' guide.

asdf-hack.lisp.in: Shore up and distribute.

For a long time, this was a private hack.  Shoring up involved using
`*load-pathname*' to find the right directory, and /that/ requires
actually having the hack be in the build directory rather than the
source, and that involves having the makefile put it there, and then it
needs shipping.

Makefile.am: Ship `emacs-hacks.el' on the offchance.

It's tiny and harmless.

lib/sod.h (SOD_DECL): Check that we allocated the right size.

lib/sod.h: Introduce `SOD_RECKLESS' feature macro to inhibit checking.

Currently there isn't any, but there will be soon.

doc/runtime.tex: Suggest asserting that a stack-allocated object tore down.

As discussed, it's not an error in itself if an object refuses teardown:
that just means that you can forget about it and it's someone else's
problem now.  But if you really have to deallocate it right now, that's
not going to work.

It might be an idea to introduce a macro to say, essentially,

{ int rc = sod_teardown(OBJ); assert(!rc); }

lib/sod.3: Add missing documentation.

I must have just stopped midway through `SOD_DECL'.  Documentation for
`sod_teardown', `SOD_MAKE' and friends, and `sod_destroy' is entirely
absent.

src/output-proto.lisp: Fix some bad indentation.

Bad Emacs.  No biscuit.

frontend.lisp: Add hooks for extensions to add new command-line options.

It seems rather pointless to document the option parser and then fail to
provide any way for extensions to make use of it.

Not that I've actually documented it yet...

src/optparse.lisp: Cope with options which don't have long names.

This makes the format strings remarkably hairy, but that just adds to
the fun, right?

src/optparse.lisp: Don't print options which have no help text.

This seems better than crashing because nil isn't a thing that can have
characters extracted from it.

src/frontend.lisp: Add a function to update the `*usage*' list.

src/frontend.lisp: Make the option parser available in a special variable.

No effect at the moment, because nobody does anything with the variable.

src/codegen-proto.lisp (definst): Overhaul argument-list processing.

Previously I just used gensyms for the argument names.  That breaks
reloading the system, though: the classes get redefined with new slot
names, but the old instances continue to linger, only they don't work
properly any more.

Instead, write a proper lambda-list parser which allows slot names to be
specified independently of the user-facing argument names.

Of course, this now changes the way the `list-exports' machinery parses
`definst' forms.

src/module-impl.lisp (find-file): Take a home path rather than a scanner.

Honestly, picking the home path out of the scanner input was always a
bit of a stretch.

Obviously, we also need to fix up the callers, but there's only one of
them.

src/: Use the `optparse' package in `sod-user'.

This involves moving the `optparse' build into the main `sod' system.

src/utilities.lisp: Share `int' to `sod' and `optparse' packages.

Now we don't have to choose between the C type and the option type.

doc/module.tex: Add stub for missing function `clear-the-decks'.

doc/misc.tex: Document some more miscellaneous utilities.

src/utilities.lisp (dosequence): Capture SEQ as a variable explicitly.

Previously it used `once-only', but that doesn't actually produce a
binding for constant expressions.

src/utilities.lisp (compose): Handle the case of zero arguments.

doc/misc.tex: Fix citation argument brackets.

doc/clang.tex: Fix `\descref' call missing its category code.

doc/: Reorder the arguments to `\descref'.

We now have

\descref*{CAT}{NAME}[TEXT]

rather than

\descref*{NAME}[TEXT]{CAT}

which flows much better.  There's a complication, that `\@ifnextchar'
gobbles space while looking for its character: implement a custom
version which doesn't do that.

The call sites were mostly fixed by [long line]

$ sed -i '/\\descref\(\*\)\?\({[^}]\+}\(\[[^]]\+]\)\?\)\({[^}]\+}\)/ s//\\descref\1\4\2/g' doc/*.tex

but some calls run over two lines and had to be found and fixed by hand.

doc/runtime.tex: Fix linking for `obj.teardown' message.

Use new `\descref*' and `\autopageref'.

doc/: Add `*' option to `\descref' to suppress the page number.

Now you only get the hyperlink.

doc/concepts.tex: Make a footnote a bit less stuffy.

doc/runtime.tex, lib/keyword.3: Explain the other benefit of `NO_KWARGS'.

It's not just for hacking around C89 after all.

doc/concepts.tex: Add some clarifications about initargs.

doc/concepts.tex: Briefly explain translation-time metaobjects.

doc/concepts.tex: Delete `no way to discover alignment for instance' claim.

Replace with a reference to the `align' class slot.

doc/misc.tex: Document many utilities.

doc/misc.tex: Fix keyword argument name in `find-duplicates'.

doc/misc.tex: `parse-body' is a function, not a macro.

doc/misc.tex: Recategorize some descriptions.

  * `loc' is a locative thing, not a macro thing.

  * `distinguished-point-shortest-paths' doesn't do anything with lists.

  * `whitespace-char-p' doesn't track positions.

squash! doc/misc.tex: Recategorize some descriptions.

doc/structures.tex: Confess to a slight lie about header files.

doc/: Invent an override for `\xref' categories, and use it.

The most important thing here is to able to list two things as `sections
X and Y'.  I can't use plain `\ref' for this any more because I'm
relying on `\xref' to highlight the category name.

doc/concepts.tex: Link to `SodObject' for the `init' message.

doc/concepts.tex: Fix subclass/superclass confusion.

If I can't get this right, my readers don't stand a chance.

doc/sod.sty: Highlight hyperlinks to descriptions better.

Make the name itself be a link, and highlight `page' as part of the page
link.

doc/sod.sty: Index `*earmuffs*' and `:keywords' more usefully.

Using the new machinery.

doc/sod.sty: Let the modifier control labelling and indexing.

doc/sod.sty: Rename `descmod' to `modcat'.

There'll be more `mod...' things along soon.

doc/sod.sty: Hoist `\@desc@dispatch' above its call sites.

doc/sod.sty: Forbid page breaks between description header entries.

doc/sod.sty: Make internal PDF links go to the right places.

doc/runtime.tex: Line-wrapping failure.

doc/structures.tex: Mention that the Sod examples are fictitious.

doc/structures.tex: Missing line break.

doc/concepts.tex: Fix description of C-fragment syntax.

lib/keyword.3, doc/concepts.tex: Mention performance of keyword arguments.

It's surprisingly not that bad.

lib/keyword.3: Missing word.

doc/: Fix <metasyntactic-variable>s which were missing their `@'.

lib/sod.h: Fix formatting failure.

lib/keyword.h, src/method-impl.lisp: Check user keywords first.

For better performance, check the user's specific keywords before the
magic built-in ones.

lib/keyword.h: Random commentary fixes.

lib/keyword.c, src/method-impl.lisp: Use `kw.valist' consistently.

Argh.  I had `kw.va_list' intermixed.  Settle on the version without the
underscore (because it matches `K_VALIST' better).

src/builtin.lisp: Keep the first initarg in the list.

Otherwise a superclass unexpectedly defining an initarg will cause it to
be demoted relative to other initargs.

src/builtin.lisp: Don't assume we have an initializer if there are initargs.

This caused an ugly crash with the text

class Foo: SodObject {
  [initarg = x] int x;
}

src/class-make-impl.lisp: Attach initargs in the correct order.

This is important for selecting the right slot initarg.

src/class-make-{proto,impl}.lisp: Don't make duplicate initargs.

If you set an initarg property on a slot definition which includes an
initializer then both the slot definition and the initializer act on the
initarg property and you end up with two initargs.  This isn't actually
a major problem, but it's ugly.

Add a new keyword argument to `make-sod-instance-initializer' to prevent
this from happening.