bug#24150: 26.0.50; New command: dired-create-empty-file

[Eli Zaretskii]

> From: Tino Calancha <tino.calancha@gmail.com>
> Cc: psainty@orcon.net.nz,  tzz@lifelogs.com,  clement.pit@gmail.com,  
> michael.albinus@gmx.de,  24150@debbugs.gnu.org,  sdl.web@gmail.com
> Date: Wed, 01 Aug 2018 14:16:54 +0900
> 
> > That's fine.  But my comment was about the doc string of
> > dired-create-empty-file.
> Ahhhh, I see.
> Hummmm, I think we assume that Dired will add the new entry;
> similarly as `dired-do-delete', which deletes the file and
> the entry from the Dired buffer: in the docstring it's not mentioned
> that this command drop the entry as well.
> It's not mentioned in `dired-create-directory' either.
> 
> Every command prefixed with 'dired-' should add/drop buffer entries
> automatically as needed.
> I think this last sentence belongs to the manual more than the
> docstrings (probably already there).

Fair enough.

I think the doc strings do need to say that the file name is
added/modified in the Dired buffer, but that's a separate issue.
Maybe to make the doc string of dired-create-empty-file hint at that,
instead "create empty file" say something like "add an empty file to
the current directory"?