From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Philipp Stephani
> From: Philipp Stephani <p.stephani2@gmail.com>
> Date: Sun, 24 Sep 2017 08:00:53 +0000
> Cc: 27764@d= ebbugs.gnu.org
>
>=C2=A0 > (defun ediff-buffers (buffer-A buffer-B &optional start= up-hooks job-name)
>=C2=A0 > - "Run Ediff on a pair of buffers, BUFFER-A and BUFFER= -B."
>=C2=A0 > + "Run Ediff on a pair of buffers, BUFFER-A and BUFFER= -B.
>=C2=A0 > +STARTUP-HOOKS is a list of functions that Emacs calls with= out
>=C2=A0 > +arguments after setting up the Ediff buffers. JOB-NAME is = a
>=C2=A0 > +symbol describing the Ediff job type; it defaults to
>=C2=A0 > +`ediff-buffers'."
>
>=C2=A0 Here and elsewhere where JOB-NAME is mentioned, it would be good= to
>=C2=A0 have a full list of supported symbols, not just the default one.=
>
> I've added some generic text to the docstrings. I have no idea wha= t the full list of supported symbols are and
> what the point of this argument is in the first place.
Can we have there at least the list of the symbols that are seen in
the sources:=C2=A0 I see these:
=C2=A0ediff-merge-files-with-ancestor, ediff-last-dir-ancestor,
=C2=A0ediff-last-dir-C, ediff-buffers, ediff-buffers3, ediff-merge-buffers,=
=C2=A0ediff-merge-buffers-with-ancestor
If this list is too long to be repeated in each doc string, we could
have it once, and reference that place from the other do strings.=C2=A0 I think either way would be much better than using some generic text.