bug#29367: 27.0.50; State and doc of `inline'

[Michael Heerdegen]

C-h f inline gives you

| inline is an alias for `progn'.
| 
| (inline BODY...)
| 
| Eval BODY forms sequentially and return value of last one.

`inline' is quite widely used in the Emacs sources - in Gnus, for
example.  But obviously not because it is such a handy alias for
`progn'.  The byte compiler treats it very specially.

I think it is obvious that `inline' needs a real documentation, and
should not be defined as an alias, because this is very confusing.

If `inline' should not be used in new code because it is obsoleted by
better alternatives (inline.el, maybe?  I don't know), we can declare it
obsolete.  Still, as long as it is used in Emacs a lot, and developers
need to work with this code base, they need to know what `inline' is.


TIA,

Michael.


In GNU Emacs 27.0.50 (build 5, x86_64-pc-linux-gnu, GTK+ Version 3.22.24)
 of 2017-11-18 built on drachen
Repository revision: 4da48312a230909a12d63987f865f25d45760773
Windowing system distributor 'The X.Org Foundation', version 11.0.11905000
System Description:     Debian GNU/Linux testing (buster)