bug#18829: 25.0.50; (emacs) manual: relation between `package-initialize' and `require' & `load-path'

bug#18829: 25.0.50; (emacs) manual: relation between `package-initialize' and `require' & `load-path'

[Drew Adams]

There is apparently a fair amount of confusion, especially by new users, about the relation between `require' and `load-path', on
the one hand, and `package-initialize', on the other.  

The doc for these is not together (which is normal), and it might help
to (a) provide cross references and (b) explicitly say that if you use
`package-initialize' then you do (should) not need to explicitly adjust
`load-path' and `require' the relevant code.

Here is one example of such a question and response explaining this:
http://emacs.stackexchange.com/a/2599/105



In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm@gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'

bug#18829: 25.0.50; (emacs) manual: relation between `package-initialize' and `require' & `load-path'

[Lars Ingebrigtsen]

Drew Adams <drew.adams@oracle.com> writes:

> There is apparently a fair amount of confusion, especially by new users, about the relation between `require' and `load-path', on
> the one hand, and `package-initialize', on the other.  
>
> The doc for these is not together (which is normal), and it might help
> to (a) provide cross references and (b)

I've now done this...

> explicitly say that if you use `package-initialize' then you do
> (should) not need to explicitly adjust `load-path' and `require' the
> relevant code.

And this.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no