Improve generic accessors concatenation.

ChangeLog entries:

2013-06-06  Didier Verna  <didier@didierverna.net>

	* src/doc/symbol.lisp (document): Only join generic reader and
        writer definitions when their docstrings are EQUAL.
Improve accessor methods concatenation.

2013-06-06  Didier Verna  <didier@didierverna.net>

	* src/doc/symbol.lisp (document): Only join accessor reader and
	writer definitions when their docstrings are EQUAL.
Don't advertise a standard method combination in definitions.

ChangeLog entries:

2013-06-06  Didier Verna  <didier@didierverna.net>

	* src/doc/symbol.lisp (render-method-combination): Don't render
        the standard method combination.
Small documentation fixes.

    2013-06-11  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (finalize-definitions): Update docstring
        and comment.
Fix one too broad method definition.

2013-06-11  Didier Verna  <didier@didierverna.net>

    * src/doc/symbol.lisp (document): Specialize the FUNCOID method on
    FUNCTION-DEFINITION only.
Initial support for documenting setf-expanders.

2013-06-11  Didier Verna  <didier@didierverna.net>

	* item/symbol.lisp (funcoid-definition): New slot SETF-EXPANDER.
	(finalize-definitions): Fill it in for macros and (generic)
	functions in the case of short forms.
	* doc/symbol.lisp (render-@defunoid): Document a potential
	setf-expander (docstring and reference to the setter function).
Support long forms of setf expanders.

2013-06-12  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (funcoid-definition): Update docstring to
	reflect handling of long forms of setf expanders.
	(finalize-definitions): Handle long forms of setf expanders.
	* src/doc/symbol.lisp (render-@defunoid): Document long forms of
	setf expanders.
Render anonymous setf expanders through Texinfo's @deffn macro.

2013-06-12  Didier Verna  <didier@didierverna.net>

	* src/util/texi.lisp (@defsetf): New macro.
	* src/doc/symbol.lisp (render-@defunoid): Use it.
Improve juncture of readers and writers methods and (generic) functions.

We don't need the lambda lists to be EQUAL since they are advertised along the
names anyway (so it doesn't hurt if they are different).

2013-06-12  Didier Verna  <didier@didierverna.net>

	* src/doc/symbol.lisp (document): Don't test for equality of
	lambda lists for (generic) accessors functions and methods.
Fix docstring typo.

2013-06-12  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (funcoid-definition): Remove redundant
        'the' in the docstring.
Commentaries about writer functions.

2013-06-12  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (accessor-definition):
	(add-symbol-definition): Add some comments about the way we handle
	writer functions.
Cosmetic fixes.

2013-06-13  Didier Verna  <didier@didierverna.net>

	    * src/item/symbol.lisp: Update file headers and cleanup
	    whitespaces.
Comment on the macro-definition structure.

2013-06-13  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (macro-definition): Add comment about the
	lack of WRITER slot.
Improve comment on reader/writer concatenation policy.

2013-06-13  Didier Verna  <didier@didierverna.net>

	* src/item/symbol.lisp (add-symbol-definition): Document that
        we don't concatenate heterogeneous readers and writers.
Improve comment on reader/writer concatenation policy.

  2013-06-13  Didier Verna  <didier@didierverna.net>

      * src/item/symbol.lisp (add-symbol-definition): Mention that regular
      and generic functions belong to different manual sections.
Improve comment about foreign definitions.

  2013-06-13  Didier Verna  <didier@didierverna.net>

      * src/item/symbol.lisp (finalize-definitions): Improve comment about
      foreign method combination operators.